QShaderDescription Class

成员函数文档

QShaderDescription::QShaderDescription()

构造一个新的、空的 QShaderDescription。

QShaderDescription::QShaderDescription(const QShaderDescription &other)

构造other 的副本。

[noexcept] QShaderDescription::~QShaderDescription()

毁灭者

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

返回组合图像采样器列表

使用 GLSL/Vulkan 着色器作为源，layout(binding = 1) uniform sampler2D tex; uniform 会生成以下内容：(此处显示为文本 JSON）

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

这并不意味着其他语言版本的着色器也必须使用组合图像采样器，尤其是考虑到这一概念可能并不普遍存在。例如，HLSL 版本很可能只使用分别带有寄存器 t1 和 s1 的 Texture2D 和 SamplerState 对象。

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

返回计算着色器的局部大小。

例如，对于声明如下的计算着色器，函数返回 { 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)

返回从stream 加载的新QShaderDescription 。version 指定 qsb 版本。

另请参见 serialize().

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

返回用作输入的活动内置程序列表。例如，读取 gl_TessCoord 和 gl_Position 值的细分曲面评估着色器将在此处列出TessCoordBuiltin 和PositionBuiltin 。

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

返回输入变量列表。这包括顶点阶段的顶点输入（有时称为属性）和其他阶段的输入（有时称为变化）。

bool QShaderDescription::isValid() const

如果QShaderDescription 包含变量和区块列表中的至少一个条目，则返回 true。

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

返回用作输入的活动内置变量列表。例如，顶点着色器通常会将PositionBuiltin 作为输出内置变量。

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

返回输出变量列表。

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

返回推送常量块列表。

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

将QShaderDescription 序列化为stream 。version 指定 qsb 版本。

另请参阅 deserialize() 和toJson()。

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

返回着色器存储块列表。

例如，以 GLSL/Vulkan 着色器为源，声明

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

会生成以下内容：(此处显示为文本 JSON）

"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

返回图像变量列表。

这些变量很可能出现在计算着色器中。例如，layout (binding = 0, rgba8) uniform readonly image2D inputImage; 会生成以下内容：(此处显示为文本 JSON）

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

QShaderDescription::TessellationMode QShaderDescription::tessellationMode() const

返回细分控制或评估着色器的细分执行模式。

未设置时，返回值为UnknownTessellationMode 。

例如，对于具有以下声明的细分评估着色器，函数返回TrianglesTessellationMode 。

layout(triangles) in;

uint QShaderDescription::tessellationOutputVertexCount() const

返回输出顶点的数量。

例如，对于具有以下声明的细分控制着色器，函数返回 3。

layout(vertices = 3) out;

QShaderDescription::TessellationPartitioning QShaderDescription::tessellationPartitioning() const

返回细分控制或评估着色器的细分分割模式。

未设置时，返回值为UnknownTessellationPartitioning 。

例如，对于具有以下声明的细分评估着色器，函数返回FractionalOddTessellationPartitioning 。

layout(triangles, fractional_odd_spacing, ccw) in;

QShaderDescription::TessellationWindingOrder QShaderDescription::tessellationWindingOrder() const

返回细分控制或评估着色器的细分卷绕顺序。

未设置时，返回值为UnknownTessellationWindingOrder 。

例如，对于具有以下声明的细分评估着色器，函数返回CcwTessellationWindingOrder 。

layout(triangles, fractional_odd_spacing, ccw) in;

QByteArray QShaderDescription::toJson() const

返回数据的序列化 JSON 文本版本。

另请参阅 serialize()。

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

返回统一区块列表。

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

为该对象指定other 。