status-im
/
Vulkan-Docs
mirror of https://github.com/status-im/Vulkan-Docs.git
2
0
Fork 0
Code Issues Projects Releases Wiki Activity
Vulkan-Docs/appendices/VK_EXT_shader_stencil_expor...

26 lines
796 B
Plaintext
Raw Normal View History

Change log for September 5, 2017 Vulkan 1.0.60 spec update: * Bump API patch number and header version number to 60 for this update. Github Issues: * Document that <<queries-timestamps, Timestamp Queries>> can only be meaningfully compared when they are written from the same queue (public issue 216). * Document that the `<extension>` tag `type` attribute is required for non-disabled extensions (derived from, but does not close public issue 354). * Clean up registry schema length attribute descriptions to be consistent and correct (public issue 555). Internal Issues: * Replace as much of the hand-written extension appendix metadata as possible with asciidoc includes generated from corresponding attributes of +vk.xml+, and enhance the style guide to match. This avoids inconsistencies between +vk.xml+ and the appendices, and produces a more uniform style (internal issue 137). * Remove the generated extDependency.{py,sh} files from the tree and create them dynamically on demand instead, reducing merge conflicts (internal issue 713). * Add a prototype tool for generating in-place difference markup for sections guarded by asciidoc conditionals, and new syntax for open blocks to support it (internal issue 833). * Remove unnecessary restriction of etext:*SYNC_FD_BIT_KHR external handle types to the same physical device in the slink:VkPhysicalDeviceIDPropertiesKHR, flink:VkImportMemoryWin32HandleInfoKHR, slink:VkImportFenceWin32HandleInfoKHR, slink:VkImportFenceFdInfoKHR, slink:VkImportSemaphoreWin32HandleInfoKHR, slink:VkImportSemaphoreFdInfoKHR <<external-memory-handle-types-compatibility, External memory handle types compatibility>>, <<external-semaphore-handle-types-compatibility, External semaphore handle types compatibility>>, and <<external-fence-handle-types-compatibility, External fence handle types compatibility>> sections (internal issue 956). Other Issues: * Remove dependency of +VK_KHX_device_group+ on +VK_KHR_swapchain+ (there is an interaction, but not a strict dependency), and add a new `extension` attribute to the `<require` XML tag to allow classifying a subset of interfaces of an extension as requiring another extension. Update the registry schema and documentation accordingly. New Extensions: * `VK_AMD_shader_fragment_mask` (and related `GL_AMD_shader_fragment_mask` GLSL extension) * `VK_EXT_sample_locations` * `VK_EXT_validation_cache`
2017-09-04 10:06:55 +00:00
include::meta/VK_EXT_shader_stencil_export.txt[]
Change log for August 19, 2017 Vulkan 1.0.59 spec update: * Bump API patch number and header version number to 59 for this update. Github Issues: * Fix a few missing Implicit Valid Usage statements to indicate that a common parent of two objects is required (public issue 497). * Clarify render pass synchronization language for slink:VkSubpassDependency and \<\<renderpass,render passes>> (public issue 531). * Rename ename:VK_STRUCTURE_TYPE_SURFACE_CAPABILITIES2_EXT to ename:VK_STRUCTURE_TYPE_SURFACE_CAPABILITIES_2_EXT for consistency, and add an alias for backwards compatibility (public issue 539). Internal Issues: * Add an explanation to the \<\<interfaces-builtin-variables-layer, code:Layer>> description explaining that writing to invalid layers results may or may not result in primitives being processed and fragment shaders being run, and gives undefined results in the framebuffer (internal issue 614) * Add valid usage statement for slink:VkDescriptorSetLayoutBinding requiring that input attachment descriptor bindings must not use non-fragment stages (internal issue 933). Other Issues: * Makes description of pname:loadOp and pname:storeOp easier to read in the \<\<renderpass-load-store-ops>> section. New Extensions: * `VK_EXT_shader_stencil_export`
2017-08-20 08:06:59 +00:00
*Last Modified Date*::
Update some old date formats
2017-10-26 17:45:00 +00:00
2017-07-19
Change log for August 19, 2017 Vulkan 1.0.59 spec update: * Bump API patch number and header version number to 59 for this update. Github Issues: * Fix a few missing Implicit Valid Usage statements to indicate that a common parent of two objects is required (public issue 497). * Clarify render pass synchronization language for slink:VkSubpassDependency and \<\<renderpass,render passes>> (public issue 531). * Rename ename:VK_STRUCTURE_TYPE_SURFACE_CAPABILITIES2_EXT to ename:VK_STRUCTURE_TYPE_SURFACE_CAPABILITIES_2_EXT for consistency, and add an alias for backwards compatibility (public issue 539). Internal Issues: * Add an explanation to the \<\<interfaces-builtin-variables-layer, code:Layer>> description explaining that writing to invalid layers results may or may not result in primitives being processed and fragment shaders being run, and gives undefined results in the framebuffer (internal issue 614) * Add valid usage statement for slink:VkDescriptorSetLayoutBinding requiring that input attachment descriptor bindings must not use non-fragment stages (internal issue 933). Other Issues: * Makes description of pname:loadOp and pname:storeOp easier to read in the \<\<renderpass-load-store-ops>> section. New Extensions: * `VK_EXT_shader_stencil_export`
2017-08-20 08:06:59 +00:00
*IP Status*::
No known IP claims.
Change log for September 5, 2017 Vulkan 1.0.60 spec update: * Bump API patch number and header version number to 60 for this update. Github Issues: * Document that <<queries-timestamps, Timestamp Queries>> can only be meaningfully compared when they are written from the same queue (public issue 216). * Document that the `<extension>` tag `type` attribute is required for non-disabled extensions (derived from, but does not close public issue 354). * Clean up registry schema length attribute descriptions to be consistent and correct (public issue 555). Internal Issues: * Replace as much of the hand-written extension appendix metadata as possible with asciidoc includes generated from corresponding attributes of +vk.xml+, and enhance the style guide to match. This avoids inconsistencies between +vk.xml+ and the appendices, and produces a more uniform style (internal issue 137). * Remove the generated extDependency.{py,sh} files from the tree and create them dynamically on demand instead, reducing merge conflicts (internal issue 713). * Add a prototype tool for generating in-place difference markup for sections guarded by asciidoc conditionals, and new syntax for open blocks to support it (internal issue 833). * Remove unnecessary restriction of etext:*SYNC_FD_BIT_KHR external handle types to the same physical device in the slink:VkPhysicalDeviceIDPropertiesKHR, flink:VkImportMemoryWin32HandleInfoKHR, slink:VkImportFenceWin32HandleInfoKHR, slink:VkImportFenceFdInfoKHR, slink:VkImportSemaphoreWin32HandleInfoKHR, slink:VkImportSemaphoreFdInfoKHR <<external-memory-handle-types-compatibility, External memory handle types compatibility>>, <<external-semaphore-handle-types-compatibility, External semaphore handle types compatibility>>, and <<external-fence-handle-types-compatibility, External fence handle types compatibility>> sections (internal issue 956). Other Issues: * Remove dependency of +VK_KHX_device_group+ on +VK_KHR_swapchain+ (there is an interaction, but not a strict dependency), and add a new `extension` attribute to the `<require` XML tag to allow classifying a subset of interfaces of an extension as requiring another extension. Update the registry schema and documentation accordingly. New Extensions: * `VK_AMD_shader_fragment_mask` (and related `GL_AMD_shader_fragment_mask` GLSL extension) * `VK_EXT_sample_locations` * `VK_EXT_validation_cache`
2017-09-04 10:06:55 +00:00
*Interactions and External Dependencies*::
- Requires the
https://www.khronos.org/registry/spir-v/extensions/EXT/SPV_EXT_shader_stencil_export.html[+SPV_EXT_shader_stencil_export+]
SPIR-V extension.
Change log for August 19, 2017 Vulkan 1.0.59 spec update: * Bump API patch number and header version number to 59 for this update. Github Issues: * Fix a few missing Implicit Valid Usage statements to indicate that a common parent of two objects is required (public issue 497). * Clarify render pass synchronization language for slink:VkSubpassDependency and \<\<renderpass,render passes>> (public issue 531). * Rename ename:VK_STRUCTURE_TYPE_SURFACE_CAPABILITIES2_EXT to ename:VK_STRUCTURE_TYPE_SURFACE_CAPABILITIES_2_EXT for consistency, and add an alias for backwards compatibility (public issue 539). Internal Issues: * Add an explanation to the \<\<interfaces-builtin-variables-layer, code:Layer>> description explaining that writing to invalid layers results may or may not result in primitives being processed and fragment shaders being run, and gives undefined results in the framebuffer (internal issue 614) * Add valid usage statement for slink:VkDescriptorSetLayoutBinding requiring that input attachment descriptor bindings must not use non-fragment stages (internal issue 933). Other Issues: * Makes description of pname:loadOp and pname:storeOp easier to read in the \<\<renderpass-load-store-ops>> section. New Extensions: * `VK_EXT_shader_stencil_export`
2017-08-20 08:06:59 +00:00
*Contributors*::
- Dominik Witczak, AMD
- Daniel Rakos, AMD
- Rex Xu, AMD
This extension adds support for the SPIR-V extension
Change log for September 5, 2017 Vulkan 1.0.60 spec update: * Bump API patch number and header version number to 60 for this update. Github Issues: * Document that <<queries-timestamps, Timestamp Queries>> can only be meaningfully compared when they are written from the same queue (public issue 216). * Document that the `<extension>` tag `type` attribute is required for non-disabled extensions (derived from, but does not close public issue 354). * Clean up registry schema length attribute descriptions to be consistent and correct (public issue 555). Internal Issues: * Replace as much of the hand-written extension appendix metadata as possible with asciidoc includes generated from corresponding attributes of +vk.xml+, and enhance the style guide to match. This avoids inconsistencies between +vk.xml+ and the appendices, and produces a more uniform style (internal issue 137). * Remove the generated extDependency.{py,sh} files from the tree and create them dynamically on demand instead, reducing merge conflicts (internal issue 713). * Add a prototype tool for generating in-place difference markup for sections guarded by asciidoc conditionals, and new syntax for open blocks to support it (internal issue 833). * Remove unnecessary restriction of etext:*SYNC_FD_BIT_KHR external handle types to the same physical device in the slink:VkPhysicalDeviceIDPropertiesKHR, flink:VkImportMemoryWin32HandleInfoKHR, slink:VkImportFenceWin32HandleInfoKHR, slink:VkImportFenceFdInfoKHR, slink:VkImportSemaphoreWin32HandleInfoKHR, slink:VkImportSemaphoreFdInfoKHR <<external-memory-handle-types-compatibility, External memory handle types compatibility>>, <<external-semaphore-handle-types-compatibility, External semaphore handle types compatibility>>, and <<external-fence-handle-types-compatibility, External fence handle types compatibility>> sections (internal issue 956). Other Issues: * Remove dependency of +VK_KHX_device_group+ on +VK_KHR_swapchain+ (there is an interaction, but not a strict dependency), and add a new `extension` attribute to the `<require` XML tag to allow classifying a subset of interfaces of an extension as requiring another extension. Update the registry schema and documentation accordingly. New Extensions: * `VK_AMD_shader_fragment_mask` (and related `GL_AMD_shader_fragment_mask` GLSL extension) * `VK_EXT_sample_locations` * `VK_EXT_validation_cache`
2017-09-04 10:06:55 +00:00
+SPV_EXT_shader_stencil_export+, providing a mechanism whereby a shader may
Change log for August 19, 2017 Vulkan 1.0.59 spec update: * Bump API patch number and header version number to 59 for this update. Github Issues: * Fix a few missing Implicit Valid Usage statements to indicate that a common parent of two objects is required (public issue 497). * Clarify render pass synchronization language for slink:VkSubpassDependency and \<\<renderpass,render passes>> (public issue 531). * Rename ename:VK_STRUCTURE_TYPE_SURFACE_CAPABILITIES2_EXT to ename:VK_STRUCTURE_TYPE_SURFACE_CAPABILITIES_2_EXT for consistency, and add an alias for backwards compatibility (public issue 539). Internal Issues: * Add an explanation to the \<\<interfaces-builtin-variables-layer, code:Layer>> description explaining that writing to invalid layers results may or may not result in primitives being processed and fragment shaders being run, and gives undefined results in the framebuffer (internal issue 614) * Add valid usage statement for slink:VkDescriptorSetLayoutBinding requiring that input attachment descriptor bindings must not use non-fragment stages (internal issue 933). Other Issues: * Makes description of pname:loadOp and pname:storeOp easier to read in the \<\<renderpass-load-store-ops>> section. New Extensions: * `VK_EXT_shader_stencil_export`
2017-08-20 08:06:59 +00:00
generate the stencil reference value per invocation.
When stencil testing is enabled, this allows the test to be performed
against the value generated in the shader.
=== Version History
* Revision 1, 2017-07-19 (Dominik Witczak)
- Initial draft