Qt3DRender::QRenderPass Class
class Qt3DRender::QRenderPassEncapsula 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
- shaderProgram : Qt3DRender::QShaderProgram*
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) |
Elementos no miembros relacionados
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`.
© 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.