Structures

VkConditionalRenderingBeginInfoEXT

Structure specifying conditional rendering begin information

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 is NULL or a pointer to a structure extending this structure.
  • buffer is a buffer containing the predicate for conditional rendering.
  • offset is the byte offset into buffer 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

Valid Usage (Implicit)