ShaderProgram QML Type
Encapsula un programa de sombreado. Más...
| Import Statement: | import Qt3D.Render 2.12 |
| In C++: | QShaderProgram |
| Status: | Deprecated |
Este tipo está obsoleto. Recomendamos encarecidamente no utilizarlo en código nuevo.
Propiedades
- computeShaderCode : string
- computeShaderGraph : string
- format : enumeration
- fragmentShaderCode : string
- fragmentShaderGraph : string
- geometryShaderCode : string
- geometryShaderGraph : string
- log : string
- status : enumeration
- tessellationControlShaderCode : string
- tessellationControlShaderGraph : string
- tessellationEvaluationShaderCode : string
- tessellationEvaluationShaderGraph : string
- vertexShaderCode : string
- vertexShaderGraph : string
Métodos
- string loadSource(url sourceUrl)
Descripción detallada
La clase `ShaderProgram` encapsula un programa de sombreado. Un programa de sombreado consta de varios sombreadores diferentes, como los sombreadores de vértices y de fragmentos.
Qt3D rellenará automáticamente un conjunto de uniformes predeterminados si los encuentra durante la fase de introspección del sombreador.
| Uniforme predeterminado | Nombre del parámetro Qt3D asociado | Declaración GLSL | |||
|---|---|---|---|---|---|
| ModelMatrix | modelMatrix | uniform mat4 modelMatrix; | |||
| ViewMatrix | viewMatrix | uniform mat4 viewMatrix; | |||
| Matriz de proyección | matriz de proyección | uniform mat4 matrizDeProyección; | |||
| Matriz de vista del modelo | modelView | uniform mat4 modelView; | |||
| matriz de proyección de vista | matrizDeProyecciónDeVista | uniform mat4 matrizDeProyecciónDeVista; | |||
| Matriz de modelo-vista-proyección | modelViewProjection mvp | uniform mat4 modelViewProjection; uniform mat4 mvp; | |||
| Matriz inversa del modelo | matrizInversaDelModelo | uniform mat4 inverseModelMatrix; | |||
| Matriz de vista inversa | matriz de vista inversa | uniform mat4 matrizInversaDeVista; | |||
| Matriz de proyección inversa | matriz de proyección inversa | uniform mat4 matriz de proyección inversa; | |||
| Matriz de vista del modelo inversa | inverseModelView | uniform mat4 inverseModelView; | |||
| Matriz de proyección inversa de la vista | matriz inversa de proyección de vista | uniform mat4 matriz de proyección inversa de vista; | |||
| Matriz de proyección inversa de ModelView | matriz inversa de la proyección del modelo-vista | uniform mat4 inversa de la matriz de proyección del modelo-vista; | |||
| MatrizNormalDelModelo | matrizNormalDelModelo | uniform mat3 matrizNormalDelModelo; | |||
| MatrizNormalVistaModelo | modelViewNormal | uniform mat3 modelViewNormal; | |||
| Matriz de ventana gráfica | matriz de ventana gráfica | uniform mat4 matrizDeVentana; | |||
| Matriz inversa de la ventana gráfica | inverseViewportMatrix | uniform mat4 inverseViewportMatrix; | |||
| AspectRatio (anchura de la superficie / altura de la superficie) | aspectRatio | uniform float relación de aspecto; | |||
| Exposición | exposición | uniform float exposición; | |||
| Gamma | gamma | gamma uniforme en coma flotante; | |||
| Tiempo (en nanosegundos) | tiempo | tiempo uniforme de tipo flotante; | |||
| EyePosition | eyePosition | uniform vec3 posiciónDelOjo; | |||
| Paleta de texturizado | skinningPalette[0] | const int maxJoints = 100; uniform mat4 skinningPalette[maxJoints]; | |||
Compatibilidad con RHI
Al escribir código de sombreador GLSL 450 para utilizarlo con el backend RHI de Qt 3D, las uniformes predeterminadas se proporcionarán como 2 objetos de búfer uniformes.
Las ubicaciones de enlace para estos se establecen en el enlace 0 para los uniformes de RenderView y en el 1 para los uniformes de comando.
#version 450 core
layout(location = 0) in vec3 vertexPosition;
layout(std140, binding = 0) uniform qt3d_render_view_uniforms {
mat4 viewMatrix;
mat4 projectionMatrix;
mat4 uncorrectedProjectionMatrix;
mat4 clipCorrectionMatrix;
mat4 viewProjectionMatrix;
mat4 inverseViewMatrix;
mat4 inverseProjectionMatrix;
mat4 inverseViewProjectionMatrix;
mat4 viewportMatrix;
mat4 inverseViewportMatrix;
vec4 textureTransformMatrix;
vec3 eyePosition;
float aspectRatio;
float gamma;
float exposure;
float time;
float yUpInNDC;
float yUpInFBO;
};
layout(std140, binding = 1) uniform qt3d_command_uniforms {
mat4 modelMatrix;
mat4 inverseModelMatrix;
mat4 modelViewMatrix;
mat3 modelNormalMatrix;
mat4 inverseModelViewMatrix;
mat4 modelViewProjection;
mat4 inverseModelViewProjectionMatrix;
};
void main()
{
gl_Position = (projectionMatrix * viewMatrix * modelMatrix * vertexPosition);
}Para los objetos de búfer de uniformes definidos por el usuario, utiliza una vinculación a partir del 2 o «auto» para que Qt 3D determine la vinculación automáticamente. Asegúrate de mantener la coherencia entre las diferentes etapas del shader.
#version 450 core
layout(std140, binding = auto) uniform my_uniforms {
vec4 myColor;
};
layout(location=0) out vec4 fragColor;
void main()
{
fragColor = myColor;
}No hay ningún cambio en lo que respecta a la asignación de valores a los uniformes.
Para el ejemplo anterior, la configuración de myColor podría realizarse de la siguiente manera:
Parameter { name: "myColor"; value: "blue" }Las texturas deben seguir definiéndose como uniformes independientes.
#version 450 core
layout(binding=0) uniform sampler2D source;
layout(location=0) out vec4 fragColor;
void main()
{
fragColor = texture(source, vec2(0.5, 0.5));
}Documentación de propiedades
computeShaderCode : string
Contiene el código del shader de cálculo utilizado por este programa de shader.
computeShaderGraph : string
Contiene la URL del gráfico de shaders de cálculo que utiliza este generador de programas de shaders.
format : enumeration
Sigue el formato del código proporcionado en ShaderProgram. El valor por defecto es ShaderProgram.GLSL
fragmentShaderCode : string
Contiene el código del shader de fragmentos que utiliza este programa de shader.
fragmentShaderGraph : string
Contiene la URL del gráfico del shader de fragmentos utilizado por este generador de programas de shader.
geometryShaderCode : string
Contiene el código del sombreador geométrico que utiliza este programa de sombreado.
geometryShaderGraph : string
Contiene la URL del gráfico de shaders geométricos que utiliza este generador de programas de shaders.
log : string [read-only]
Contiene el registro del programa de sombreado actual. Esto resulta útil para diagnosticar un error de compilación del programa de sombreado.
status : enumeration [read-only]
Contiene el estado del programa de sombreado actual.
tessellationControlShaderCode : string
Contiene el código del shader de control de teselación que utiliza este programa de shader.
tessellationControlShaderGraph : string
Contiene la URL del gráfico de shaders del control de teselación que utiliza este generador de programas de shaders.
tessellationEvaluationShaderCode : string
Contiene el código del shader de evaluación de teselación utilizado por este programa de shader.
tessellationEvaluationShaderGraph : string
Contiene la URL del gráfico de shaders de evaluación de teselación que utiliza este generador de programas de shaders.
vertexShaderCode : string
Contiene el código del sombreador de vértices utilizado por este programa de sombreado.
vertexShaderGraph : string
Contiene la URL del gráfico del sombreador de vértices utilizado por este generador de programas de sombreado.
Documentación de métodos
string loadSource(url sourceUrl)
Devuelve el código del shader cargado desde sourceUrl.
© 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.