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: | |
| Status: | Deprecated |
Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.
Eigenschaften
- enablement : enumeration
Methoden
- void requestUpdate()
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.
RenderSurfaceSelector {
ClearBuffers {
Viewport {
CameraSelector {}
}
}
SubtreeEnabler {
enabled: showDebugView
Viewport {
CameraSelector {
RenderPassFilter {}
}
}
}
}„SubtreeEnabler“ ist standardmäßig aktiviert.
Dokumentation der Eigenschaften
enablement : enumeration
Legt fest, ob die Aktivierung von Unterbäumen dauerhaft oder vorübergehend ist.
| Konstante | Beschreibung |
|---|---|
Persistent | Der Wert „enabled“ ist dauerhaft. Dies ist die Standardeinstellung. |
SingleShot | Der 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.