SPIR-V Non-Semantic Clspv Reflection Instructions

Kernel

Declares a shader entry-point generated by clspv.

Kernel must be an OpFunction that is declared as a GLCompute entry-point.

Name must be an OpString specifying the name of the entry-point. Name must match an entry-point name for Kernel.

NumArguments must be a 32-bit unsigned integer OpConstant specifying the number of arguments to the kernel function. Unused kernel arguments may not appear in subsequent reflection instructions. This operand is missing before version 5.

Flags must be a 32-bit unsigned integer OpConstant with a value combining one or more of the values from the Kernel Property Flags bit field. This operand is missing before version 5.

Attributes must be an OpString. If the kernel was created from OpenCL C source, Attributes must containing a space delimited list of attributes specified for the entry-point using the __attribute__ OpenCL C qualifier. Attributes must be spelled as they are declared inside the OpenCL C attribute qualifier with any surrounding whitespace and embedded newlines removed. These attributes include attributes described in the OpenCL C kernel language specification and other attributes supported by the implementation. If the kernel was not created from OpenCL C source then Attributes must be an empty string. This operand is missing before version 5.

1

<id>
Kernel

<id>
Name

<id>
NumArguments

<id>
Flags

<id>
Attributes

ArgumentInfo

The operands in this instruction are suitable for return from clGetKernelArgInfo.

Name must be an OpString specifying the name of the kernel argument.

TypeName must be an OpString specifying the type of the kernel argument.

AddressQualifier must be a 32-bit unsigned integer OpConstant specifying the address space enum value of the kernel argument.

AccessQualifier must be a 32-bit unsigned integer OpConstant specifying the access qualifier enum value of the kernel argument.

TypeQualifier must be a 32-bit unsigned integer OpConstant specifying the type qualifier enum value of the kernel argument.

2

<id>
Name

Optional
<id>
TypeName

Optional
<id>
AddressQualifier

Optional
<id>
AccessQualifier

Optional
<id>
TypeQualifier

ArgumentStorageBuffer

Declares a StorageBuffer argument for Kernel. The Vulkan descriptor type should use VK_DESCRIPTOR_TYPE_STORAGE_BUFFER.

Kernel must be a Kernel extended instruction from the same import.

Ordinal must be a 32-bit unsigned integer OpConstant specifying the argument ordinal using zero-based counting.

DescriptorSet must be a 32-bit unsigned integer OpConstant specifying the descriptor set.

Binding must be a 32-bit unsigned integer OpConstant specifying the binding.

ArgInfo must be an ArgumentInfo extended instruction from the same import.

3

<id>
Kernel

<id>
Ordinal

<id>
DescriptorSet

<id>
Binding

Optional
<id>
ArgInfo

ArgumentUniform

Declares a Uniform buffer argument for Kernel. The Vulkan descriptor type should use VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER.

Kernel must be a Kernel extended instruction from the same import.

Ordinal must be a 32-bit unsigned integer OpConstant specifying the argument ordinal using zero-based counting.

DescriptorSet must be a 32-bit unsigned integer OpConstant specifying the descriptor set.

Binding must be a 32-bit unsigned integer OpConstant specifying the binding.

ArgInfo must be an ArgumentInfo extended instruction from the same import.

4

<id>
Kernel

<id>
Ordinal

<id>
DescriptorSet

<id>
Binding

Optional
<id>
ArgInfo

ArgumentPodStorageBuffer

Declares a StorageBuffer plain-old-data argument for Kernel. The Vulkan descriptor type should use VK_DESCRIPTOR_TYPE_STORAGE_BUFFER. This argument may share a descriptor set and binding with other plain-old-data arguments.

Kernel must be a Kernel extended instruction from the same import.

Ordinal must be a 32-bit unsigned integer OpConstant specifying the argument ordinal using zero-based counting.

DescriptorSet must be a 32-bit unsigned integer OpConstant specifying the descriptor set.

Binding must be a 32-bit unsigned integer OpConstant specifying the binding.

Offset must be a 32-bit unsigned integer OpConstant specifying the offset in the block in bytes.

Size must be a 32-bit unsigned integer OpConstant specifying the size of the argument in bytes.

ArgInfo must be a ArgumentInfo extended instruction from the same import.

5

<id>
Kernel

<id>
Ordinal

<id>
DescriptorSet

<id>
Binding

<id>
Offset

<id>
Size

Optional
<id>
ArgInfo

ArgumentPodUniform

Declares a Uniform buffer plain-old-data argument for Kernel. The Vulkan descriptor type should use VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER. This argument may share a descriptor set and binding with other plain-old-data arguments.

Kernel must be a Kernel extended instruction from the same import.

Ordinal must be a 32-bit unsigned integer OpConstant specifying the argument ordinal using zero-based counting.

DescriptorSet must be a 32-bit unsigned integer OpConstant specifying the descriptor set.

Binding must be a 32-bit unsigned integer OpConstant specifying the binding.

Offset must be a 32-bit unsigned integer OpConstant specifying the offset in the block in bytes.

Size must be a 32-bit unsigned integer OpConstant specifying the size of the argument in bytes.

ArgInfo must be an ArgumentInfo extended instruction from the same import.

6

<id>
Kernel

<id>
Ordinal

<id>
DescriptorSet

<id>
Binding

<id>
Offset

<id>
Size

Optional
<id>
ArgInfo

ArgumentPodPushConstant

Declares a PushConstant plain-old-data argument for Kernel. This argument’s offset and size should be included in the push constant range declared for this kernel using the VK_SHADER_STAGE_COMPUTE_BIT flag bit.

Kernel must be a Kernel extended instruction from the same import.

Ordinal must be a 32-bit unsigned integer OpConstant specifying the argument ordinal using zero-based counting.

Offset must be a 32-bit unsigned integer OpConstant specifying the offset in the block in bytes.

Size must be a 32-bit unsigned integer OpConstant specifying the size of the argument in bytes.

ArgInfo must be an ArgumentInfo extended instruction from the same import.

7

<id>
Kernel

<id>
Ordinal

<id>
Offset

<id>
Size

Optional
<id>
ArgInfo

ArgumentSampledImage

Declares a sampled image (OpTypeImage with Sampled operand of 1) argument for Kernel. The Vulkan descriptor type should use VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE.

Kernel must be a Kernel extended instruction from the same import.

Ordinal must be a 32-bit unsigned integer OpConstant specifying the argument ordinal using zero-based counting.

DescriptorSet must be a 32-bit unsigned integer OpConstant specifying the descriptor set.

Binding must be a 32-bit unsigned integer OpConstant specifying the binding.

ArgInfo must be an ArgumentInfo extended instruction from the same import.

8

<id>
Kernel

<id>
Ordinal

<id>
DescriptorSet

<id>
Binding

Optional
<id>
ArgInfo

ArgumentStorageImage

Declares a storage image (OpTypeImage with Sampled operand of 2) argument for Kernel. The Vulkan descriptor type should use VK_DESCRIPTOR_TYPE_STORAGE_IMAGE.

Kernel must be a Kernel extended instruction from the same import.

Ordinal must be a 32-bit unsigned integer OpConstant specifying the argument ordinal using zero-based counting.

DescriptorSet must be a 32-bit unsigned integer OpConstant specifying the descriptor set.

Binding must be a 32-bit unsigned integer OpConstant specifying the binding.

ArgInfo must be an ArgumentInfo extended instruction from the same import.

9

<id>
Kernel

<id>
Ordinal

<id>
DescriptorSet

<id>
Binding

Optional
<id>
ArgInfo

ArgumentSampler

Declares a sampler argument for Kernel. The Vulkan descriptor type should use VK_DESCRIPTOR_TYPE_SAMPELR.

Kernel must be a Kernel extended instruction from the same import.

Ordinal must be a 32-bit unsigned integer OpConstant specifying the argument ordinal using zero-based counting.

DescriptorSet must be a 32-bit unsigned integer OpConstant specifying the descriptor set.

Binding must be a 32-bit unsigned integer OpConstant specifying the binding.

ArgInfo must be an ArgumentInfo extended instruction from the same import.

10

<id>
Kernel

<id>
Ordinal

<id>
DescriptorSet

<id>
Binding

Optional
<id>
ArgInfo

ArgumentWorkgroup

Declares a workgroup buffer argument for Kernel. This argument is instantiated as Workgroup storage-class array. It should be sized using the SpecId operand. The size of the array elements is indicated by the ElemSize operand.

Kernel must be a Kernel extended instruction from the same import.

Ordinal must be a 32-bit unsigned integer OpConstant specifying the argument ordinal using zero-based counting.

SpecId must be a 32-bit unsigned integer OpConstant specifying the specialization id used to size the argument.

ElemSize must be a 32-bit unsigned integer OpConstant specifying the element size of the argument in bytes.

ArgInfo must be an ArgumentInfo extended instruction from the same import.

11

<id>
Kernel

<id>
Ordinal

<id>
SpecId

<id>
ElemSize

Optional
<id>
ArgInfo

SpecConstantWorkgroupSize

Declares the specialization ids used to set the WorkgroupSize builtin.

X must be a 32-bit unsigned integer OpConstant specifying the specialization id of the x dimension.

Y must be a 32-bit unsigned integer OpConstant specifying the specialization id of the y dimension.

Z must be a 32-bit unsigned integer OpConstant specifying the specialization id of the z dimension.

12

<id>
X

<id>
Y

<id>
Z

SpecConstantGlobalOffset

Declares the specialization ids used to specify the global offset.

X must be a 32-bit unsigned integer OpConstant specifying the specialization id of the x dimension.

Y must be a 32-bit unsigned integer OpConstant specifying the specialization id of the y dimension.

Z must be a 32-bit unsigned integer OpConstant specifying the specialization id of the z dimension.

13

<id>
X

<id>
Y

<id>
Z

SpecConstantWorkDim

Declares the specialization id used to specify the work dimensions.

Dim must be a 32-bit unsigned integer OpConstant specifying the specialization id of the dimensions.

14

<id>
Dim

PushConstantGlobalOffset

Declares a PushConstant entry to specify the global offset of a kernel. All kernels from this module should include a push constant range that encompasses the Offset and Size operands.

Offset must be a 32-bit unsigned integer OpConstant specifying the offset in the block in bytes.

Size must be a 32-bit unsigned integer OpConstant specifying the size of the push constant in bytes.

15

<id>
Offset

<id>
Size

PushConstantEnqueuedLocalSize

Declares a PushConstant entry to specify the enqueued local size of a kernel. All kernels from this module should include a push constant range that encompasses the Offset and Size operands.

Offset must be a 32-bit unsigned integer OpConstant specifying the offset in the block in bytes.

Size must be a 32-bit unsigned integer OpConstant specifying the size of the push constant in bytes.

16

<id>
Offset

<id>
Size

PushConstantGlobalSize

Declares a PushConstant entry to specify the global size of a kernel. All kernels from this module should include a push constant range that encompasses the Offset and Size operands.

Offset must be a 32-bit unsigned integer OpConstant specifying the offset in the block in bytes.

Size must be a 32-bit unsigned integer OpConstant specifying the size of the push constant in bytes.

17

<id>
Offset

<id>
Size

PushConstantRegionOffset

Declares a PushConstant entry to specify the region offset of a kernel. All kernels from this module should include a push constant range that encompasses the Offset and Size operands.

Offset must be a 32-bit unsigned integer OpConstant specifying the offset in the block in bytes.

Size must be a 32-bit unsigned integer OpConstant specifying the size of the push constant in bytes.

18

<id>
Offset

<id>
Size

PushConstantNumWorkgroups

Declares a PushConstant entry to specify the number of workgroups enqueued. All kernels from this module should include a push constant range that encompasses the Offset and Size operands.

Offset must be a 32-bit unsigned integer OpConstant specifying the offset in the block in bytes.

Size must be a 32-bit unsigned integer OpConstant specifying the size of the push constant in bytes.

19

<id>
Offset

<id>
Size

PushConstantRegionGroupOffset

Declares a PushConstant entry to specify the region group offset of a kernel. All kernels from this module should include a push constant range that encompasses the Offset and Size operands.

Offset must be a 32-bit unsigned integer OpConstant specifying the offset in the block in bytes.

Size must be a 32-bit unsigned integer OpConstant specifying the size of the push constant in bytes.

20

<id>
Offset

<id>
Size

ConstantDataStorageBuffer

Declares a storage buffer to hold constant data specified by Data. All kernels from this module should include a descriptor with the type VK_DESCRIPTOR_TYPE_STORAGE_BUFFER that is backed by a buffer initialized with Data.

DescriptorSet must be a 32-bit unsigned integer OpConstant specifying the descriptor set.

Binding must be a 32-bit unsigned integer OpConstant specifying the binding.

Data must be an OpString that encodes the hexbytes of the constant data.

21

<id>
DescriptorSet

<id>
Binding

<id>
Data

ConstantDataUniform

Declares a uniform buffer to hold constant data specified by Data. All kernels from this module should include a descriptor with the type VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER that is backed by a buffer initialized with Data.

DescriptorSet must be a 32-bit unsigned integer OpConstant specifying the descriptor set.

Binding must be a 32-bit unsigned integer OpConstant specifying the binding.

Data must be an OpString that encodes the hexbytes of the constant data.

22

<id>
DescriptorSet

<id>
Binding

<id>
Data

LiteralSampler

Declares a literal sampler used by the module. All kernels from this module should include a descriptor with the type VK_DESCRIPTOR_TYPE_SAMPLER that has the properties encoded by Mask (see Sampler.h).

DescriptorSet must be a 32-bit unsigned integer OpConstant specifying the descriptor set.

Binding must be a 32-bit unsigned integer OpConstant specifying the binding.

Mask must be a 32-bit unsigned integer OpConstant specifying the encoding of coordinate normalization, address mode and filter mode.

23

<id>
DescriptorSet

<id>
Binding

<id>
Mask

PropertyRequiredWorkgroupSize

Declares the required workgroup size of Kernel.

Kernel must be a Kernel extended instruction from the same import.

X must be a 32-bit unsigned integer OpConstant specifying the x dimension.

Y must be a 32-bit unsigned integer OpConstant specifying the y dimension.

Z must be a 32-bit unsigned integer OpConstant specifying the z dimension.

24

<id>
Kernel

<id>
X

<id>
Y

<id>
Z

SpecConstantSubgroupMaxSize

Missing before version 2.

Declares the specialization id used to set the maximum size of a subgroup, i.e. the value returned by get_max_sub_group_size().

Size must be a 32-bit unsigned integer OpConstant specifying the specialization id for the value.

25

<id>
Size

ArgumentPointerPushConstant

Missing before version 3.

Declares a pointer argument for Kernel passed via PushConstant. This argument’s offset and size should be included in the push constant range declared for this kernel using the VK_SHADER_STAGE_COMPUTE_BIT flag bit.

Kernel must be a Kernel extended instruction from the same import.

Ordinal must be a 32-bit unsigned integer OpConstant specifying the argument ordinal using zero-based counting.

Offset must be a 32-bit unsigned integer OpConstant specifying the offset in the block in bytes.

Size must be a 32-bit unsigned integer OpConstant specifying the size of the pointer in bytes.

ArgInfo must be an ArgumentInfo extended instruction from the same import.

26

<id>
Kernel

<id>
Ordinal

<id>
Offset

<id>
Size

Optional
<id>
ArgInfo

ArgumentPointerUniform

Missing before version 3.

Declares a pointer argument for Kernel passed in a Uniform buffer. The Vulkan descriptor type should use VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER. This argument may share a descriptor set and binding with other users.

Kernel must be a Kernel extended instruction from the same import.

Ordinal must be a 32-bit unsigned integer OpConstant specifying the argument ordinal using zero-based counting.

DescriptorSet must be a 32-bit unsigned integer OpConstant specifying the descriptor set.

Binding must be a 32-bit unsigned integer OpConstant specifying the binding.

Offset must be a 32-bit unsigned integer OpConstant specifying the offset in the block in bytes.

Size must be a 32-bit unsigned integer OpConstant specifying the size of the pointer in bytes.

ArgInfo must be an ArgumentInfo extended instruction from the same import.

27

<id>
Kernel

<id>
Ordinal

<id>
DescriptorSet

<id>
Binding

<id>
Offset

<id>
Size

Optional
<id>
ArgInfo

ProgramScopeVariablesStorageBuffer

Missing before version 3.

Declares a storage buffer to hold program scope variables. All kernels from this module should include a descriptor with the type VK_DESCRIPTOR_TYPE_STORAGE_BUFFER that is backed by a buffer initialized with Data and shared between all instances of kernels created from this module.

DescriptorSet must be a 32-bit unsigned integer OpConstant specifying the descriptor set.

Binding must be a 32-bit unsigned integer OpConstant specifying the binding.

Data must be an OpString that encodes the hexbytes of the data used to initialize the buffer.

28

<id>
DescriptorSet

<id>
Binding

<id>
Data

ProgramScopeVariablePointerRelocation

Missing before version 3.

Declares a relocation for a pointer into the program scope variables storage buffer initialized with the address of another program scope variable.

ObjectOffset must be a 32-bit unsigned integer OpConstant specifying the offset into the program scope variable storage buffer at which the object pointed to resides.

PointerOffset must be a 32-bit unsigned integer OpConstant specifying the offset into the program scope variable storage buffer at which the pointer resides.

PointerSize must be a 32-bit unsigned integer OpConstant specifying the size of the pointer stored in the program scope variable storage buffer.

29

<id>
ObjectOffset

<id>
PointerOffset

<id>
PointerSize

ImageArgumentInfoChannelOrderPushConstant

Missing before version 3.

Declares a PushConstant location to pass the channel order of the image that is argument Ordinal to Kernel. The offset and size should be included in the push constant range declared for this kernel using the VK_SHADER_STAGE_COMPUTE_BIT flag bit.

Kernel must be a Kernel extended instruction from the same import.

Ordinal must be a 32-bit unsigned integer OpConstant specifying the image argument ordinal using zero-based counting.

Offset must be a 32-bit unsigned integer OpConstant specifying the offset in the block in bytes.

Size must be a 32-bit unsigned integer OpConstant specifying the size of the channel order in bytes.

30

<id>
Kernel

<id>
Ordinal

<id>
Offset

<id>
Size

ImageArgumentInfoChannelDataTypePushConstant

Missing before version 3.

Declares a PushConstant location to pass the channel data type of the image that is argument Ordinal to Kernel. The offset and size should be included in the push constant range declared for this kernel using the VK_SHADER_STAGE_COMPUTE_BIT flag bit.

Kernel must be a Kernel extended instruction from the same import.

Ordinal must be a 32-bit unsigned integer OpConstant specifying the image argument ordinal using zero-based counting.

Offset must be a 32-bit unsigned integer OpConstant specifying the offset in the block in bytes.

Size must be a 32-bit unsigned integer OpConstant specifying the size of the channel data type in bytes.

31

<id>
Kernel

<id>
Ordinal

<id>
Offset

<id>
Size

ImageArgumentInfoChannelOrderUniform

Missing before version 3.

Declares a location in a Uniform buffer to pass the channel order of the image that is argument Ordinal to Kernel. The Vulkan descriptor type should use VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER. This argument may share a descriptor set and binding with other users.

Kernel must be a Kernel extended instruction from the same import.

Ordinal must be a 32-bit unsigned integer OpConstant specifying the image argument ordinal using zero-based counting.

DescriptorSet must be a 32-bit unsigned integer OpConstant specifying the descriptor set.

Binding must be a 32-bit unsigned integer OpConstant specifying the binding.

Offset must be a 32-bit unsigned integer OpConstant specifying the offset in the block in bytes.

Size must be a 32-bit unsigned integer OpConstant specifying the size of the channel order in bytes.

32

<id>
Kernel

<id>
Ordinal

<id>
DescriptorSet

<id>
Binding

<id>
Offset

<id>
Size

ImageArgumentInfoChannelDataTypeUniform

Missing before version 3.

Declares a location in a Uniform buffer to pass the channel data type of the image that is argument Ordinal to Kernel. The Vulkan descriptor type should use VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER. This argument may share a descriptor set and binding with other users.

Kernel must be a Kernel extended instruction from the same import.

Ordinal must be a 32-bit unsigned integer OpConstant specifying the image argument ordinal using zero-based counting.

DescriptorSet must be a 32-bit unsigned integer OpConstant specifying the descriptor set.

Binding must be a 32-bit unsigned integer OpConstant specifying the binding.

Offset must be a 32-bit unsigned integer OpConstant specifying the offset in the block in bytes.

Size must be a 32-bit unsigned integer OpConstant specifying the size of the channel data type in bytes.

33

<id>
Kernel

<id>
Ordinal

<id>
DescriptorSet

<id>
Binding

<id>
Offset

<id>
Size

ArgumentStorageTexelBuffer

Missing before version 4.

Declares a storage texel buffer (OpTypeImage with Dim operand of Buffer) argument for Kernel. The Vulkan descriptor type should use VK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER.

Kernel must be a Kernel extended instruction from the same import.

Ordinal must be a 32-bit unsigned integer OpConstant specifying the argument ordinal using zero-based counting.

DescriptorSet must be a 32-bit unsigned integer OpConstant specifying the descriptor set.

Binding must be a 32-bit unsigned integer OpConstant specifying the binding.

ArgInfo must be an ArgumentInfo extended instruction from the same import.

34

<id>
Kernel

<id>
Ordinal

<id>
DescriptorSet

<id>
Binding

Optional
<id>
ArgInfo

ArgumentUniformTexelBuffer

Missing before version 4.

Declares a uniform texel buffer (OpTypeImage with Dim operand of Buffer) argument for Kernel. The Vulkan descriptor type should use VK_DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER.

Kernel must be a Kernel extended instruction from the same import.

Ordinal must be a 32-bit unsigned integer OpConstant specifying the argument ordinal using zero-based counting.

DescriptorSet must be a 32-bit unsigned integer OpConstant specifying the descriptor set.

Binding must be a 32-bit unsigned integer OpConstant specifying the binding.

ArgInfo must be an ArgumentInfo extended instruction from the same import.

35

<id>
Kernel

<id>
Ordinal

<id>
DescriptorSet

<id>
Binding

Optional
<id>
ArgInfo

ConstantDataPointerPushConstant

Missing before version 5.

Declares a PushConstant entry to specify the physical address of a buffer containing constants for this module. All kernels from this module should include a push constant range that encompasses the Offset and Size operands.

Offset must be a 32-bit unsigned integer OpConstant specifying the offset in the block in bytes.

Size must be a 32-bit unsigned integer OpConstant specifying the size of the push constant in bytes.

Data must be an OpString that encodes the hexbytes of the constant data.

36

<id>
Offset

<id>
Size

<id>
Data

ProgramScopeVariablePointerPushConstant

Missing before version 5.

Declares a PushConstant entry to specify the physical address of a buffer containing program-scope variables for this module. The buffer must be initialized with Data and shared between all instances of kernels created from this module. All kernels from this module should include a push constant range that encompasses the Offset and Size operands.

Offset must be a 32-bit unsigned integer OpConstant specifying the offset in the block in bytes.

Size must be a 32-bit unsigned integer OpConstant specifying the size of the push constant in bytes.

Data must be an OpString that encodes the hexbytes of the initialization data.

37

<id>
Offset

<id>
Size

<id>
Data

PrintfInfo

Missing before version 5.

Declares a string associated with a printf builtin call, a unique ID for the string, and an optional number of argument sizes.

The string may represent the format string of a printf builtin call. In this case ArgumentSizes must contain the storage size, in bytes, of each argument that will be written to the buffer by the printf builtin, in the order that they appear. The printf buffer is a buffer of unsigned 32-bit integers, so arguments must be padded to reach a minimum storage size of 4 bytes if necessary.

The string will otherwise represent a string literal argument to another printf call that is not the format string. A valid printf implementation should write the value of this PrintfID to the printf buffer for a string literal argument instead of the actual string data. ArgumentSizes has no meaning for this usage.

A valid printf implementation should write the PrintfID associated with the call to the next free location in the printf buffer, followed by the value of each argument that appears after the format string.

PrintfID must be a 32-bit unsigned integer OpConstant with a value unique to each occurence of the PrintfInfo instruction.

FormatString must be an OpString.

ArgumentSizes must be zero or more 32-bit unsigned integer OpConstants representing the storage size of the corresponding printf arguments. The Nth value corresponds to the Nth printf argument after the format string (i.e. the N+1th argument to printf).

38

<id>
PrintfID

<id>
FormatString

Optional
<id>, …​
ArgumentSizes

PrintfBufferStorageBuffer

Missing before version 5.

Declares a storage buffer to hold the output of the printf builtin. All kernels from this module should include a descriptor with the type VK_DESCRIPTOR_TYPE_STORAGE_BUFFER that is backed by a zero-initialized buffer with a size of at least Size. The first 4 bytes of the buffer should be zero-initialized.

The buffer contains a series of 32-bit unsigned integers. The first integer of the buffer represents the offset from the second integer to the next available free memory. This may be incremented atomically to allocate regions of the buffer in a thread-safe way. This can be used to determine the amount of data written after a kernel has executed. Subsequent data written by the printf builtin will be as described by PrintfInfo.

DescriptorSet must be a 32-bit unsigned integer OpConstant specifying the descriptor set.

Binding must be a 32-bit unsigned integer OpConstant specifying the binding.

Size must be a 32-bit unsigned integer OpConstant specifying the buffer size in bytes.

39

<id>
DescriptorSet

<id>
Binding

<id>
Size

PrintfBufferPointerPushConstant

Missing before version 5.

Declares a PushConstant entry to specify the physical address of a buffer to hold the output of the printf builtin. All kernels from this module should include a push constant range that encompasses the Offset and Size operands. The buffer should have a size of at least BufferSize, and the first 4 bytes should be zero-initialized.

The usage of the buffer is as described for PrintfBufferStorageBuffer.

Offset must be a 32-bit unsigned integer OpConstant specifying the offset in the block in bytes.

Size must be a 32-bit unsigned integer OpConstant specifying the size of the push constant in bytes.

BufferSize must be a 32-bit unsigned integer OpConstant specifying the buffer size in bytes.

40

<id>
Offset

<id>
Size

<id>
BufferSize

NormalizedSamplerMaskPushConstant

Missing before version 6.

Declares a PushConstant entry to specify the sampler mask of a non literal sampler. It means that the kernel accesses 3D images with this sampler, but Vulkan does not allow accessing 3D images with a sampler using unnormalized coordinates. Clspv will generates code to normalized the coordinates. Clspv will choose at runtime whether to use the original coordinates or the normalized one depending on the mask of the sampler. All kernels from this module should include a push constant range that encompasses the Offset and Size operands.
Kernel must be a Kernel extended instruction from the same import.

Ordinal must be a 32-bit unsigned integer OpConstant specifying the argument ordinal using zero-based counting.

Offset must be a 32-bit unsigned integer OpConstant specifying the offset in the block in bytes.

Size must be a 32-bit unsigned integer OpConstant specifying the size of the push constant in bytes.

41

<id>
Kernel

<id>
Ordinal

<id>
Offset

<id>
Size