QShaderDescription Class

Documentation sur les fonctions de membre

QShaderDescription::QShaderDescription()

Crée un nouvel objet QShaderDescription vide.

QShaderDescription::QShaderDescription(const QShaderDescription &other)

Crée une copie de other.

[noexcept] QShaderDescription::~QShaderDescription()

Destructeur.

QList<QShaderDescription::InOutVariable> QShaderDescription::combinedImageSamplers() const

Renvoie la liste des échantillonneurs d'images combinés

Avec des shaders GLSL/Vulkan comme source, un uniforme layout(binding = 1) uniform sampler2D tex; génère ce qui suit : (présenté ici sous forme de texte JSON)

"combinedImageSamplers": [
     {
         "binding": 1,
         "name": "tex",
         "set": 0,
         "type": "sampler2D"
     }
 ]

Cela ne signifie pas que les versions du shader écrites dans d’autres langages doivent également utiliser un échantillonneur d’image combiné, d’autant plus que ce concept n’existe pas forcément partout. Par exemple, une version HLSL utilisera probablement simplement un objet `Texture2D` et un objet `SamplerState` avec les registres `t1` et `s1`, respectivement.

std::array<uint, 3> QShaderDescription::computeShaderLocalSize() const

Renvoie la taille locale d'un shader de calcul.

Par exemple, pour un shader de calcul présentant la déclaration suivante, la fonction renvoie { 256, 16, 1}.

layout(local_size_x = 256, local_size_y = 16, local_size_z = 1) in;

[static] QShaderDescription QShaderDescription::deserialize(QDataStream *stream, int version)

Renvoie un nouvel objet ` QShaderDescription ` chargé à partir de stream. ` version ` spécifie la version de qsb.

Voir également serialize().

QList<QShaderDescription::BuiltinVariable> QShaderDescription::inputBuiltinVariables() const

Renvoie la liste des fonctions intégrées actives utilisées en entrée. Par exemple, un shader d’évaluation de tessellation lisant les valeurs de `gl_TessCoord` et `gl_Position` affichera ici les éléments suivants : ` TessCoordBuiltin ` et ` PositionBuiltin `.

QList<QShaderDescription::InOutVariable> QShaderDescription::inputVariables() const

Renvoie la liste des variables d'entrée. Celle-ci comprend les entrées de sommets (parfois appelées « attributs ») pour l'étape des sommets, ainsi que les entrées pour les autres étapes (parfois appelées « variables »).

bool QShaderDescription::isValid() const

Renvoie « true » si l'QShaderDescription ion contient au moins une entrée dans l'une des listes « variable » ou « block ».

QList<QShaderDescription::BuiltinVariable> QShaderDescription::outputBuiltinVariables() const

Renvoie la liste des variables intégrées actives utilisées comme données d'entrée. Par exemple, un shader de sommet aura très souvent la variable intégrée « PositionBuiltin » comme sortie.

QList<QShaderDescription::InOutVariable> QShaderDescription::outputVariables() const

Renvoie la liste des variables de sortie.

QList<QShaderDescription::PushConstantBlock> QShaderDescription::pushConstantBlocks() const

Renvoie la liste des blocs de constantes « push ».

void QShaderDescription::serialize(QDataStream *stream, int version) const

Sérialise cette URL QShaderDescription vers stream. version spécifie la version de qsb.

Voir également deserialize() et toJson().

QList<QShaderDescription::StorageBlock> QShaderDescription::storageBlocks() const

Renvoie la liste des blocs de stockage de shaders.

Par exemple, avec des shaders GLSL/Vulkan comme source, la déclaration

struct Stuff {
    vec2 a;
    vec2 b;
};
layout(std140, binding = 0) buffer StuffSsbo {
    vec4 whatever;
    Stuff stuff[];
} buf;

génère ce qui suit : (présenté ici sous forme de JSON textuel)

"storageBlocks": [ {
    "binding": 0,
    "blockName": "StuffSsbo",
    "instanceName": "buf",
    "knownSize": 16,
    "runtimeArrayStride": 16
    "members": [
        {
            "name": "whatever",
            "offset": 0,
            "size": 16,
            "type": "vec4"
        },
        {
            "arrayDims": [
                0
            ],
            "name": "stuff",
            "offset": 16,
            "size": 0,
            "structMembers": [
                {
                    "name": "a",
                    "offset": 0,
                    "size": 8,
                    "type": "vec2"
                },
                {
                    "name": "b",
                    "offset": 8,
                    "size": 8,
                    "type": "vec2"
                }
            ],
            "type": "struct"
        }
    ],
    "set": 0
} ]

QList<QShaderDescription::InOutVariable> QShaderDescription::storageImages() const

Renvoie la liste des variables d'image.

Celles-ci apparaîtront probablement dans les shaders de calcul. Par exemple, layout (binding = 0, rgba8) uniform readonly image2D inputImage; génère ce qui suit : (présenté ici sous forme de texte JSON)

"storageImages": [
     {
         "binding": 0,
         "imageFormat": "rgba8",
         "name": "inputImage",
         "set": 0,
         "type": "image2D"
     }
 ]

QShaderDescription::TessellationMode QShaderDescription::tessellationMode() const

Renvoie le mode d'exécution de la tessellation pour un shader de contrôle ou d'évaluation de la tessellation.

Si ce paramètre n’est pas défini, la valeur renvoyée est UnknownTessellationMode.

Par exemple, pour un shader d’évaluation de tessellation présentant la déclaration suivante, la fonction renvoie « TrianglesTessellationMode ».

layout(triangles) in;

uint QShaderDescription::tessellationOutputVertexCount() const

Renvoie le nombre de sommets de sortie.

Par exemple, pour un shader de contrôle de tessellation présentant la déclaration suivante, la fonction renvoie 3.

layout(vertices = 3) out;

QShaderDescription::TessellationPartitioning QShaderDescription::tessellationPartitioning() const

Renvoie le mode de partitionnement de tessellation pour un shader de contrôle ou d'évaluation de tessellation.

Si ce paramètre n’est pas défini, la valeur renvoyée est UnknownTessellationPartitioning.

Par exemple, pour un shader d’évaluation de tessellation présentant la déclaration suivante, la fonction renvoie « FractionalOddTessellationPartitioning ».

layout(triangles, fractional_odd_spacing, ccw) in;

QShaderDescription::TessellationWindingOrder QShaderDescription::tessellationWindingOrder() const

Renvoie l'ordre d'enroulement d'une tessellation pour un shader de contrôle ou d'évaluation de tessellation.

Si ce paramètre n’est pas défini, la valeur renvoyée est UnknownTessellationWindingOrder.

Par exemple, pour un shader d’évaluation de tessellation présentant la déclaration suivante, la fonction renvoie « CcwTessellationWindingOrder ».

layout(triangles, fractional_odd_spacing, ccw) in;

QByteArray QShaderDescription::toJson() const

Renvoie une version textuelle JSON sérialisée des données.

Voir également serialize().

QList<QShaderDescription::UniformBlock> QShaderDescription::uniformBlocks() const

Renvoie la liste des blocs uniformes.

QShaderDescription &QShaderDescription::operator=(const QShaderDescription &other)

Attribue la propriété « other » à cet objet.