QQuick3DRenderExtension Class
Clase abstracta para implementar extensiones de renderizado por parte del usuario. Más información...
| Header: | #include <QQuick3DRenderExtension> |
| Since: | Qt 6.7 |
| In QML: | RenderExtension |
| Inherits: | QQuick3DObject |
| Inherited By: |
Funciones públicas reimplementadas
| virtual QSSGRenderGraphObject * | updateSpatialNode(QSSGRenderGraphObject *node) override |
Descripción detallada
Esta es la parte del front-end de una extensión de renderizado. La parte de back-end se implementa en ` QSSGRenderExtension`. La clase `QQuick3DRenderExtension` se utiliza para crear una extensión de renderizado personalizada que se puede emplear en el grafo de escena de ` QtQuick3D `, añadiéndola a la lista de extensiones que se utilizarán con un ` View3D`. A continuación, el código de la extensión se ejecutará como parte de la ejecución del proceso de renderizado de ` QtQuick3D`.
La clase `QQuick3DRenderExtension` es una clase abstracta de la que se debe crear una subclase y que debe exponerse a QML. La subclase debe implementar la función ` QQuick3DRenderExtension::updateSpatialNode()` y devolver una instancia de ` QSSGRenderExtension ` que contenga el código que se debe ejecutar.
Véase también QSSGRenderExtension.
Documentación de las funciones miembro
[override virtual] QSSGRenderGraphObject *QQuick3DRenderExtension::updateSpatialNode(QSSGRenderGraphObject *node)
Esta función se invoca durante la sincronización del grafo de escena de « QtQuick3D » cuando se crea un elemento o cuando se solicita una actualización, normalmente como consecuencia de un cambio en las propiedades del elemento. La función debe devolver una instancia de « QSSGRenderExtension » que contenga el código que debe ejecutarse durante la ejecución del proceso de renderizado de « QtQuick3D ».
El parámetro node es la instancia anterior de QSSGRenderExtension que devolvió esta función, o null si es la primera vez que se llama a la función. La función puede devolver la misma instancia, una instancia diferente o null. Si la función devuelve null, la extensión se eliminará del proceso de renderizado.
Nota: La instancia ` QSSGRenderExtension ` es un objeto de recurso y será propiedad del grafo de escena ` QtQuick3D `. Si se devuelve una instancia diferente, o `null`, el renderizador pondrá la instancia anterior en cola para su eliminación.
Véase también 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.