QPickingSettings Class
class Qt3DRender::QPickingSettingsQPickingSettings 클래스는 엔티티 선택이 처리되는 방식을 지정합니다. 더 보기...
| Header: | #include <QPickingSettings> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3drender)target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake: | QT += 3drender |
| QML에서: | PickingSettings |
| 상속합니다: | Qt3DCore::QNode |
| 상태: | Deprecated |
공용 유형
| 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
면 방향이 트라이앵글 선택에 영향을 미치는 방식을 지정합니다.
| Constant | 값 | 설명 |
|---|---|---|
Qt3DRender::QPickingSettings::FrontFace | 0x01 | 정면을 향한 트라이앵글만 선택됩니다(기본값). |
Qt3DRender::QPickingSettings::BackFace | 0x02 | 뒷면을 향한 트라이앵글만 선택됩니다. |
Qt3DRender::QPickingSettings::FrontAndBackFace | 0x03 | 앞면과 뒷면을 향한 트라이앵글이 모두 선택됩니다. |
enum QPickingSettings::PickMethod
선택 방법을 지정합니다.
| Constant | 값 | 설명 |
|---|---|---|
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) |
알림 신호:
| 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()도 참조하세요 .
© 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.
