画像オブジェクト

画像オブジェクトは Labvanced で最も一般的に使用されるオブジェクトの一つであり、研究者が実験中に参加者に静止画像や写真を提示することを可能にします。これは、物体、風景、顔などの刺激を表示するために、認知、社会、行動研究において一般的に使用されます。 画像オブジェクトは非常に柔軟であり、実験デザインに合わせてさまざまなプロパティや設定でカスタマイズできます。研究者は、画像のサイズ、位置、回転、透明度などの要素を制御し、正確な刺激提示を保証できます。さらに、画像オブジェクトはイベントを通じて動的に操作でき、高度な論理的相互作用を実現します。

実験デザインにおける画像オブジェクト

画像オブジェクトを扱うには、実験デザイン中にどのように扱うかを知っておくことが重要です。以下では、このオブジェクトを介してどのように画像を追加するか、またカスタマイズやデータフレームやイベントのようなより動的なアプローチでどのように制御するかについていくつかのオプションを説明します。 Labvanced では、実験内での画像オブジェクトの提示と動作を制御するための複数の方法を提供しています。これらは以下を使用して行えます：

• オブジェクトプロパティパネル
• タスクウィザード
• トライアルシステム
• イベント
• ランダム化

上記のトピックに入る前に、編集者に画像を追加する方法について説明します。

画像オブジェクトを追加する

実験に画像オブジェクトを統合するには、オブジェクトメニューに移動し、画像オブジェクトを選択します。

画像オブジェクト用オブジェクトプロパティパネル

オブジェクトプロパティパネルは、編集モード中に画面の右側に位置し、画像オブジェクトのすべてのプロパティを編集するためのいくつかのオプションを提供します。 以下の画像に示されているように、画像の設定を数回のクリックで制御できる右側のパネルにいくつかのオプションがあります。この画像は「ターゲット画像」と呼ばれるように名前を変更しました。

これらのオプションについての完全な説明は、このページの下部のセクション を参照してください。すべてのプロパティが表形式でリストされています。

このパネルを使用してデフォルトプロパティを設定し、次にイベントを使用して動的に新しい値に更新するのが一般的です。たとえば、イベントを使用し、画像クリック（トリガー）時に画像を右に5ユニットシフトすることを指定できます。

画像オブジェクトを追加するためのタスクウィザード

スプレッドシートや CSV データを使用して実験的タスクを設定したい場合は、タスクウィザードを使用して画像刺激を追加できます。

以下の例では、列 B および C は画像刺激を表しており、Labvanced のタスクウィザードを利用することで自動的に画像オブジェクトに追加されます。

以下の例では、列 B および C は画像刺激を表しており、Labvanced のタスクウィザードを利用することで自動的に画像オブジェクトに追加されます。

このウィザードを使用すると、刺激、イベント、変数、要因、条件、ランダム化、データ記録を含む実験タスクの全体的な構造を単一の CSV ファイルと刺激ファイルから作成できます。

トライアルシステムと画像オブジェクト

画像オブジェクトがフレームに追加されると、トライアルシステムを集合的に使用して、実験仮説に基づいて異なるトライアル（タスクのユニークな繰り返し）を作成できます。

例えば、感情を研究しており、トライアルを感情タイプに基づいてカテゴリ分けし、デザインしたいとします。ポジティブな感情の刺激がある画像オブジェクトと、ネガティブな感情の刺激がある別の画像オブジェクトをフレームに追加できます。そして、その後、‘感情’という名前の要因を2つのレベル（‘ポジティブ’および‘ネガティブ’）で追加し、関連する条件の下で画像刺激をアップロードできます。

📌 実践例：特定のレベルとオブジェクトへの刺激のアップロード： 以下のビデオでは、関連する条件に画像刺激をアップロードすることで実験デザインを展開します。

詳細については、トライアルシステム のドキュメントをご覧ください。

イベントシステムと画像オブジェクト

イベントシステムは、以下のように、画像の動作を制御したり、オブジェクトの特定のプロパティを記録したり、データフレームを介して画像刺激を提示したりする動的な方法です。

これらのポイントについて、詳しく説明します。

画像の動作を制御する

画像のどんな動作や外観もイベントを使用して変更できます。

以下の例では、「ターゲット画像」という画像オブジェクトの上でマウスクリック（トリガー）を設定し、ターゲット画像の x 座標（プロパティ）が +5 ずつ増加することを指定します。これは、各クリック時に x 座標が +5 増加し、画像が右にシフトすることを意味します。

画像オブジェクトからのデータと記録

画像オブジェクトに関連する値を記録するには、Set/Record Variable アクションを使用し、記録したいデータを指定します。

ファイル名の記録

場合によっては、実験中にトライアルに提示された画像の正確な名前を記録したいことがあります。それは絶対に可能で、簡単に設定できます！

以下の例では、正しい画像と間違った画像の画像名を保存します。2つの変数―「正しい画像名」と「間違った画像名」―があり、どちらも文字列形式のデータを保持します。

オブジェクトを指すには、単に鉛筆アイコンをクリックし、「フレーム / タスク / オブジェクト」カテゴリを選択し、「オブジェクトプロパティ」を選択します。最初のフィールドではターゲットオブジェクトを選択し、2番目のフィールドでは「ファイル名」を選択します。同様に、「間違った画像名」変数についても、間違った画像オブジェクトをリンクすることで刺激のファイル名を指します。

結果として、上記の内容により、各トライアルの特定の画像ファイル名が下の画像のようにリストされます。

上記の例は、あなたがアカウントにインポートできるブーバ・キキ効果についてのサンプル研究からのものです。

ランダム化と画像オブジェクト

ランダム化は画像提示に関連するもう一つの重要なトピックです。この文脈においてランダム化については多くの方法がありますが、ランダム化は特に現在の実験に依存します。

画像オブジェクトに関しては、ランダム化は通常、ターゲット画像の位置を変更するか、一連の中からランダムな画像を選択することを含みます。

Labvanced におけるランダム化とバランスについての詳細については、このページを参照してください。

研究スポットライト：実際に使用される画像オブジェクト

画像オブジェクトは実験研究において重要な役割を果たし、特に視覚的知覚、記憶、および注意に関する研究において重要です。Labvanced はさまざまな分野の研究者が Labvanced の画像オブジェクトを使用して研究を行うことを可能にしています。

視覚注意のダイナミクス：眼球追跡研究

この研究（Calignano et al., 2024）は、語彙や物体の意味がどのように私たちの視覚的焦点の方向やそれをどのように指し示すかに影響を与えるかを探究しました。実際の単語や慣れ親しんだ物体が、擬似単語や擬似物体よりも効果的に注意の関与と目標の検出をバイアスするだろうという仮説が立てられました。

参加者には、プライム（後のターゲットへの注意や知覚に影響を与える可能性のある初期の手がかり）が提示されました。研究者たちは、Labvanced を使用して、2つのウェブベースの眼球追跡実験を実施しました：

• 実験 1: 参加者には手がかりとして単語（実際の単語または擬似単語）が提示されました
• 実験 2: 実体的な物体または擬似物体の画像を手がかりとして提示しました。

言葉（実験1）と画像（実験2）を用いた実験パラダイム； Calignano et al. (2024).

プライムの視聴後、ターゲットを探すために見つけるべき場所を示す空間的手がかり（有効または無効）が表示されました。有効な空間的手がかりは、ターゲットと同じ場所に現れ、無効な手がかりはターゲットとは異なる場所に現れます。参加者はターゲットを特定し、ターゲットを見つけたときにキーを押すことで応答しなければなりませんでした。

収集されたデータには、ターゲット検出の反応時間（ミリ秒）、タスクパフォーマンスの正確性、および注意分析のための眼球追跡データが含まれました。

結果は、単語や認識された物体が、タスクとの関連がない場合でも、トップダウンプロセスを通じてターゲット検出を強化できることを示しました。

画像オブジェクトプロパティテーブル

Labvanced の任意のオブジェクトと同様に、オブジェクトを扱うときに右側のパネルに表示される一般的だがオブジェクト固有のプロパティがあります。以下は、画像オブジェクトオプションに関連する仕様と説明です：

画像オブジェクトの主なプロパティ

プロパティ名	データ型	修正可能、方法	フレームタイプ	説明
Name	文字列	はい、テキストボックス	キャンバス & ページ	オブジェクトの名前。名前はオブジェクトへの参照として多くの回数使用されるため（つまり、イベント内で）、ユニークである必要があります。
Visibility	数値 (0-1)	はい、チェックボックス	キャンバス	オブジェクトの透明度の値。値が 0 の場合、オブジェクトは完全に不可視になります。値が 1 の場合、完全に可視です。
Active	ブール (true / false)	はい、チェックボックス	キャンバス & ページ	オブジェクトがアクティブであり、実験実行中に変更できるかどうかを決定します。false に設定された場合、オブジェクトは何のアクションも引き起こしません。

画像オブジェクトの位置とサイズプロパティ

プロパティ名	データ型	修正可能、方法	フレームタイプ	説明
X	数値 (0-フレームの幅)	はい、テキストまたは矢印	キャンバス	オブジェクトの X 位置。
Y	数値 (0-フレームの高さ)	はい、テキストまたは矢印	キャンバス	オブジェクトの Y 位置。
Width	数値 (0-フレームの幅)	はい、テキストまたは矢印	キャンバス	オブジェクトの幅。
Height	数値 (0-フレームの高さ)	はい、テキストまたは矢印	キャンバス	オブジェクトの高さ。
Anchor	カテゴリカル (1-9)	はい、選択オプション	キャンバス	アンカーはオブジェクトの「位置参照点」を設定します。デフォルトでは、これは左上隅です。

画像オブジェクトのスケールと回転プロパティ

プロパティ名	データ型	修正可能、方法	フレームタイプ	説明
Scaling	数値 (0-Inf)	はい、テキストまたは矢印	キャンバス	要素のスケール/ズームを変更します。大きな値は要素をズームインします。
Rotation	数値 (0-359)	はい、テキストまたは矢印	キャンバス	オブジェクトの回転を変更します。0はデフォルトの直立位置です。
Keep aspect ratio	ブール (true / false)	はい、チェックボックス	キャンバス	オブジェクトが再スケールされたときに、そのアスペクト比が保持されるかどうかを決定します。

画像オブジェクトのスタイル

プロパティ名	データ型	修正可能、方法	フレームタイプ	説明
Border-Size	数値 (0-INF)	はい、テキストまたは矢印	キャンバス	オブジェクトのボーダーサイズを変更します。0はボーダーがないことを示します。
Border-Color	16進文字列 (色)	はい、選択オプション	キャンバス	オブジェクトのボーダーの色を変更します。
Background (BG)-Color	16進文字列 (色)	はい、選択オプション	キャンバス	オブジェクトの背景色を変更します。デフォルトでは色がなく透明です。
Roundness	数値 (0-1)	はい、テキストまたは矢印	キャンバス	オブジェクトの丸みを変更します。1 は完全に丸いオブジェクト、0 は完全に角ばったオブジェクトです。
Overflow-X	カテゴリカル (隠す、自動、表示)	はい、選択オプション	キャンバス	オブジェクトが X 次元において可視スクロールバーを持つかどうかを決定します。
Overflow-Y	カテゴリカル (隠す、自動、表示)	はい、選択オプション	キャンバス	オブジェクトが Y 次元において可視スクロールバーを持つかどうかを決定します。
Scroll Margin	数値	はい、テキストまたは矢印	キャンバス	スクロールバーの余白をパーセントで決定します。
Change CSS Properties	CSS コード	はい、チェックボックスとテキストボックス	キャンバス	CSS コードを使用してオブジェクトの外観の一部を変更します。

プレイヤーにおけるマウスの相互作用

プロパティ名	データ型	修正可能、方法	フレームタイプ	説明
Selectable	ブール (true / false)	はい、チェックボックス	キャンバス	実験実行中にオブジェクトを選択/ハイライトできるかどうかを決定します。
Highlight on Select	ブール (true / false)	はい、チェックボックス	キャンバス	選択されたオブジェクトが視覚的に選択されていることを示すかどうかを決定します（例：ボーダーで）。
Draggable	ブール (true / false)	はい、チェックボックス	キャンバス	実験実行中にオブジェクトをドラッグ可能かどうかを決定します。
Resizable	ブール (true / false)	はい、チェックボックス	キャンバス	実験実行中にオブジェクトを再スケール可能かどうかを決定します。
Track Scroll	ブール (true / false)	はい、チェックボックスと数値（有効化された場合：ScrollPositionX, ScrollPositionY）	キャンバス	スクロールバーがあるオブジェクトのスクロールをトラッキングできるようにします。

画像プロパティ

プロパティ名	データ型	修正可能、方法	説明
Filename	文字列	はい、テキストボックス	ファイルの指定された名前。
Select File (Folder Icon)	機能	はい、アイコンをクリック	フォルダーアイコンをクリックすると、ファイルマネージャーが開き、既存のファイルを選択したり、新しいファイルをアップロードして選択することができます。
Stimulus Info	文字列	はい、テキストボックス	実験実行中に動的な刺激情報を保存するために使用できる修正可能なプロパティ。
Stretch to Fit Bounding Box	ブール (true / false)	はい、チェックボックス	有効化されると、画像が境界ボックスを完全に埋めるように引き伸ばされます。
Bounding Box Fit	機能	はい、アイコンをクリック	「フィット」をクリックすると、境界ボックスが画像の寸法にクロップされます。
Auto Fit Bounding Box with Image	機能	はい、チェックボックス	有効化されると、境界ボックスが画像に合わせて自動的に変更されます。