ShaderProgram QML Type

Encapsule un programme de shader. En savoir plus...

Ce type est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

• Liste de tous les membres, y compris les membres hérités

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 renseignera automatiquement un ensemble d’uniformes par défaut s’ils sont détectés lors de la phase d’introspection du shader.

Prise en charge de RHI

Lors de l'écriture de code de shader GLSL 450 destiné à être utilisé avec le backend RHI d'Qt 3D, les uniformes par défaut seront fournis sous la forme de 2 objets de tampon uniformes.

Leurs emplacements de liaison sont définis sur 0 pour les uniformes RenderView et sur 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 de tampon uniform définis par l’utilisateur, utilisez une liaison à partir de 2 ou « auto » pour laisser Qt 3D déterminer automatiquement la liaison. Veillez à maintenir la cohérence 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 aucun changement à apporter en ce qui concerne la transmission de valeurs aux uniformes.

Pour l’exemple ci-dessus, la définition de myColor pourrait se faire ainsi :

Parameter { name: "myColor"; value: "blue" }

Les textures doivent toujours être définies en tant qu’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 sur les propriétés

computeShaderCode : string

Contient le code du shader de calcul utilisé par ce programme de shader.

computeShaderGraph : string

Contient l'URL du graphe de shaders de calcul utilisé par ce générateur de programmes de shaders.

format : enumeration

Respecte le format du code fourni sur ShaderProgram. La valeur par défaut est ShaderProgram.GLSL

fragmentShaderCode : string

Contient le code du shader de fragment utilisé par ce programme de shader.

fragmentShaderGraph : string

Contient l'URL du graphe de shaders de fragment utilisé par ce générateur de programmes de shaders.

geometryShaderCode : string

Contient le code du shader géométrique utilisé par ce programme de shader.

geometryShaderGraph : string

Contient l'URL du graphe de shaders géométriques utilisé par ce générateur de programmes de shaders.

log : string [read-only]

Contient le journal du programme de shader actuel. Cela s'avère utile pour diagnostiquer un échec de compilation du programme de shader.

status : enumeration [read-only]

Contient l'état du programme de shader actuel.

tessellationControlShaderCode : string

Contient le code du shader de contrôle de tessellation utilisé par ce programme de shader.

tessellationControlShaderGraph : string

Contient l'URL du graphe de shaders de contrôle de tessellation utilisé par ce générateur de programmes de shaders.

tessellationEvaluationShaderCode : string

Contient le code du shader d'évaluation de la tessellation utilisé par ce programme de shader.

tessellationEvaluationShaderGraph : string

Contient l'URL du graphe de shaders d'évaluation de la tessellation utilisé par ce générateur de programmes de shaders.

vertexShaderCode : string

Contient le code du shader de sommets utilisé par ce programme de shader.

vertexShaderGraph : string

Contient l'URL du graphe de shaders de sommets utilisé par ce générateur de programmes de shaders.

Documentation des méthodes

string loadSource(url sourceUrl)

Renvoie le code du shader chargé depuis sourceUrl.