QShaderDescription Class

Dokumentation zu Member-Funktionen

QShaderDescription::QShaderDescription()

Erstellt eine neue, leere `QShaderDescription`.

QShaderDescription::QShaderDescription(const QShaderDescription &other)

Erstellt eine Kopie von „ other “.

[noexcept] QShaderDescription::~QShaderDescription()

Destruktor.

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

Gibt die Liste der kombinierten Bild-Sampler zurück

Bei GLSL-/Vulkan-Shadern als Quelle erzeugt ein Uniform vom Typ „ layout(binding = 1) uniform sampler2D tex; “ Folgendes: (hier als JSON-Text dargestellt)

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

Dies bedeutet nicht, dass auch andere Sprachversionen des Shaders einen kombinierten Bild-Sampler verwenden müssen, zumal dieses Konzept möglicherweise nicht überall existiert. Eine HLSL-Version würde beispielsweise wahrscheinlich lediglich ein `Texture2D`- und ein `SamplerState`-Objekt mit den Registern `t1` bzw. `s1` verwenden.

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

Gibt die lokale Größe eines Compute-Shaders zurück.

Beispielsweise gibt die Funktion für einen Compute-Shader mit der folgenden Deklaration den Wert { 256, 16, 1} zurück.

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

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

Gibt ein neues „ QShaderDescription “ zurück, das von stream geladen wurde. „ version “ gibt die QSB-Version an.

Siehe auch serialize().

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

Gibt die Liste der aktiven Builtins zurück, die als Eingabe verwendet werden. Beispielsweise werden bei einem Shader zur Tessellationsauswertung, der die Werte von `gl_TessCoord` und `gl_Position` ausliest, hier ` TessCoordBuiltin ` und ` PositionBuiltin ` aufgeführt.

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

Gibt die Liste der Eingabevariablen zurück. Dazu gehören Vertex-Eingaben (manchmal auch als „Attribute“ bezeichnet) für die Vertex-Stufe sowie Eingaben für andere Stufen (manchmal auch als „Varyings“ bezeichnet).

bool QShaderDescription::isValid() const

Gibt „true“ zurück, wenn die „ QShaderDescription “ mindestens einen Eintrag in einer der Variablen- oder Blocklisten enthält.

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

Gibt die Liste der aktiven integrierten Variablen zurück, die als Eingabe verwendet werden. Beispielsweise verfügt ein Vertex-Shader sehr häufig über „ PositionBuiltin “ als integrierte Ausgabevariable.

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

Gibt die Liste der Ausgabevariablen zurück.

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

Gibt die Liste der Push-Konstantenblöcke zurück.

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

Serialisiert „ QShaderDescription “ in „ stream “. „ version “ gibt die QSB-Version an.

Siehe auch deserialize() und toJson().

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

Gibt die Liste der Shader-Speicherblöcke zurück.

Beispiel: Bei GLSL-/Vulkan-Shadern als Quelle erzeugt die Deklaration

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

Folgendes: (hier als textuelles JSON dargestellt)

"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

Gibt die Liste der Bildvariablen zurück.

Diese kommen wahrscheinlich in Compute-Shadern vor. Beispielsweise erzeugt layout (binding = 0, rgba8) uniform readonly image2D inputImage; Folgendes: (hier als JSON-Text dargestellt)

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

QShaderDescription::TessellationMode QShaderDescription::tessellationMode() const

Gibt den Tessellationsausführungsmodus für einen Tessellationssteuerungs- oder Auswertungs-Shader zurück.

Ist dieser nicht festgelegt, lautet der Rückgabewert „ UnknownTessellationMode “.

Beispielsweise gibt die Funktion für einen Tessellationsauswertungs-Shader mit der folgenden Deklaration „ TrianglesTessellationMode “ zurück.

layout(triangles) in;

uint QShaderDescription::tessellationOutputVertexCount() const

Gibt die Anzahl der Ausgangs-Eckpunkte zurück.

Beispielsweise gibt die Funktion bei einem Tessellations-Control-Shader mit der folgenden Deklaration den Wert 3 zurück.

layout(vertices = 3) out;

QShaderDescription::TessellationPartitioning QShaderDescription::tessellationPartitioning() const

Gibt den Tessellations-Partitionierungsmodus für einen Tessellations-Steuer- oder Auswertungs-Shader zurück.

Ist dieser nicht festgelegt, lautet der Rückgabewert „ UnknownTessellationPartitioning “.

Beispielsweise gibt die Funktion für einen Tessellationsauswertungs-Shader mit der folgenden Deklaration „ FractionalOddTessellationPartitioning “ zurück.

layout(triangles, fractional_odd_spacing, ccw) in;

QShaderDescription::TessellationWindingOrder QShaderDescription::tessellationWindingOrder() const

Gibt die Tessellations-Winding-Reihenfolge für einen Tessellations-Steuer- oder Auswertungs-Shader zurück.

Ist dieser Parameter nicht festgelegt, lautet der Rückgabewert „ UnknownTessellationWindingOrder “.

Beispielsweise gibt die Funktion für einen Tessellationsauswertungs-Shader mit der folgenden Deklaration „ CcwTessellationWindingOrder “ zurück.

layout(triangles, fractional_odd_spacing, ccw) in;

QByteArray QShaderDescription::toJson() const

Gibt eine serialisierte JSON-Textversion der Daten zurück.

Siehe auch ` serialize()`.

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

Gibt die Liste der einheitlichen Blöcke zurück.

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

Weist diesem Objekt „ other “ zu.