SubtreeEnabler QML Type

프레임 그래프 노드의 전체 서브트리를 활성화 또는 비활성화합니다. 더 보기...

Import Statement:	`import Qt3D.Render 2.8`
In C++:	QSubtreeEnabler
Inherits:	FrameGraphNode
Status:	Deprecated

상속된 멤버를 포함한 모든 멤버 목록

속성

enablement : enumeration

방법

void requestUpdate()

상세 설명

프레임그래프 노드는 enabled 속성을 통해 개별적으로 활성화 및 비활성화할 수 있지만, 전체 경로를 켜거나 꺼야 할 때는 번거로울 수 있습니다. 서브트리 활성화기는 이 사용 사례를 간단하게 만들어주는 편의 노드로, 하나의 스위치로 모든 자식을 제어할 수 있습니다.

예를 들어 다음 단순화된 프레임 그래프에는 디버그 렌더링을 위한 서브트리가 포함되어 있으며 디버깅할 때만 쉽게 활성화할 수 있습니다.

RenderSurfaceSelector {
    ClearBuffers {
        Viewport {
            CameraSelector {}
        }
    }

    SubtreeEnabler {
        enabled: showDebugView
        Viewport {
            CameraSelector {
                RenderPassFilter {}
            }
        }
    }
}

서브트리 인에이블러는 기본적으로 활성화되어 있습니다.

프로퍼티 문서

enablement : enumeration

서브트리 활성화가 영구적인지 일시적인지 여부를 제어합니다.

Constant	설명
`Persistent`	enabled 값은 영구적입니다. 기본값입니다.
`SingleShot`	enabled 값은 한 프레임 동안 지속된 후 false로 재설정됩니다. 예를 들어 씬의 관련 부분이 변경되었을 때만 FBO를 업데이트하기 위해 FBO에 서브트리를 그리는 데 사용할 수 있습니다.

메서드 문서

void requestUpdate()

서브트리를 활성화하도록 요청합니다.

SingleShot 활성화와 함께 사용하기 위한 편의성 메서드입니다.

© 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.