QBoundingVolume Class
class Qt3DCore::QBoundingVolume를 사용하여 엔티티의 바운딩 볼륨을 재정의할 수 있습니다. 더 보기...
| Header: | #include <Qt3DCore/QBoundingVolume> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3DCore)target_link_libraries(mytarget PRIVATE Qt6::3DCore) |
| qmake: | QT += 3dcore |
| 이후: | Qt 6.0 |
| QML에서: | BoundingVolume |
| 상속: | Qt3DCore::QComponent |
| 상속 대상: | |
| Status: | Deprecated |
속성
|
공용 기능
| QBoundingVolume(Qt3DCore::QNode *parent = nullptr) | |
| bool | areImplicitPointsValid() const |
| QVector3D | implicitMaxPoint() const |
| QVector3D | implicitMinPoint() const |
| QVector3D | maxPoint() const |
| QVector3D | minPoint() const |
| Qt3DCore::QGeometryView * | view() const |
공용 슬롯
| void | setMaxPoint(const QVector3D &maxPoint) |
| void | setMinPoint(const QVector3D &minPoint) |
| void | setView(Qt3DCore::QGeometryView *view) |
| bool | updateImplicitBounds() |
신호
| void | implicitMaxPointChanged(const QVector3D &implicitMaxPoint) |
| void | implicitMinPointChanged(const QVector3D &implicitMinPoint) |
| void | implicitPointsValidChanged(bool implicitPointsValid) |
| void | maxPointChanged(QVector3D maxPoint) |
| void | minPointChanged(QVector3D minPoint) |
| void | viewChanged(Qt3DCore::QGeometryView *view) |
상세 설명
엔티티의 바운딩 볼륨은 피킹 또는 뷰 프러스텀 컬링과 같은 많은 연산에 사용됩니다. 일반적으로 렌더링된 지오메트리를 트래버스하여 계산됩니다.
응용 프로그램에서 지오메트리의 범위를 알고 있으므로 Qt 3D 계산할 필요가 없는 경우 QBoundingVolume을 사용할 수 있습니다.
바운딩 볼륨은 최소 및 최대 범위 좌표로 제공되거나 렌더링된 메시를 근사화하는 별도의 더 간단한 지오메트리로 제공될 수 있습니다.
최소 및 최대 범위를 사용하는 경우, 지오메트리의 로컬 좌표계에서 축 정렬 바운딩 박스의 반대쪽 모서리로 간주됩니다.
QBoundingVolume을 사용하여 GeometryView 의 계산된 바운딩 볼륨을 쿼리할 수도 있습니다. 지오메트리가 변경되면 implicitMinPoint 및 implicitMaxPoint 프로퍼티가 업데이트됩니다. 이 작업은 백그라운드 스레드에서 비동기적으로 수행되므로 읽기 전에 implicitPointsValid 값을 확인해야 합니다.
updateImplicitBounds 을 호출하여 암시적 확장을 강제로 업데이트할 수 있습니다. 이렇게 하면 결과를 사용할 수 있을 때까지 호출 스레드가 차단됩니다.
참고: GeometryRenderer 은 BoundingVolume 을 상속하므로 암시적 범위를 읽거나 명시적 범위를 설정하는 것도 지원합니다.
속성 문서
[read-only] implicitMaxPoint : const QVector3D
* 지정된 뷰에서 계산된 바운딩 볼륨의 최대 범위를 유지합니다.
액세스 함수:
| QVector3D | implicitMaxPoint() const |
알림 신호:
| void | implicitMaxPointChanged(const QVector3D &implicitMaxPoint) |
[read-only] implicitMinPoint : const QVector3D
* 지정된 뷰에서 계산된 바운딩 볼륨의 최소 범위를 유지합니다.
액세스 함수:
| QVector3D | implicitMinPoint() const |
알림 신호:
| void | implicitMinPointChanged(const QVector3D &implicitMinPoint) |
[read-only] implicitPointsValid : const bool
* 뷰가 할당되어 있고 암시적 범위 속성이 최신 상태인 경우 true입니다. * *
함수에 액세스합니다:
| bool | areImplicitPointsValid() const |
알림 신호:
| void | implicitPointsValidChanged(bool implicitPointsValid) |
updateImplicitBounds 을참조하십시오 .
maxPoint : QVector3D
* * * 사용자가 지정한 바운딩 볼륨의 최대 범위입니다. 최소 * 범위와 함께 설정하면 * 지오메트리에서 볼륨을 계산하지 않도록 내부적으로 사용됩니다.
액세스 함수:
| QVector3D | maxPoint() const |
| void | setMaxPoint(const QVector3D &maxPoint) |
알림 신호:
| void | maxPointChanged(QVector3D maxPoint) |
minPoint : QVector3D
* * * 사용자가 지정한 바운딩 볼륨의 최소 범위입니다. 최대 * 범위와 함께 설정하면 * 지오메트리에서 볼륨을 계산하지 않기 위해 내부적으로 사용됩니다.
액세스 함수:
| QVector3D | minPoint() const |
| void | setMinPoint(const QVector3D &minPoint) |
알림 신호:
| void | minPointChanged(QVector3D minPoint) |
view : QGeometryView*
* 설정된 경우 * 바운딩 볼륨을 계산하는 데 사용되는 QGeometryView 인스턴스에 대한 포인터를 보유합니다.
함수에 액세스합니다:
| Qt3DCore::QGeometryView * | view() const |
| void | setView(Qt3DCore::QGeometryView *view) |
알림 신호:
| void | viewChanged(Qt3DCore::QGeometryView *view) |
멤버 함수 문서
[explicit] QBoundingVolume::QBoundingVolume(Qt3DCore::QNode *parent = nullptr)
parent 를 사용하여 새 QBoundingVolume을 생성합니다.
[slot] bool QBoundingVolume::updateImplicitBounds()
* 지정된 뷰의 암시적 경계를 업데이트합니다. 계산에 성공하면 * true 를 반환하고 그렇지 않으면 false를 반환합니다. * *
참고: 계산은 호출 스레드에서 수행되며, 큰 메시의 경우 상당한 시간이 걸릴 수 있습니다.
© 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.
