多边形

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

一个常见的应用是眼动追踪：通过勾勒出具有多个顶点的不规则刺激的轮廓，您可以将多边形用作分析器中的精确 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 实验编辑器中所有可用对象的完整索引，包括显示、输入、媒体和录制元素。