C Specification
To dynamically set the order of coverage samples in fragments larger than one pixel, call:
// Provided by VK_NV_shading_rate_image
void vkCmdSetCoarseSampleOrderNV(
VkCommandBuffer commandBuffer,
VkCoarseSampleOrderTypeNV sampleOrderType,
uint32_t customSampleOrderCount,
const VkCoarseSampleOrderCustomNV* pCustomSampleOrders);
Parameters
-
commandBuffer
is the command buffer into which the command will be recorded. -
sampleOrderType
specifies the mechanism used to order coverage samples in fragments larger than one pixel. -
customSampleOrderCount
specifies the number of custom sample orderings to use when ordering coverage samples. -
pCustomSampleOrders
is a pointer to an array of VkCoarseSampleOrderCustomNV structures, each structure specifying the coverage sample order for a single combination of fragment area and coverage sample count.
Description
If sampleOrderType
is VK_COARSE_SAMPLE_ORDER_TYPE_CUSTOM_NV
, the
coverage sample order used for any combination of fragment area and coverage
sample count not enumerated in pCustomSampleOrders
will be identical
to that used for VK_COARSE_SAMPLE_ORDER_TYPE_DEFAULT_NV
.
This command sets the order of coverage samples for subsequent drawing
commands
when drawing using shader objects, or
when the graphics pipeline is created with
VK_DYNAMIC_STATE_VIEWPORT_COARSE_SAMPLE_ORDER_NV
set in
VkPipelineDynamicStateCreateInfo::pDynamicStates
.
Otherwise, this state is specified by the
VkPipelineViewportCoarseSampleOrderStateCreateInfoNV values used to
create the currently active pipeline.
Document Notes
For more information, see the Vulkan Specification
This page is extracted from the Vulkan Specification. Fixes and changes should be made to the Specification, not directly.