C Specification
The VkRenderingAttachmentLocationInfo structure is defined as:
// Provided by VK_VERSION_1_4
typedef struct VkRenderingAttachmentLocationInfo {
VkStructureType sType;
const void* pNext;
uint32_t colorAttachmentCount;
const uint32_t* pColorAttachmentLocations;
} VkRenderingAttachmentLocationInfo;
or the equivalent
// Provided by VK_KHR_dynamic_rendering_local_read
typedef VkRenderingAttachmentLocationInfo VkRenderingAttachmentLocationInfoKHR;
Members
-
sTypeis a VkStructureType value identifying this structure. -
pNextisNULLor a pointer to a structure extending this structure. -
colorAttachmentCountis the number of elements inpColorAttachmentLocations. -
pColorAttachmentLocationsis a pointer to an array ofcolorAttachmentCountuint32_tvalues defining remapped locations for color attachments.
Description
This structure allows applications to remap the locations of color attachments to different fragment shader output locations.
Each element of pColorAttachmentLocations set to
VK_ATTACHMENT_UNUSED will be inaccessible to this pipeline as a color
attachment; no location will map to it.
Each element of pColorAttachmentLocations set to any other value will
map the specified location value to the color attachment specified in the
render pass at the corresponding index in the
pColorAttachmentLocations array.
Any writes to a fragment output location that is not mapped to an attachment
must be discarded.
If pColorAttachmentLocations is NULL, it is equivalent to setting
each element to its index within the array.
This structure can be included in the pNext chain of a
VkGraphicsPipelineCreateInfo structure to set this state for a
pipeline.
If this structure is not included in the pNext chain of
VkGraphicsPipelineCreateInfo, it is equivalent to specifying this
structure with the following properties:
-
colorAttachmentCountset to VkPipelineRenderingCreateInfo::colorAttachmentCount. -
pColorAttachmentLocationsset toNULL.
This structure can be included in the pNext chain of a
VkCommandBufferInheritanceInfo structure to specify inherited state
from the primary command buffer.
If VkCommandBufferInheritanceInfo::renderPass is not
VK_NULL_HANDLE, or
VK_COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT is not specified in
VkCommandBufferBeginInfo::flags, members of this structure are
ignored.
If this structure is not included in the pNext chain of
VkCommandBufferInheritanceInfo, it is equivalent to specifying this
structure with the following properties:
-
colorAttachmentCountset to VkCommandBufferInheritanceRenderingInfo::colorAttachmentCount. -
pColorAttachmentLocationsset toNULL.
Document Notes
For more information, see the Vulkan Specification
This page is extracted from the Vulkan Specification. Fixes and changes should be made to the Specification, not directly.