Vulkan-Docs/appendices/VK_INTEL_shader_integer_functions2.txt

56 lines
1.2 KiB
Plaintext
Raw Normal View History

include::{generated}/meta/VK_INTEL_shader_integer_functions2.txt[]
*Last Modified Date*::
2019-04-30
*IP Status*::
No known IP claims.
*Contributors*::
- Ian Romanick, Intel
- Ben Ashbaugh, Intel
Change log for May 24, 2019 Vulkan 1.1.109 spec update: * Update release number to 109. Github Issues: * Require matching for physical devices to be in a device group in the <<devsandqueues-devices, Devices>> section (public issue 695). * Fix typo in an equation in the <<fragmentdensitymap-fetch-density-value, Fetch Density Value>> section (public issue 954). * Fix styleguide links (public pull request 965). Internal Issues: * Allow <<renderpass-compatibility, compatibility of single-subpass renderpasses>> with different resolve attachments (internal issue 1464). * Add some missing empty flags types to API spec so custom refpage generation doesn't break (internal issue 1607). * Add a "`SPIR-V Sampled Type`" column to the <<formats-numericformat, Interpretation of Numeric Formats>> table, and clarify the requirement that the code:OpTypeImage sampled type match the bound image's numeric format for slink:VkClearColorValue and in the <<interfaces-resources-descset, Descriptor Set Interface>> section (internal issue 1646). * Fix a typo in the <<tessellation-quad-tessellation, Quad Tessellation>> section which should refer to rectangles, not triangles (internal issue 1667). * Clarify the definition of time domains in elink:VkTimeDomainEXT (internal merge request 3110). * Add R10X6 and R12X4 formats to the <<formats-mandatory-features-10bit>> table (internal merge request 3137). * Don't require extern sync on wait/signal semaphores in `vk.xml` for flink:vkQueueSubmit and flink:vkQueueBindSparse (internal merge request 3116). * Improve phrasing of compute and mesh shader size related to code:LocalSize and code:WorkgroupSize in slink:VkPhysicalDeviceMeshShaderPropertiesNV and slink:VkPhysicalDeviceMaintenance3Properties (internal merge request 3156). * Make the flink:vkCmdBindShadingRateImageNV pname:imageView parameter optional in `vk.xml` (internal merge request 3157). New Extensions: * `<<VK_INTEL_performance_query>>` * `<<VK_INTEL_shader_integer_functions2>>`
2019-05-24 05:29:25 -07:00
This extension adds support for several new integer instructions in SPIR-V
for use in graphics shaders.
Many of these instructions have pre-existing counterparts in the Kernel
environment.
The added integer functions are defined by the
Change log for August 17, 2019 Vulkan 1.1.120 spec update: * Update release number to 120. Github Issues: * Add slink:VkAccelerationStructureTypeNV explicitly to extension XML for `<<VK_NV_ray_tracing>>` (public issue 848). * Add missing valid usage statements for feature flags in slink:VkCommandBufferInheritanceInfo (public pull request 1017). Internal Issues: * Clarify behavior of non-premultiplied destination colors for `<<VK_EXT_blend_operation_advanced>>` prior to the definition of slink:VkBlendOverlapEXT (internal issue 1766). * Fix the confusing phrasing "`no other queue must: be (doing something)`" for flink:vkQueuePresentKHR, flink:vkQueueSubmit, and flink:vkQueueBindSparse (internal issue 1774). * Add `<<VK_EXT_validation_features>>` flag to enable best practices checks, which will soon be available in the validation layer (internal issue 1779). * Specify allowed characters for VUID tag name components in the style guide (internal issue 1788). * Update links to SPIR-V extension specifications, and parameterize their markup in case the URLs change in the future (internal issue 1797). * Fix an off-by-one error in the valid usage statement for slink:VkPipelineExecutableInfoKHR (internal merge request 3303). * Clean up markup indentation not matching the style guide (internal merge request 3314). * Minor script updates to allow refpage aliases, generate a dynamic TOC for refpages, generate Apache rewrite rules for aliases, open external links from refpages in a new window, and synchronize with the OpenCL scripts. This will shortly enable a paned navigation setup for refpages, similar to the OpenCL 2.2 refpages (internal merge request 3322). * Script updates to add tests to the checker, refactor and reformat code, generate better text for some valid usage statements, use more Pythonic idioms, and synchronize with the OpenXR scripts (internal merge request 3239). * Script updates and minor fixes in spec language to not raise checker errors for refpage markup of pages not existing in the API, such as VKAPI_NO_STDINT_H. Remove corresponding suppression of some check_spec_links.py tests from .gitlab-ci.yml and 'allchecks' target (internal merge request 3315).
2019-08-17 15:33:21 -07:00
{spirv}/INTEL/SPV_INTEL_shader_integer_functions2.html[`SPV_INTEL_shader_integer_functions`]
Change log for May 24, 2019 Vulkan 1.1.109 spec update: * Update release number to 109. Github Issues: * Require matching for physical devices to be in a device group in the <<devsandqueues-devices, Devices>> section (public issue 695). * Fix typo in an equation in the <<fragmentdensitymap-fetch-density-value, Fetch Density Value>> section (public issue 954). * Fix styleguide links (public pull request 965). Internal Issues: * Allow <<renderpass-compatibility, compatibility of single-subpass renderpasses>> with different resolve attachments (internal issue 1464). * Add some missing empty flags types to API spec so custom refpage generation doesn't break (internal issue 1607). * Add a "`SPIR-V Sampled Type`" column to the <<formats-numericformat, Interpretation of Numeric Formats>> table, and clarify the requirement that the code:OpTypeImage sampled type match the bound image's numeric format for slink:VkClearColorValue and in the <<interfaces-resources-descset, Descriptor Set Interface>> section (internal issue 1646). * Fix a typo in the <<tessellation-quad-tessellation, Quad Tessellation>> section which should refer to rectangles, not triangles (internal issue 1667). * Clarify the definition of time domains in elink:VkTimeDomainEXT (internal merge request 3110). * Add R10X6 and R12X4 formats to the <<formats-mandatory-features-10bit>> table (internal merge request 3137). * Don't require extern sync on wait/signal semaphores in `vk.xml` for flink:vkQueueSubmit and flink:vkQueueBindSparse (internal merge request 3116). * Improve phrasing of compute and mesh shader size related to code:LocalSize and code:WorkgroupSize in slink:VkPhysicalDeviceMeshShaderPropertiesNV and slink:VkPhysicalDeviceMaintenance3Properties (internal merge request 3156). * Make the flink:vkCmdBindShadingRateImageNV pname:imageView parameter optional in `vk.xml` (internal merge request 3157). New Extensions: * `<<VK_INTEL_performance_query>>` * `<<VK_INTEL_shader_integer_functions2>>`
2019-05-24 05:29:25 -07:00
SPIR-V extension and can be used with the GL_INTEL_shader_integer_functions2
GLSL extension.
=== New Object Types
None.
=== New Enum Constants
* Extending elink:VkStructureType:
Change log for July 14, 2019 Vulkan 1.1.115 spec update: * Update release number to 115. GitHub issues: * Add valid usage statements to slink:VkWriteDescriptorSet and slink:VkCopyDescriptorSet specifying that updating immutable descriptors with ename:VK_DESCRIPTOR_TYPE_SAMPLER is invalid, and that updating ename:VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER ignores the update's samplers (public issue 985). * Document that the `manhtmlpages` target requires building with all extensions enabled, in `BUILD.adoc` (public issue 992). * Fix reference to the wrong subpass in valid usage statement for slink:VkRenderPassCreateInfo (public pull request 994). Internal Issues: * Rename slink:VkPhysicalDeviceShaderIntegerFunctions2INTEL and ename:VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SHADER_INTEGER_FUNCTIONS2_FEATURES_INTEL for consistency with global naming conventions, and to help code generation in other projects (internal issue 1685). * Update valid usage statements for image code:Offset / code:ConstOffset usage in the <<textures-gather, Texel Gathering>> and <<spirvenv-module-validation, Validation Rules within a Module>> sections, and for the <<limits-minTexelGatherOffset>> and <<limits-maxTexelGatherOffset>> limits (internal issue 1723). * Require code:code:OpGroupNonUniformBroadcast to take a constant `Id` operand in the <<spirvenv-module-validation, Validation Rules within a Module>> sections (internal issue 1726). * Note that the swapchain specified in slink:VkImageSwapchainCreateInfoKHR when creating an image must match the one specified in slink:VkBindImageMemorySwapchainInfoKHR when binding memory to the image (internal issue 1729). * Remove stext:KHR suffix from some structure cross-references that were promoted to Vulkan 1.1 (internal issue 1730). * Fix structure name in `structextends` attribute for slink:VkPhysicalDeviceTexelBufferAlignmentPropertiesEXT in `vk.xml` (internal issue 1740). * Fix an error in the code:ClipColor() pseudocode for <<VK_EXT_blend_operation_advanced>> (internal issue 1741). * Add a row for ename:VK_QUERY_TYPE_ACCELERATION_STRUCTURE_COMPACTED_SIZE_NV to the description of elink:VkQueryType, and make a few related minor text cleanups. * Rename slink:VkPhysicalDeviceFloat16Int8FeaturesKHR to slink:VkPhysicalDeviceShaderFloat16Int8FeaturesKHR for consistency, retaining aliases of the old structure name and structure type enum for backwards compatibility.
2019-07-14 06:04:09 -07:00
** ename:VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SHADER_INTEGER_FUNCTIONS_2_FEATURES_INTEL
=== New Enums
None.
=== New Structures
* Extending slink:VkPhysicalDeviceFeatures2:
Change log for July 14, 2019 Vulkan 1.1.115 spec update: * Update release number to 115. GitHub issues: * Add valid usage statements to slink:VkWriteDescriptorSet and slink:VkCopyDescriptorSet specifying that updating immutable descriptors with ename:VK_DESCRIPTOR_TYPE_SAMPLER is invalid, and that updating ename:VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER ignores the update's samplers (public issue 985). * Document that the `manhtmlpages` target requires building with all extensions enabled, in `BUILD.adoc` (public issue 992). * Fix reference to the wrong subpass in valid usage statement for slink:VkRenderPassCreateInfo (public pull request 994). Internal Issues: * Rename slink:VkPhysicalDeviceShaderIntegerFunctions2INTEL and ename:VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SHADER_INTEGER_FUNCTIONS2_FEATURES_INTEL for consistency with global naming conventions, and to help code generation in other projects (internal issue 1685). * Update valid usage statements for image code:Offset / code:ConstOffset usage in the <<textures-gather, Texel Gathering>> and <<spirvenv-module-validation, Validation Rules within a Module>> sections, and for the <<limits-minTexelGatherOffset>> and <<limits-maxTexelGatherOffset>> limits (internal issue 1723). * Require code:code:OpGroupNonUniformBroadcast to take a constant `Id` operand in the <<spirvenv-module-validation, Validation Rules within a Module>> sections (internal issue 1726). * Note that the swapchain specified in slink:VkImageSwapchainCreateInfoKHR when creating an image must match the one specified in slink:VkBindImageMemorySwapchainInfoKHR when binding memory to the image (internal issue 1729). * Remove stext:KHR suffix from some structure cross-references that were promoted to Vulkan 1.1 (internal issue 1730). * Fix structure name in `structextends` attribute for slink:VkPhysicalDeviceTexelBufferAlignmentPropertiesEXT in `vk.xml` (internal issue 1740). * Fix an error in the code:ClipColor() pseudocode for <<VK_EXT_blend_operation_advanced>> (internal issue 1741). * Add a row for ename:VK_QUERY_TYPE_ACCELERATION_STRUCTURE_COMPACTED_SIZE_NV to the description of elink:VkQueryType, and make a few related minor text cleanups. * Rename slink:VkPhysicalDeviceFloat16Int8FeaturesKHR to slink:VkPhysicalDeviceShaderFloat16Int8FeaturesKHR for consistency, retaining aliases of the old structure name and structure type enum for backwards compatibility.
2019-07-14 06:04:09 -07:00
** slink:VkPhysicalDeviceShaderIntegerFunctions2FeaturesINTEL
=== New Functions
None.
=== New SPIR-V Capabilities
* <<spirvenv-capabilities-table-cooperativeMatrix,ShaderIntegerFunctions2INTEL>>
=== Issues
None.
=== Version History
* Revision 1, 2019-04-30 (Ian Romanick)
- Initial draft