Polígono
El objeto Polígono te permite colocar un estímulo personalizado en forma de polígono en un marco al hacer clic para definir sus vértices en el editor de tareas. Una vez dibujado, el polígono es completamente editable: puedes arrastrar vértices existentes, agregar puntos intermedios y eliminar puntos. La apariencia de relleno y trazo del polígono es configurable, y puedes vincular la forma a una variable de información del estímulo.
Una aplicación común es el seguimiento ocular: al trazar el contorno de un estímulo irregular con muchos vértices, puedes usar el Polígono como una máscara de AOI precisa en el Analizador. Esto es especialmente útil cuando la forma del estímulo no se puede capturar con un rectángulo y no está disponible un SVG.
Tabla de Contenidos
Agregar el Objeto de Dibujo Poligonal
En la barra de herramientas del editor de tareas, abre el grupo Images & Drawing y selecciona Polygon para agregar un objeto Polígono al marco actual.
El elemento se agrega al marco como un polígono vacío. El modo de dibujo comienza automáticamente para que puedas comenzar a colocar vértices de inmediato.
Dibujar un Polígono
Con el Objeto de Dibujo Poligonal seleccionado y el modo de dibujo activo, haz clic en cualquier lugar del lienzo del marco para colocar un vértice. Cada clic agrega un nuevo punto al contorno del polígono.
Para cerrar el polígono (conectar el último vértice de nuevo al primero), haz clic en el mango circular en el primer vértice. Alternativamente, activa la propiedad Closed en el panel de propiedades para forzar el cierre de la forma sin hacer clic en el mango.
Para dejar de agregar vértices sin cerrar la forma, haz clic en Stop drawing (ESC) en el panel de propiedades, o presiona ESC. El polígono permanece como una polilínea abierta hasta que se activa Closed.
Modificar un Polígono Existente
Después de detener el dibujo, el polígono entra en modo de edición. Todos los mangos de los vértices existentes permanecen visibles en el lienzo.
- Mover un vértice: Haz clic y arrastra cualquier mango de vértice a una nueva posición. Los bordes del polígono se actualizan en tiempo real.
- Agregar un punto intermedio: En la Tabla de Puntos, haz clic en el ícono
+en cualquier fila. Se inserta un nuevo vértice en el punto medio entre ese punto y el siguiente en la secuencia. - Eliminar un vértice: En la Tabla de Puntos, haz clic en el ícono
×en la fila del vértice que deseas eliminar.
Para reanudar la adición de nuevos vértices al final de la secuencia, haz clic en Continue drawing en el panel de propiedades.
Propiedades del Objeto
Todas las propiedades a continuación se encuentran en el panel de propiedades cuando el Objeto de Dibujo Poligonal está seleccionado.
| Propiedad | Descripción |
|---|---|
Stimulus Info | Una etiqueta de texto asociada con el elemento. Utiliza esto para vincular el polígono a una variable de información del estímulo para grabar o identificar la forma en los datos exportados. |
Fill color | Una casilla de verificación controla si se aplica relleno. Cuando está marcada, un selector de color establece el color de relleno del interior del polígono. Cuando está desmarcada, el interior es transparente. |
Stroke color | El color del contorno del polígono. Utiliza el selector de color para establecerlo. |
Stroke width | El ancho del contorno del polígono en píxeles. Introduce un número positivo. |
Closed | Cuando está marcada, el último vértice se conecta de nuevo al primero, formando un polígono cerrado. Cuando está desmarcada, la forma es una polilínea abierta. |
Tabla de Puntos
La sección Points en el panel de propiedades muestra una tabla de todos los vértices actuales. Cada fila muestra el índice del vértice (nr), su posición horizontal (x), y su posición vertical (y) en coordenadas de marco.
Utiliza los controles de fila para:
- Hacer clic en
+para insertar un nuevo vértice en el punto medio entre esa fila y la siguiente. - Hacer clic en el ícono de eliminar para borrar el vértice en esa fila.
También puedes establecer los puntos del polígono programáticamente usando una variable de marco de datos y la acción Set Object Property en el sistema de eventos. Cada fila en el marco de datos representa un vértice, con columnas para las coordenadas x e y.
Limpiar el Dibujo
Para eliminar todos los vértices y comenzar el polígono desde cero, haz clic en Clear all en el panel de propiedades. Esto restablece la forma a un polígono vacío y vuelve a activar automáticamente el modo de dibujo.
Usar el Polígono como un AOI de Seguimiento Ocular
El objeto Polígono puede servir como una máscara AOI invisible para el seguimiento ocular. La configuración típica es dibujar el polígono trazando el contorno de un estímulo irregular, y luego dejarlo completamente sin estilo: sin relleno, sin trazo. El polígono es invisible para los participantes, pero su límite de vértices se usa para pruebas de impacto de mirada y fijación.
Usa este enfoque cuando un AOI rectangular es demasiado grueso para la forma del estímulo y no hay disponible un elemento SVG. Debido a que puedes colocar tantos vértices como necesites, puedes seguir de cerca cualquier contorno irregular.
Las muestras de mirada y fijación se prueban contra el conjunto exacto de vértices del polígono en lugar de un rectángulo delimitador. Métricas como el tiempo de permanencia y el porcentaje de tiempo en el AOI se calculan utilizando el límite completo del polígono.
Si la forma de tu polígono difiere por condición, el conjunto correcto de vértices se resuelve automáticamente por prueba utilizando el sistema de modificadores.
Dale al polígono una etiqueta clara Stimulus Info para que sea fácil de identificar al configurar métricas de AOI.
Modificar el Polígono en Tiempo de Ejecución
Usa la acción Set Object Property en el sistema de eventos para actualizar el polígono durante un experimento. Las siguientes propiedades se pueden establecer en tiempo de ejecución:
| Propiedad | Tipo | Qué hace |
|---|---|---|
stimulusInformation | string | Actualiza la etiqueta del estímulo asociada con el polígono. |
fillColor | string | Cambia el color de relleno del polígono. |
strokeColor | string | Cambia el color del contorno del polígono. |
strokeWidth | number | Cambia el ancho del contorno en píxeles. |
points | array | Reemplaza el conjunto completo de vértices con un nuevo conjunto de pares de coordenadas [x, y]. |
hasClosed | boolean | Establece si el polígono está cerrado (true) o abierto (false). |
Ejemplo: reemplaza la forma del polígono cuando comienza un ensayo
Disparador:
On Frame Start
Acción:Set Object Property->Set Target: tu objeto Polígono -> Propiedad:points-> Valor: tu variable que contiene el nuevo arreglo de coordenadas
Lectura Adicional
Propiedades del Objeto
El panel de propiedades compartido que todos los objetos heredan: posición, tamaño, escala, rotación y estilo. Cubre la configuración de Mantener Proporción y los controles de copiar/pegar para los valores de posición y escala.
Sistema de Eventos
Cómo funcionan los disparadores y acciones en Labvanced. Usa Establecer Propiedad de Objeto para actualizar los vértices del polígono, relleno, trazo y estado cerrado en tiempo de ejecución.
Todos los Objetos
Un índice completo de todos los objetos disponibles en el editor de experimentos de Labvanced, incluidos elementos de visualización, entrada, medios y grabación.