ポリゴン
ポリゴンオブジェクトを使うと、タスクエディタでクリックして頂点を定義することで、カスタムのポリゴン形状の刺激をフレームに配置できます。一度描画すると、ポリゴンは完全に編集可能です：既存の頂点をドラッグしたり、中点を追加したり、ポイントを削除したりできます。ポリゴンの塗りつぶしとストロークの外観は設定可能で、形状を刺激情報変数にリンクすることができます。
一般的な用途は目の追跡です：多くの頂点を持つ不規則な刺激の輪郭をトレースすることで、ポリゴンをアナライザーでの精密な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アクションを使用してプログラム的にポリゴンのポイントを設定することもできます。データフレームの各行は1つの頂点を表し、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-> 値: 新しい座標配列を含むあなたの変数