QShaderDescription Class

Documentation des fonctions membres

QShaderDescription::QShaderDescription()

Construit un nouveau QShaderDescription vide.

QShaderDescription::QShaderDescription(const QShaderDescription &other)

Construit une copie de other.

[noexcept] QShaderDescription::~QShaderDescription()

Destructeur.

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

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

Avec les 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 JSON textuel)

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

Cela ne signifie pas que les versions du shader dans d'autres langages doivent également utiliser un échantillonneur d'images combiné, surtout si l'on considère que le concept n'existe pas partout. Par exemple, une version HLSL utilisera probablement un objet Texture2D et SamplerState avec les registres t1 et s1, respectivement.

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

Renvoie la taille locale d'un nuanceur de calcul.

Par exemple, pour un nuanceur de calcul avec 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 nouveau QShaderDescription chargé à partir de stream. version spécifie la version qsb.

Voir aussi serialize().

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

Renvoie la liste des composants actifs utilisés en entrée. Par exemple, un shader d'évaluation de tessellation lisant les valeurs de gl_TessCoord et gl_Position aura TessCoordBuiltin et PositionBuiltin listés ici.

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

Renvoie la liste des variables d'entrée. Cela comprend les entrées du sommet (parfois appelées attributs) pour l'étape du sommet, et les entrées pour les autres étapes (parfois appelées variations).

bool QShaderDescription::isValid() const

Retourne vrai si le site QShaderDescription contient au moins une entrée dans l'une des listes de variables et de blocs.

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

Renvoie la liste des variables intégrées actives utilisées en entrée. Par exemple, un vertex shader aura très souvent PositionBuiltin comme variable intégrée de 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 de poussée.

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

Sérialise ce QShaderDescription en stream. version spécifie la version qsb.

Voir aussi deserialize() et toJson().

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

Renvoie la liste des blocs de stockage de shaders.

Par exemple, avec les 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 seront probablement présentes dans les nuanceurs de calcul. Par exemple, layout (binding = 0, rgba8) uniform readonly image2D inputImage; génère ce qui suit : (présenté ici sous forme de JSON textuel)

"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 contrôle de tessellation ou un nuanceur d'évaluation.

Si elle n'est pas définie, la valeur renvoyée est UnknownTessellationMode.

Par exemple, pour un nuanceur d'évaluation de tessellation avec la déclaration suivante, la fonction renvoie TrianglesTessellationMode.

layout(triangles) in;

uint QShaderDescription::tessellationOutputVertexCount() const

Renvoie le nombre de sommets en sortie.

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

layout(vertices = 3) out;

QShaderDescription::TessellationPartitioning QShaderDescription::tessellationPartitioning() const

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

Si elle n'est pas définie, la valeur renvoyée est UnknownTessellationPartitioning.

Par exemple, pour un nuanceur d'évaluation de tessellation avec 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 de la tessellation pour un contrôle de tessellation ou un nuanceur d'évaluation.

Si elle n'est pas définie, la valeur renvoyée est UnknownTessellationWindingOrder.

Par exemple, pour un nuanceur d'évaluation de tessellation avec la déclaration suivante, la fonction renvoie CcwTessellationWindingOrder.

layout(triangles, fractional_odd_spacing, ccw) in;

QByteArray QShaderDescription::toJson() const

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

Voir aussi serialize().

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

Renvoie la liste des blocs uniformes.

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

Attribue other à cet objet.