Polygon
Das Polygon-Objekt erlaubt es Ihnen, einen benutzerdefinierten polygonförmigen Stimulus auf einem Rahmen zu platzieren, indem Sie im Task-Editor auf die Eckpunkte klicken. Nachdem das Polygon gezeichnet wurde, ist es vollständig bearbeitbar: Sie können vorhandene Eckpunkte ziehen, Zwischenpunkte hinzufügen und Punkte entfernen. Das Aussehen des Füllbereichs und der Kontur des Polygons ist konfigurierbar, und Sie können die Form mit einer Stimulus-Informationsvariablen verknüpfen.
Eine häufige Anwendung ist das Eyetracking: Durch das Nachzeichnen der Kontur eines unregelmäßigen Stimulus mit vielen Eckpunkten können Sie das Polygon als präzise AOI-Maske im Analyzer verwenden. Dies ist besonders nützlich, wenn die Form des Stimulus nicht mit einem Rechteck erfasst werden kann und kein SVG verfügbar ist.
Inhaltsverzeichnis
Hinzufügen des Polygon-Zeichenobjekts
Öffnen Sie in der Task-Editor-Werkzeugleiste die Images & Drawing-Gruppe und wählen Sie Polygon aus, um ein Polygon-Objekt zum aktuellen Rahmen hinzuzufügen.
Das Element wird als leeres Polygon zum Rahmen hinzugefügt. Der Zeichenmodus startet automatisch, sodass Sie sofort mit dem Platzieren der Eckpunkte beginnen können.
Zeichnen eines Polygons
Mit dem ausgewählten Polygon-Zeichenobjekt und aktivem Zeichenmodus klicken Sie irgendwo auf die Rahmen-Leinwand, um einen Eckpunkt zu platzieren. Jeder Klick fügt der Polygonkontur einen neuen Punkt hinzu.
Um das Polygon zu schließen (den letzten Eckpunkt zum ersten zurück zu verbinden), klicken Sie auf den kreisförmigen Griff am ersten Eckpunkt. Alternativ aktivieren Sie die Closed-Eigenschaft im Eigenschaftenbereich, um die Form ohne Klicken auf den Griff zu schließen.
Um das Hinzufügen von Eckpunkten zu stoppen, ohne die Form zu schließen, klicken Sie auf Stop drawing (ESC) im Eigenschaftenbereich oder drücken Sie ESC. Das Polygon bleibt als offene Polylinie, bis Closed aktiviert ist.
Ändern eines bestehenden Polygons
Nachdem Sie das Zeichnen gestoppt haben, geht das Polygon in den Bearbeitungsmodus. Alle vorhandenen Eckpunktgriffe bleiben auf der Leinwand sichtbar.
- Einen Eckpunkt bewegen: Klicken und ziehen Sie einen beliebigen Eckpunktgriff an eine neue Position. Die Polygonkanten werden in Echtzeit aktualisiert.
- Einen Zwischenpunkt hinzufügen: Klicken Sie in der Punkte Tabelle auf das
+-Symbol in einer beliebigen Zeile. Ein neuer Eckpunkt wird an der Mitte zwischen diesem Punkt und dem nächsten in der Sequenz eingefügt. - Einen Eckpunkt entfernen: Klicken Sie in der Punkte Tabelle auf das
×-Symbol in der Zeile für den Eckpunkt, den Sie löschen möchten.
Um das Hinzufügen neuer Eckpunkte am Ende der Sequenz fortzusetzen, klicken Sie auf Continue drawing im Eigenschaftenbereich.
Objekt Eigenschaften
Alle unten aufgeführten Eigenschaften finden Sie im Eigenschaftenbereich, wenn das Polygon-Zeichenobjekt ausgewählt ist.
| Eigenschaft | Beschreibung |
|---|---|
Stimulus Info | Ein Textlabel, das mit dem Element verknüpft ist. Verwenden Sie dies, um das Polygon mit einer Stimulus-Informationsvariablen zu verknüpfen, um die Form in exportierten Daten zu erfassen oder zu identifizieren. |
Fill color | Eine Checkbox, die steuert, ob eine Füllung angewendet wird. Wenn aktiviert, stellt ein Farbpicker die Füllfarbe des Innenraums des Polygons ein. Wenn deaktiviert, ist der Innenraum transparent. |
Stroke color | Die Farbe der Polygonkontur. Verwenden Sie den Farbpicker, um sie einzustellen. |
Stroke width | Die Breite der Polygonkontur in Pixel. Geben Sie eine positive Zahl ein. |
Closed | Wenn aktiviert, wird der letzte Eckpunkt mit dem ersten verbunden, wodurch ein geschlossenes Polygon entsteht. Wenn deaktiviert, ist die Form eine offene Polylinie. |
Punkte Tabelle
Der Points-Abschnitt im Eigenschaftenbereich zeigt eine Tabelle aller aktuellen Eckpunkte. Jede Zeile zeigt den Eckpunktindex (nr), seine horizontale Position (x), und seine vertikale Position (y) in Rahmenkoordinaten.
Verwenden Sie die Zeilensteuerungen, um:
- Auf
+zu klicken, um einen neuen Eckpunkt in der Mitte zwischen dieser Zeile und der nächsten einzufügen. - Auf das Entfernen-Symbol zu klicken, um den Eckpunkt in dieser Zeile zu löschen.
Sie können auch die Punkte des Polygons programmatisch mithilfe einer Datenrahmenvariable und der Set Object Property-Aktion im Ereignissystem festlegen. Jede Zeile im Datenrahmen repräsentiert einen Eckpunkt, mit Spalten für x- und y-Koordinaten.
Das Zeichnen löschen
Um alle Eckpunkte zu entfernen und das Polygon von Grund auf neu zu starten, klicken Sie auf Clear all im Eigenschaftenbereich. Dadurch wird die Form auf ein leeres Polygon zurückgesetzt und der Zeichenmodus automatisch erneut aktiviert.
Das Polygon als Eyetracking-AOI verwenden
Das Polygon-Objekt kann als unsichtbare AOI-Maske für Eyetracking dienen. Die typische Einrichtung besteht darin, das Polygon so zu zeichnen, dass die Kontur eines unregelmäßigen Stimulus nachgezeichnet wird, und es dann vollständig ohne Stil zu belassen: keine Füllung, keine Kontur. Das Polygon ist für die Teilnehmer unsichtbar, aber die Eckpunktgrenze wird für die Blick- und Fixations-Hit-Tests verwendet.
Verwenden Sie diesen Ansatz, wenn eine rechteckige AOI für die Stimulus-Form zu grob ist und kein SVG-Element verfügbar ist. Da Sie so viele Eckpunkte setzen können, wie Sie benötigen, können Sie jeder unregelmäßigen Kontur genau folgen.
Blick- und Fixationsproben werden gegen den genauen Eckpunktsatz des Polygons getestet und nicht gegen ein umschließendes Rechteck. Metriken wie Verweildauer und prozentuale Zeit in der AOI werden unter Verwendung der vollständigen Polygongrenze berechnet.
Wenn Ihre Polygonform je nach Bedingung unterschiedlich ist, wird der richtige Eckpunktsatz automatisch pro Versuch unter Verwendung des Modifiersystems ermittelt.
Geben Sie dem Polygon ein klares Stimulus Info-Label, damit es bei der Konfiguration von AOI-Metriken leicht zu identifizieren ist.
Das Polygon zur Laufzeit ändern
Verwenden Sie die Set Object Property-Aktion im Ereignissystem, um das Polygon während eines Experiments zu aktualisieren. Folgende Eigenschaften können zur Laufzeit gesetzt werden:
| Eigenschaft | Typ | Was sie tut |
|---|---|---|
stimulusInformation | string | Aktualisiert das Stimuluslabel, das mit dem Polygon verknüpft ist. |
fillColor | string | Ändert die Füllfarbe des Polygons. |
strokeColor | string | Ändert die Konturfarbe des Polygons. |
strokeWidth | number | Ändert die Konturbreite in Pixel. |
points | array | Ersetzt den vollständigen Eckpunktsatz durch einen neuen Satz von [x, y]-Koordinaten. |
hasClosed | boolean | Legt fest, ob das Polygon geschlossen (true) oder offen (false) ist. |
Beispiel: Ersetzen Sie die Form des Polygons, wenn ein Versuch beginnt
Auslöser:
On Frame Start
Aktion:Set Object Property->Set Target: Ihr Polygon-Objekt -> Eigenschaft:points-> Wert: Ihre Variable mit dem neuen Koordinatenarray
Weiterführende Literatur
Objekt Eigenschaften
Das gemeinsame Eigenschaftenpanel, das alle Objekte erben: Position, Größe, Skalierung, Rotation und Stil. Behandelt die Einstellung "Seitenverhältnis beibehalten" und die Kopieren/Einfügen-Steuerungen für Position- und Skalierungswerte.
Ereignissystem
Wie Trigger und Aktionen in Labvanced funktionieren. Verwenden Sie Set Object Property, um Polygon-Eckpunkte, Füllung, Kontur und den geschlossenen Zustand zur Laufzeit zu aktualisieren.
Alle Objekte
Ein vollständiges Verzeichnis aller in dem Labvanced-Experiment-Editor verfügbaren Objekte, einschließlich Anzeige-, Eingabe-, Medien- und Aufnahme-Elementen.