Qt3DRender::QShaderProgramBuilder Class
class Qt3DRender::QShaderProgramBuilderGenera 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.