QShaderDescription Class

 #version 440

 layout(location = 0) in vec4 position;
 layout(location = 1) in vec3 color;
 layout(location = 0) out vec3 v_color;

 layout(std140, binding = 0) uniform buf {
     mat4 mvp;
     float opacity;
 } ubuf;

 void main()
 {
     v_color = color;
     gl_Position = ubuf.mvp * position;
 }

 {
     "inputs": [
         {
             "location": 1,
             "name": "color",
             "type": "vec3"
         },
         {
             "location": 0,
             "name": "position",
             "type": "vec4"
         }
     ],
     "outputs": [
         {
             "location": 0,
             "name": "v_color",
             "type": "vec3"
         }
     ],
     "uniformBlocks": [
         {
             "binding": 0,
             "blockName": "buf",
             "members": [
                 {
                     "matrixStride": 16,
                     "name": "mvp",
                     "offset": 0,
                     "size": 64,
                     "type": "mat4"
                 },
                 {
                     "name": "opacity",
                     "offset": 64,
                     "size": 4,
                     "type": "float"
                 }
             ],
             "set": 0,
             "size": 68,
             "structName": "ubuf"
         }
     ]
 }

Member Function Documentation

QShaderDescription::QShaderDescription()

Constructs a new, empty QShaderDescription.

QShaderDescription::QShaderDescription(const QShaderDescription &other)

Constructs a copy of other.

[noexcept] QShaderDescription::~QShaderDescription()

Destructor.

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

Returns the list of combined image samplers

With GLSL/Vulkan shaders as source a layout(binding = 1) uniform sampler2D tex; uniform generates the following: (shown as textual JSON here)

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

This does not mean that other language versions of the shader must also use a combined image sampler, especially considering that the concept may not exist everywhere. For instance, a HLSL version will likely just use a Texture2D and SamplerState object with registers t1 and s1, respectively.

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

Returns the local size of a compute shader.

For example, for a compute shader with the following declaration the function returns { 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)

Returns a new QShaderDescription loaded from stream. version specifies the qsb version.

See also serialize().

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

Returns the list of active builtins used as input. For example, a tessellation evaluation shader reading the value of gl_TessCoord and gl_Position will have TessCoordBuiltin and PositionBuiltin listed here.

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

Returns the list of input variables. This includes vertex inputs (sometimes called attributes) for the vertex stage, and inputs for other stages (sometimes called varyings).

bool QShaderDescription::isValid() const

Returns true if the QShaderDescription contains at least one entry in one of the variable and block lists.

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

Returns the list of active built-in variables used as input. For example, a vertex shader will very often have PositionBuiltin as an output built-in.

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

Returns the list of output variables.

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

Returns the list of push constant blocks.

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

Serializes this QShaderDescription to stream. version specifies the qsb version.

See also deserialize() and toJson().

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

Returns the list of shader storage blocks.

For example, with GLSL/Vulkan shaders as source, the declaration

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

generates the following: (shown as textual JSON here)

 "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

Returns the list of image variables.

These will likely occur in compute shaders. For example, layout (binding = 0, rgba8) uniform readonly image2D inputImage; generates the following: (shown as textual JSON here)

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

QShaderDescription::TessellationMode QShaderDescription::tessellationMode() const

Returns the tessellation execution mode for a tessellation control or evaluation shader.

When not set, the returned value is UnknownTessellationMode.

For example, for a tessellation evaluation shader with the following declaration the function returns TrianglesTessellationMode.

 layout(triangles) in;

uint QShaderDescription::tessellationOutputVertexCount() const

Returns the number of output vertices.

For example, for a tessellation control shader with the following declaration the function returns 3.

 layout(vertices = 3) out;

QShaderDescription::TessellationPartitioning QShaderDescription::tessellationPartitioning() const

Returns the tessellation partitioning mode for a tessellation control or evaluation shader.

When not set, the returned value is UnknownTessellationPartitioning.

For example, for a tessellation evaluation shader with the following declaration the function returns FractionalOddTessellationPartitioning.

 layout(triangles, fractional_odd_spacing, ccw) in;

QShaderDescription::TessellationWindingOrder QShaderDescription::tessellationWindingOrder() const

Returns the tessellation winding order for a tessellation control or evaluation shader.

When not set, the returned value is UnknownTessellationWindingOrder.

For example, for a tessellation evaluation shader with the following declaration the function returns CcwTessellationWindingOrder.

 layout(triangles, fractional_odd_spacing, ccw) in;

QByteArray QShaderDescription::toJson() const

Returns a serialized JSON text version of the data.

See also serialize().

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

Returns the list of uniform blocks.

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

Assigns other to this object.