C Specification
The VkRenderingAttachmentLocationInfoKHR structure is defined as:
// Provided by VK_KHR_dynamic_rendering_local_read
typedef struct VkRenderingAttachmentLocationInfoKHR {
VkStructureType sType;
const void* pNext;
uint32_t colorAttachmentCount;
const uint32_t* pColorAttachmentLocations;
} 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.
If pColorAttachmentLocations is NULL, it is equivalent to setting
each element to its index within the array.
Any writes to a fragment output location that is not mapped to an attachment
must be discarded.
This structure can be included in the pNext chain of a
VkGraphicsPipelineCreateInfo structure to set this state for a
pipeline.
This structure can be included in the pNext chain of a
VkCommandBufferInheritanceInfo structure to specify inherited state
from the primary command buffer.
If this structure is not included in the pNext chain of
VkGraphicsPipelineCreateInfo or VkCommandBufferInheritanceInfo,
it is equivalent to specifying this structure with the following properties:
-
colorAttachmentCountset to VkPipelineRenderingCreateInfo::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.