vkCmdSetExclusiveScissorNV - Set the dynamic exclusive scissor rectangles on a command buffer

Parameters

• CommandBuffer is the command buffer into which the command will be recorded.

• firstExclusiveScissor is the index of the first exclusive scissor rectangle whose state is updated by the command.
• exclusiveScissorCount is the number of exclusive scissor rectangles updated by the command.
• pExclusiveScissors is a pointer to an array of Rect2D structures defining exclusive scissor rectangles.

Description

The scissor rectangles taken from element i of pExclusiveScissors replace the current state for the scissor index firstExclusiveScissor + i, for i in [0, exclusiveScissorCount).

Each scissor rectangle is described by a Rect2D structure, with the offset.x and offset.y values determining the upper left corner of the scissor rectangle, and the extent.width and extent.height values determining the size in pixels.

Valid Usage

• The exclusive scissor feature must be enabled.

• firstExclusiveScissor must be less than PhysicalDeviceLimits::maxViewports
• The sum of firstExclusiveScissor and exclusiveScissorCount must be between 1 and PhysicalDeviceLimits::maxViewports, inclusive
• If the multiple viewports feature is not enabled, firstExclusiveScissor must be 0
• If the multiple viewports feature is not enabled, exclusiveScissorCount must be 1
• The x and y members of offset in each member of pExclusiveScissors must be greater than or equal to 0
• Evaluation of (offset.x + extent.width) for each member of pExclusiveScissors must not cause a signed integer addition overflow
• Evaluation of (offset.y + extent.height) for each member of pExclusiveScissors must not cause a signed integer addition overflow

Valid Usage (Implicit)

• CommandBuffer must be a valid CommandBuffer handle

• pExclusiveScissors must be a valid pointer to an array of exclusiveScissorCount Rect2D structures
• CommandBuffer must be in the recording state
• The CommandPool that CommandBuffer was allocated from must support graphics operations
• exclusiveScissorCount must be greater than 0

Host Synchronization

• Host access to CommandBuffer must be externally synchronized

• Host access to the CommandPool that CommandBuffer was allocated from must be externally synchronized

Command Properties

'

See Also

CommandBuffer, Rect2D

VkPhysicalDeviceExclusiveScissorFeaturesNV - Structure describing exclusive scissor features that can be supported by an implementation

Members

The members of the PhysicalDeviceExclusiveScissorFeaturesNV structure describe the following features:

Description

See Exclusive Scissor Test for more information.

If the PhysicalDeviceExclusiveScissorFeaturesNV structure is included in the pNext chain of PhysicalDeviceFeatures2, it is filled with values indicating whether the feature is supported. PhysicalDeviceExclusiveScissorFeaturesNV can also be included in the pNext chain of DeviceCreateInfo to enable the feature.

Valid Usage (Implicit)

See Also

Bool32, StructureType

VkPipelineViewportExclusiveScissorStateCreateInfoNV - Structure specifying parameters controlling exclusive scissor testing

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 PhysicalDeviceLimits::maxViewports
• exclusiveScissorCount must be 0 or identical to the viewportCount member of PipelineViewportStateCreateInfo
• If no element of the pDynamicStates member of pDynamicState is DYNAMIC_STATE_EXCLUSIVE_SCISSOR_NV and exclusiveScissorCount is not 0, pExclusiveScissors must be a valid pointer to an array of exclusiveScissorCount Rect2D structures

Valid Usage (Implicit)

• sType must be 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 Rect2D structures

See Also

Rect2D, StructureType