
Polygon
Das Polygon-Objekt ermöglicht es Ihnen, einen benutzerdefinierten polygonförmigen Stimulus auf einem Rahmen zu platzieren, indem Sie im Aufgabeneditor auf die Scheitelpunkte klicken. Einmal gezeichnet, ist das Polygon vollständig bearbeitbar: Sie können bestehende Scheitelpunkte ziehen, Mittelpunkte hinzufügen und Punkte entfernen. Das Aussehen der Füllung und der Umrandung des Polygons ist konfigurierbar, und Sie können die Form an eine Stimulus-Informationsvariable verknüpfen.
Eine häufige Anwendung ist das Eye-Tracking: indem Sie den Umriss eines unregelmäßigen Stimulus mit vielen Scheitelpunkten nachzeichnen, können Sie das Polygon als präzise AOI-Maske im Analyzer verwenden. Dies ist besonders nützlich, wenn die Stimulusform nicht mit einem Rechteck erfasst werden kann und kein SVG verfügbar ist.
Inhaltsverzeichnis
Hinzufügen des Polygon-Zeichnungsobjekts
Öffnen Sie in der Symbolleiste des Aufgabeneditors 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 Zeichnungsmodus beginnt automatisch, sodass Sie sofort mit dem Platzieren der Scheitelpunkte beginnen können.
Zeichnen eines Polygons
Wählen Sie das Polygon-Zeichnungsobjekt aus und aktivieren Sie den Zeichnungsmodus, indem Sie irgendwo auf der Rahmenleinwand klicken, um einen Scheitelpunkt zu platzieren. Jeder Klick fügt einen neuen Punkt zur Kontur des Polygons hinzu.
Um das Polygon zu schließen (den letzten Scheitelpunkt mit dem ersten zu verbinden), klicken Sie auf den runden Griff am ersten Scheitelpunkt. Alternativ können Sie das Closed-Attribut im Eigenschaftenbereich aktivieren, um die Form zu schließen, ohne den Griff anzuklicken.
Um das Hinzufügen von Scheitelpunkten 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, wechselt das Polygon in den Bearbeitungsmodus. Alle bestehenden Scheitelpunktgriffe bleiben auf der Leinwand sichtbar.
- Bewegen eines Scheitelpunkts: Klicken Sie auf einen beliebigen Scheitelpunktgriff und ziehen Sie ihn an eine neue Position. Die Kanten des Polygons aktualisieren sich in Echtzeit.
- Hinzufügen eines Mittelpunkts: Klicken Sie in der Punktetabelle auf das
+-Symbol in einer beliebigen Zeile. Ein neuer Scheitelpunkt wird an dem Mittelpunkt zwischen diesem Punkt und dem nächsten in der Sequenz eingefügt. - Entfernen eines Scheitelpunkts: Klicken Sie in der Punktetabelle auf das
×-Symbol in der Zeile für den Scheitelpunkt, den Sie löschen möchten.
Um das Hinzufügen neuer Scheitelpunkte am Ende der Sequenz wieder aufzunehmen, klicken Sie auf Continue drawing im Eigenschaftenbereich.
Objekteigenschaften
Alle unten genannten Eigenschaften finden Sie im Eigenschaftenbereich, wenn das Polygon-Zeichnungsobjekt ausgewählt ist.
| Eigenschaft | Beschreibung |
|---|---|
Stimulus Info | Ein Textlabel, das mit dem Element verbunden ist. Verwenden Sie dies, um das Polygon mit einer Stimulus-Informationsvariable zur Aufzeichnung oder Identifizierung der Form in exportierten Daten zu verknüpfen. |
Fill color | Ein Kontrollkästchen steuert, ob die Füllung angewendet wird. Wenn es aktiviert ist, wird die Füllfarbe des Innenraums des Polygons mit einem Farbwähler festgelegt. Wenn es deaktiviert ist, ist der Innenraum transparent. |
Stroke color | Die Farbe des Polygonumrisses. Verwenden Sie den Farbwähler, um sie festzulegen. |
Stroke width | Die Breite des Polygonumrisses in Pixeln. Geben Sie eine positive Zahl ein. |
Closed | Wenn aktiviert, wird der letzte Scheitelpunkt mit dem ersten verbunden, wodurch ein geschlossenes Polygon entsteht. Wenn deaktiviert, ist die Form eine offene Polylinie. |
Punktetabelle
Der Points-Abschnitt im Eigenschaftenbereich zeigt eine Tabelle aller aktuellen Scheitelpunkte. Jede Zeile zeigt den Scheitelpunktindex (nr), seine horizontale Position (x), und seine vertikale Position (y) in Rahmenkoordinaten.
Verwenden Sie die Zeilensteuerungen, um:
- Klicken Sie auf
+, um einen neuen Scheitelpunkt am Mittelpunkt zwischen dieser Zeile und der nächsten einzufügen. - Klicken Sie auf das Entfernen-Symbol, um den Scheitelpunkt in dieser Zeile zu löschen.
Sie können auch die Punkte des Polygons programmgesteuert mit einer Datenrahmenvariablen und der Set Object Property-Aktion im Ereignissystem festlegen. Jede Zeile im Datenrahmen entspricht einem Scheitelpunkt, mit Spalten für x- und y-Koordinaten.
Zeichnung löschen
Um alle Scheitelpunkte zu entfernen und das Polygon von Grund auf neu zu beginnen, klicken Sie auf Clear all im Eigenschaftenbereich. Dies setzt die Form auf ein leeres Polygon zurück und betritt automatisch erneut den Zeichnungsmodus.
Verwendung des Polygons als Eye Tracking AOI
Das Polygon-Objekt kann als unsichtbare AOI-Maske für Eye-Tracking dienen. Die typische Konfiguration besteht darin, das Polygon zu zeichnen, indem der Umriss eines unregelmäßigen Stimulus nachgezeichnet wird, und es dann vollständig ungestaltet zu lassen: keine Füllung, keine Umrandung. Das Polygon ist für die Teilnehmer unsichtbar, aber die Grenzen der Scheitelpunkte werden für die Gaze- und Fixations-Hit-Testung verwendet.
Verwenden Sie diesen Ansatz, wenn eine rechteckige AOI für die Stimulusform zu grob ist und kein SVG-Element verfügbar ist. Da Sie so viele Scheitelpunkte platzieren können, wie Sie benötigen, können Sie jede unregelmäßige Kontur genau verfolgen.
Gaze- und Fixationsproben werden gegen das genaue Set der Scheitelpunkte des Polygons getestet und nicht gegen ein Begrenzungsrechteck. Kennzahlen wie Verweildauer und Prozentsatz der Zeit in der AOI werden unter Verwendung der vollständigen Polygongrenze berechnet.
Wenn sich die Form Ihres Polygons pro Bedingung unterscheidet, wird das richtige Scheitelpunkt-Set pro Versuch automatisch mit dem Modifiersystem aufgelöst.
Geben Sie dem Polygon ein klares Stimulus Info-Label, damit es beim Konfigurieren von AOI-Kennzahlen leicht zu identifizieren ist.
Ändern des Polygons zur Laufzeit
Verwenden Sie die Set Object Property-Aktion im Ereignissystem, um das Polygon während eines Experiments zu aktualisieren. Die folgenden Eigenschaften können zur Laufzeit festgelegt werden:
| Eigenschaft | Typ | Was sie tut |
|---|---|---|
stimulusInformation | string | Aktualisiert das Stimuluslabel, das mit dem Polygon verbunden ist. |
fillColor | string | Ändert die Füllfarbe des Polygons. |
strokeColor | string | Ändert die Farbe des Polygonumrisses. |
strokeWidth | number | Ändert die Umrandungsbreite in Pixeln. |
points | array | Ersetzt das vollständige Scheitelpunkt-Set durch ein neues Set von [x, y]-Koordinatenpaaren. |
hasClosed | boolean | Legt fest, ob das Polygon geschlossen (true) oder offen (false) ist. |
Beispiel: Ersetzen Sie die Form des Polygons, wenn ein Versuch beginnt
Trigger:
On Frame Start
Aktion:Set Object Property->Set Target: Ihr Polygon-Objekt -> Eigenschaft:points-> Wert: Ihre Variable, die das neue Koordinatenarray enthält
Weiterführende Literatur
Ereignissystem
Wie Trigger und Aktionen in Labvanced funktionieren. Verwenden Sie Set Object Property, um Polygon-Scheitelpunkte, Füllung, Umrandung und geschlossenen Zustand zur Laufzeit zu aktualisieren.
Objekteigenschaften
Das gemeinsame Eigenschaftenfeld, das alle Objekte erben: Position, Größe, Skalierung, Rotation und Stil. Behandelt die Einstellung "Seitenverhältnis beibehalten" und Kopieren/Einfügen-Controls für Position und Skalierungswerte.
Alle Objekte
Ein gesamter Index aller in Labvanced verfügbaren Objekte im Experimenteditor, einschließlich Anzeige-, Eingabe-, Medien- und Aufzeichnungselementen.