Elemento: Traza.

Icono:   

Texto: Una secuencia de puntos.

Descripción: Una Traza es un elemento de dibujo que dibuja una serie de puntos en unas determinadas coordenadas del padre. Los puntos a dibujar se añaden uno a uno, secuencialmente, y pueden visualizarse usando marcadores o uniéndolos mediante segmentos (o ambas cosas a la vez).


Dos trazas sin marcadores y conectadas.

Puede indicarse a la traza que dibuje un número máximo de puntos, en cuyo caso, descartará valores viejos para acomodar a los nuevos. No obstante, si la propiedad "No Repetir" es cierta y el punto a añadir es idéntico al anterior, se ignorará. Puede también deshabilitarse (normalmente sólo temporalmente) la recepción de datos. Finalmente, la traza puede aceptar sólo uno de cada cierto número de puntos recibidos. Esto es útil en caso de que el modelo genere demasiados datos.

Las trazas responden a la interacción del usuario sobre su posición (que puede ser diferente de las coordenadas de los puntos introducidos), cambiando de posición e invocando hasta tres acciones distintas.

Tabla de propiedades

Nombre Descripción Valores aceptados
Entrada
X La coordenada X del nuevo punto a introducir. Cualquier constante o variable de tipo double o int.
Y La coordenada Y del nuevo punto a introducir. Cualquier constante o variable de tipo double o int.
Z La coordenada Z del nuevo punto a introducir. Cualquier constante o variable de tipo double o int.

Posición

Posición X La coordenada X del elemento. Cualquier constante o variable de tipo double o int.
Posición Y La coordenada Y del elemento. Cualquier constante o variable de tipo double o int.
Posición Z La coordenada Z del elemento. Cualquier constante o variable de tipo double o int.

Configuración

Puntos Número máximo de puntos a dibujar. El valor especial 0 indica que deben dibujarse todos los puntos. Cualquier constante o variable de tipo int.
Saltar El número de puntos a recibir para finalmente aceptar un dato. Cualquier constante o variable de tipo int.
Activa Si la traza recibe datos o no. Una variable booleana o una de las constantes true o false.
No Repetir Si debe descartarse un  punto idéntico al anterior. Una variable booleana o una de las constantes true o false.
Conectar Si debe conectarse el nuevo punto recibido con el anterior. Una variable booleana o una de las constantes true o false.

Visibilidad e Interacción

Visible La visibilidad del elemento. Una variable booleana o una de las constantes true o false.
Movible Si el elemento responde a interacción del usuario. Una variable booleana o una de las constantes true o false.

Acciones

Al Pulsar La acción a invocar cuando se hace clic sobre el elemento. El código Java a invocar para la acción. 
Al Mover La acción a invocar cuando se arrastra el elemento. El código Java a invocar para la acción. 
Al Soltar La acción a invocar cuando se suelta el elemento. El código Java a invocar para la acción. 
Aspecto Gráfico
Color Línea El color usado para las líneas del elemento.  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.

Grosor El grosor para las líneas del elemento. Cualquier constante o variable de tipo double o int. El valor por defecto es 1.

También puede proporcionarse una variable Object de la clase java.awt.Stroke.

Estilo Marca La forma gráfica de dibujo de las marcas. Una de las constantes siguientes:
  • NONE. No se dibuja marca alguna. (Entero equivalente: 0).
  • ELLIPSE. Se dibuja una elipse. (Entero equivalente: 1).
  • RECTANGLE. Se dibuja un rectángulo. (Entero equivalente: 2).
  • ROUND_RECTANGLE. Se dibuja un rectángulo con los bordes redondeados.(Entero equivalente: 3).
  • WHEEL. Se dibuja una elipse con sus ejes coordenados.(Entero equivalente: 4).

Puede usarse también uno de los números enteros indicados entre paréntesis, lo que permite variar la forma de dibujo en tiempo de ejecución.

Tamaño Marca El tamaño de las marcas en píxeles. Cualquier constante o variable de tipo int
Color Marca El color usado para las marcas. Ver los valores para la propiedad Color Línea.
Posición La posición exacta de dibujo de las marcas relativa a las coordenadas del elemento. Una de las constantes siguientes:
  • CENTERED. Se dibuja centrado. (Entero equivalente: 0).
  • NORTH. Se dibuja con sus coordenadas arriba y en el centro del elemento. (Entero equivalente: 1).
  • SOUTH. Se dibuja con sus coordenadas abajo y en el centro del elemento. (Entero equivalente: 2).
  • EAST. Se dibuja con sus coordenadas a la derecha y en el centro del elemento.(Entero equivalente: 3).
  • WEST. Se dibuja con sus coordenadas a la izquierda y en el centro del elemento.(Entero equivalente: 4).
  • NORTH_EAST. Se dibuja con sus coordenadas arriba y a la derecha del elemento. (Entero equivalente: 5).
  • NORTH_WEST. Se dibuja con sus coordenadas arriba y a la izquierda del elemento. (Entero equivalente: 6).
  • SOUTH_EAST. Se dibuja con sus coordenadas abajo y a la derecha del elemento.(Entero equivalente: 7).
  • SOUTH_WEST. Se dibuja con sus coordenadas abajo y a la izquierda del elemento.(Entero equivalente: 8).

Puede usarse también uno de los números enteros indicados entre paréntesis, lo que permite variar la posición de dibujo en tiempo de ejecución.

Girar El ángulo de giro a aplicar a las marcas. 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.
Memoria Un valor entero que indica cuantos conjuntos de datos debe recordar la traza. 0 : La traza muestra todos los  conjuntos de datos  que recibe hasta que se llama al método _resetView().
1: La traza muestra únicamente los datos actuales (este es el valor por defecto).
2 o más: La traza muestra tantos conjuntos de datos como se indica. La adición de nuevos conjuntos causa que se pierdan los más antiguos amteriores.
Mostrar Mem Cómo se muestran las series en memoria. Una delas constantes siguientes:
  • SHOW_ALL. Los datos anteriores se muestran completos. (Entero equivalente: 0).
  • AS_ADDED. Los datos anteriores se muestran al mismo tiempo que se añaden nuevos datos. (Entero equivalente: 1).
  • X_ORDER. Se muestran todos los puntos anteriores cuya coordenada X sean menor o igual que la del último punto nuevo añadido. (Entero equivalente: 2).
  • Y_ORDER. Similar a X_ORDER.(Entero equivalente: 3).
  • Z_ORDER. Similar a X_ORDER.(Entero equivalente: 4).

Puede usarse también uno de los números enteros indicados entre paréntesis, lo que permite variar la forma de dibujo en tiempo de ejecución.

Color Mem El color usado para dibujar los datos en memoria. Ver los valores para la propiedad Color Línea.