XrSpatialAnchor QML Type
Verfolgt einen bestimmten Ort oder ein Objekt im realen Raum. Mehr...
| Import Statement: | import QtQuick3D.Xr |
| Since: | Qt 6.8 |
| Inherits: | |
| Status: | Technical Preview |
Eigenschaften
- Classification : enumeration
- classification : enumeration
- classificationString : string
- extent2D : vector2d
- extent3D : vector3d
- has2DBounds : bool
- has3DBounds : bool
- identifier : string
- offset2D : vector2d
- offset3D : vector3d
- position : vector3d
- rotation : quaternion
Detaillierte Beschreibung
Dieser Typ stellt einen räumlichen Anker dar, der einen bestimmten Ort oder ein Objekt im realen Raum verfolgt. Er liefert Informationen über die Position, die Drehung, die Klassifizierung und die Grenzen des Ankers.
Auf räumliche Anker wird über eine XrSpatialAnchorListModel zugegriffen.
Hinweis: Ankerobjekte werden vom System bereitgestellt. Sie können nicht in QML erstellt werden.
Siehe das Qt Quick 3D - XR Spatial Anchors Example für die Verwendung dieses Typs.
Eigenschaft Dokumentation
Classification : enumeration |
Die Klassifizierung des räumlichen Ankers.
Die Aufzählung Classification bietet eine Reihe von vordefinierten Kategorietypen, die den Zweck oder Kontext eines räumlichen Ankers beschreiben.
| Konstante | Beschreibung |
|---|---|
Classification.Unknown | Die Beschriftung wurde nicht festgelegt oder identifiziert. |
Classification.Wall | Der Anker stellt eine Wand dar. |
Classification.Ceiling | Der Anker stellt eine Decke dar. |
Classification.Floor | Der Anker stellt einen Boden dar. |
Classification.Table | Der Anker stellt einen Tisch dar. |
Classification.Seat | Der Anker stellt einen Sitz dar. |
Classification.Window | Der Anker stellt ein Fenster dar. |
Classification.Door | Der Anker stellt eine Tür dar. |
Classification.Other | Der Anker wurde nicht als einer der oben genannten Typen identifiziert. Siehe: classificationString |
Die folgende Tabelle zeigt das Mapping zwischen dem Klassifizierungstyp in Qt Quick 3D Xr, OpenXR und VisionOS. Wenn der Klassifizierungstyp aus dem System außerhalb der definierten Typen liegt, wird der Typ auf Other gesetzt, und der Systemtyp wird durch die Eigenschaft classificationString bereitgestellt.
Hinweis: Die Klassifizierungszeichenfolge kann auch Other sein.
| Typ | OpenXR | VisionOS | Beschreibung |
|---|---|---|---|
| Unbekannt | - | - | Das Etikett wurde nicht gesetzt oder identifiziert. |
| Wand | WALL_FACE | Wand | Der Anker stellt eine Wand dar. |
| Decke | DECKEN | Decke | Der Anker stellt eine Decke dar. |
| Boden | FLOOR | Fußboden | Der Anker stellt einen Fußboden dar. |
| Tisch | TISCH | Tisch | Der Anker stellt einen Tisch dar. |
| Sitzplatz | COUCH | Sitz | Der Anker stellt einen Sitz dar. |
| Fenster | FENSTER_RAHMEN | Fenster | Der Anker stellt ein Fenster dar. |
| Tür | TÜR_RAHMEN | Tür | Der Anker stellt eine Tür dar. |
| Andere | - | - | Der Anker steht für etwas anderes. Siehe: classificationString |
classification : enumeration |
Die Klassifizierungsart des räumlichen Ankers.
Diese Eigenschaft gibt die classification type für diesen Anker zurück (z. B.Table oder Floor), die den Zweck oder Kontext des Ankers beschreibt.
Hinweis: Die Klassifizierungsart, die vom System kommt, gehört möglicherweise nicht zu den Bezeichnungen, die durch das Classification enum definiert sind. In diesem Fall wird die Art auf Other gesetzt und die Eigenschaft classificationString enthält die ursprüngliche Bezeichnung.
Siehe auch classificationString.
classificationString : string |
Die Klassifizierungsart des räumlichen Ankers als String.
Diese Eigenschaft gibt die Klassifizierungsart als String zurück, wenn sie existiert. Wenn die Klassifizierungsart nicht in der Menge der durch die Classification enums definierten Arten enthalten ist, wird die Bezeichnung auf Other gesetzt, und diese Eigenschaft kann verwendet werden, um auf die Art zuzugreifen, wie sie vom System gemeldet wurde.
Hinweis: Diese Zeichenkette kann leer sein oder sich ändern, abhängig vom System und davon, wie der Anker klassifiziert wird.
Siehe auch classification.
extent2D : vector2d |
Die 2D-Ausdehnung des räumlichen Ankers.
Diese Eigenschaft enthält die Größe des räumlichen Ankers in zwei Dimensionen (Breite und Höhe) innerhalb der X/Z-Ebene. Sie ist gültig, wenn has2DBounds true ist.
Siehe auch has2DBounds und offset2D.
extent3D : vector3d |
Die 3D-Ausdehnung des räumlichen Ankers.
Diese Eigenschaft gibt das Volumen des räumlichen Ankers in drei Dimensionen (Breite, Höhe und Tiefe) an. Sie ist gültig, wenn has3DBounds gleich true ist.
Siehe auch offset3D und has3DBounds.
has2DBounds : bool |
Gibt an, ob der räumliche Anker 2D-Grenzen hat.
Diese Eigenschaft ist gültig true, wenn der räumliche Anker 2D-Grenzen hat, die durch offset2D und extent2D beschrieben werden, was bedeutet, dass er eine flache Oberfläche darstellt (z. B. einen Boden oder eine Wand).
Andernfalls gibt sie false zurück.
Siehe auch offset2D, extent2D, und has3DBounds.
has3DBounds : bool |
Gibt an, ob der räumliche Anker 3D-Grenzen hat.
Diese Eigenschaft gibt true zurück, wenn der räumliche Anker 3D-Grenzen hat, was bedeutet, dass er ein Volumen darstellt (z. B. einen Tisch oder einen Schrank). Die Begrenzungen werden durch offset3D und extent3D beschrieben.
Andernfalls wird false zurückgegeben.
Siehe auch offset3D, extent3D, und has2DBounds.
identifier : string |
Ein eindeutiger Bezeichner für diesen räumlichen Anker.
Diese Eigenschaft enthält einen eindeutigen Bezeichner, der mit dem räumlichen Anker verbunden ist. Dies ist derselbe Bezeichner, auf den ein XrSpatialAnchorListModel verweist.
offset2D : vector2d |
Der 2D-Versatz des räumlichen Ankers.
Diese Eigenschaft enthält den Versatz der Grenzen des Ankers in der X/Z-Ebene. Sie ist gültig, wenn has2DBounds true ist.
Siehe auch has2DBounds und extent2D.
offset3D : vector3d |
Der 3D-Versatz des räumlichen Ankers.
Diese Eigenschaft gibt den 3D-Offset der Ankerbegrenzungen (in Metern) vom Anker position an.
Siehe auch offset3D und has3DBounds.
position : vector3d |
Die Position des räumlichen Ankers.
Diese Eigenschaft gibt die 3D-Position (in Metern) des Ursprungs des räumlichen Ankers im Koordinatensystem der Sitzung an.
rotation : quaternion |
Die Ausrichtung des räumlichen Ankers.
Diese Eigenschaft liefert die Drehung des räumlichen Ankers (als 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.
