ラインオブジェクト
ラインオブジェクトは、キャンバスフレーム上でスタートポイントからエンドポイントまで直線を描き、各端にオプションのヘッドを付けます。サイズに関係なくシャープさを保ち、画像ファイルは不要で、ストローク、ヘッド、エンドポイントは条件ごとに異なるか、実験中にイベントを通じて変更できます。
ツールバーのArrowエントリーは、端に矢印ヘッドを持つ同じオブジェクトを作成します。詳細は矢印オブジェクトを参照してください。閉じたアウトラインについては、長方形および楕円オブジェクトを参照してください。
ラインオブジェクトの追加
タスクエディタのツールバーでImages & Drawingグループを開き、Lineを選択して現在のフレームにラインオブジェクトを追加します。
新しいラインは200の長さで、ヘッド幅は20、ストロークは2の幅の黒、ヘッドはありません。
形状はキャンバスフレームに追加できます。Images & Drawingグループはページフレームやウェブサイトフレームでは提供されていません。
ボックスがラインを定義する方法
ラインはそのボックスの中央を貫通し、スタートポイントからエンドポイントまで走ります。アンカーはスタートポイントに固定されています。このため、ライン用のAnchorセレクタは隠されています。オブジェクトプロパティパネルのボックス値の意味:
| プロパティ | ラインの意味 |
|---|---|
XとY | スタートポイント |
Width | ラインの長さ |
Height | ヘッド幅、ヘッドがラインを横切るのに使用できるスペース |
Rotation | ラインの方向(度) |
フレーム上で、選択されたラインは通常の8つのリサイズハンドルの代わりに各端に1つのハンドルを表示します。いずれかのハンドルをドラッグしてその端を移動させ、他方の端はそのままの位置に留まります。ドラッグされた端はフレーム単位にスナップします。Shiftを押し続けると、方向が15度ステップにスナップします。
Rotationを変更すると、スタートポイントを中心にラインが回転します。これは時計の針や回転ポインターに必要なすべてです。
オブジェクトプロパティ
以下の設定は、ラインが選択されているときにプロパティパネルに表示されます。形状の名前の見出しの下に自分のセクションに表示されます。
ライン設定
| プロパティ | デフォルト | 説明 |
|---|---|---|
Stroke width | 2 | フレーム単位でのラインの幅。0はラインを描きません。 |
Stroke color | 黒 | ラインとヘッドの色。 |
Fill | オフ | チェックボックスとカラーピッカー。アウトラインのヘッドの内側のみを色付けします(Triangle (outline)およびCircle (outline))。 |
Hit margin | 10 | ヒットエリアの周囲の追加バンド、フレーム単位で。ヒットエリアとヒットマージンを参照してください。 |
Start head | None | スタートポイントのヘッド。ラインヘッズを参照してください。 |
End head | None | エンドポイントのヘッド。 |
Swap heads | スタートヘッドとエンドヘッドを交換するボタン。 | |
Head length | 1 | ヘッドの長さ、ラインのHeight(× Height)の倍数。各ヘッドは最大でラインの半分を占めます。 |
Endpoints | Start X、Start Y、End XおよびEnd Y。エンドポイントを参照してください。 |
他のオブジェクトプロパティと同様に、各設定はトライアルタイプごとに異なる場合があり、デフォルトから異なる値はダークグレーの背景で表示されます。
スタイル
Visibilityは他のオブジェクトと同様に機能します。一般的なScaling、Border-Size、Border-Color、BG-Color、Transparent、Roundness、Overflow-X、Overflow-YおよびScroll Marginの設定は形状に対して非表示です。代わりにStroke color、Fillを使用します。ラインは常にスタートポイントに固定されているため、Anchorセレクタも非表示です。
カスタムCSS
Change CSS Propertiesオプションは他のオブジェクトと同様に機能します。オブジェクトプロパティを参照してください。
ラインヘッズ
Start headおよびEnd headはアイコンピッカーです。選択されたスタイルの名前がアイコンの下に表示されます。
| スタイル | 描画内容 |
|---|---|
None | ヘッドなし。 |
Open arrow | ラインの色の2つの腕で形成されたオープン矢印。 |
Filled arrow | ラインの色で塗りつぶされた三角形。 |
Triangle (outline) | アウトラインとして描かれた三角形、FillがオンになっているとFillで塗りつぶされます。 |
Circle | ラインの色で塗られた円。 |
Circle (outline) | アウトラインとして描かれた円、FillがオンになっているとFillで塗りつぶされます。 |
Square | ラインの色で塗りつぶされた四角形。 |
Bar | ラインの端にあるバー。 |
Diamond | ラインの色で塗りつぶされた菱形。 |
Head lengthはヘッドの長さをHeightの倍数として設定します。2つのヘッドは決して重なりません:各ヘッドは最大でラインの半分を占めます。
エンドポイント
Endpointsセクションは、フレーム座標でStart X、Start Y、End XおよびEnd Yを表示します。エンドポイントはボックス値から導出され、別々には保存されません。値は2桁に丸められます。
- 新しいエンドポイントを入力すると、スタートポイントは保持され、
WidthおよびRotationが変更されます。 - 新しいスタートポイントを入力すると、エンドポイントは保持され、
X、Y、WidthおよびRotationが変更されます。
ヒットエリアとヒットマージン
ラインのヒットエリアは、ラインおよびそのヘッドのストロークバンドです。細いラインはヒットしにくいため、ラインはHit marginの10から始まります。マージンはすべての側に指定されたフレーム単位数でヒットエリアを広げ、参加者には見えません。正確なラインのために0に設定します。
同じ領域がプレーヤーのマウストリガーに使用され、ターゲットオブジェクトに制限されたEyetracking GazeおよびEyetracking Fixationトリガーに使用されます。
イベント統合
ラインは一般的なオブジェクトトリガーのターゲットになることができます。一般的な例:
Mouse:オブジェクト上でのClick、PressDown、PressUp、Hover、LeaveまたはMoveに反応します。それはそのヒットエリアに対して測定されます。Eyetracking GazeおよびEyetracking Fixation:注視またはフィキュレーションがそのヒットエリアに当たった際に反応するターゲットとしてラインに制限します。アイトラッキングフィキュレーショントリガーおよびアイトラッキングガゼトリガーページを参照してください。
実験が実行中にラインを変更するには、オブジェクトプロパティアクションを設定を使用します。プロパティはそのパネル名とともにリストされます:Stroke color、Stroke width、Fill、Fill color、Hit margin、Start head、End head、Head length、Start X、Start Y、End XおよびEnd Y。ボックス値(X、Y、Width、Height、RotationおよびVisibility)はすべてのオブジェクトと同様に使用可能です。同じプロパティはSet / Record Variableを使って変数に読み込むことができ、Object Propertyを値ソースとして使用します。
Start headおよびEnd headは、ヘッドスタイルを短いIDとして取得します。例えばopenArrow、filledArrow、triangle、circle、circleOutline、square、bar、diamondまたはnoneを使用します。ピッカーに表示される名前ではなくIDを使用してください。
例:ボタンがクリックされたときにポインターを回転させる
トリガー:
Mouse→Set Target:あなたのボタン →Click
アクション:Set Object Property→Set Target:あなたのライン →Rotation→ 新しい角度(度)
例:ラインの端を新しい位置に移動する
トリガー:
On Frame Start
アクション1:Set Object Property→Set Target:あなたのライン →End X→ 値または変数
アクション2:Set Object Property→Set Target:あなたのライン →End Y→ 値または変数