이 페이지에서

pickResult QML Value Type

선택 결과를 포함합니다. 더 보기...

Import Statement: import QtQuick3D

속성

상세 설명

View3D::pick 에 반환 객체로 생성됩니다.

속성 문서

distance : real [read-only]

이 프로퍼티는 선택 원점과 히트 위치 사이의 거리, 즉 광선의 길이를 보유합니다. 뷰포트 좌표를 사용하여 선택 원점을 지정하는 경우 선택 원점은 활성 카메라의 위치가 됩니다.

hitType : enumeration [read-only, since 6.8]

이 속성은 선택 결과의 히트 유형을 저장합니다.

Constant설명
PickResult.Null선택이 아무 것도 적중하지 않았습니다.
PickResult.Model선택이 모델에 적중했습니다.
PickResult.Item선택이 QQuickItem 에 도달했습니다.

이 프로퍼티는 Qt 6.8에 도입되었습니다.

instanceIndex : int [read-only, since 6.5]

이 속성은 선택이 인스턴스화된 모델의 인스턴스에 도달한 경우에 대한 인스턴스 테이블의 인덱스를 보유합니다.

이 프로퍼티는 Qt 6.5에 도입되었습니다.

itemHit : Item [read-only, since 6.8]

이 속성은 선택에 의해 히트된 Qt Quick 항목을 보유합니다. hitTypepickResult.Item 이 아닌 경우 이 값은 null이 됩니다.

이 프로퍼티는 Qt 6.8에 도입되었습니다.

objectHit도 참조하십시오 .

normal : vector3d [read-only]

이 프로퍼티는 로컬 좌표 공간에서 부딪힌 얼굴의 노멀을 보유합니다.

참고: 2D 아이템의 경우 항상 (0, 0, 1)이 됩니다.

objectHit : Model [read-only]

이 프로퍼티는 선택에 의해 히트된 모델 객체를 보유합니다. hitTypepickResult.Model 이 아닌 경우 이 값은 null이 됩니다.

itemHit도 참조하세요 .

position : vector3d [read-only]

이 프로퍼티는 로컬 좌표 공간에서 히트 장면의 위치를 저장합니다.

sceneNormal : vector3d [read-only]

이 프로퍼티는 씬 좌표 공간에 부딪힌 얼굴의 노멀을 저장합니다.

scenePosition : vector3d [read-only]

이 프로퍼티는 히트의 장면 위치를 저장합니다.

uvPosition : vector2d [read-only]

이 프로퍼티에는 히트의 UV 위치가 저장됩니다. UV 위치는 바운딩 볼륨을 기준으로 히트 포인트의 정규화된 로컬 x 및 y 좌표로 계산됩니다. 화면 밖에서 렌더링된 오브젝트에 대한 추가 피킹에 유용합니다.

hitTypepickResult.Item 인 경우 이 값은 itemHit 의 좌표 공간에서 히트 위치를 나타냅니다.

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