SubtreeEnabler QML Type
프레임 그래프 노드의 전체 하위 트리를 활성화하거나 비활성화합니다. 더 보기...
| Import Statement: | import Qt3D.Render 2.12 |
| In C++: | QSubtreeEnabler |
| Inherits: | |
| Status: | Deprecated |
이 유형은 더 이상 사용되지 않습니다. 새로운 코드에서는 이 유형을 사용하지 않는 것을 강력히 권장합니다.
속성
- enablement : enumeration
방법
- void requestUpdate()
상세 설명
FrameGraphNodes는 ` enabled ` 속성을 통해 개별적으로 활성화 및 비활성화할 수 있지만, 전체 경로를 켜거나 꺼야 할 때는 이 작업이 번거로울 수 있습니다. `SubtreeEnabler`는 이러한 사용 사례를 간편하게 처리해 주는 편의 노드로, 단일 스위치로 모든 자식 노드를 제어할 수 있게 해줍니다.
예를 들어, 다음의 단순화된 프레임 그래프에는 디버깅 시에만 쉽게 활성화할 수 있는 디버그 렌더링용 서브트리가 포함되어 있습니다.
RenderSurfaceSelector {
ClearBuffers {
Viewport {
CameraSelector {}
}
}
SubtreeEnabler {
enabled: showDebugView
Viewport {
CameraSelector {
RenderPassFilter {}
}
}
}
}SubtreeEnabler는 기본적으로 활성화되어 있습니다.
속성 설명서
enablement : enumeration
서브트리 활성화가 영구적인지 일시적인지를 제어합니다.
| 상수 | 설명 |
|---|---|
Persistent | enabled의 값은 영구적으로 유지됩니다. 이것이 기본값입니다. |
SingleShot | enabled의 값은 한 프레임 동안 유지된 후 false로 재설정됩니다. 이는 예를 들어, FBO에 서브트리를 그릴 때, 씬의 관련 부분이 변경된 경우에만 FBO를 업데이트하는 데 사용될 수 있습니다. |
메서드 문서
void requestUpdate()
서브트리를 활성화하도록 요청합니다.
SingleShot 활성화와 함께 사용하도록 의도된 편의 메서드입니다.
© 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.