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