mirror of
https://github.com/status-im/Vulkan-Docs.git
synced 2025-02-19 17:48:23 +00:00
* Update release number to 96. Public Issues: * Fix typo in `vk.xml` for `structextends` attribute of slink:VkPhysicalDeviceShadingRateImagePropertiesNV (public PR 870). * Fix links in optimized PDF output (public PR 879). Internal Issues: * Add a link to GitHub contributors in the <<credits, Other Credits>> section (internal issue 808). * Clarify the behavior of command aliases described in the <<versions,Core Revisions>> and <<initialization-functionpointers, Command Function Pointers>> sections and the registry schema document with respect to whether they are or are not the same entry point, and what the behaviour of the ftext:vkGet*ProcAddr commands is for each alias (internal issue 1462). * Update slink:VkPipelineShaderStageCreateInfo valid usage statements for writing to code:Layer and code:viewportIndex to apply to any vertex processing stage (internal issue 1475). * Make sparse image creation optional for Y'C~B~C~R~ formats in the <<features-required-format-support, Required Format Support>> section and the <<features-formats-requiring-sampler-ycbcr-conversion, Formats requiring sampler Y'C~B~C~R~ conversion for ename:VK_IMAGE_ASPECT_COLOR_BIT image views>> table (internal issue 1476). * Modify the valid usage statement for flink:vkCmdDrawIndirectByteCountEXT::pname:vertexStride to use the pname:maxTransformFeedbackBufferDataStride limit rather than the pname:maxVertexInputBindingStride limit, which is a better match for transform feedback related operations (internal issue 1487). * Changed all members of slink:VkPhysicalDevicePCIBusInfoPropertiesEXT to have the `uint32_t` type. This is an imcompatible change to an EXT that's very recently released; although this is against usual Vulkan WG policy, we discussed and consider this an acceptable risk, but have polled the mesa-dev list in case there are use cases we missed (internal issue 1492). * Set spec vetsion to 1 for `VK_GOOGLE_hlsl_functionality1` and `VK_GOOGLE_decorate_string` in `vk.xml` (internal MR 2948). * Remove redundant valid usage statement `VkImageCreateInfo-pNext-02395` (internal MR 2950). * Add `check_spec_links.py` script, use it in Gitlab CI, and fix many minor markup issues discovered by the script (internal MR 2955). * Update `BUILD.md` to the current Ruby version (2.5.3), and make some corresponding updates to per-platform build instructions (internal MR 2956). * Fix binding numbers and other details in flink:vkUpdateDescriptorSetWithTemplate.txt example code blocks (internal MR 2960). * Remove some nautovalidity="true" in `vk.xml` for NV extensions where it's clearly wrong (internal MR 2970).
70 lines
2.0 KiB
Plaintext
70 lines
2.0 KiB
Plaintext
include::meta/VK_EXT_discard_rectangles.txt[]
|
|
|
|
*Last Modified Date*::
|
|
2016-12-22
|
|
*Interactions and External Dependencies*::
|
|
- Interacts with VK_KHR_device_group
|
|
- Interacts with Vulkan 1.1
|
|
*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.
|
|
ifdef::VK_VERSION_1_1,VK_KHR_device_group[]
|
|
The discard rectangles can be different for each physical device in a device
|
|
group by specifying the device mask and setting discard rectangle dynamic
|
|
state.
|
|
endif::VK_VERSION_1_1,VK_KHR_device_group[]
|
|
|
|
=== 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
|
|
|
|
* tlink: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
|