QQuick3DRenderExtension Class
Abstrakte Klasse zur Implementierung von benutzerseitigen Render-Erweiterungen. Mehr...
| Header: | #include <QQuick3DRenderExtension> |
| Since: | Qt 6.7 |
| In QML: | RenderExtension |
| Inherits: | QQuick3DObject |
| Inherited By: |
Neu implementierte öffentliche Funktionen
| virtual QSSGRenderGraphObject * | updateSpatialNode(QSSGRenderGraphObject *node) override |
Ausführliche Beschreibung
Dies ist die Frontend-Seite einer Render-Erweiterung. Die Backend-Seite wird in ` QSSGRenderExtension` implementiert. Die Klasse `QQuick3DRenderExtension` dient dazu, eine benutzerdefinierte Render-Erweiterung zu erstellen, die im Szenengraphen von ` QtQuick3D ` verwendet werden kann, indem sie der Liste der Erweiterungen hinzugefügt wird, die mit ` View3D` verwendet werden sollen. Der Code der Erweiterung wird dann als Teil der Ausführung der Rendering-Pipeline von ` QtQuick3D` ausgeführt.
Die Klasse „QQuick3DRenderExtension“ ist eine abstrakte Klasse, die unterklassifiziert und in QML verfügbar gemacht werden sollte. Die Unterklasse sollte die Funktion „ QQuick3DRenderExtension::updateSpatialNode()“ implementieren und eine „ QSSGRenderExtension “-Instanz zurückgeben, die den auszuführenden Code enthält.
Siehe auch ` QSSGRenderExtension`.
Dokumentation zu den Mitgliedsfunktionen
[override virtual] QSSGRenderGraphObject *QQuick3DRenderExtension::updateSpatialNode(QSSGRenderGraphObject *node)
Diese Funktion wird während der Synchronisation des Szenengraphen von „ QtQuick3D “ aufgerufen, wenn ein Element erstellt wird oder eine Aktualisierung angefordert wird – in der Regel infolge einer Änderung der Eigenschaften des Elements. Die Funktion sollte eine „ QSSGRenderExtension “-Instanz zurückgeben, die den Code enthält, der während der Ausführung der Rendering-Pipeline von „ QtQuick3D “ ausgeführt werden soll.
Der Parameter ` node ` ist die vorherige ` QSSGRenderExtension `-Instanz, die von dieser Funktion zurückgegeben wurde, oder `null`, wenn die Funktion zum ersten Mal aufgerufen wird. Die Funktion kann dieselbe Instanz, eine andere Instanz oder `null` zurückgeben. Wenn die Funktion `null` zurückgibt, wird die Erweiterung aus der Rendering-Pipeline entfernt.
Hinweis: Die Instanz ` QSSGRenderExtension ` ist ein Ressourcenobjekt und gehört zum Szenengraphen von ` QtQuick3D `. Wird eine andere Instanz oder `null` zurückgegeben, wird die vorherige Instanz vom Renderer zur Löschung in die Warteschlange gestellt.
Siehe auch „ QSSGRenderExtension “.
© 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.
