VkPipelineCoverageToColorStateCreateInfoNV
The VkPipelineCoverageToColorStateCreateInfoNV
structure is defined
as:
typedef struct VkPipelineCoverageToColorStateCreateInfoNV {
VkStructureType sType;
const void* pNext;
VkPipelineCoverageToColorStateCreateFlagsNV flags;
VkBool32 coverageToColorEnable;
uint32_t coverageToColorLocation;
} VkPipelineCoverageToColorStateCreateInfoNV;
sType
is a VkStructureType value identifying this structure.pNext
isNULL
or a pointer to a structure extending this structure.flags
is reserved for future use.coverageToColorEnable
controls whether the fragment coverage value replaces a fragment color output.coverageToColorLocation
controls which fragment shader color output value is replaced.
If the pNext
chain of VkPipelineMultisampleStateCreateInfo
includes a VkPipelineCoverageToColorStateCreateInfoNV
structure, then
that structure controls whether the fragment coverage is substituted for a
fragment color output and, if so, which output is replaced.
If coverageToColorEnable
is VK_TRUE
, the
coverage mask replaces the first
component of the color value corresponding to the fragment shader output
location with Location
equal to coverageToColorLocation
and
Index
equal to zero.
If the color attachment format has fewer bits than the coverage mask, the
low bits of the sample coverage mask are taken without any clamping.
If the color attachment format has more bits than the coverage mask, the
high bits of the sample coverage mask are filled with zeros.
If coverageToColorEnable
is VK_FALSE
, these operations are
skipped.
If this structure is not included in the pNext
chain, it is as if
coverageToColorEnable
is VK_FALSE
.
Valid Usage
VUID-VkPipelineCoverageToColorStateCreateInfoNV-coverageToColorEnable-01404
If coverageToColorEnable
is VK_TRUE
, then the render pass
subpass indicated by
VkGraphicsPipelineCreateInfo::renderPass
and
VkGraphicsPipelineCreateInfo::subpass
must have a color
attachment at the location selected by coverageToColorLocation
,
with a VkFormat of VK_FORMAT_R8_UINT
,
VK_FORMAT_R8_SINT
, VK_FORMAT_R16_UINT
,
VK_FORMAT_R16_SINT
, VK_FORMAT_R32_UINT
, or
VK_FORMAT_R32_SINT
Valid Usage (Implicit)
VUID-VkPipelineCoverageToColorStateCreateInfoNV-sType-sType
sType
must be VK_STRUCTURE_TYPE_PIPELINE_COVERAGE_TO_COLOR_STATE_CREATE_INFO_NV