XrSpatialAnchor QML Type
実空間の特定の場所や物体を追跡します。詳細...
Import Statement: | import QtQuick3D.Xr |
Since: | Qt 6.8 |
Inherits: | |
Status: | Technical Preview |
プロパティ
- Classification : enumeration
- classification : enumeration
- classificationString : string
- extent2D : vector2d
- extent3D : vector3d
- has2DBounds : bool
- has3DBounds : bool
- identifier : string
- offset2D : vector2d
- offset3D : vector3d
- position : vector3d
- rotation : quaternion
詳細説明
この型は、実空間の特定の場所やオブジェクトを追跡する空間アンカーを表す。アンカーの位置、回転、分類、境界に関する情報を提供する。
空間アンカーはXrSpatialAnchorListModel を通してアクセスされる。
注意: アンカーオブジェクトはシステムから提供されます。QMLで作成することはできません。
このタイプの使用方法については、Qt Quick 3D - XR Spatial Anchors Exampleを参照してください。
プロパティ ドキュメント
Classification : enumeration |
空間アンカーの分類。
Classification列挙型は、空間アンカーの目的やコンテキストを記述する、定義済みのカテゴリータイプのセットを提供します。
定数 | 説明 |
---|---|
Classification.Unknown | ラベルは設定または識別されていません。 |
Classification.Wall | アンカーは壁を表します。 |
Classification.Ceiling | アンカーは天井を表す。 |
Classification.Floor | アンカーは床を表す。 |
Classification.Table | アンカーはテーブルを表す。 |
Classification.Seat | アンカーは座席を表す。 |
Classification.Window | 錨は窓を表す。 |
Classification.Door | アンカーはドアを表す。 |
Classification.Other | アンカーは上記のタイプのいずれにも該当しない。参照:classificationString |
次の表は、Qt Quick 3D Xr、OpenXR、および VisionOS における分類タイプ間のマッピングを示しています。システムからの分類タイプが定義されたタイプから外れる場合、タイプは Other
に設定され、システム・タイプはclassificationString プロパティによって提供されます。
注: 分類文字列は、Other
にすることもできます。
タイプ | OpenXR | VisionOS | 説明 |
---|---|---|---|
不明 | - | - | ラベルが設定または識別されていない。 |
壁 | 壁面 | 壁 | アンカーは壁を表す。 |
天井 | 天井 | 天井 | アンカーは天井を表す。 |
床 | 床 | 床 | アンカーは床を表す。 |
テーブル | テーブル | テーブル | アンカーはテーブルを表す。 |
シート | ソファー | シート | アンカーは座席を表す。 |
窓 | 窓枠 | 窓 | アンカーは窓を表す。 |
ドア | ドア_フレーム | ドア | アンカーはドアを表す。 |
その他 | - | - | アンカーは他の何かを表す。参照:classificationString |
classification : enumeration |
空間アンカーの分類タイプ。
このプロパティは、アンカーの目的またはコンテキストを記述する、このアンカーのclassification type (例えば、Table
またはFloor
)を返す。
注意: システムからの分類タイプは、Classification enumで定義されたラベルのセットに含まれていない可能性があります。その場合、タイプはOther
に設定され、classificationString プロパティには元のラベルが含まれます。
classificationStringも参照のこと 。
classificationString : string |
空間アンカーの分類タイプを文字列として返す。
このプロパティは、分類タイプが存在する場合、文字列として返す。分類タイプがClassification enums で定義されたタイプセットにない場合、ラベルはOther
に設定され、このプロパティを使用してシステムから報告されたタイプにアクセスできます。
注: この文字列は、システムとアンカーがどのように分類されるかに応じて、空または変更される。
classificationも参照のこと 。
extent2D : vector2d |
空間アンカーの 2D 範囲。
このプロパティは、空間アンカーのX/Z平面内の2次元サイズ(幅と高さ)を保持する。has2DBounds がtrue
のときに有効です。
has2DBounds およびoffset2Dも参照のこと 。
extent3D : vector3d |
空間アンカーの3Dエクステント。
このプロパティは、空間アンカーの体積を3次元(幅、高さ、奥行き)で指定する。has3DBounds がtrue
のときに有効です。
offset3D およびhas3DBoundsも参照 。
has2DBounds : bool |
空間アンカーが 2D 境界を持つかどうかを示します。
このプロパティは、空間アンカーがoffset2D およびextent2D で説明される 2D 境界を持つ場合、true
を保持する。これは、空間アンカーが平面(例えば、床や壁)を表すことを示す。
そうでない場合は、false を返します。
offset2D 、extent2D 、およびhas3DBoundsも参照のこと 。
has3DBounds : bool |
空間アンカーに 3D 境界があるかどうかを示します。
このプロパティは、空間アンカーが3D境界を持つ場合、true
を返す。これは、空間アンカーがボリューム(テーブルや食器棚など)を表すことを示す。境界はoffset3D とextent3D で説明される。
そうでない場合は、false
を返します。
offset3D 、extent3D 、およびhas2DBoundsも参照 。
identifier : string |
この空間アンカーの一意の識別子。
このプロパティは、空間アンカーに関連付けられた一意の識別子を保持する。これは、XrSpatialAnchorListModel で参照される識別子と同じである。
offset2D : vector2d |
空間アンカーの 2D オフセット。
このプロパティは、X/Z 平面内でのアンカーの境界のオフセットを保持する。has2DBounds がtrue
のときに有効である。
has2DBounds およびextent2Dも参照 。
offset3D : vector3d |
空間アンカーの3Dオフセット。
このプロパティは、アンカーのposition からのアンカーの境界の3Dオフセット(メートル単位)を提供する。
offset3D およびhas3DBoundsも参照してください 。
position : vector3d |
空間アンカーの位置。
このプロパティは、セッションの座標系内での空間アンカーの原点の3D位置(メートル単位)を返す。
rotation : quaternion |
空間アンカーの向き。
このプロパティは、空間アンカーの回転を(クォータニオンとして)提供します。
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.