Polygone
L'objet Polygone vous permet de placer un stimulus en forme de polygone personnalisé sur un cadre en cliquant pour définir ses sommets dans l'éditeur de tâches. Une fois dessiné, le polygone est entièrement modifiable : vous pouvez faire glisser des sommets existants, ajouter des points médians et supprimer des points. L'apparence de remplissage et de contour du polygone est configurable, et vous pouvez lier la forme à une variable d'information sur le stimulus.
Une application courante est le suivi oculaire : en traçant le contour d'un stimulus irrégulier avec de nombreux sommets, vous pouvez utiliser le Polygone comme un masque AOI précis dans l'Analyseur. Cela est particulièrement utile lorsque la forme du stimulus ne peut pas être capturée avec un rectangle et qu'un SVG n'est pas disponible.
Table des matières
Ajout de l'objet de dessin Polygone
Dans la barre d'outils de l'éditeur de tâches, ouvrez le groupe Images & Drawing et sélectionnez Polygon pour ajouter un objet Polygone au cadre actuel.
L'élément est ajouté au cadre en tant que polygone vide. Le mode de dessin démarre automatiquement pour que vous puissiez commencer à placer des sommets immédiatement.
Dessiner un Polygone
Avec l'objet de dessin Polygone sélectionné et le mode de dessin actif, cliquez n'importe où sur le canevas du cadre pour placer un sommet. Chaque clic ajoute un nouveau point au contour du polygone.
Pour fermer le polygone (connecter le dernier sommet au premier), cliquez sur la poignée circulaire au premier sommet. Alternativement, cochez la propriété Closed dans le panneau des propriétés pour forcer la forme à se fermer sans cliquer sur la poignée.
Pour arrêter d'ajouter des sommets sans fermer la forme, cliquez sur Stop drawing (ESC) dans le panneau des propriétés, ou appuyez sur ESC. Le polygone reste comme une polyligne ouverte jusqu'à ce que Closed soit activé.
Modifier un Polygone Existant
Après avoir arrêté le dessin, le polygone entre en mode modification. Toutes les poignées de sommet existantes restent visibles sur le canevas.
- Déplacer un sommet : Cliquez et faites glisser n'importe quelle poignée de sommet vers une nouvelle position. Les bords du polygone se mettent à jour en temps réel.
- Ajouter un point médian : Dans la Table des Points, cliquez sur l'icône
+sur n'importe quelle ligne. Un nouveau sommet est inséré au point médian entre ce point et le suivant dans la séquence. - Supprimer un sommet : Dans la Table des Points, cliquez sur l'icône
×sur la ligne pour le sommet que vous souhaitez supprimer.
Pour reprendre l'ajout de nouveaux sommets à la fin de la séquence, cliquez sur Continue drawing dans le panneau des propriétés.
Propriétés de l'objet
Toutes les propriétés ci-dessous se trouvent dans le panneau des propriétés lorsque l'objet de dessin Polygone est sélectionné.
| Propriété | Description |
|---|---|
Stimulus Info | Une étiquette texte associée à l'élément. Utilisez ceci pour lier le polygone à une variable d'information sur le stimulus pour l'enregistrement ou l'identification de la forme dans les données exportées. |
Fill color | Une case à cocher contrôle si le remplissage est appliqué. Lorsqu'elle est cochée, un sélecteur de couleur définit la couleur de remplissage de l'intérieur du polygone. Lorsqu'elle est décochée, l'intérieur est transparent. |
Stroke color | La couleur du contour du polygone. Utilisez le sélecteur de couleur pour la définir. |
Stroke width | La largeur du contour du polygone en pixels. Entrez un nombre positif. |
Closed | Lorsqu'elle est cochée, le dernier sommet est connecté au premier, formant un polygone fermé. Lorsqu'elle est décochée, la forme est une polyligne ouverte. |
Table des points
La section Points dans le panneau des propriétés montre une table de tous les sommets actuels. Chaque ligne affiche l'index du sommet (nr), sa position horizontale (x), et sa position verticale (y) dans les coordonnées du cadre.
Utilisez les contrôles de ligne pour :
- Cliquez sur
+pour insérer un nouveau sommet au point médian entre cette ligne et la suivante. - Cliquez sur l'icône de suppression pour supprimer le sommet à cette ligne.
Vous pouvez également définir les points du polygone de manière programmatique en utilisant une variable de trame de données et l'action Set Object Property dans le système d'événements. Chaque ligne de la trame de données représente un sommet, avec des colonnes pour les coordonnées x et y.
Effacer le dessin
Pour supprimer tous les sommets et recommencer le polygone à zéro, cliquez sur Clear all dans le panneau des propriétés. Cela réinitialise la forme en un polygone vide et réactive automatiquement le mode de dessin.
Utiliser le Polygone comme AOI de suivi oculaire
L'objet Polygone peut servir de masque AOI invisible pour le suivi oculaire. La configuration typique consiste à dessiner le polygone en traçant le contour d'un stimulus irrégulier, puis à le laisser complètement non stylé : pas de remplissage, pas de contour. Le polygone est invisible pour les participants mais sa frontière de sommet est utilisée pour le test de regard et de fixation.
Utilisez cette approche lorsque l'AOI rectangulaire est trop grossière pour la forme du stimulus et qu'un élément SVG n'est pas disponible. Parce que vous pouvez placer autant de sommets que nécessaire, vous pouvez suivre de près tout contour irrégulier.
Les échantillons de regard et de fixation sont testés par rapport à l'ensemble exact de sommets du polygone plutôt qu'à un rectangle bounding. Des indicateurs tels que le temps de séjour et le pourcentage de temps dans l'AOI sont calculés en utilisant la frontière complète du polygone.
Si la forme de votre polygone diffère par condition, l'ensemble de sommets correct est résolu par essai automatiquement grâce au système de modificateurs.
Donnez au polygone une étiquette claire Stimulus Info afin qu'il soit facile à identifier lors de la configuration des métriques AOI.
Modifier le Polygone à l'exécution
Utilisez l'action Set Object Property dans le système d'événements pour mettre à jour le polygone pendant une expérience. Les propriétés suivantes peuvent être définies à l'exécution :
| Propriété | Type | Ce que cela fait |
|---|---|---|
stimulusInformation | chaîne | Met à jour l'étiquette de stimulus associée au polygone. |
fillColor | chaîne | Change la couleur de remplissage du polygone. |
strokeColor | chaîne | Change la couleur du contour du polygone. |
strokeWidth | nombre | Change la largeur du contour en pixels. |
points | tableau | Remplace l'ensemble complet de sommets par un nouvel ensemble de paires [x, y] de coordonnées. |
hasClosed | booléen | Définit si le polygone est fermé (true) ou ouvert (false). |
Exemple : remplacer la forme du polygone lorsque l'essai commence
Déclencheur :
On Frame Start
Action :Set Object Property->Set Target: votre objet Polygone -> Propriété :points-> Valeur : votre variable contenant le nouveau tableau de coordonnées
Lectures complémentaires
Propriétés de l'objet
Le panneau de propriétés partagé dont héritent tous les objets : position, taille, échelle, rotation et style. Couvre le paramètre Conserver le rapport d'aspect et les contrôles copier/coller pour les valeurs de position et d'échelle.
Système d'événements
Comment fonctionnent les déclencheurs et les actions dans Labvanced. Utilisez Définir la propriété de l'objet pour mettre à jour les sommets du polygone, le remplissage, le contour, et l'état fermé à l'exécution.
Tous les objets
Un index complet de tous les objets disponibles dans l'éditeur d'expériences Labvanced, y compris les éléments d'affichage, d'entrée, de médias et d'enregistrement.