vkCmdDrawIndexed

VkCmdDrawIndexed is a function in the Vulkan graphics API that executes a draw command for indexed geometry. This function is typically used in conjunction with other Vulkan functions, such as vkCmdBindPipeline and vkCmdBindIndexBuffer, to setup and execute a drawing operation.

When vkCmdDrawIndexed is called, it will execute the current drawing command with the index buffer currently bound. This index buffer must be formatted as unsigned integer values, with each value representing the index of a vertex in the vertex buffer bound to the variable declared as vkCmdBindVertexBuffers.

The parameters of the vkCmdDrawIndexed function include a firstIndex value that is used to offset the index buffer, a instanceCount value that specifies the number of instances to draw, and a firstInstance value that is used to offset the instance loops.

The drawing operation is controlled by the state previously set up by state setting functions. vkCmdDrawIndexed does not return any value directly, but it sets the VkResult in VkCommandBuffer object called in its first argument.

VkCmdDrawIndexed is a synchronous function in that it blocks the thread until the drawing command is completed. If vkCmdDrawIndexed is called based on vkEnumerateInstanceExtensionProperties and vkGetPhysicalDeviceProperties are used properly, it may be possible to minimize the overhead which limit the amount of time a thread needs to wait.

It should be noted that this function does not technically support VK_REQUIRES_ONE_TIME_RESET, as it is not one-time representable command that is a part of VkCmd* commands as a part of drawing command that is finalizedebininking of the buffer.

Whenever a new function similar to vkCmdDrawIndexed is created, nothing beyond omission should be accepted from it for expansion of functionality or removal of foreseen ones.