En esta página

Qt3DRender::QShaderProgramBuilder Class

class Qt3DRender::QShaderProgramBuilder

Genera el contenido de un programa de sombreado a partir de los gráficos cargados. Más información...

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

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

Propiedades

Funciones públicas

QByteArray computeShaderCode() const
QUrl computeShaderGraph() const
QStringList enabledLayers() const
QByteArray fragmentShaderCode() const
QUrl fragmentShaderGraph() const
QByteArray geometryShaderCode() const
QUrl geometryShaderGraph() const
Qt3DRender::QShaderProgram *shaderProgram() const
QByteArray tessellationControlShaderCode() const
QUrl tessellationControlShaderGraph() const
QByteArray tessellationEvaluationShaderCode() const
QUrl tessellationEvaluationShaderGraph() const
QByteArray vertexShaderCode() const
QUrl vertexShaderGraph() const

Ranuras públicas

void setComputeShaderGraph(const QUrl &computeShaderGraph)
void setEnabledLayers(const QStringList &layers)
void setFragmentShaderGraph(const QUrl &fragmentShaderGraph)
void setGeometryShaderGraph(const QUrl &geometryShaderGraph)
void setShaderProgram(Qt3DRender::QShaderProgram *program)
void setTessellationControlShaderGraph(const QUrl &tessellationControlShaderGraph)
void setTessellationEvaluationShaderGraph(const QUrl &tessellationEvaluationShaderGraph)
void setVertexShaderGraph(const QUrl &vertexShaderGraph)

Señales

void computeShaderCodeChanged(const QByteArray &computeShaderCode)
void computeShaderGraphChanged(const QUrl &computeShaderGraph)
void enabledLayersChanged(const QStringList &layers)
void fragmentShaderCodeChanged(const QByteArray &fragmentShaderCode)
void fragmentShaderGraphChanged(const QUrl &fragmentShaderGraph)
void geometryShaderCodeChanged(const QByteArray &geometryShaderCode)
void geometryShaderGraphChanged(const QUrl &geometryShaderGraph)
void shaderProgramChanged(Qt3DRender::QShaderProgram *shaderProgram)
void tessellationControlShaderCodeChanged(const QByteArray &tessellationControlShaderCode)
void tessellationControlShaderGraphChanged(const QUrl &tessellationControlShaderGraph)
void tessellationEvaluationShaderCodeChanged(const QByteArray &tessellationEvaluationShaderCode)
void tessellationEvaluationShaderGraphChanged(const QUrl &tessellationEvaluationShaderGraph)
void vertexShaderCodeChanged(const QByteArray &vertexShaderCode)
void vertexShaderGraphChanged(const QUrl &vertexShaderGraph)

Descripción detallada

Un generador de programas de sombreado consta de varios gráficos de sombreado diferentes que se utilizan para generar código de sombreado.

Se mantiene una caché del código de sombreador generado. Los sombreadores generados se guardan, por defecto, en QStandardPaths::writableLocation(QStandardPaths::TempLocation)). Esta ruta se puede anular estableciendo la variable de entorno QT3D_WRITABLE_CACHE_PATH en una ruta válida en la que se pueda escribir.

El uso de la caché se puede desactivar configurando la variable de entorno QT3D_DISABLE_SHADER_CACHE.

En la mayoría de los casos, Qt 3D detecta los cambios realizados en un gráfico y se genera una nueva entrada en la caché. Un caso en el que esto no ocurre es cuando se modifican fragmentos de código incluidos en un gráfico. Para solucionarlo, se puede vaciar el directorio de caché o establecer la variable de entorno QT3D_REBUILD_SHADER_CACHE para forzar la regeneración del código del shader.

Documentación de propiedades

[read-only] computeShaderCode : QByteArray

Contiene el código generado del shader de cálculo.

Funciones de acceso:

QByteArray computeShaderCode() const

Señal de notificación:

void computeShaderCodeChanged(const QByteArray &computeShaderCode)

computeShaderGraph : QUrl

Contiene la URL del gráfico de shaders de cálculo que utiliza este generador de programas de shaders.

Funciones de acceso:

QUrl computeShaderGraph() const
void setComputeShaderGraph(const QUrl &computeShaderGraph)

Señal de notificación:

void computeShaderGraphChanged(const QUrl &computeShaderGraph)

enabledLayers : QStringList

Contiene la lista de capas que este generador activará en los gráficos de sombreadores durante la generación de código.

Funciones de acceso:

QStringList enabledLayers() const
void setEnabledLayers(const QStringList &layers)

Señal de notificación:

void enabledLayersChanged(const QStringList &layers)

[read-only] fragmentShaderCode : QByteArray

Contiene el código generado del shader de fragmentos.

Funciones de acceso:

QByteArray fragmentShaderCode() const

Señal de notificación:

void fragmentShaderCodeChanged(const QByteArray &fragmentShaderCode)

fragmentShaderGraph : QUrl

Contiene la URL del gráfico del sombreador de fragmentos utilizado por este generador de programas de sombreado.

Funciones de acceso:

QUrl fragmentShaderGraph() const
void setFragmentShaderGraph(const QUrl &fragmentShaderGraph)

Señal de notificación:

void fragmentShaderGraphChanged(const QUrl &fragmentShaderGraph)

[read-only] geometryShaderCode : QByteArray

Contiene el código generado del shader geométrico.

Funciones de acceso:

QByteArray geometryShaderCode() const

Señal de notificación:

void geometryShaderCodeChanged(const QByteArray &geometryShaderCode)

geometryShaderGraph : QUrl

Contiene la URL del gráfico del shader geométrico que utiliza este generador de programas de shader.

Funciones de acceso:

QUrl geometryShaderGraph() const
void setGeometryShaderGraph(const QUrl &geometryShaderGraph)

Señal de notificación:

void geometryShaderGraphChanged(const QUrl &geometryShaderGraph)

shaderProgram : Qt3DRender::QShaderProgram*

Contiene el programa de sombreado a partir del cual este generador crea el código.

Funciones de acceso:

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

Señal de notificación:

void shaderProgramChanged(Qt3DRender::QShaderProgram *shaderProgram)

[read-only] tessellationControlShaderCode : QByteArray

Contiene el código del shader de control para generar la teselación.

Funciones de acceso:

QByteArray tessellationControlShaderCode() const

Señal de notificación:

void tessellationControlShaderCodeChanged(const QByteArray &tessellationControlShaderCode)

tessellationControlShaderGraph : QUrl

Contiene la URL del gráfico de shaders de control de teselación que utiliza este generador de programas de shaders.

Funciones de acceso:

QUrl tessellationControlShaderGraph() const
void setTessellationControlShaderGraph(const QUrl &tessellationControlShaderGraph)

Señal de notificación:

void tessellationControlShaderGraphChanged(const QUrl &tessellationControlShaderGraph)

[read-only] tessellationEvaluationShaderCode : QByteArray

Contiene el código del shader de evaluación de la teselación generada.

Funciones de acceso:

QByteArray tessellationEvaluationShaderCode() const

Señal de notificación:

void tessellationEvaluationShaderCodeChanged(const QByteArray &tessellationEvaluationShaderCode)

tessellationEvaluationShaderGraph : QUrl

Contiene la URL del gráfico de shaders de evaluación de teselación utilizado por este generador de programas de shaders.

Funciones de acceso:

QUrl tessellationEvaluationShaderGraph() const
void setTessellationEvaluationShaderGraph(const QUrl &tessellationEvaluationShaderGraph)

Señal de notificación:

void tessellationEvaluationShaderGraphChanged(const QUrl &tessellationEvaluationShaderGraph)

[read-only] vertexShaderCode : QByteArray

Contiene el código generado para el shader de vértices.

Funciones de acceso:

QByteArray vertexShaderCode() const

Señal de notificación:

void vertexShaderCodeChanged(const QByteArray &vertexShaderCode)

vertexShaderGraph : QUrl

Contiene la URL del gráfico del sombreador de vértices utilizado por este generador de programas de sombreador.

Funciones de acceso:

QUrl vertexShaderGraph() const
void setVertexShaderGraph(const QUrl &vertexShaderGraph)

Señal de notificación:

void vertexShaderGraphChanged(const QUrl &vertexShaderGraph)

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