En esta página

Qt3DRender::QRenderPass Class

class Qt3DRender::QRenderPass

Encapsula un paso de renderizado. Más...

Encabezado: #include <qrenderpass.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
En QML: RenderPass
Heredado de: Qt3DCore::QNode
Estado: Obsoleto

Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.

Propiedades

Funciones públicas

QRenderPass(Qt3DCore::QNode *parent = nullptr)
void addFilterKey(Qt3DRender::QFilterKey *filterKey)
void addParameter(Qt3DRender::QParameter *parameter)
void addRenderState(Qt3DRender::QRenderState *state)
QList<Qt3DRender::QFilterKey *> filterKeys() const
QList<Qt3DRender::QParameter *> parameters() const
void removeFilterKey(Qt3DRender::QFilterKey *filterKey)
void removeParameter(Qt3DRender::QParameter *parameter)
void removeRenderState(Qt3DRender::QRenderState *state)
QList<Qt3DRender::QRenderState *> renderStates() const
Qt3DRender::QShaderProgram *shaderProgram() const

Ranuras públicas

void setShaderProgram(Qt3DRender::QShaderProgram *shaderProgram)

Señales

void shaderProgramChanged(Qt3DRender::QShaderProgram *shaderProgram)

Descripción detallada

Un « Qt3DRender::QRenderPass » especifica una única pasada de renderizado —una instancia de ejecución de un programa de sombreado— utilizada por « Qt3DRender::QTechnique ». La pasada de renderizado consta de un « Qt3DRender::QShaderProgram » y una lista de objetos « Qt3DRender::QFilterKey », una lista de objetos « Qt3DRender::QRenderState » y una lista de objetos « Qt3DRender::QParameter ».

QRenderPass ejecuta el QShaderProgram utilizando los nodos QRenderState y QParameter proporcionados cuando al menos uno de los nodos QFilterKey a los que se hace referencia coincide con cualquiera de los nodos QFilterKey de QRenderPassFilter o cuando no se especifican nodos QFilterKey y no hay ningún QRenderPassFilter presente en el FrameGraph.

Si el QRenderPass define un ` QParameter`, este quedará anulado por un ` QParameter ` con el mismo nombre si existe en cualquiera de los ` QTechnique`, ` QEffect`, ` QMaterial`, ` QTechniqueFilter` o ` QRenderPassFilter ` asociados al paso en tiempo de ejecución. Esto puede resultar útil para definir valores predeterminados razonables.

En el momento del renderizado, para cada nodo hoja del FrameGraph se registra un estado de renderizado base mediante la acumulación de los estados definidos por todos los nodos QRenderStateSet de la rama del FrameGraph. Cada QRenderPass puede sobrescribir este estado de renderizado base especificando sus propios nodos QRenderState.

// Create the render passes
QRenderPass *pass = new QRenderPass();

// Create shader program
QShaderProgram *glShader = new QShaderProgram();

// Set the shader on the render pass
pass->setShaderProgram(glShader);

// Create a FilterKey
QFilterKey *filterKey = new QFilterKey();
filterKey->setName(QStringLiteral("name"));
fitlerKey->setValue(QStringLiteral("zFillPass"));

// Add the FilterKey to the pass
pass->addFilterKey(filterKey);

// Create a QParameter
QParameter *colorParameter = new QParameter(QStringLiteral("color"), QColor::fromRgbF(0.0f, 0.0f, 1.0f, 1.0f));

// Add parameter to pass
pass->addParameter(colorParameter);

// Create a QRenderState
QDepthTest *depthTest = new QDepthTest();

// Add the render state to the pass
pass->addRenderState(depthTest);

Véase también QRenderPassFilter, QFilterKey, QParameter, QRenderState, QEffect y QTechnique.

Documentación sobre la propiedad

shaderProgram : Qt3DRender::QShaderProgram*

Especifica el programa de sombreado que se utilizará para esta pasada de renderizado.

Funciones de acceso:

Qt3DRender::QShaderProgram *shaderProgram() const
void setShaderProgram(Qt3DRender::QShaderProgram *shaderProgram)

Señal de notificación:

void shaderProgramChanged(Qt3DRender::QShaderProgram *shaderProgram)

Documentación de funciones de miembro

[explicit] QRenderPass::QRenderPass(Qt3DCore::QNode *parent = nullptr)

Crea un nuevo objeto `QRenderPass` con el ` parent` especificado.

void QRenderPass::addFilterKey(Qt3DRender::QFilterKey *filterKey)

Añade « filterKey » a las claves de filtro local « Qt3DRender::QRenderPass ».

void QRenderPass::addParameter(Qt3DRender::QParameter *parameter)

Añade « parameter » a los parámetros del paso de renderizado.

void QRenderPass::addRenderState(Qt3DRender::QRenderState *state)

Añade un estado de renderizado ( state ) a la pasada de renderizado. Esto implica que, cuando se ejecute la pasada en el momento del renderizado, el estado de renderizado establecido globalmente se verá modificado por los estados definidos localmente por el ` Qt3DRender::QRenderPass`.

Nota: si no se define ningún `Qt3DRender::QRenderState` en un paso, este utilizará el estado de renderizado establecido globalmente para una ruta de ejecución determinada de la rama del `FrameGraph`.

QList<Qt3DRender::QFilterKey *> QRenderPass::filterKeys() const

Devuelve la lista de objetos clave `Qt3DRender::QFilterKey` que conforman las claves de filtro de ` Qt3DRender::QRenderPass`.

QList<Qt3DRender::QParameter *> QRenderPass::parameters() const

Devuelve un vector con los parámetros actuales de la pasada de renderizado

void QRenderPass::removeFilterKey(Qt3DRender::QFilterKey *filterKey)

Elimina « filterKey » de las claves de filtro locales de « Qt3DRender::QRenderPass ».

void QRenderPass::removeParameter(Qt3DRender::QParameter *parameter)

Elimina « parameter » de los parámetros de la pasada de renderizado.

void QRenderPass::removeRenderState(Qt3DRender::QRenderState *state)

Elimina « state » del estado de renderizado local de « Qt3DRender::QRenderPass ».

QList<Qt3DRender::QRenderState *> QRenderPass::renderStates() const

Devuelve la lista de objetos de estado `Qt3DRender::QRenderState` que conforman el estado de renderizado de ` Qt3DRender::QRenderPass`.

Elementos no miembros relacionados

[alias] ParameterList

Una lista de los parámetros de Qt3DRender::QParameter.

© 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.