diff options
Diffstat (limited to 'chapters/interfaces.adoc')
| -rw-r--r-- | chapters/interfaces.adoc | 41 |
1 files changed, 33 insertions, 8 deletions
diff --git a/chapters/interfaces.adoc b/chapters/interfaces.adoc index 5ace09d2..2fd5bfd6 100644 --- a/chapters/interfaces.adoc +++ b/chapters/interfaces.adoc @@ -479,23 +479,37 @@ Each element of pname: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 pname:pColorAttachmentLocations array. -If pname: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. +If pname:pColorAttachmentLocations is `NULL`, it is equivalent to setting +each element to its index within the array. + This structure can: be included in the pname:pNext chain of a slink:VkGraphicsPipelineCreateInfo structure to set this state for a pipeline. +If this structure is not included in the pname:pNext chain of +slink:VkGraphicsPipelineCreateInfo, it is equivalent to specifying this +structure with the following properties: + + * pname:colorAttachmentCount set to + slink:VkPipelineRenderingCreateInfo::pname:colorAttachmentCount. + * pname:pColorAttachmentLocations set to `NULL`. + This structure can: be included in the pname:pNext chain of a slink:VkCommandBufferInheritanceInfo structure to specify inherited state from the primary command buffer. +If slink:VkCommandBufferInheritanceInfo::renderPass is not +dlink:VK_NULL_HANDLE, or +ename:VK_COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT is not specified in +slink:VkCommandBufferBeginInfo::flags, members of this structure are +ignored. If this structure is not included in the pname:pNext chain of -slink:VkGraphicsPipelineCreateInfo or slink:VkCommandBufferInheritanceInfo, -it is equivalent to specifying this structure with the following properties: +slink:VkCommandBufferInheritanceInfo, it is equivalent to specifying this +structure with the following properties: * pname:colorAttachmentCount set to - slink:VkPipelineRenderingCreateInfo::pname:colorAttachmentCount. + slink:VkCommandBufferInheritanceRenderingInfo::pname:colorAttachmentCount. * pname:pColorAttachmentLocations set to `NULL`. .Valid Usage @@ -755,6 +769,7 @@ ename:VK_ATTACHMENT_UNUSED indicates that the corresponding attachment will not be used as an input attachment in this pipeline. Any other value in each of those elements will map the corresponding attachment to a code:InputAttachmentIndex value defined in shader code. + If pname:pColorAttachmentInputIndices is `NULL`, it is equivalent to setting each element to its index within the array. @@ -770,15 +785,25 @@ code:InputAttachmentIndex value defined in shader code. This structure can: be included in the pname:pNext chain of a slink:VkGraphicsPipelineCreateInfo structure to set this state for a pipeline. +If this structure is not included in the pname:pNext chain of +slink:VkGraphicsPipelineCreateInfo, it is equivalent to specifying this +structure with the following properties: + + * pname:colorAttachmentCount set to + slink:VkPipelineRenderingCreateInfo::pname:colorAttachmentCount. + * pname:pColorAttachmentInputIndices set to `NULL`. + * pname:pDepthInputAttachmentIndex set to `NULL`. + * pname:pStencilInputAttachmentIndex set to `NULL`. + This structure can: be included in the pname:pNext chain of a slink:VkCommandBufferInheritanceInfo structure to specify inherited state from the primary command buffer. If this structure is not included in the pname:pNext chain of -slink:VkGraphicsPipelineCreateInfo or slink:VkCommandBufferInheritanceInfo, -it is equivalent to specifying this structure with the following properties: +slink:VkCommandBufferInheritanceInfo, it is equivalent to specifying this +structure with the following properties: * pname:colorAttachmentCount set to - slink:VkPipelineRenderingCreateInfo::pname:colorAttachmentCount. + slink:VkCommandBufferInheritanceRenderingInfo::pname:colorAttachmentCount. * pname:pColorAttachmentInputIndices set to `NULL`. * pname:pDepthInputAttachmentIndex set to `NULL`. * pname:pStencilInputAttachmentIndex set to `NULL`. |