SubtreeEnabler QML Type

Aktiviert oder deaktiviert ganze Teilbäume von Knoten des Rahmengraphen. Mehr...

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

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

enablement : enumeration

Methoden

void requestUpdate()

Detaillierte Beschreibung

Während FrameGraphNodes über die Eigenschaft enabled einzeln ein- und ausgeschaltet werden können, kann dies mühsam werden, wenn ein ganzer Pfad ein- oder ausgeschaltet werden muss. SubtreeEnabler ist ein Komfortknoten, der diesen Anwendungsfall trivial macht, indem er es ermöglicht, dass alle seine Kinder durch einen einzigen Schalter gesteuert werden.

Der folgende vereinfachte Framediagramm enthält beispielsweise einen Teilbaum für das Debugging-Rendering, der einfach nur während der Fehlersuche aktiviert werden kann.

RenderSurfaceSelector {
    ClearBuffers {
        Viewport {
            CameraSelector {}
        }
    }

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

SubtreeEnabler ist standardmäßig aktiviert.

Eigenschaft Dokumentation

enablement : enumeration

Steuert, ob die Teilbaumaktivierung dauerhaft oder vorübergehend ist.

Konstante	Beschreibung
`Persistent`	Der Wert von enabled ist persistent. Dies ist die Standardeinstellung.
`SingleShot`	Der Wert von enabled bleibt für einen einzigen Frame bestehen und wird dann auf false zurückgesetzt. Dies könnte z.B. für einen Teilbaum verwendet werden, der auf einen FBO gezeichnet wird, um den FBO nur zu aktualisieren, wenn sich die relevanten Teile der Szene ändern.

Methode Dokumentation

void requestUpdate()

Fordert an, dass der Teilbaum aktiviert wird.

Eine Conveninence-Methode, die mit SingleShot enablement verwendet werden soll.

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