QShaderDescription Class

Dokumentation der Mitgliedsfunktionen

QShaderDescription::QShaderDescription()

Konstruiert eine neue, leere QShaderDescription.

QShaderDescription::QShaderDescription(const QShaderDescription &other)

Konstruiert eine Kopie von other.

[noexcept] QShaderDescription::~QShaderDescription()

Zerstörer.

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

Gibt die Liste der kombinierten Bild-Sampler zurück

Mit GLSL/Vulkan-Shadern als Quelle erzeugt ein layout(binding = 1) uniform sampler2D tex; uniform folgendes: (hier als textuelles JSON dargestellt)

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

Dies bedeutet nicht, dass andere Sprachversionen des Shaders auch einen kombinierten Bild-Sampler verwenden müssen, insbesondere wenn man bedenkt, dass das Konzept nicht überall existiert. Zum Beispiel wird eine HLSL-Version wahrscheinlich nur ein Texture2D- und 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.

Für einen Compute-Shader mit der folgenden Deklaration gibt die Funktion zum Beispiel { 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 Buildins zurück, die als Eingabe verwendet werden. Bei einem Tessellierungsbewertungs-Shader, der den Wert von gl_TessCoord und gl_Position liest, werden hier beispielsweise TessCoordBuiltin und PositionBuiltin aufgeführt.

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

Gibt die Liste der Eingabevariablen zurück. Dazu gehören Scheitelpunkt-Eingaben (manchmal Attribute genannt) für die Scheitelpunkt-Stufe und Eingaben für andere Stufen (manchmal Variationen genannt).

bool QShaderDescription::isValid() const

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

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

Gibt die Liste der aktiven eingebauten Variablen zurück, die als Eingabe verwendet werden. Ein Vertex-Shader hat z. B. sehr oft 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 dieses QShaderDescription zu 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.

Zum Beispiel, mit 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;

das Folgende erzeugt: (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 werden wahrscheinlich in Compute-Shadern vorkommen. Zum Beispiel erzeugt layout (binding = 0, rgba8) uniform readonly image2D inputImage; das Folgende: (hier als textuelles JSON dargestellt)

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

QShaderDescription::TessellationMode QShaderDescription::tessellationMode() const

Gibt den Tesselation-Ausführungsmodus für ein Tesselation-Steuerelement oder einen Evaluierungs-Shader zurück.

Wenn er nicht festgelegt ist, lautet der Rückgabewert UnknownTessellationMode.

Für einen Tessellierungs-Evaluierungs-Shader mit der folgenden Deklaration gibt die Funktion beispielsweise TrianglesTessellationMode zurück.

layout(triangles) in;

uint QShaderDescription::tessellationOutputVertexCount() const

Gibt die Anzahl der ausgegebenen Scheitelpunkte zurück.

Für einen Tessellation Control Shader mit der folgenden Deklaration gibt die Funktion zum Beispiel 3 zurück.

layout(vertices = 3) out;

QShaderDescription::TessellationPartitioning QShaderDescription::tessellationPartitioning() const

Gibt den Tessellierungs-Partitionierungsmodus für ein Tessellierungs-Steuerelement oder einen Evaluierungs-Shader zurück.

Wenn er nicht festgelegt ist, lautet der Rückgabewert UnknownTessellationPartitioning.

Für einen Tessellierungs-Evaluierungs-Shader mit der folgenden Deklaration gibt die Funktion beispielsweise FractionalOddTessellationPartitioning zurück.

layout(triangles, fractional_odd_spacing, ccw) in;

QShaderDescription::TessellationWindingOrder QShaderDescription::tessellationWindingOrder() const

Gibt die Reihenfolge der Tessellierung für ein Tessellierungs-Steuerelement oder einen Evaluierungs-Shader zurück.

Wenn nicht festgelegt, ist der zurückgegebene Wert UnknownTessellationWindingOrder.

Für einen Tessellierungs-Evaluierungs-Shader mit der folgenden Deklaration gibt die Funktion zum Beispiel 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.