Structures

VkPipelineViewportShadingRateImageStateCreateInfoNV

Structure specifying parameters controlling shading rate image usage

If the pNext chain of VkPipelineViewportStateCreateInfo includes a VkPipelineViewportShadingRateImageStateCreateInfoNV structure, then that structure includes parameters controlling the shading rate.

The VkPipelineViewportShadingRateImageStateCreateInfoNV structure is defined as:

typedef struct VkPipelineViewportShadingRateImageStateCreateInfoNV {
    VkStructureType sType;
    const void* pNext;
    VkBool32 shadingRateImageEnable;
    uint32_t viewportCount;
    const VkShadingRatePaletteNV* pShadingRatePalettes;
} VkPipelineViewportShadingRateImageStateCreateInfoNV;
  • sType is a VkStructureType value identifying this structure.
  • pNext is NULL or a pointer to a structure extending this structure.
  • shadingRateImageEnable specifies whether shading rate image and palettes are used during rasterization.
  • viewportCount specifies the number of per-viewport palettes used to translate values stored in shading rate images.
  • pShadingRatePalettes is a pointer to an array of VkShadingRatePaletteNV structures defining the palette for each viewport. If the shading rate palette state is dynamic, this member is ignored.

If this structure is not present, shadingRateImageEnable is considered to be VK_FALSE, and the shading rate image and palettes are not used.

Valid Usage

VUID-VkPipelineViewportShadingRateImageStateCreateInfoNV-viewportCount-02054

If the multiViewport feature is not enabled, viewportCount must be 0 or 1

VUID-VkPipelineViewportShadingRateImageStateCreateInfoNV-viewportCount-02055

viewportCount must be less than or equal to VkPhysicalDeviceLimits::maxViewports

VUID-VkPipelineViewportShadingRateImageStateCreateInfoNV-shadingRateImageEnable-02056

If shadingRateImageEnable is VK_TRUE, viewportCountmust be greater or equal to the viewportCount member of VkPipelineViewportStateCreateInfo

Valid Usage (Implicit)

VUID-VkPipelineViewportShadingRateImageStateCreateInfoNV-sType-sType

sType must be VK_STRUCTURE_TYPE_PIPELINE_VIEWPORT_SHADING_RATE_IMAGE_STATE_CREATE_INFO_NV