本文へスキップ

イメージ・ターゲット・イベント

タイプ​

ImagePropertiesObject​

ImagePropertiesObjectは以下のプロパティを持つオブジェクトである：

プロパティタイプ概要
幅Number画像ターゲットの幅。
高さNumber画像ターゲットの高さ。
オリジナル幅Numberアップロードされた画像の幅。
元の高さNumberアップロードされた画像の高さ。
回転booleanターゲット画像が回転しているかどうか。

ImageLoadingObject​

ImageLoadingObject`は以下のプロパティを持つオブジェクトである：

プロパティタイプ概要
名称String画像の名前。
タイプStringFLAT、CYLINDRICAL、CONICAL`のいずれか。
メタデータオブジェクトユーザーのメタデータ。

ImageScanningObject​

ImageScanningObject`は以下のプロパティを持つオブジェクトである：

プロパティタイプ説明
名称String画像の名前。
タイプStringFLAT、CYLINDRICAL、CONICAL`のいずれか。
メタデータオブジェクトユーザーのメタデータ。
ジオメトリーオブジェクトジオメトリデータを含むオブジェクトです。 ジオメトリデータを含むオブジェクト。 type=FLAT の場合：{scaledWidth, scaledHeight}, else if type=CYLINDRICAL or type=CONICAL: {height, radiusTop, radiusBottom, arcStartRadians, arcLengthRadians}

イベント​

現実_画像​

このイベントは、イメージターゲットが最初に見つかったときに発行される。

プロパティ​

プロパティタイプ説明
名称String画像の名前。
タイプ文字列FLAT、CYLINDRICAL、CONICALのいずれか。
position{x, y, z}配置された画像の3次元位置。
rotation{w, x, y, z}配置された画像の3次元のローカルの向きです。
scale番号この画像に添付されているオブジェクトに適用されるスケールファクター。
プロパティImagePropertiesObject追加のイメージターゲットプロパティ。
scaledWidth番号**FLAT**にのみ適用されます。 シーン内の画像の幅（scaleを掛けた場合）。
scaledHeight番号**FLAT**にのみ適用されます。 Scaleを掛けたときのシーン内の画像の高さ。
高さ番号**CYLINDRICALまたはCONICAL`**にのみ適用される。 カーブしたターゲットの高さ。
半径トップ番号**CYLINDRICALまたはCONICAL**にのみ適用される。 上部のカーブしたターゲットの半径。
底半径番号**CYLINDRICALまたはCONICAL**にのみ適用される。 下部のカーブしたターゲットの半径。
アーク開始ラジアン番号**CYLINDRICALまたはCONICAL**にのみ適用される。 ラジアン単位の開始角度。
弧長ラジアン番号**CYLINDRICALまたはCONICAL**にのみ適用される。 ラジアン単位の中心角。

例​

defineState('initial-state').initial().listen(world.events.globalId, ecs.events.REALITY_IMAGE_FOUND, (event) => {
  console.log('Image found: ', event.data.name)
})

リアリティ画像ローディング​

このイベントは、検出画像のロードが開始されたときに発行されます。

プロパティ​

プロパティタイプ説明
イメージターゲットArray<ImageLoadingObject>画像ターゲットのリスト。

例​

defineState('initial-state').initial().listen(world.events.globalId, ecs.events.REALITY_IMAGE_LOADING, (event) => {
  event.data.imageTargets.forEach(({name, type, metadata, geometry}) => {
    console.log('Loading: ', name)
  })
})

リアリティ_イメージ_ロスト​

このイベントは、イメージターゲットが追跡されなくなったときに発行される。

プロパティ​

プロパティタイプ説明
名称String画像の名前。
タイプStringFLAT、CYLINDRICAL、CONICALのいずれか。
position{x, y, z}配置された画像の3次元位置。
rotation{w, x, y, z}配置された画像の3次元のローカルの向きです。
scale番号この画像に添付されているオブジェクトに適用されるスケールファクター。
プロパティImagePropertiesObject追加のイメージターゲットプロパティ。
scaledWidth番号**FLAT**にのみ適用されます。 シーン内の画像の幅（scaleを掛けた場合）。
scaledHeight番号**FLAT**にのみ適用されます。 Scaleを掛けたときのシーン内の画像の高さ。
高さ番号**CYLINDRICALまたはCONICAL**にのみ適用される。 カーブしたターゲットの高さ。
半径トップ番号**CYLINDRICALまたはCONICAL**にのみ適用される。 上部のカーブしたターゲットの半径。
底半径番号**CYLINDRICALまたはCONICAL**にのみ適用される。 下部のカーブしたターゲットの半径。
アーク開始ラジアン番号**CYLINDRICALまたはCONICAL**にのみ適用される。 ラジアン単位の開始角度。
弧長ラジアン番号**CYLINDRICALまたはCONICAL**にのみ適用される。 ラジアン単位の中心角。

例​

defineState('initial-state').initial().listen(world.events.globalId, ecs.events.REALITY_IMAGE_LOST, (event) => {
  console.log('Image lost: ', event.data.name)
})

リアリティ・イメージ・スキャニング​

このイベントは、すべての検出画像がロードされ、スキャンが開始されたときに発行される。

プロパティ​

プロパティタイプ説明
イメージターゲットArray<ImageScanningObject>画像ターゲットのリスト。

例​

defineState('initial-state').initial().listen(world.events.globalId, ecs.events.REALITY_IMAGE_SCANNING, (event) => {
  event.data.imageTargets.forEach(({name, type, metadata, geometry}) => {
    console.log('Scanning: ', name)
  })
})

現実_image_updated​

このイベントは、イメージターゲットが位置、回転、スケールを変更したときに発行されます。

プロパティ​

プロパティタイプ説明
名称文字列画像の名前。
タイプ文字列FLAT、CYLINDRICAL、CONICALのいずれか。
位置{x, y, z}配置された画像の3次元位置。
ローテーション{w, x, y, z}配置された画像の3次元の局所的な向き。
スケール番号この画像に添付されているオブジェクトに適用されるスケールファクター。
プロパティImagePropertiesObject追加のイメージターゲットプロパティ。
scaledWidth番号**FLAT**にのみ適用されます。 シーン内の画像の幅（scaleを掛けた場合）。
scaledHeight番号**FLAT**にのみ適用されます。 Scaleを掛けたときのシーン内の画像の高さ。
高さ番号**CYLINDRICALまたはCONICAL**にのみ適用される。 カーブしたターゲットの高さ。
半径トップ番号**CYLINDRICALまたはCONICAL**にのみ適用される。 上部のカーブしたターゲットの半径。
底半径番号**CYLINDRICALまたはCONICAL**にのみ適用される。 下部のカーブしたターゲットの半径。
アーク開始ラジアン番号**CYLINDRICALまたはCONICAL**にのみ適用される。 ラジアン単位の開始角度。
弧長ラジアン番号**CYLINDRICALまたはCONICAL**にのみ適用される。 ラジアン単位の中心角。

例​

defineState('initial-state').initial().listen(world.events.globalId, ecs.events.REALITY_IMAGE_UPDATED, (event) => {
  console.log('Image updated: ', event.data.position, event.data.rotation)
})