mirror of
https://github.com/status-im/Vulkan-Docs.git
synced 2025-01-28 15:15:20 +00:00
65 lines
1.8 KiB
Plaintext
65 lines
1.8 KiB
Plaintext
include::meta/VK_EXT_discard_rectangles.txt[]
|
|
|
|
*Last Modified Date*::
|
|
2016-12-22
|
|
*Contributors*::
|
|
- Daniel Koch, NVIDIA
|
|
- Jeff Bolz, NVIDIA
|
|
|
|
This extension provides additional orthogonally aligned "discard rectangles"
|
|
specified in framebuffer-space coordinates that restrict rasterization of
|
|
all points, lines and triangles.
|
|
|
|
From zero to an implementation-dependent limit (specified by
|
|
pname:maxDiscardRectangles) number of discard rectangles can be operational
|
|
at once.
|
|
When one or more discard rectangles are active, rasterized fragments can
|
|
either survive if the fragment is within any of the operational discard
|
|
rectangles (ename:VK_DISCARD_RECTANGLE_MODE_INCLUSIVE_EXT mode) or be
|
|
rejected if the fragment is within any of the operational discard rectangles
|
|
(ename:VK_DISCARD_RECTANGLE_MODE_EXCLUSIVE_EXT mode).
|
|
|
|
These discard rectangles operate orthogonally to the existing scissor test
|
|
functionality.
|
|
If the <<VK_KHX_device_group>> extension is enabled the discard rectangles
|
|
can be different for each physical device in the device group by specifying
|
|
the device mask and setting discard rectangle dynamic state.
|
|
|
|
=== New Object Types
|
|
|
|
None.
|
|
|
|
=== New Enum Constants
|
|
|
|
* Extending elink:VkStructureType:
|
|
|
|
** ename:VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DISCARD_RECTANGLE_PROPERTIES_EXT
|
|
** ename:VK_STRUCTURE_TYPE_PIPELINE_DISCARD_RECTANGLE_STATE_CREATE_INFO_EXT
|
|
|
|
* Extending elink:VkDynamicState
|
|
|
|
** ename:VK_DYNAMIC_STATE_DISCARD_RECTANGLE_EXT
|
|
|
|
=== New Enums
|
|
|
|
* elink:VkPipelineDiscardRectangleStateCreateFlagsEXT
|
|
* elink:VkDiscardRectangleModeEXT
|
|
|
|
=== New Structures
|
|
|
|
* slink:VkPhysicalDeviceDiscardRectanglePropertiesEXT
|
|
* slink:VkPipelineDiscardRectangleStateCreateInfoEXT
|
|
|
|
=== New Functions
|
|
|
|
* flink:vkCmdSetDiscardRectangleEXT
|
|
|
|
=== Issues
|
|
|
|
None.
|
|
|
|
=== Version History
|
|
|
|
* Revision 1, 2016-12-22 (Piers Daniell)
|
|
- Internal revisions
|