
多边形
多边形对象允许您通过单击在任务编辑器中定义其顶点来在框架上放置自定义多边形形状的刺激。一旦绘制完成,多边形是完全可编辑的:您可以拖动现有顶点,添加中点,并移除点。多边形的填充和边框外观是可配置的,您可以将形状链接到刺激信息变量。
一个常见的应用是眼动追踪:通过描绘一个不规则刺激的轮廓,您可以将多边形作为 Analyzer 中的精确 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 蒙版。典型的设置是绘制多边形,描绘不规则刺激的轮廓,然后完全不样式化:无填充,无边框。多边形对参与者是不可见的,但其顶点边界用于注视和凝视检测。
当矩形 AOI 对于刺激形状来说过于粗糙且没有 SVG 元素可用时,请使用这种方法。因为您可以根据需要放置任意多的顶点,所以您可以紧密跟随任何不规则轮廓。
凝视和凝视样本是针对多边形的精确顶点集进行检测的,而不是针对边界矩形。诸如停留时间和在 AOI 中的时间百分比等指标使用完整的多边形边界进行计算。
如果您的多边形形状在每个条件下有所不同,则通过修饰符系统自动解决每个试验的正确顶点集。
给多边形一个清晰的 Stimulus Info 标签,以便在配置 AOI 指标时易于识别。
在运行时修改多边形
使用事件系统中的 Set Object Property 动作在实验中更新多边形。可以在运行时设置以下属性:
| 属性 | 类型 | 功能 |
|---|---|---|
stimulusInformation | 字符串 | 更新与多边形关联的刺激标签。 |
fillColor | 字符串 | 更改多边形的填充颜色。 |
strokeColor | 字符串 | 更改多边形的轮廓颜色。 |
strokeWidth | 数字 | 更改轮廓宽度,单位为像素。 |
points | 数组 | 用新的 [x, y] 坐标对替换整个顶点集。 |
hasClosed | 布尔值 | 设置多边形是闭合 (true) 还是开放 (false)。 |
示例:在试验开始时替换多边形的形状
触发器:
On Frame Start
动作:Set Object Property->Set Target: 您的多边形对象 -> 属性:points-> 值:包含新坐标数组的变量