Qt3DRender::QSubtreeEnabler Class
class Qt3DRender::QSubtreeEnabler프레임그래프 노드의 전체 하위 트리를 활성화하거나 비활성화합니다. 더 보기...
| 헤더: | #include <qsubtreeenabler.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake: | QT += 3drender |
| QML에서: | SubtreeEnabler |
| 상속: | Qt3DRender::QFrameGraphNode |
| 상태: | 사용 중단됨 |
이 클래스는 더 이상 사용되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않는 것을 강력히 권장합니다.
공개 유형
| enum | Enablement { Persistent, SingleShot } |
속성
- enablement : Enablement
공개 함수
| Qt3DRender::QSubtreeEnabler::Enablement | enablement() const |
| void | requestUpdate() |
| void | setEnablement(Qt3DRender::QSubtreeEnabler::Enablement enablement) |
신호
| void | enablementChanged(Qt3DRender::QSubtreeEnabler::Enablement enablement) |
상세 설명
QFrameGraphNodes는 ` enabled ` 속성을 통해 개별적으로 활성화 및 비활성화할 수 있지만, 전체 경로를 한 번에 켜거나 꺼야 할 때는 이 작업이 번거로울 수 있습니다. `QSubtreeEnabler`는 이러한 사용 사례를 간편하게 처리해 주는 편의 노드로, 단일 스위치로 모든 자식 노드를 제어할 수 있게 해줍니다.
QSubtreeEnabler는 기본적으로 활성화되어 있습니다.
멤버 유형 문서
enum QSubtreeEnabler::Enablement
서브트리 활성화가 영구적인지 일시적인지를 지정합니다.
| 상수 | 값 | 설명 |
|---|---|---|
Qt3DRender::QSubtreeEnabler::Persistent | 0 | enabled 값은 영구적입니다. 이것이 기본값입니다. |
Qt3DRender::QSubtreeEnabler::SingleShot | 1 | enabled 값은 단일 프레임 동안 유지된 후 false로 재설정됩니다. 이는 예를 들어 FBO에 서브트리를 그릴 때, 씬의 관련 부분이 변경되었을 때만 FBO를 업데이트하는 데 사용될 수 있습니다. |
속성 설명서
enablement : Enablement
서브트리 활성화가 영구적인지 일시적인지를 제어합니다.
액세스 함수:
| Qt3DRender::QSubtreeEnabler::Enablement | enablement() const |
| void | setEnablement(Qt3DRender::QSubtreeEnabler::Enablement enablement) |
알림 신호:
| void | enablementChanged(Qt3DRender::QSubtreeEnabler::Enablement enablement) |
멤버 함수 문서
[invokable] void QSubtreeEnabler::requestUpdate()
서브트리를 활성화하도록 요청합니다.
SingleShot 활성화와 함께 사용하도록 의도된 편의 메서드입니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
© 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.
