ShaderProgram QML Type
Encapsule un programme d'ombrage. Plus d'informations...
| Import Statement: | import Qt3D.Render 2.10 |
| In C++: | QShaderProgram |
| Status: | Deprecated |
Propriétés
- 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éthodes
- string loadSource(url sourceUrl)
Description détaillée
La classe ShaderProgram encapsule un programme de shaders. Un programme de shaders se compose de plusieurs shaders différents, tels que les shaders de sommets et de fragments.
Qt3D remplira automatiquement un ensemble d'uniformes par défaut s'ils sont rencontrés pendant la phase d'instrospection du shader.
| Uniforme par défaut | Nom du paramètre Qt3D associé | Déclaration GLSL | |||
|---|---|---|---|---|---|
| Matrice de modèle | matriceModèle | mat4 uniforme matriceModèle ; | |||
| Matrice de vue | matriceVue | matrice de vue mat4 uniforme ; | |||
| Matrice de projection | matrice de projection | matrice de projection mat4 uniforme ; | |||
| Matrice de vue du modèle | vue-modèle | mat4 uniforme modelView ; | |||
| Matrice de projection de vue | matrice de projection de vue | matrice uniforme mat4 viewProjectionMatrix ; | |||
| Matrice de projection de la vue-modèle | modelViewProjection mvp | matrice uniforme mat4 modelViewProjection ; matrice uniforme mat4 mvp ; | |||
| Matrice de modèle inverse | matriceModèleInverse | mat4 uniforme inverseModelMatrix ; | |||
| Matrice de vue inversée | inverseViewMatrix | matrice uniforme mat4 inverseViewMatrix ; | |||
| Matrice d'injection inverse | matrice d'injection inverse | matrice uniforme mat4 inverseProjectionMatrix ; | |||
| Matrice inverseModelView | inverseModelView | matrice uniforme mat4 inverseModelView ; | |||
| Matrice d'injection inverseView | Matrice d'injection inverseView | matrice uniforme mat4 inverseViewProjectionMatrix ; | |||
| Matrice d'injection InverseModelView | inverseModelViewProjection | matrice uniforme mat4 inverseViewProjection ; | |||
| Matrice ModèleNormal | matrice modèleNormal | matrice uniforme mat3 modelNormalMatrix ; | |||
| MatriceNormaleModèle | modèleVueNormale | matrice uniforme mat3 modelViewNormal ; | |||
| Matrice de la vue | MatriceVueSurVue | matrice uniforme mat4 viewportMatrix ; | |||
| Matrice d'affichage inverse | matrice inverseViewportMatrix | matrice uniforme mat4 inverseViewportMatrix ; | |||
| AspectRatio (largeur de la surface / hauteur de la surface) | aspectRatio | float uniforme aspectRatio ; | |||
| Exposition | exposition | float uniforme exposure ; | |||
| Gamma | gamma | float uniforme gamma ; | |||
| Temps (en nano secondes) | temps | float uniforme time ; | |||
| Position de l'oeil | position de l'oeil | vec3 uniforme eyePosition ; | |||
| Palette d'habillage | skinningPalette[0] | const int maxJoints = 100 ; uniform mat4 skinningPalette[maxJoints] ; | |||
Support RHI
Lorsque vous écrivez du code de shader GLSL 450 à utiliser avec le backend RHI de Qt 3D, les uniformes par défaut seront fournis sous la forme de 2 objets uniformes tampons.
Les emplacements de liaison pour ceux-ci sont définis sur les liaisons 0 pour les uniformes RenderView et 1 pour les uniformes Command.
#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);
}Pour les objets tampons d'uniformes définis par l'utilisateur, utilisez la liaison commençant par 2 ou auto pour laisser Qt 3D déterminer la liaison automatiquement. Veillez à rester cohérent entre les différentes étapes du shader.
#version 450 core
layout(std140, binding = auto) uniform my_uniforms {
vec4 myColor;
};
layout(location=0) out vec4 fragColor;
void main()
{
fragColor = myColor;
}Il n'y a pas de changement lorsqu'il s'agit d'alimenter les uniformes en valeurs.
Pour l'exemple ci-dessus, la définition de myColor peut être faite avec :
Parameter { name: "myColor"; value: "blue" }Les textures doivent toujours être définies comme des uniformes autonomes.
#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));
}Documentation des propriétés
computeShaderCode : string |
Contient le code du shader de calcul utilisé par ce programme de shader.
computeShaderGraph : string |
Contient l'URL du graphique de calcul des shaders utilisé par ce constructeur de programme de shaders.
format : enumeration |
Indique le format du code fourni sur le site ShaderProgram. La valeur par défaut est ShaderProgram.GLSL.
fragmentShaderCode : string |
Contient le code du nuanceur de fragment utilisé par ce programme de nuanceurs.
fragmentShaderGraph : string |
Contient l'URL du graphique de nuanceur de fragments utilisé par ce constructeur de programmes de nuanceurs.
geometryShaderCode : string |
Contient le code du nuanceur géométrique utilisé par ce programme de nuanceurs.
geometryShaderGraph : string |
Contient l'URL du graphique de nuanceur géométrique utilisé par ce constructeur de programme de nuanceurs.
log : string |
Contient le journal du programme de nuanceur actuel. Il est utile pour diagnostiquer un échec de compilation du programme de shaders.
status : enumeration |
Contient le statut du programme de nuanceur actuel.
tessellationControlShaderCode : string |
Contient le code du shader de contrôle de tesselation utilisé par ce programme de nuanceur.
tessellationControlShaderGraph : string |
Contient l'URL du graphique de shader de contrôle de tesselation utilisé par ce constructeur de programme de shader.
tessellationEvaluationShaderCode : string |
Contient le code du shader d'évaluation de tesselation utilisé par ce programme de shaders.
tessellationEvaluationShaderGraph : string |
Contient l'URL du graphe de shaders d'évaluation de tesselation utilisé par ce constructeur de programmes de shaders.
vertexShaderCode : string |
Contient le code du nuanceur de sommets utilisé par ce programme de nuanceurs.
vertexShaderGraph : string |
Contient l'URL du graphe de nuanceur de sommets utilisé par ce constructeur de programme de nuanceurs.
Documentation de la méthode
© 2025 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.