Auf dieser Seite

SubtreeEnabler QML Type

Aktiviert oder deaktiviert ganze Teilbäume von Knoten im Frame-Graph. Mehr...

Import Statement: import Qt3D.Render 2.12
In C++: QSubtreeEnabler
Inherits:

FrameGraphNode

Status: Deprecated

Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.

Eigenschaften

Methoden

Ausführliche Beschreibung

Zwar lassen sich FrameGraphNodes über die Eigenschaft „ enabled “ einzeln aktivieren und deaktivieren, doch kann dies mühsam werden, wenn ein ganzer Pfad ein- oder ausgeschaltet werden soll. SubtreeEnabler ist ein Komfortknoten, der diesen Anwendungsfall vereinfacht, da alle seine untergeordneten Knoten über einen einzigen Schalter gesteuert werden können.

Beispielsweise enthält der folgende vereinfachte Frame-Graph einen Teilbaum für das Debug-Rendering, der problemlos nur während der Fehlersuche aktiviert werden kann.

„SubtreeEnabler“ ist standardmäßig aktiviert.

Dokumentation der Eigenschaften

enablement : enumeration

Legt fest, ob die Aktivierung von Unterbäumen dauerhaft oder vorübergehend ist.

KonstanteBeschreibung
PersistentDer Wert „enabled“ ist dauerhaft. Dies ist die Standardeinstellung.
SingleShotDer Wert von „enabled“ gilt nur für einen einzelnen Frame und wird anschließend auf „false“ zurückgesetzt. Dies kann beispielsweise beim Zeichnen eines Teilbaums in ein FBO verwendet werden, um das FBO nur dann zu aktualisieren, wenn sich die relevanten Teile der Szene geändert haben.

Methodendokumentation

void requestUpdate()

Fordert an, dass der Teilbaum aktiviert wird.

Eine Komfortmethode, die für die Verwendung mit der Aktivierung von „ SingleShot “ vorgesehen ist.

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