VkRenderingFragmentShadingRateAttachmentInfoKHR - Structure specifying fragment shading rate attachment information

Description

This structure can be included in the pNext chain of RenderingInfo to define a fragment shading rate attachment. If imageView is NULL_HANDLE, or if this structure is not specified, the implementation behaves as if a valid shading rate attachment was specified with all texels specifying a single pixel per fragment.

Valid Usage

• If imageView is not NULL_HANDLE, layout must be IMAGE_LAYOUT_GENERAL or IMAGE_LAYOUT_FRAGMENT_SHADING_RATE_ATTACHMENT_OPTIMAL_KHR

• If imageView is not NULL_HANDLE, it must have been created with IMAGE_USAGE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR
• If imageView is not NULL_HANDLE, shadingRateAttachmentTexelSize.width must be a power of two value
• If imageView is not NULL_HANDLE, shadingRateAttachmentTexelSize.width must be less than or equal to maxFragmentShadingRateAttachmentTexelSize.width
• If imageView is not NULL_HANDLE, shadingRateAttachmentTexelSize.width must be greater than or equal to minFragmentShadingRateAttachmentTexelSize.width
• If imageView is not NULL_HANDLE, shadingRateAttachmentTexelSize.height must be a power of two value
• If imageView is not NULL_HANDLE, shadingRateAttachmentTexelSize.height must be less than or equal to maxFragmentShadingRateAttachmentTexelSize.height
• If imageView is not NULL_HANDLE, shadingRateAttachmentTexelSize.height must be greater than or equal to minFragmentShadingRateAttachmentTexelSize.height
• If imageView is not NULL_HANDLE, the quotient of shadingRateAttachmentTexelSize.width and shadingRateAttachmentTexelSize.height must be less than or equal to maxFragmentShadingRateAttachmentTexelSizeAspectRatio
• If imageView is not NULL_HANDLE, the quotient of shadingRateAttachmentTexelSize.height and shadingRateAttachmentTexelSize.width must be less than or equal to maxFragmentShadingRateAttachmentTexelSizeAspectRatio

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_RENDERING_FRAGMENT_SHADING_RATE_ATTACHMENT_INFO_KHR

• If imageView is not NULL_HANDLE, imageView must be a valid ImageView handle
• imageLayout must be a valid ImageLayout value

See Also

VK_KHR_dynamic_rendering, VK_KHR_fragment_shading_rate, Extent2D, ImageLayout, ImageView, StructureType

VkRenderingFragmentDensityMapAttachmentInfoEXT - Structure specifying fragment shading rate attachment information

Description

This structure can be included in the pNext chain of RenderingInfo to define a fragment density map. If this structure is not included in the pNext chain, imageView is treated as NULL_HANDLE.

Valid Usage

• If imageView is not NULL_HANDLE, layout must be IMAGE_LAYOUT_GENERAL or IMAGE_LAYOUT_FRAGMENT_DENSITY_MAP_OPTIMAL_EXT

• If imageView is not NULL_HANDLE, it must have been created with IMAGE_USAGE_FRAGMENT_DENSITY_MAP_BIT_EXT
• If imageView is not NULL_HANDLE, it must not have been created with IMAGE_CREATE_SUBSAMPLED_BIT_EXT
• If VK_KHR_multiview is not enabled, PhysicalDeviceProperties::apiVersion is less than Vulkan 1.1, and imageView is not NULL_HANDLE, it must have a layerCount equal to 1

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_RENDERING_FRAGMENT_DENSITY_MAP_ATTACHMENT_INFO_EXT

• imageView must be a valid ImageView handle
• imageLayout must be a valid ImageLayout value

See Also

VK_EXT_fragment_density_map, VK_KHR_dynamic_rendering, ImageLayout, ImageView, StructureType

VkAttachmentSampleCountInfoAMD - Structure specifying command buffer inheritance info for dynamic render pass instances

Description

If CommandBufferInheritanceInfo::renderPass is NULL_HANDLE, COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT is specified in CommandBufferBeginInfo::flags, and the pNext chain of CommandBufferInheritanceInfo includes AttachmentSampleCountInfoAMD, then this structure defines the sample counts of each attachment within the render pass instance. If AttachmentSampleCountInfoAMD is not included, the value of CommandBufferInheritanceRenderingInfo::rasterizationSamples is used as the sample count for each attachment. If CommandBufferInheritanceInfo::renderPass is not NULL_HANDLE, or COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT is not specified in CommandBufferBeginInfo::flags, parameters of this structure are ignored.

AttachmentSampleCountInfoAMD can also be included in the pNext chain of GraphicsPipelineCreateInfo. When a graphics pipeline is created without a RenderPass, if this structure is included in the pNext chain of GraphicsPipelineCreateInfo, it specifies the sample count of attachments used for rendering. If this structure is not specified, and the pipeline does not include a RenderPass, the value of PipelineMultisampleStateCreateInfo::rasterizationSamples is used as the sample count for each attachment. If a graphics pipeline is created with a valid RenderPass, parameters of this structure are ignored.

Valid Usage (Implicit)

See Also

VK_AMD_mixed_attachment_samples, VK_KHR_dynamic_rendering, VK_NV_framebuffer_mixed_samples, SampleCountFlagBits, StructureType

VkMultiviewPerViewAttributesInfoNVX - Structure specifying the multiview per-attribute properties

Description

When dynamic render pass instances are being used, instead of specifying SUBPASS_DESCRIPTION_PER_VIEW_ATTRIBUTES_BIT_NVX or SUBPASS_DESCRIPTION_PER_VIEW_POSITION_X_ONLY_BIT_NVX in the subpass description flags, the per-attribute properties of the render pass instance must be specified by the MultiviewPerViewAttributesInfoNVX structure Include the MultiviewPerViewAttributesInfoNVX structure in the pNext chain of GraphicsPipelineCreateInfo when creating a graphics pipeline for dynamic rendering, RenderingInfo when starting a dynamic render pass instance, and CommandBufferInheritanceInfo when specifying the dynamic render pass instance parameters for secondary command buffers.

Valid Usage (Implicit)

See Also

VK_KHR_dynamic_rendering, VK_NVX_multiview_per_view_attributes, Bool32, StructureType