QSSGRenderExtension Class
Clase base para las implementaciones de nodos de backend de extensión. Más...
| Header: | #include <qssgrenderextensions.h> |
| Since: | Qt 6.7 |
| Inherited By: |
Tipos públicos
| enum class | RenderMode { Standalone, Main } |
| enum class | RenderStage { PreColor, PostColor } |
Funciones públicas
| virtual QSSGRenderExtension::RenderMode | mode() const = 0 |
| virtual bool | prepareData(QSSGFrameData &data) = 0 |
| virtual void | prepareRender(QSSGFrameData &data) = 0 |
| virtual void | render(QSSGFrameData &data) = 0 |
| virtual void | resetForFrame() = 0 |
| virtual QSSGRenderExtension::RenderStage | stage() const = 0 |
Funciones protegidas
| QSSGRenderExtension(QSSGRenderGraphObject::Type inType, QSSGRenderGraphObject::FlagT inFlags) |
Véase también QQuick3DRenderExtension.
Documentación sobre tipos de miembro
enum class QSSGRenderExtension::RenderMode
Especifica el modo de extensión de renderizado.
| Constante | Valor | Descripción |
|---|---|---|
QSSGRenderExtension::RenderMode::Standalone | 0 | El código de renderizado se graba íntegramente durante la fase de preparación del renderizado. Esto suele implicar que ya se ha generado algún resultado para una o varias extensiones de renderizado anteriores. Cuando se utiliza este modo, las funciones ` prepareRender()` y ` render()` se invocan ambas durante la fase de preparación del fotograma. |
QSSGRenderExtension::RenderMode::Main | 1 | El código de renderizado se registra dentro de la pasada de renderizado principal. En este modo, se llama a prepareRender() en la fase de preparación del fotograma, mientras que render() se llama en la fase de renderizado del fotograma. |
enum class QSSGRenderExtension::RenderStage
Especifica el orden en el que se llamará a la extensión.
| Constante | Valor | Descripción |
|---|---|---|
QSSGRenderExtension::RenderStage::PreColor | 0 | El código de renderizado se graba y se ejecuta antes de la pasada principal (de color). |
QSSGRenderExtension::RenderStage::PostColor | 1 | El código de renderizado se graba y se ejecuta después de la pasada principal (de color). Nota: La etapa de renderizado (RenderStage) solo es relevante cuando la opción « RenderMode » está configurada en « Main ». |
Documentación de las funciones de miembro
[protected] QSSGRenderExtension::QSSGRenderExtension(QSSGRenderGraphObject::Type inType, QSSGRenderGraphObject::FlagT inFlags)
Constructor que permite a los usuarios especificar un tipo de usuario y unos indicadores para una extensión.
Nota: Para las extensiones definidas por el usuario, el tipo debe ser una combinación de `QSSGRenderGraphObject::BaseType::User` y un valor comprendido entre 0 y 4095.
Nota: El tipo QSSGRenderGraphObject::BaseType::Extension se añade automáticamente al inType especificado.
Nota: El ` inFlags ` debe incluir `Flags::HasGraphicsResources` si la extensión asigna recursos gráficos.
[pure virtual] QSSGRenderExtension::RenderMode QSSGRenderExtension::mode() const
Devuelve el modo de representación utilizado para esta extensión.
[pure virtual] bool QSSGRenderExtension::prepareData(QSSGFrameData &data)
Se invoca una vez que se ha recopilado el ` data ` de la escena, pero antes de que se hayan procesado los datos de renderizado o se haya realizado el renderizado del fotograma actual.
Devuelve el estado «Dirty». Devuelve « true » si hay datos modificados que deben renderizarse.
Nota: Gran parte de los datos creados o recopilados por el motor durante las fases de preparación y renderizado son específicos de cada fotograma y deben liberarse, o darse por liberados, al inicio del siguiente fotograma
Véase también ` QSSGFrameData`.
[pure virtual] void QSSGRenderExtension::prepareRender(QSSGFrameData &data)
Preparar los datos para el renderizado. Generar y recopilar los datos de « data » necesarios para el renderizado. Cualquier extensión de renderizado programada antes de esta ya se habrá procesado. Además, cualquier extensión de renderizado en modo « RenderMode::Standalone », si se ha ejecutado correctamente, se habrá completado en su totalidad.
Nota: Gran parte de los datos creados o recopilados del motor durante las fases de preparación y renderizado son específicos de cada fotograma y deben liberarse o darse por liberados al inicio del siguiente fotograma
Véase también QSSGFrameData.
[pure virtual] void QSSGRenderExtension::render(QSSGFrameData &data)
Graba la pasada de renderizado. Dependiendo de las extensiones mode, esta función se invocará durante la fase de preparación o de renderizado del fotograma.
Utiliza data para acceder al contexto de renderizado desde el que se puede consultar el objeto QRhi activo.
Véase también QSSGRenderExtension::RenderMode.
[pure virtual] void QSSGRenderExtension::resetForFrame()
Se ejecuta cada vez que comienza un nuevo fotograma. En este momento deben borrarse todos los datos del fotograma anterior.
[pure virtual] QSSGRenderExtension::RenderStage QSSGRenderExtension::stage() const
Devuelve la etapa en la que se utilizará esta extensión de renderizado.
© 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.