多边形

多边形对象允许您通过在任务编辑器中单击定义其顶点来在框架上放置自定义多边形形状的刺激。绘制完成后，多边形是完全可编辑的：您可以拖动现有顶点、添加中点并删除点。多边形的填充和描边外观是可配置的，您可以将形状链接到刺激信息变量。

一个常见的应用是眼动追踪：通过描绘不规则刺激的轮廓（具有许多顶点），您可以将多边形用作分析器中的精确 AOI 蒙版。当刺激形状无法用矩形捕获，并且没有 SVG 可用时，这尤其有用。

添加多边形绘图对象

在任务编辑器工具栏中，打开 Images & Drawing 组并选择 Polygon 以将多边形对象添加到当前框架。

该元素作为空白多边形添加到框架。绘图模式自动开始，因此您可以立即开始放置顶点。

在选择多边形绘图对象并激活绘图模式时，单击框架画布上的任何地方以放置一个顶点。每次单击都将在多边形轮廓上添加一个新点。

要闭合多边形（将最后一个顶点连接回第一个），请单击第一个顶点上的圆形手柄。或者，在属性面板中勾选 Closed 属性以强制形状闭合，无需单击手柄。

要停止添加顶点而不闭合形状，请在属性面板中单击 Stop drawing (ESC)，或按 ESC。多边形保持为开放折线，直到启用 Closed。

停止绘制后，多边形进入编辑模式。所有现有的顶点手柄在画布上保持可见。

要在序列的末尾恢复添加新顶点，请在属性面板中单击 Continue drawing。

选择多边形绘图对象时，所有以下属性都会在属性面板中找到。

属性	描述
`Stimulus Info`	与该元素相关联的文本标签。使用此标签将多边形链接到刺激信息变量，以便在导出数据时进行记录或识别形状。
`Fill color`	一个复选框控制是否应用填充。当选中时，颜色选择器设置多边形内部的填充颜色。当未选中时，内部是透明的。
`Stroke color`	多边形轮廓的颜色。使用颜色选择器进行设置。
`Stroke width`	多边形轮廓的宽度（以像素为单位）。输入一个正数。
`Closed`	当选中时，最后一个顶点连接回第一个，形成一个封闭的多边形。当未选中时，形状是开放的折线。

属性面板中的 Points 部分显示所有当前顶点的表格。每行显示顶点索引 (nr)、其水平位置 (x) 和其垂直位置 (y) 的框架坐标。

使用行控制：

您还可以使用数据框变量和事件系统中的 Set Object Property 操作程序以编程方式设置多边形的点。数据框中的每一行表示一个顶点，列用于 x 和 y 坐标。

要删除所有顶点并从头开始绘制多边形，请在属性面板中单击 Clear all。这会将形状重置为一个空多边形并自动重新进入绘图模式。

多边形对象可以作为眼动追踪的隐形 AOI 蒙版。典型的设置是绘制多边形以跟踪不规则刺激的轮廓，然后保持其完全无样式：无填充，无描边。多边形对参与者是不可见的，但其顶点边界用于注视和凝视命中测试。

在矩形 AOI 对刺激形状过于粗糙且没有 SVG 元素可用时，可以使用此方法。由于您可以根据需要放置任意数量的顶点，因此可以紧密跟随任何不规则轮廓。

注视和凝视样本是针对多边形的确切顶点集进行测试，而不是边界矩形。像停留时间和在 AOI 中的时间百分比这样的指标是使用完整的多边形边界计算的。

如果您的多边形形状随着条件而不同，正确的顶点集会在试验过程中使用修改器系统自动解析。

给多边形一个清晰的 Stimulus Info 标签，以便在配置 AOI 指标时易于识别。

使用事件系统中的 Set Object Property 操作在实验过程中更新多边形。以下属性可以在运行时设置：

示例：在试验开始时替换多边形的形状

触发器： On Frame Start
操作： Set Object Property -> Set Target: 您的多边形对象 -> 属性: points -> 值: 包含新坐标数组的变量

所有对象继承的共享属性面板：位置、大小、比例、旋转和样式。涵盖保持宽高比设置以及位置和比例值的复制/粘贴控制。

了解 Labvanced 中触发器和操作的工作原理。使用设置对象属性在运行时更新多边形顶点、填充、描边和闭合状态。

Labvanced 实验编辑器中所有可用对象的完整索引，包括显示、输入、媒体和录音元素。