Qt3DRender::QPickingSettings Class
class Qt3DRender::QPickingSettingsQPickingSettings 클래스는 엔티티 피킹이 어떻게 처리되는지를 지정합니다. 더 보기...
| 헤더: | #include <qpickingsettings.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake: | QT += 3drender |
| QML에서: | PickingSettings |
| 상속: | Qt3DCore::QNode |
| 상태: | 사용 중단됨 |
이 클래스는 더 이상 사용되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않는 것을 강력히 권장합니다.
공개 유형
| enum | FaceOrientationPickingMode { FrontFace, BackFace, FrontAndBackFace } |
| enum | PickMethod { BoundingVolumePicking, TrianglePicking, LinePicking, PointPicking, PrimitivePicking } |
| enum | PickResultMode { NearestPick, AllPicks, NearestPriorityPick } |
속성
- faceOrientationPickingMode : FaceOrientationPickingMode
- pickMethod : PickMethod
- pickResultMode : PickResultMode
- worldSpaceTolerance : float
공개 함수
| Qt3DRender::QPickingSettings::FaceOrientationPickingMode | faceOrientationPickingMode() const |
| Qt3DRender::QPickingSettings::PickMethod | pickMethod() const |
| Qt3DRender::QPickingSettings::PickResultMode | pickResultMode() const |
| float | worldSpaceTolerance() const |
공개 슬롯
| void | setFaceOrientationPickingMode(Qt3DRender::QPickingSettings::FaceOrientationPickingMode faceOrientationPickingMode) |
| void | setPickMethod(Qt3DRender::QPickingSettings::PickMethod pickMethod) |
| void | setPickResultMode(Qt3DRender::QPickingSettings::PickResultMode pickResultMode) |
| void | setWorldSpaceTolerance(float worldSpaceTolerance) |
신호
| void | faceOrientationPickingModeChanged(Qt3DRender::QPickingSettings::FaceOrientationPickingMode faceOrientationPickingMode) |
| void | pickMethodChanged(Qt3DRender::QPickingSettings::PickMethod pickMethod) |
| void | pickResultModeChanged(Qt3DRender::QPickingSettings::PickResultMode pickResult) |
| void | worldSpaceToleranceChanged(float worldSpaceTolerance) |
상세 설명
피킹 설정은 엔티티 피킹이 어떻게 처리될지를 결정합니다. 엔티티 피킹에 대한 자세한 내용은 QObjectPicker 및 QRayCaster 컴포넌트 설명서를 참조하십시오.
QObjectPicker 컴포넌트를 사용할 때, 피킹은 마우스 이벤트에 의해 트리거됩니다.
QRayCaster 또는 QScreenRayCaster 컴포넌트를 사용할 경우, 피킹은 애플리케이션에서 명시적으로 트리거할 수 있습니다.
두 경우 모두, 빔을 통해 씬을 스캔하여 빔과 교차하는 지오메트리를 찾습니다.
QObjectPicker, QPickEvent, QPickTriangleEvent, QRayCaster 및 QScreenRayCaster도 참조하십시오 .
멤버 유형 문서
enum QPickingSettings::FaceOrientationPickingMode
삼각형 선택에 면의 방향이 어떤 영향을 미치는지 지정합니다
| 상수 | 값 | 설명 |
|---|---|---|
Qt3DRender::QPickingSettings::FrontFace | 0x01 | 앞을 향한 삼각형만 선택됩니다(기본값). |
Qt3DRender::QPickingSettings::BackFace | 0x02 | 뒷면을 향한 삼각형만 선택됩니다. |
Qt3DRender::QPickingSettings::FrontAndBackFace | 0x03 | 앞쪽을 향한 삼각형과 뒤쪽을 향한 삼각형 모두 선택됩니다. |
enum QPickingSettings::PickMethod
피킹 방법을 지정합니다.
| 상수 | 값 | 설명 |
|---|---|---|
Qt3DRender::QPickingSettings::BoundingVolumePicking | 0x00 | 피킹 광선이 엔티티의 바운딩 볼륨과 교차하면 해당 엔티티는 선택된 것으로 간주됩니다(기본값). |
Qt3DRender::QPickingSettings::TrianglePicking | 0x01 | 피킹 광선이 엔티티의 메쉬 컴포넌트에 속한 삼각형 중 하나와 교차하면 해당 엔티티는 선택된 것으로 간주됩니다. |
Qt3DRender::QPickingSettings::LinePicking | 0x02 | 피킹 광선이 엔티티의 메쉬 컴포넌트에 속한 어떤 모서리와도 교차하면 해당 엔티티가 선택된 것으로 간주됩니다. |
Qt3DRender::QPickingSettings::PointPicking | 0x04 | 피킹 광선이 엔티티의 메쉬 컴포넌트의 임의의 점과 교차하는 경우, 해당 엔티티는 선택된 것으로 간주됩니다. |
Qt3DRender::QPickingSettings::PrimitivePicking | TrianglePicking | LinePicking | PointPicking | 피킹 광선이 엔티티의 메쉬 구성 요소의 임의의 점, 모서리 또는 삼각형과 교차하면 해당 엔티티는 선택된 것으로 간주됩니다. |
enum QPickingSettings::PickResultMode
피킹 결과에 포함될 항목을 지정합니다.
| 상수 | 값 | 설명 |
|---|---|---|
Qt3DRender::QPickingSettings::NearestPick | 0 | 피킹 광선과 교차하는 엔티티 중 피킹 광선 원점에 가장 가까운 엔티티만 선택됩니다(기본값). |
Qt3DRender::QPickingSettings::AllPicks | 1 | 피킹 광선과 교차하는 모든 엔티티가 선택됩니다. |
Qt3DRender::QPickingSettings::NearestPriorityPick | 2 | 오브젝트 피커의 값이 가장 높은 엔티티를 선택합니다. 여러 오브젝트 피커의 우선순위가 동일한 경우, 선상에서 가장 가까운 피커가 선택됩니다. |
Qt3DRender::QPickEvent도 참조하십시오 .
속성 설명서
faceOrientationPickingMode : FaceOrientationPickingMode
면 방향이 삼각형 선택에 미치는 영향을 지정합니다.
액세스 함수:
| Qt3DRender::QPickingSettings::FaceOrientationPickingMode | faceOrientationPickingMode() const |
| void | setFaceOrientationPickingMode(Qt3DRender::QPickingSettings::FaceOrientationPickingMode faceOrientationPickingMode) |
알림 신호:
| void | faceOrientationPickingModeChanged(Qt3DRender::QPickingSettings::FaceOrientationPickingMode faceOrientationPickingMode) |
pickMethod : PickMethod
현재 선택 방식을 저장합니다.
기본적으로 성능상의 이유로 레이 캐스팅은 바운딩 볼륨 피킹을 사용합니다. 그러나 뒤에 있는 큰 오브젝트의 바운딩 스피어 내에 작은 오브젝트가 포함된 경우, 예상치 못한 결과가 발생할 수 있습니다.
삼각형 피킹은 정확한 결과를 산출하지만 계산 비용이 더 많이 듭니다.
액세스 함수:
| Qt3DRender::QPickingSettings::PickMethod | pickMethod() const |
| void | setPickMethod(Qt3DRender::QPickingSettings::PickMethod pickMethod) |
알림 신호:
| void | pickMethodChanged(Qt3DRender::QPickingSettings::PickMethod pickMethod) |
pickResultMode : PickResultMode
현재 선택 결과 모드를 유지합니다.
기본적으로 픽 결과는 카메라에 가장 가까운 엔티티에 대해서만 생성됩니다.
픽 방법을 ` AllPicks`로 설정하면, 광선을 따라 위치한 QObjectPicker를 가진 모든 엔티티에 대해 이벤트가 트리거됩니다.
픽 방법을 ` NearestPriorityPick`로 설정하면, 레이를 따라 가장 가까운 최우선순위 피커에 대해 이벤트가 트리거됩니다. 이는 다른 엔티티가 앞에 있더라도 특정 요소가 항상 선택되어야 할 때 사용할 수 있습니다.
QObjectPicker가 여러 자식 엔티티를 가진 엔티티에 할당된 경우, 레이와 교차하는 각 자식 엔티티에 대해 이벤트가 트리거됩니다.
액세스 함수:
| Qt3DRender::QPickingSettings::PickResultMode | pickResultMode() const |
| void | setPickResultMode(Qt3DRender::QPickingSettings::PickResultMode pickResultMode) |
Notifier 신호:
| void | pickResultModeChanged(Qt3DRender::QPickingSettings::PickResultMode pickResult) |
worldSpaceTolerance : float
선 및 점 선택 평가에 사용되는 임계값을 모델 공간 좌표계로 저장합니다.
액세스 함수:
| float | worldSpaceTolerance() const |
| void | setWorldSpaceTolerance(float worldSpaceTolerance) |
알림 신호:
| void | worldSpaceToleranceChanged(float worldSpaceTolerance) |
멤버 함수 문서
[slot] void QPickingSettings::setWorldSpaceTolerance(float worldSpaceTolerance)
선 및 점 선택에 사용되는 임계값을 ` worldSpaceTolerance`로 설정합니다.
참고: 속성 ` worldSpaceTolerance`에 대한설정 함수입니다.
worldSpaceTolerance()도 참조하십시오 .
float QPickingSettings::worldSpaceTolerance() const
worldSpaceTolerance의 선 및 점 정밀도를 반환합니다.
참고: worldSpaceTolerance 속성에 대한게터 함수입니다.
setWorldSpaceTolerance()도 참조하십시오 .
© 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.
