mirror of
https://github.com/status-im/Vulkan-Docs.git
synced 2025-02-17 08:46:32 +00:00
43f1fd5550
* Bump API patch number and header version number to 44 for this update.
Github Issues:
* Fix description of <<features-extentperimagetype, Allowed Extent Values
Based On Image Type>> (public issue 290).
* Better specify VK_DEVICE_LOST behavior around flink:vkQueueSubmit,
flink:vkWaitForFences, and flink:vkGetFenceStatus (public issue 423).
* Clarify definition of flink:vkGetQueryPoolResults::pname:queryCount
(public issue 441).
* Simplify and clean up normative language. Remove shall and replace
recommend and variants with should wherever possible (public issue 448).
* Fix all dangling internal cross-references in the 1.0-extensions
specification, and add scripts/checkXrefs to find these in the future
(public issue 456).
* Reverse order of ChangeLog.txt entries so the most recent version is
documented first (public issue 463)
* Removes "become invalid" which clashes with invalid state for command
buffers. (public issue 467)
* Disallowed pending state in spec text for vkResetCommandBuffer, matching
valid usage (public issue 468)
* Removes sentence describing invalid state "like initial state". (public
issue 469)
* Disallows begin command buffer from resetting command buffers in the
"recording" state. (public issue 470)
* Removes mention of state from description of
VK_COMMAND_POOL_CREATE_RESET_COMMAND_BUFFER_BIT (public issue 471)
* Removed extra valid usage statement in VkSubmitInfo (public issue 472)
Internal Issues:
* Clarify description of the pname:imageLayout member of
sname:VkDescriptorImageInfo.
* Fix typos where etext:VK_VIEW_TYPE* was used instead of
etext:VK_IMAGE_VIEW_TYPE.
* Removed the <<VK_KHR_display>> and <<VK_KHR_display_swapchain>> example
code from the specification and noted it has been moved to the Vulkan
SDK cube demo (internal issue 179).
* Reorder VkExternalMemoryHandleTypeFlagBitsNV description (internal issue
480).
* Clarify than an implementation is
<<fundamentals-validusage-flags,permitted to return 'undefined' bit
flags>> in a bitfield (internal issue 640).
* Break Valid Usage statements describing unrelated parameters into
separate statements, and add a style guide entry to follow this approach
(internal issue 685).
* Move valid usage statement for slink:VkImageCreateInfo from spec body to
the explicit valid usage block (internal issue 693).
* Fix typos in the descriptions of slink:VkDisplaySurfaceCreateInfoKHR,
flink:vkCreateDisplayModeKHR, and
flink:vkGetDisplayPlaneSupportedDisplaysKHR in the <<display,Presenting
Directly to Display Devices>> section (internal issue 698, 704, 716).
* Clarified that mandatory depth/stencil formats are only a requirement
for 2D images (internal issue 719).
* Clarify that variables decorated with DeviceIndex/ViewIndex must be in
the Input storage class (internal issue 733).
* Work around generator script problem with removal of Unicode literals
from Python 3.0-3.2 using `future` package (internal issue 737).
* Remove nonexistent structure type enums from vk.xml (internal issue
738).
* Fix validextensionstructs attributes for structures in the pname:pNext
chain for VkPresentInfoKHR, fixing implicit valid usage statements for
those structures (internal issue 740).
New Extensions:
124 lines
3.6 KiB
Plaintext
124 lines
3.6 KiB
Plaintext
[[VK_AMD_rasterization_order]]
|
|
== VK_AMD_rasterization_order
|
|
|
|
*Name String*::
|
|
+VK_AMD_rasterization_order+
|
|
*Extension Type*::
|
|
Device extension
|
|
*Registered Extension Number*::
|
|
19
|
|
*Last Modified Date*::
|
|
2016-04-25
|
|
*Revision*::
|
|
1
|
|
*IP Status*::
|
|
No known IP claims.
|
|
*Dependencies*::
|
|
- This extension is written against version 1.0.11 of the Vulkan API.
|
|
*Contributors*::
|
|
- Matthaeus G.
|
|
Chajdas, AMD
|
|
- Jaakko Konttinen, AMD
|
|
- Daniel Rakos, AMD
|
|
- Graham Sellers, AMD
|
|
- Dominik Witczak, AMD
|
|
*Contacts*::
|
|
- Daniel Rakos, AMD
|
|
|
|
This extension introduces the possibility for the application to control the
|
|
order of primitive rasterization.
|
|
In unextended Vulkan, the following stages are guaranteed to execute in _API
|
|
order_:
|
|
|
|
* depth bounds test
|
|
* stencil test, stencil op, and stencil write
|
|
* depth test and depth write
|
|
* occlusion queries
|
|
* blending, logic op, and color write
|
|
|
|
This extension enables applications to opt into a relaxed, implementation
|
|
defined primitive rasterization order that may allow better parallel
|
|
processing of primitives and thus enabling higher primitive throughput.
|
|
It is applicable in cases where the primitive rasterization order is known
|
|
to not affect the output of the rendering or any differences caused by a
|
|
different rasterization order are not a concern from the point of view of
|
|
the application's purpose.
|
|
|
|
A few examples of cases when using the relaxed primitive rasterization order
|
|
would not have an effect on the final rendering:
|
|
|
|
* If the primitives rendered are known to not overlap in framebuffer
|
|
space.
|
|
* If depth testing is used with a comparison operator of
|
|
ename:VK_COMPARE_OP_LESS, ename:VK_COMPARE_OP_LESS_OR_EQUAL,
|
|
ename:VK_COMPARE_OP_GREATER, or ename:VK_COMPARE_OP_GREATER_OR_EQUAL,
|
|
and the primitives rendered are known to not overlap in clip space.
|
|
* If depth testing is not used and blending is enabled for all attachments
|
|
with a commutative blend operator.
|
|
|
|
=== New Object Types
|
|
|
|
None
|
|
|
|
=== New Enum Constants
|
|
|
|
* Extending elink:VkStructureType:
|
|
** ename:VK_STRUCTURE_TYPE_PIPELINE_RASTERIZATION_STATE_RASTERIZATION_ORDER_AMD
|
|
|
|
=== New Enums
|
|
|
|
* elink:VkRasterizationOrderAMD
|
|
|
|
=== New Structures
|
|
|
|
* slink:VkPipelineRasterizationStateRasterizationOrderAMD
|
|
|
|
=== New Functions
|
|
|
|
None
|
|
|
|
=== Issues
|
|
|
|
1) How is this extension useful to application developers?
|
|
|
|
*RESOLVED*: Allows them to increase primitive throughput for cases when
|
|
strict API order rasterization is not important due to the nature of the
|
|
content, the configuration used, or the requirements towards the output of
|
|
the rendering.
|
|
|
|
2) How does this extension interact with content optimizations aiming to
|
|
reduce overdraw by appropriately ordering the input primitives?
|
|
|
|
*RESOLVED*: While the relaxed rasterization order might somewhat limit the
|
|
effectiveness of such content optimizations, most of the benefits of it are
|
|
expected to be retained even when the relaxed rasterization order is used,
|
|
so applications should: still apply these optimizations even if they intend
|
|
to use the extension.
|
|
|
|
3) Are there any guarantees about the primitive rasterization order when
|
|
using the new relaxed mode?
|
|
|
|
*RESOLVED*: No.
|
|
The rasterization order is completely implementation dependent in this case
|
|
but in practice it is expected to partially still follow the order of
|
|
incoming primitives.
|
|
|
|
4) Does the new relaxed rasterization order have any adverse effect on
|
|
repeatability and other invariance rules of the API?
|
|
|
|
*RESOLVED*: Yes, in the sense that it extends the list of exceptions when
|
|
the repeatability requirement does not apply.
|
|
|
|
=== Examples
|
|
|
|
None
|
|
|
|
=== Issues
|
|
|
|
None
|
|
|
|
=== Version History
|
|
|
|
* Revision 1, 2016-04-25 (Daniel Rakos)
|
|
- Initial draft.
|