XrSpatialAnchor QML Type

실제 공간에서 특정 위치 또는 개체를 추적합니다. 더 보기...

Import Statement: import QtQuick3D.Xr
Since: Qt 6.8
Inherits:

QtObject

Status: Technical Preview

속성

상세 설명

이 유형은 실제 공간에서 특정 위치 또는 개체를 추적하는 공간 앵커를 나타냅니다. 앵커의 위치, 회전, 분류 및 경계에 대한 정보를 제공합니다.

공간 앵커는 XrSpatialAnchorListModel 을 통해 액세스할 수 있습니다.

참고: 앵커 개체는 시스템에서 제공합니다. QML에서는 생성할 수 없습니다.

이 유형을 사용하는 방법은 Qt Quick 3D - XR 공간 앵커 예시를 참조하세요.

속성 문서

Classification : enumeration [read-only]

공간 앵커의 분류입니다.

분류 열거형은 공간 앵커의 목적 또는 컨텍스트를 설명하는 미리 정의된 카테고리 유형 집합을 제공합니다.

Constant설명
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 일 수도 있습니다.

TypeOpenXRVisionOS설명
알 수 없음--레이블이 설정되지 않았거나 식별되지 않았습니다.
WallWALL_FACEWall앵커는 벽을 나타냅니다.
천장CEILING천장앵커는 천장을 나타냅니다.
FloorFLOORFloor앵커는 바닥을 나타냅니다.
TABLE앵커는 테이블을 나타냅니다.
좌석COUCH좌석앵커는 좌석을 나타냅니다.
WINDOW_FRAME앵커는 창을 나타냅니다.
DoorDOOR_FRAMEDoor앵커는 문을 나타냅니다.
기타--앵커는 다른 것을 나타냅니다. 참조: classificationString

classification : enumeration [read-only]

공간 앵커의 분류 유형입니다.

이 속성은 이 앵커(예:Table 또는 Floor)에 대해 앵커의 목적 또는 컨텍스트를 설명하는 classification type 을 반환합니다.

참고: 시스템에서 가져온 분류 유형이 Classification 열거형에 정의된 레이블 집합에 없을 수 있으며, 이 경우 유형은 Other 으로 설정되고 classificationString 속성에는 원래 레이블이 포함됩니다.

classificationString참조하세요 .


classificationString : string [read-only]

공간 앵커의 분류 유형을 문자열로 반환합니다.

이 속성은 분류 유형이 있는 경우 분류 유형을 문자열로 반환합니다. 분류 유형이 Classification 열거형에 정의된 유형 집합에 없는 경우 레이블은 Other 으로 설정되며 이 속성을 사용하여 시스템에서 보고된 대로 유형에 액세스할 수 있습니다.

참고: 이 문자열은 시스템 및 앵커가 분류되는 방식에 따라 비어 있거나 변경될 수 있습니다.

classification참조하세요 .


extent2D : vector2d [read-only]

공간 앵커의 2D 범위입니다.

이 속성은 공간 앵커의 크기를 X/Z 평면 내에서 2차원(너비 및 높이)으로 유지합니다. has2DBoundstrue 일 때 유효합니다.

has2DBoundsoffset2D참조하세요 .


extent3D : vector3d [read-only]

공간 앵커의 3D 범위.

이 속성은 공간 앵커의 볼륨을 3차원(너비, 높이, 깊이)으로 지정합니다. has3DBoundstrue 일 때 유효합니다.

offset3Dhas3DBounds참조하세요 .


has2DBounds : bool [read-only]

공간 앵커에 2D 바운드가 있는지 여부를 나타냅니다.

공간 앵커에 offset2Dextent2D 으로 설명되는 2D 바운드가 있는 경우 이 속성은 true 을 반환하여 평평한 표면(예: 바닥 또는 벽)을 나타냅니다.

그렇지 않으면 false를 반환합니다.

offset2D, extent2D, has3DBounds도 참조하세요 .


has3DBounds : bool [read-only]

공간 앵커에 3D 바운드가 있는지 여부를 나타냅니다.

공간 앵커에 3D 바운드가 있는 경우 이 속성은 true 을 반환하여 볼륨(예: 테이블 또는 찬장)을 나타냅니다. 바운드는 offset3Dextent3D 으로 설명됩니다.

그렇지 않으면 false 을 반환합니다.

offset3D, extent3D, has2DBounds도 참조하세요 .


identifier : string [read-only]

이 공간 앵커의 고유 식별자입니다.

이 속성은 공간 앵커와 관련된 고유 식별자를 보유합니다. 이는 XrSpatialAnchorListModel 에서 참조하는 식별자와 동일합니다.


offset2D : vector2d [read-only]

공간 앵커의 2D 오프셋입니다.

이 속성은 X/Z 평면 내에서 앵커의 바운드 오프셋을 보유합니다. has2DBoundstrue 일 때 유효합니다.

has2DBoundsextent2D참조하세요 .


offset3D : vector3d [read-only]

공간 앵커의 3D 오프셋입니다.

이 프로퍼티는 앵커의 position 에서 앵커 바운드의 3D 오프셋(미터 단위)을 제공합니다.

offset3D 및 has3DBounds도 참조하십시오 .


position : vector3d [read-only]

공간 앵커의 위치.

이 속성은 세션의 좌표계 내에서 공간 앵커 원점의 3D 위치(미터)를 반환합니다.


rotation : quaternion [read-only]

공간 앵커의 방향입니다.

이 속성은 공간 앵커의 회전(쿼터니언)을 제공합니다.


© 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.