Package org.lwjgl.vulkan

Class VkRenderingAttachmentLocationInfoKHR

java.lang.Object
org.lwjgl.system.Pointer.Default
org.lwjgl.system.Struct<VkRenderingAttachmentLocationInfoKHR>
org.lwjgl.vulkan.VkRenderingAttachmentLocationInfoKHR
All Implemented Interfaces:
AutoCloseable, org.lwjgl.system.NativeResource, org.lwjgl.system.Pointer
public class VkRenderingAttachmentLocationInfoKHR extends org.lwjgl.system.Struct<VkRenderingAttachmentLocationInfoKHR> implements org.lwjgl.system.NativeResource
Structure specifying attachment locations.
Description

This structure allows applications to remap the locations of color attachments to different fragment shader output locations.

Each element of pColorAttachmentLocations set to 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:

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 NULL_HANDLE, or 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:

Valid Usage
  • If the dynamicRenderingLocalRead feature is not enabled, and pColorAttachmentLocations is not NULL, each element must be set to the value of its index within the array
  • Elements of pColorAttachmentLocations that are not ATTACHMENT_UNUSED must each be unique
  • colorAttachmentCount must be less than or equal to maxColorAttachments
  • Each element of pColorAttachmentLocations must be less than maxColorAttachments
Valid Usage (Implicit)
See Also

CmdSetRenderingAttachmentLocationsKHR

Layout


 struct VkRenderingAttachmentLocationInfoKHR {
     VkStructureType sType();
     void const * pNext();
     uint32_t colorAttachmentCount();
     uint32_t const * pColorAttachmentLocations();
 }