public Class EXTConditionalRendering

Extends VkAccessFlagBits.

Extends VkBufferUsageFlagBits.

VkConditionalRenderingFlagBitsEXT - Specify the behavior of conditional rendering

Description

• CONDITIONAL_RENDERING_INVERTED_BIT_EXT specifies the condition used to determine whether to discard rendering commands or not. That is, if the 32-bit predicate read from buffer memory at offset is zero, the rendering commands are not discarded, and if non zero, then they are discarded.

The extension name.

The extension specification version.

Extends VkPipelineStageFlagBits.

Extends VkStructureType.

Enum values:

• STRUCTURE_TYPE_COMMAND_BUFFER_INHERITANCE_CONDITIONAL_RENDERING_INFO_EXT
• STRUCTURE_TYPE_PHYSICAL_DEVICE_CONDITIONAL_RENDERING_FEATURES_EXT
• STRUCTURE_TYPE_CONDITIONAL_RENDERING_BEGIN_INFO_EXT

Extends VkStructureType.

Enum values:

• STRUCTURE_TYPE_COMMAND_BUFFER_INHERITANCE_CONDITIONAL_RENDERING_INFO_EXT
• STRUCTURE_TYPE_PHYSICAL_DEVICE_CONDITIONAL_RENDERING_FEATURES_EXT
• STRUCTURE_TYPE_CONDITIONAL_RENDERING_BEGIN_INFO_EXT

Extends VkStructureType.

Enum values:

• STRUCTURE_TYPE_COMMAND_BUFFER_INHERITANCE_CONDITIONAL_RENDERING_INFO_EXT
• STRUCTURE_TYPE_PHYSICAL_DEVICE_CONDITIONAL_RENDERING_FEATURES_EXT
• STRUCTURE_TYPE_CONDITIONAL_RENDERING_BEGIN_INFO_EXT

Unsafe version of: CmdBeginConditionalRenderingEXT

Define the beginning of a conditional rendering block.

C Specification

To begin conditional rendering, call:

void vkCmdBeginConditionalRenderingEXT(
    VkCommandBuffer                             commandBuffer,
    const VkConditionalRenderingBeginInfoEXT*   pConditionalRenderingBegin);

Valid Usage

• Conditional rendering must not already be active

Valid Usage (Implicit)

• commandBuffer must be a valid VkCommandBuffer handle
• pConditionalRenderingBegin must be a valid pointer to a valid VkConditionalRenderingBeginInfoEXT structure
• commandBuffer must be in the recording state
• The VkCommandPool that commandBuffer was allocated from must support graphics, or compute operations
• This command must only be called outside of a video coding scope

Host Synchronization

• Host access to commandBuffer must be externally synchronized
• Host access to the VkCommandPool that commandBuffer was allocated from must be externally synchronized

Command Properties

See Also

VkConditionalRenderingBeginInfoEXT

Parameters

commandBuffer:VkCommandBuffer

the command buffer into which this command will be recorded.

pConditionalRenderingBegin:VkConditionalRenderingBeginInfoEXT

a pointer to a VkConditionalRenderingBeginInfoEXT structure specifying parameters of conditional rendering.

Define the end of a conditional rendering block.

C Specification

To end conditional rendering, call:

void vkCmdEndConditionalRenderingEXT(
    VkCommandBuffer                             commandBuffer);

Description

Once ended, conditional rendering becomes inactive.

Valid Usage

• Conditional rendering must be active
• If conditional rendering was made active outside of a render pass instance, it must not be ended inside a render pass instance
• If conditional rendering was made active within a subpass it must be ended in the same subpass

Valid Usage (Implicit)

• commandBuffer must be a valid VkCommandBuffer handle
• commandBuffer must be in the recording state
• The VkCommandPool that commandBuffer was allocated from must support graphics, or compute operations
• This command must only be called outside of a video coding scope

Host Synchronization

• Host access to commandBuffer must be externally synchronized
• Host access to the VkCommandPool that commandBuffer was allocated from must be externally synchronized

Command Properties

Parameters

commandBuffer:VkCommandBuffer

the command buffer into which this command will be recorded.