# VkCoarseSampleLocationNV(3) Manual Page

## Name

VkCoarseSampleLocationNV - Structure specifying parameters controlling shading rate image usage

## C Specification

The `VkCoarseSampleLocationNV` structure identifies a specific pixel and sample number for one of the coverage samples in a fragment that is larger than one pixel. This structure is defined as:

    typedef struct VkCoarseSampleLocationNV {
        uint32_t    pixelX;
        uint32_t    pixelY;
        uint32_t    sample;
    } VkCoarseSampleLocationNV;

## Members

- `pixelX` is added to the x coordinate of the upper-leftmost pixel of each fragment to identify the pixel containing the coverage sample.

- `pixelY` is added to the y coordinate of the upper-leftmost pixel of each fragment to identify the pixel containing the coverage sample.

- `sample` is the number of the coverage sample in the pixel identified by `pixelX` and `pixelY`.

## Description

Valid Usage

- `pixelX` must be less than the width (in pixels) of the fragment.

- `pixelY` must be less than the height (in pixels) of the fragment.

- `sample` must be less than the number of coverage samples in each pixel belonging to the fragment.

## See Also

VkCoarseSampleOrderCustomNV

## 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.

## Copyright

Copyright (c) 2014-2020 Khronos Group. This work is licensed under a Creative Commons Attribution 4.0 International License.