ObjectPicker QML Type

ObjectPicker 클래스는 ‘피킹(picking)’이라고 하는 과정을 통해 엔티티와 상호 작용하는 데 사용할 수 있는 컴포넌트를 인스턴스화합니다. 더 보기...

이 유형은 더 이상 사용되지 않습니다. 새로운 코드에서는 이 유형을 사용하지 않는 것을 강력히 권장합니다.

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• containsMouse : bool
• dragEnabled : bool
• hoverEnabled : bool
• pressed : bool
• priority : int

신호

• clicked(PickEvent pick)
• entered()
• exited()
• moved(PickEvent pick)
• pressed(PickEvent pick)
• released(PickEvent pick)

상세 설명

뷰포트와 카메라의 모든 조합에 대해, 피킹 작업은 씬을 가로질러 광선을 투사하여 해당 광선과 바운딩 볼륨이 교차하는 엔티티를 찾습니다. 바운딩 볼륨은 지오메트리의 boundingVolumePositionAttribute에 지정된 속성 버퍼의 값을 사용하여 계산됩니다.

pickAttribute 속성으로 정의된 바운딩 볼륨이 레이와 교차할 때, pressed(), released(), clicked(), moved(), entered() 및 exited() 신호가 발산됩니다.

대부분의 신호는 ` PickEvent ` 인스턴스를 전달합니다. ` PickingSettings.pickMode`가 ` PickingSettings.TrianglePicking`으로 설정된 경우, `pick` 매개변수의 실제 유형은 ` PickTriangleEvent`이 됩니다.

픽 쿼리는 마우스 클릭 및 마우스 릴리스 시 수행됩니다. 드래그가 활성화된 경우, 어떤 버튼이든 눌려 있는 동안 마우스가 움직일 때마다 쿼리가 수행됩니다. 호버가 활성화된 경우, 버튼이 눌려 있지 않아도 마우스가 움직일 때마다 쿼리가 수행됩니다.

PickingSettings, Geometry, Attribute, PickEvent, PickTriangleEvent 및 NoPicking도 참조하십시오 .

속성 문서

containsMouse : bool [read-only]

현재 오브젝트 피커에 마우스가 포함되어 있는지 여부를 지정합니다.

dragEnabled : bool

hoverEnabled : bool

호버 기능이 활성화되어 있는지 여부를 지정합니다.

pressed : bool [read-only]

객체 선택기가 현재 눌려 있는지 여부를 지정합니다.

priority : int

PickingSettings.pickResultMode가 PickingSettings.PriorityPick으로 설정되었을 때, 피킹 결과를 우선순위에 따라 필터링할 때 적용할 우선순위입니다.

Signal 문서

clicked(PickEvent pick)

이 신호는 마우스 클릭 시 pickAttribute 속성으로 정의된 경계 볼륨이 광선과 교차할 때 발생합니다. 교차 정보는 pick 매개변수를 통해 확인할 수 있습니다.

entered()

이 신호는 pickAttribute 속성으로 정의된 경계 볼륨이, 해당 볼륨으로 들어오는 마우스 광선과 교차할 때 발생합니다.

exited()

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

moved(PickEvent pick)

이 신호는 마우스 버튼이 눌린 상태에서 마우스를 이동할 때, pickAttribute 속성으로 정의된 경계 볼륨이 광선과 교차할 때 발생합니다. 교차 정보는 pick 매개변수를 통해 확인할 수 있습니다.

pressed(PickEvent pick)

이 신호는 마우스 클릭 시 pickAttribute 속성으로 정의된 경계 볼륨이 레이와 교차할 때 발생합니다. 교차 정보는 pick 매개변수를 통해 확인할 수 있습니다.

released(PickEvent pick)

이 신호는 마우스 버튼이 놓일 때 pickAttribute 속성으로 정의된 경계 볼륨이 광선과 교차할 때 발생합니다. 교차 정보는 pick 매개변수를 통해 확인할 수 있습니다.