Elemento: PanelDibujo3D.
Icono:
Texto: Un contenedor 3D para elementos de dibujo.
Descripción: Un PanelDibujo3D es un contenedor especial en tres dimensiones para hijos que sean elementos de dibujo. Aunque también es un contenedor, no debe usarse para albergar otro tipo de elementos.
Los paneles de dibujo en 3D representan una región del espacio tridimensional y proporcionan su propio sistema de coordenadas, desde el punto (Mínimo X, Mínimo Y, Mínimo Z) al (Máximo X, Máximo Y, Máximo X). (Aunque también pueden ajustar sus escalas automáticamente). Están provistos de un sistema básico de eliminación de líneas ocultas, que resulta muy efectivo para configuraciones sencillas.
Los paneles de dibujo 3D son interactivos, pero de manera diferente a los paneles de dibujo bidimensionales.
Haciendo clic y arrastrando el ratón sobre una zona limpia de la pantalla cambia el punto de vista de la escena. Sujetar la tecla derecha o izquierda del ratón al arrastrar puede implicar una forma diferente de redibujar la escena mientras se gira.
Si se mantiene pulsada a la vez la tecla "Control", la escena se mueve en su conjunto.
Si la tecla que se mantiene pulsada es la de mayúsculas, se aplica un zoom (positivo o negativo, según el movimiento del ratón) a toda la escena.
Si esta tecla es la de "Alt", aparece un cursor tridimensional que permite seleccionar un punto de la escena. El movimiento de este cursor responde al movimiento bidimensional del ratón afectando solamente a dos coordenadas espaciales. Para forzar el movimiento en una dimensión particular, deberá mantenerse pulsada la tecla correspondiente, X, Y o Z. Al cambiar de punto se aplican las acciones "Al Pulsar", "Al Mover" y "Al Soltar", exactamente igual que en el caso de los paneles de dibujo bidimensionales.
Tabla de propiedades |
||
Nombre | Descripción | Valores aceptados |
Escalas | ||
Autoescala X | Si se debe calcular automáticamente la escala en el eje X. | Una variable booleana o una de las constantes true o false. |
Autoescala Y | Si se debe calcular automáticamente la escala en el eje Y. | Una variable booleana o una de las constantes true o false. |
Autoescala Z | Si se debe calcular automáticamente la escala en el eje Z. | Una variable booleana o una de las constantes true o false. |
Mínimo X | El menor valor de la coordenada X que resulta visible en el panel. | Una constante o variable de tipo double. |
Máximo X | El mayor valor de la coordenada X que resulta visible en el panel. | Una constante o variable de tipo double. |
Mínimo Y | El menor valor de la coordenada Y que resulta visible en el panel. | Una constante o variable de tipo double. |
Mínimo Y | El mayor valor de la coordenada Y que resulta visible en el panel. | Una constante o variable de tipo double. |
Mínimo Z | El menor valor de la coordenada Z que resulta visible en el panel. | Una constante o variable de tipo double. |
Mínimo Z | El mayor valor de la coordenada Z que resulta visible en el panel. | Una constante o variable de tipo double. |
Interacción | ||
X | La coordenada X de la posición del ratón. | Una variable de tipo double. |
Y | La coordenada Y de la posición del ratón. | Una variable de tipo double. |
Z | La coordenada Z de la posición del ratón. | Una variable de tipo double. |
Al Pulsar | La acción a invocar cuando se hace clic sobre el panel. | El código Java a invocar para la acción. |
Al Mover | La acción a invocar cuando se arrastra el ratón pulsado sobre el panel. | El código Java a invocar para la acción. |
Al Soltar | La acción a invocar cuando se suelta el botón del ratón sobre el panel. | El código Java a invocar para la acción. |
Modo de Proyección |
||
Proyección | El modo de proyección de la escena sobre el plano. | Una de las constantes siguientes:
Puede usarse también uno de los números enteros indicados entre paréntesis, lo que permite variar la proyección en tiempo de ejecución. |
Cuadrado | Si debe mantenerse la proporción entre las coordenadas horizontal y vertical (cuando se proyecta en dos dimensiones). | Una variable booleana o una de las constantes true o false. |
Ocultar Líneas | Si se deben eliminar las líneas ocultas. | Una variable booleana o una de las constantes true o false. |
Dibujo Rápido | Si se puede usar una modalidad de dibujo rápido (y menos pulido) al girar la escena. | Una variable booleana o una de las constantes true o false. |
Alfa | El ángulo con que se debe girar la escena horizontalmente antes de proyectarla (en modos 3D). | Una constante o variable de tipo double, si el ángulo se da en radianes, o una constante o variable de tipo int, si el ángulo se da en grados. |
Beta | El ángulo con que se debe girar la escena verticalmente antes de proyectarla (en modos 3D). | Una constante o variable de tipo double, si el ángulo se da en radianes, o una constante o variable de tipo int, si el ángulo se da en grados. |
Zoom | Un factor de aumento para el dibujo. | Una constante o variable de tipo double. |
Aspecto Gráfico |
||
Decoración | El tipo de decoración por defecto que presenta la escena. | Una de las constantes siguientes:
Puede usarse también uno de los números enteros indicados entre paréntesis. |
Cursor | El tipo de cursor a usar cuando se sitúa un punto. | Una de las constantes siguientes:
Puede usarse también uno de los números enteros indicados entre paréntesis. |
Coordenadas | Si se deben mostrar las coordenadas al pulsar sobre un punto del panel. | Una variable booleana o una de las constantes true o false. |
Formato X | El formato para la visualización de la coordenada X. | Cualquier valor aceptado por la clase java.text.DecimalFormat. Ver página auxiliar. El valor por defecto es "x=0.000". |
Formato Y | El formato para la visualización de la coordenada Y. | Cualquier valor aceptado por la clase java.text.DecimalFormat. Ver página auxiliar. El valor por defecto es "y=0.000". |
Formato Z | El formato para la visualización de la coordenada Z. | Cualquier valor aceptado por la clase java.text.DecimalFormat. Ver página auxiliar. El valor por defecto es "z=0.000". |
Tamaño | El tamaño del elemento. | Una variable Object de tipo java.awt.Dimension o los valores enteros de ancho y alto, respectivamente, separados por una coma. |
Fondo | El color usado para el fondo del elemento y el de sus hijos (salvo que fijen expresamente su propio valor). | Una variable Object de la clase java.awt.Color
o uno de los colores predefinidos: black,
blue, cyan, darkGray, gray, green, lightGray, magenta, orange, pink,
red, white, yellow.
También puede especificarse un color dando las coordenadas enteras (entre 0 y 255) de sus componentes RGB (más la transparencia opcional). El valor por defecto lo decide el sistema. |
Color | El color usado para los textos del elemento o de cualquiera de sus hijos (salvo que fijen expresamente su propio valor). | Ver los valores para la propiedad Fondo. |
Fuente | El tipo de fuente a usar por cualquier texto del elemento o de cualquiera de sus hijos (salvo que fijen expresamente su propio valor). | Una variable Object de la clase java.awt.Font
o una terna de familia, estilo y tamaño, separados por comas. El
estilo debe ser uno de plain,
bold, italic, bold | italic. Ejemplo: Monospaced,italic,18.
El valor por defecto lo decide el sistema. |
Ayuda | El texto mostrado cuando el cursor se posa sobre el elemento. | Cualquier constante o variable de tipo String. |