Back to Qt.io
Contact Us Blog Download Qt

ObjectPicker QML Type

ObjectPicker 클래스는 선택이라는 프로세스를 통해 엔티티와 상호 작용하는 데 사용할 수 있는 컴포넌트를 인스턴스화합니다. 더 보기...

Import Statement: import Qt3D.Render 2.8
In C++: QObjectPicker
Status: Deprecated

속성

신호

자세한 설명

뷰포트와 카메라의 모든 조합에 대해 선택은 씬을 통해 광선을 투사하여 바운딩 볼륨이 광선과 교차하는 엔티티를 찾습니다. 바운딩 볼륨은 지오메트리의 바운딩볼륨위치속성으로 지정된 속성 버퍼의 값을 사용하여 계산됩니다.

pressed(), released(), clicked(), moved(), entered(), exited() 신호는 pickAttribute 속성으로 정의된 바운딩 볼륨이 광선과 교차할 때 방출됩니다.

대부분의 신호는 PickEvent 인스턴스를 전달합니다. PickingSettings .pickMode가 PickingSettings.TrianglePicking으로 설정된 경우 pick 파라미터의 실제 유형은 PickTriangleEvent 입니다.

선택 쿼리는 마우스를 누르고 마우스를 놓으면 수행됩니다. 드래그가 활성화된 경우 버튼을 누르고 있는 동안 마우스를 움직일 때마다 쿼리가 수행됩니다. 호버가 활성화된 경우 버튼을 누르지 않아도 마우스를 움직일 때마다 쿼리가 수행됩니다.

참고: QtQuick 에서 호버 이벤트를 수신하려면 Scene3D의 hoverEnabled 속성도 설정해야 합니다.

참고: 이 컴포넌트의 인스턴스를 공유해서는 안 되며, 이 조건을 준수하지 않으면 정의되지 않은 동작이 발생할 가능성이 높습니다.

참고: 카메라 원거리 평면 값이 ~100,000보다 크면 부동 소수점 정밀도로 인해 피킹에 영향을 미치고 잘못된 결과를 생성합니다.

PickingSettings, Geometry, Attribute, PickEvent, PickTriangleEvent, NoPicking 를참조하세요 .

속성 문서

containsMouse : bool [read-only]

개체 선택기에 현재 마우스가 포함되어 있는지 여부를 지정합니다.


dragEnabled : bool


hoverEnabled : bool

호버가 활성화되어 있는지 지정합니다.


pressed : bool [read-only]

개체 선택기가 현재 누르고 있는지 지정합니다.


priority : int

PickingSettings.pickResultMode가 PickingSettings.PriorityPick으로 설정된 경우 우선순위에 따라 선택 결과를 필터링할 때 사용할 우선순위입니다.


신호 문서

clicked(PickEvent pick)

이 신호는 pickAttribute 속성으로 정의된 바운딩 볼륨이 마우스 클릭 시 광선과 교차할 때 발생합니다. 교차 정보는 pick 파라미터를 통해 액세스할 수 있습니다.

참고: 해당 핸들러는 onClicked 입니다.


entered()

이 신호는 pickAttribute 속성으로 정의된 바운딩 볼륨이 볼륨에 들어오는 마우스의 광선과 교차할 때 발생합니다.

참고: 해당 핸들러는 onEntered 입니다.


exited()

이 신호는 pickAttribute 속성으로 정의된 바운딩 볼륨이 볼륨을 빠져나가는 광선의 광선과 교차할 때 발생합니다.

참고: 해당 핸들러는 onExited 입니다.


moved(PickEvent pick)

이 신호는 버튼을 누른 상태에서 마우스를 움직일 때 pickAttribute 속성으로 정의된 바운딩 볼륨이 광선과 교차할 때 발생합니다. 교차 정보는 pick 매개변수를 통해 액세스할 수 있습니다.

참고: 해당 핸들러는 onMoved 입니다.


pressed(PickEvent pick)

이 신호는 pickAttribute 속성으로 정의된 바운딩 볼륨이 마우스를 누른 상태에서 광선과 교차할 때 발생합니다. 교차 정보는 pick 매개변수를 통해 액세스할 수 있습니다.

참고: 해당 핸들러는 onPressed 입니다.


released(PickEvent pick)

이 신호는 pickAttribute 속성으로 정의된 바운딩 볼륨이 마우스 릴리스 시 광선과 교차할 때 발생합니다. 교차 정보는 pick 매개변수를 통해 액세스할 수 있습니다.

참고: 해당 핸들러는 onReleased 입니다.


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