public Class EXTVertexInputDynamicState

Extends VkDynamicState.

The extension name.

The extension specification version.

Extends VkStructureType.

Enum values:

• STRUCTURE_TYPE_PHYSICAL_DEVICE_VERTEX_INPUT_DYNAMIC_STATE_FEATURES_EXT
• STRUCTURE_TYPE_VERTEX_INPUT_BINDING_DESCRIPTION_2_EXT
• STRUCTURE_TYPE_VERTEX_INPUT_ATTRIBUTE_DESCRIPTION_2_EXT

Extends VkStructureType.

Enum values:

• STRUCTURE_TYPE_PHYSICAL_DEVICE_VERTEX_INPUT_DYNAMIC_STATE_FEATURES_EXT
• STRUCTURE_TYPE_VERTEX_INPUT_BINDING_DESCRIPTION_2_EXT
• STRUCTURE_TYPE_VERTEX_INPUT_ATTRIBUTE_DESCRIPTION_2_EXT

Extends VkStructureType.

Enum values:

• STRUCTURE_TYPE_PHYSICAL_DEVICE_VERTEX_INPUT_DYNAMIC_STATE_FEATURES_EXT
• STRUCTURE_TYPE_VERTEX_INPUT_BINDING_DESCRIPTION_2_EXT
• STRUCTURE_TYPE_VERTEX_INPUT_ATTRIBUTE_DESCRIPTION_2_EXT

Unsafe version of: CmdSetVertexInputEXT

Parameters

vertexBindingDescriptionCount:int

the number of vertex binding descriptions provided in pVertexBindingDescriptions.

vertexAttributeDescriptionCount:int

the number of vertex attribute descriptions provided in pVertexAttributeDescriptions.

Set the vertex input state dynamically for a command buffer.

C Specification

To dynamically set the vertex input attribute and vertex input binding descriptions, call:

void vkCmdSetVertexInputEXT(
    VkCommandBuffer                             commandBuffer,
    uint32_t                                    vertexBindingDescriptionCount,
    const VkVertexInputBindingDescription2EXT*  pVertexBindingDescriptions,
    uint32_t                                    vertexAttributeDescriptionCount,
    const VkVertexInputAttributeDescription2EXT* pVertexAttributeDescriptions);

Description

This command sets the vertex input attribute and vertex input binding descriptions state for subsequent drawing commands when drawing using shader objects, or when the graphics pipeline is created with DYNAMIC_STATE_VERTEX_INPUT_EXT set in VkPipelineDynamicStateCreateInfo::pDynamicStates. Otherwise, this state is specified by the VkGraphicsPipelineCreateInfo::pVertexInputState values used to create the currently active pipeline.

If drawing using shader objects, or if the bound pipeline state object was also created with the DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE dynamic state enabled, then CmdBindVertexBuffers2 can be used instead of vkCmdSetVertexInputEXT to dynamically set the stride.

Valid Usage

• Either the vertexInputDynamicState feature or the shaderObject feature or both must be enabled
• vertexBindingDescriptionCount must be less than or equal to VkPhysicalDeviceLimits::maxVertexInputBindings
• vertexAttributeDescriptionCount must be less than or equal to VkPhysicalDeviceLimits::maxVertexInputAttributes
• For every binding specified by each element of pVertexAttributeDescriptions, a VkVertexInputBindingDescription2EXT must exist in pVertexBindingDescriptions with the same value of binding
• All elements of pVertexBindingDescriptions must describe distinct binding numbers
• All elements of pVertexAttributeDescriptions must describe distinct attribute locations

Valid Usage (Implicit)

• commandBuffer must be a valid VkCommandBuffer handle
• If vertexBindingDescriptionCount is not 0, pVertexBindingDescriptions must be a valid pointer to an array of vertexBindingDescriptionCount valid VkVertexInputBindingDescription2EXT structures
• If vertexAttributeDescriptionCount is not 0, pVertexAttributeDescriptions must be a valid pointer to an array of vertexAttributeDescriptionCount valid VkVertexInputAttributeDescription2EXT structures
• commandBuffer must be in the recording state
• The VkCommandPool that commandBuffer was allocated from must support graphics 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

VkVertexInputAttributeDescription2EXT, VkVertexInputBindingDescription2EXT

Parameters

commandBuffer:VkCommandBuffer

the command buffer into which the command will be recorded.

pVertexBindingDescriptions:VkVertexInputBindingDescription2EXT.Buffer

a pointer to an array of VkVertexInputBindingDescription2EXT structures.

pVertexAttributeDescriptions:VkVertexInputAttributeDescription2EXT.Buffer

a pointer to an array of VkVertexInputAttributeDescription2EXT structures.