VkConditionalRenderingBeginInfoEXT
The VkConditionalRenderingBeginInfoEXT
structure is defined as:
typedef struct VkConditionalRenderingBeginInfoEXT {
VkStructureType sType;
const void* pNext;
VkBuffer buffer;
VkDeviceSize offset;
VkConditionalRenderingFlagsEXT flags;
} VkConditionalRenderingBeginInfoEXT;
sType
is a VkStructureType value identifying this structure.pNext
isNULL
or a pointer to a structure extending this structure.buffer
is a buffer containing the predicate for conditional rendering.offset
is the byte offset intobuffer
where the predicate is located.flags
is a bitmask of VkConditionalRenderingFlagsEXT specifying the behavior of conditional rendering.
If the 32-bit value at offset
in buffer
memory is zero, then the
rendering commands are discarded, otherwise they are executed as normal.
If the value of the predicate in buffer memory changes while conditional
rendering is active, the rendering commands may be discarded in an
implementation-dependent way.
Some implementations may latch the value of the predicate upon beginning
conditional rendering while others may read it before every rendering
command.
Valid Usage
VUID-VkConditionalRenderingBeginInfoEXT-buffer-01981
If buffer
is non-sparse then it must be bound completely and
contiguously to a single VkDeviceMemory
object
VUID-VkConditionalRenderingBeginInfoEXT-buffer-01982
buffer
must have been created with the
VK_BUFFER_USAGE_CONDITIONAL_RENDERING_BIT_EXT
bit set
VUID-VkConditionalRenderingBeginInfoEXT-offset-01983
offset
must be less than the size of buffer
by at least 32
bits
VUID-VkConditionalRenderingBeginInfoEXT-offset-01984
offset
must be a multiple of 4
Valid Usage (Implicit)
VUID-VkConditionalRenderingBeginInfoEXT-sType-sType
sType
must be VK_STRUCTURE_TYPE_CONDITIONAL_RENDERING_BEGIN_INFO_EXT
VUID-VkConditionalRenderingBeginInfoEXT-pNext-pNext
pNext
must be NULL
VUID-VkConditionalRenderingBeginInfoEXT-buffer-parameter
buffer
must be a valid VkBuffer handle
VUID-VkConditionalRenderingBeginInfoEXT-flags-parameter
flags
must be a valid combination of VkConditionalRenderingFlagBitsEXT values