pickResult QML Value Type

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

Import Statement: import QtQuick3D

속성

distance : real
hitType : enumeration (since 6.8)
instanceIndex : int (since 6.5)
itemHit : Item (since 6.8)
normal : vector3d
objectHit : Model
position : vector3d
sceneNormal : vector3d
scenePosition : vector3d
uvPosition : vector2d

상세 설명

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 항목을 보유합니다. hitType 이 pickResult.Item 이 아닌 경우 이 값은 null이 됩니다.

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

objectHit도 참조하십시오 .

normal : vector3d [read-only]

이 프로퍼티는 로컬 좌표 공간에서 히트된 얼굴의 법선을 저장합니다.

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

objectHit : Model [read-only]

이 프로퍼티는 선택에 맞은 모델 개체를 보유합니다. hitType 이 pickResult.Model 이 아닌 경우 이 값은 null이 됩니다.

itemHit 를참조하세요 .

position : vector3d [read-only]

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

sceneNormal : vector3d [read-only]

이 프로퍼티는 히트된 얼굴의 노멀을 장면 좌표 공간에 저장합니다.

scenePosition : vector3d [read-only]

이 프로퍼티는 히트의 씬 위치를 보유합니다.

uvPosition : vector2d [read-only]

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

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

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