VkPipelineViewportExclusiveScissorStateCreateInfoNV(3)

# VkPipelineViewportExclusiveScissorStateCreateInfoNV(3) Manual Page

## Name

VkPipelineViewportExclusiveScissorStateCreateInfoNV - Structure specifying parameters controlling exclusive scissor testing

## C Specification

If the `pNext` chain of `VkPipelineViewportStateCreateInfo` includes a `VkPipelineViewportExclusiveScissorStateCreateInfoNV` structure, then that structure includes parameters that affect the exclusive scissor test.

The `VkPipelineViewportExclusiveScissorStateCreateInfoNV` structure is defined as:

    typedef struct VkPipelineViewportExclusiveScissorStateCreateInfoNV {
        VkStructureType    sType;
        const void*        pNext;
        uint32_t           exclusiveScissorCount;
        const VkRect2D*    pExclusiveScissors;
    } VkPipelineViewportExclusiveScissorStateCreateInfoNV;

## Members

- `sType` is the type of this structure.

- `pNext` is `NULL` or a pointer to an extension-specific structure.

- `exclusiveScissorCount` is the number of exclusive scissor rectangles used by the pipeline.

- `pExclusiveScissors` is a pointer to an array of VkRect2D structures defining exclusive scissor rectangles. If the exclusive scissor state is dynamic, this member is ignored.

## Description

If this structure is not present, `exclusiveScissorCount` is considered to be `0` and the exclusive scissor test is disabled.

Valid Usage

- If the multiple viewports feature is not enabled, `exclusiveScissorCount` must be `0` or `1`

- `exclusiveScissorCount` must be less than or equal to `VkPhysicalDeviceLimits`::`maxViewports`

- `exclusiveScissorCount` must be `0` or identical to the `viewportCount` member of `VkPipelineViewportStateCreateInfo`

- If no element of the `pDynamicStates` member of `pDynamicState` is `VK_DYNAMIC_STATE_EXCLUSIVE_SCISSOR_NV` and `exclusiveScissorCount` is not `0`, `pExclusiveScissors` must be a valid pointer to an array of `exclusiveScissorCount` `VkRect2D` structures

Valid Usage (Implicit)

- `sType` must be `VK_STRUCTURE_TYPE_PIPELINE_VIEWPORT_EXCLUSIVE_SCISSOR_STATE_CREATE_INFO_NV`

- If `exclusiveScissorCount` is not `0`, and `pExclusiveScissors` is not `NULL`, `pExclusiveScissors` must be a valid pointer to an array of `exclusiveScissorCount` `VkRect2D` structures

## See Also

VkRect2D, VkStructureType

## 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-2019 Khronos Group. This work is licensed under a Creative Commons Attribution 4.0 International License.