En esta página

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:

QSSGRenderTextureProviderExtension

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)

Descripción detallada

Véase también QQuick3DRenderExtension.

Documentación sobre tipos de miembro

enum class QSSGRenderExtension::RenderMode

Especifica el modo de extensión de renderizado.

ConstanteValorDescripción
QSSGRenderExtension::RenderMode::Standalone0El 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::Main1El 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.

ConstanteValorDescripción
QSSGRenderExtension::RenderStage::PreColor0El código de renderizado se graba y se ejecuta antes de la pasada principal (de color).
QSSGRenderExtension::RenderStage::PostColor1El 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.