2
0

spir-v.xml 22 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <registry>
  3. <!--
  4. Copyright (c) 2015-2024 The Khronos Group Inc.
  5. Permission is hereby granted, free of charge, to any person obtaining a
  6. copy of this software and/or associated documentation files (the
  7. "Materials"), to deal in the Materials without restriction, including
  8. without limitation the rights to use, copy, modify, merge, publish,
  9. distribute, sublicense, and/or sell copies of the Materials, and to
  10. permit persons to whom the Materials are furnished to do so, subject to
  11. the following conditions:
  12. The above copyright notice and this permission notice shall be included
  13. in all copies or substantial portions of the Materials.
  14. THE MATERIALS ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  15. EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  16. MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
  17. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
  18. CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
  19. TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
  20. MATERIALS OR THE USE OR OTHER DEALINGS IN THE MATERIALS.
  21. -->
  22. <!--
  23. This file, spir-v.xml, is the SPIR-V Tool ID, opcode and enumerant registry.
  24. The canonical version of the registry, together with related schema and
  25. documentation, can be found in the Khronos Registry at
  26. include/spirv/spir-v.xml in the master branch at
  27. https://github.com/KhronosGroup/SPIRV-Headers
  28. -->
  29. <!-- SECTION: SPIR-V Tool ID Definitions -->
  30. <!-- A SPIR-V Generator Magic Number is a 32 bit word: The high order 16
  31. bits are a tool ID, which should be unique across all SPIR-V
  32. generators. The low order 16 bits are reserved for use as a tool
  33. version number, or any other purpose the tool supplier chooses.
  34. Only the tool IDs are reserved with Khronos.
  35. Add new tool ID reservations contiguously with the first available
  36. number (the "start" attribute of the <unused> tag below), and
  37. modify that <unused> tag accordingly. Please add a vendor/tool
  38. supplier name in a 'vendor="name"' attribute; a tool name in a
  39. 'tool="name"' attribute; and a contact person/address in a
  40. 'comment' attribute. Remember that this value is the high 16 bits
  41. of a 32-bit word.
  42. Note: a single vendor/tool supplier may have multiple tool IDs
  43. reserved for different SPIR-V generators -->
  44. <ids type="vendor" start="0" end="0xFFFF" comment="SPIR-V Tool IDs">
  45. <id value="0" vendor="Khronos" comment="Reserved by Khronos"/>
  46. <id value="1" vendor="LunarG" comment="Contact TBD"/>
  47. <id value="2" vendor="Valve" comment="Contact TBD"/>
  48. <id value="3" vendor="Codeplay" comment="Contact Victor Lomuller, [email protected]"/>
  49. <id value="4" vendor="NVIDIA" comment="Contact Kerch Holt, [email protected]"/>
  50. <id value="5" vendor="ARM" comment="Contact Kevin Petit, [email protected]"/>
  51. <id value="6" vendor="Khronos" tool="LLVM/SPIR-V Translator" comment="Contact Yaxun (Sam) Liu, [email protected]"/>
  52. <id value="7" vendor="Khronos" tool="SPIR-V Tools Assembler" comment="Contact David Neto, [email protected]"/>
  53. <id value="8" vendor="Khronos" tool="Glslang Reference Front End" comment="Contact John Kessenich, [email protected]"/>
  54. <id value="9" vendor="Qualcomm" comment="Contact [email protected]"/>
  55. <id value="10" vendor="AMD" comment="Contact Daniel Rakos, [email protected]"/>
  56. <id value="11" vendor="Intel" comment="Contact Alexey, [email protected]"/>
  57. <id value="12" vendor="Imagination" comment="Contact Stephen Clarke, [email protected]"/>
  58. <id value="13" vendor="Google" tool="Shaderc over Glslang" comment="Contact David Neto, [email protected]"/>
  59. <id value="14" vendor="Google" tool="spiregg" comment="Contact Steven Perron, [email protected]"/>
  60. <id value="15" vendor="Google" tool="rspirv" comment="Contact Lei Zhang, [email protected]"/>
  61. <id value="16" vendor="X-LEGEND" tool="Mesa-IR/SPIR-V Translator" comment="Contact Metora Wang, github:metora/MesaGLSLCompiler"/>
  62. <id value="17" vendor="Khronos" tool="SPIR-V Tools Linker" comment="Contact David Neto, [email protected]"/>
  63. <id value="18" vendor="Wine" tool="VKD3D Shader Compiler" comment="Contact [email protected]"/>
  64. <id value="19" vendor="Tellusim" tool="Clay Shader Compiler" comment="Contact [email protected]"/>
  65. <id value="20" vendor="W3C WebGPU Group" tool="WHLSL Shader Translator" comment="https://github.com/gpuweb/WHLSL"/>
  66. <id value="21" vendor="Google" tool="Clspv" comment="Contact David Neto, [email protected]"/>
  67. <id value="22" vendor="LLVM" tool="MLIR SPIR-V Serializer" comment="Contact Jakub Kuderski, [email protected], https://mlir.llvm.org/docs/Dialects/SPIR-V/"/>
  68. <id value="23" vendor="Google" tool="Tint Compiler" comment="Contact David Neto, [email protected]"/>
  69. <id value="24" vendor="Google" tool="ANGLE Shader Compiler" comment="Contact Shahbaz Youssefi, [email protected]"/>
  70. <id value="25" vendor="Netease Games" tool="Messiah Shader Compiler" comment="Contact Yuwen Wu, [email protected]"/>
  71. <id value="26" vendor="Xenia" tool="Xenia Emulator Microcode Translator" comment="Contact Vitaliy Kuzmin, [email protected], https://github.com/xenia-project/xenia"/>
  72. <id value="27" vendor="Embark Studios" tool="Rust GPU Compiler Backend" comment="https://github.com/embarkstudios/rust-gpu"/>
  73. <id value="28" vendor="gfx-rs community" tool="Naga" comment="https://github.com/gfx-rs/naga"/>
  74. <id value="29" vendor="Mikkosoft Productions" tool="MSP Shader Compiler" comment="Contact Mikko Rasa, [email protected]"/>
  75. <id value="30" vendor="SpvGenTwo community" tool="SpvGenTwo SPIR-V IR Tools" comment="https://github.com/rAzoR8/SpvGenTwo"/>
  76. <id value="31" vendor="Google" tool="Skia SkSL" comment="Contact Ethan Nicholas, [email protected]"/>
  77. <id value="32" vendor="TornadoVM" tool="Beehive SPIRV Toolkit" comment="https://github.com/beehive-lab/beehive-spirv-toolkit"/>
  78. <id value="33" vendor="DragonJoker" tool="ShaderWriter" comment="Contact Sylvain Doremus, https://github.com/DragonJoker/ShaderWriter"/>
  79. <id value="34" vendor="Rayan Hatout" tool="SPIRVSmith" comment="Contact Rayan Hatout [email protected], Repo https://github.com/rayanht/SPIRVSmith"/>
  80. <id value="35" vendor="Saarland University" tool="Shady" comment="Contact Hugo Devillers [email protected], Repo https://github.com/Hugobros3/shady"/>
  81. <id value="36" vendor="Taichi Graphics" tool="Taichi" comment="Contact Rendong Liang [email protected], Repo https://github.com/taichi-dev/taichi"/>
  82. <id value="37" vendor="heroseh" tool="Hero C Compiler" comment="https://github.com/heroseh/hcc"/>
  83. <id value="38" vendor="Meta" tool="SparkSL" comment="Contact Dunfan Lu, [email protected], https://sparkar.facebook.com/ar-studio/learn/sparksl/sparksl-overview"/>
  84. <id value="39" vendor="SirLynix" tool="Nazara ShaderLang Compiler" comment="Contact Jérôme Leclercq, https://github.com/NazaraEngine/ShaderLang"/>
  85. <id value="40" vendor="Khronos" tool="Slang Compiler" comment="https://shader-slang.org"/>
  86. <id value="41" vendor="Zig Software Foundation" tool="Zig Compiler" comment="Contact Robin Voetter, https://github.com/Snektron"/>
  87. <id value="42" vendor="Rendong Liang" tool="spq" comment="Contact Rendong Liang, [email protected], https://github.com/PENGUINLIONG/spq-rs"/>
  88. <id value="43" vendor="LLVM" tool="LLVM SPIR-V Backend" comment="Contact Michal Paszkowski, [email protected], https://github.com/llvm/llvm-project/tree/main/llvm/lib/Target/SPIRV"/>
  89. <id value="44" vendor="Robert Konrad" tool="Kongruent" comment="Contact Robert Konrad, https://github.com/Kode/Kongruent"/>
  90. <id value="45" vendor="Kitsunebi Games" tool="Nuvk SPIR-V Emitter and DLSL compiler" comment="Contact Luna Nielsen, [email protected], https://github.com/Inochi2D/nuvk"/>
  91. <id value="46" vendor="Nintendo" comment="Contact Steve Urquhart, [email protected]"/>
  92. <id value="47" vendor="ARM" comment="Contact Christopher Gautier, [email protected]"/>
  93. <unused start="48" end="0xFFFF" comment="Tool ID range reservable for future use by vendors"/>
  94. </ids>
  95. <!-- SECTION: SPIR-V Opcodes and Enumerants -->
  96. <!-- Vendors reserve new ranges of:
  97. - opcode enumerants in the "opcode" list below, and
  98. - non-opcode enumerants in the non-opcodes "enumerant" list below.
  99. Both are reserved by contiguous blocks of 64, preceding the given
  100. "Future use" blocks.
  101. SPIR-V background:
  102. - SPIR-V currently has well over 30 enums, including the opcode enum
  103. - each enum has its own name space, allowing reuse of enumerants
  104. - SPIR-V restricts opcode enumerants to 16 bits
  105. - all other enums use 32-bit enumerants
  106. Reservation rules:
  107. - opcode reservations ("opcode") are only valid for opcodes
  108. - non-opcode reservations ("enumerant") are not valid for opcodes
  109. - reservations in the enumerant list are valid for all non-opcode enums
  110. - it is simpler to use each non-opcode enumerant for only one purpose
  111. but this is left to the discretion of the vendor
  112. - all enumerants in a range should be used before allocating a new range
  113. (several extensions can use enumerants from the same range)
  114. Each vendor determines the use of enumerants in the ranges they
  115. reserve. Vendors are not required to disclose those uses. If the use
  116. of an enumerant is included in an extension that is adopted by a Khronos
  117. extension or specification, then that enumerant's use may be permanently
  118. fixed as if originally reserved in a Khronos range.
  119. -->
  120. <!-- Begin reservations of opcode enumerants -->
  121. <ids type="opcode" start="0" end="4095" vendor="Khronos" comment="Reserved opcodes, not available to vendors - see the SPIR-V Specification"/>
  122. <ids type="opcode" start="4096" end="4159" vendor="Mesa" comment="Contact TBD"/>
  123. <ids type="opcode" start="4160" end="4415" vendor="ARM" comment="Contact [email protected]"/>
  124. <ids type="opcode" start="4416" end="4479" vendor="Khronos" comment="SPV_ARB_shader_ballot - contact Neil Henning, [email protected]"/>
  125. <ids type="opcode" start="4480" end="4991" vendor="Qualcomm" comment="Contact [email protected]"/>
  126. <ids type="opcode" start="4992" end="5247" vendor="AMD"/>
  127. <ids type="opcode" start="5248" end="5503" vendor="NVIDIA"/>
  128. <ids type="opcode" start="5504" end="5567" vendor="Imagination"/>
  129. <ids type="opcode" start="5568" end="5631" vendor="Intel" comment="Contact [email protected]"/>
  130. <ids type="opcode" start="5632" end="5695" vendor="Google" comment="Contact [email protected]"/>
  131. <ids type="opcode" start="5696" end="5823" vendor="Intel" comment="Contact [email protected]"/>
  132. <ids type="opcode" start="5824" end="5951" vendor="Intel" comment="Contact [email protected]"/>
  133. <ids type="opcode" start="5952" end="6015" vendor="Codeplay" comment="Contact [email protected]"/>
  134. <ids type="opcode" start="6016" end="6079" vendor="Khronos" comment="Contact @tobski"/>
  135. <ids type="opcode" start="6080" end="6143" vendor="Intel" comment="Contact [email protected]"/>
  136. <ids type="opcode" start="6144" end="6271" vendor="Intel" comment="Contact [email protected]"/>
  137. <ids type="opcode" start="6272" end="6399" vendor="Huawei" comment="Contact [email protected]"/>
  138. <ids type="opcode" start="6400" end="6463" vendor="Intel" comment="Contact [email protected]"/>
  139. <ids type="opcode" start="6464" end="6527" vendor="N/A" comment="Blank range to keep alignment with non-opcodes"/>
  140. <ids type="opcode" start="6528" end="6591" vendor="Codeplay" comment="Contact [email protected]"/>
  141. <ids type="opcode" start="6592" end="6655" vendor="Saarland University" comment="Contact [email protected]"/>
  142. <ids type="opcode" start="6656" end="6719" vendor="Meta" comment="Contact [email protected]"/>
  143. <ids type="opcode" start="6720" end="6783" vendor="MediaTek" comment="Contact [email protected]"/>
  144. <!-- Opcode enumerants to reserve for future use. To get a block, allocate
  145. multiples of 64 starting at the lowest available point in this
  146. block and add a corresponding <ids> tag immediately above. Make
  147. sure to fill in the vendor attribute, and preferably add a contact
  148. person/address in a comment attribute. -->
  149. <!-- Example new block: <ids type="opcode" start="XXXX" end="XXXX+64n-1" vendor="Add vendor" comment="Contact TBD"/> -->
  150. <ids type="opcode" start="6784" end="65535" comment="Opcode range reservable for future use by vendors"/>
  151. <!-- End reservations of opcodes -->
  152. <!-- Begin reservations of non-opcode enumerants -->
  153. <ids type="enumerant" start="0" end="4095" vendor="Khronos" comment="Reserved enumerants, not available to vendors - see the SPIR-V Specification"/>
  154. <ids type="enumerant" start="4096" end="4159" vendor="Mesa" comment="Contact TBD"/>
  155. <ids type="enumerant" start="4160" end="4415" vendor="ARM" comment="Contact [email protected]"/>
  156. <ids type="enumerant" start="4416" end="4479" vendor="Khronos" comment="SPV_ARB_shader_ballot - contact Neil Henning, [email protected]"/>
  157. <ids type="enumerant" start="4480" end="4991" vendor="Qualcomm" comment="Contact [email protected]"/>
  158. <ids type="enumerant" start="4992" end="5247" vendor="AMD"/>
  159. <ids type="enumerant" start="5248" end="5503" vendor="NVIDIA"/>
  160. <ids type="enumerant" start="5504" end="5567" vendor="Imagination"/>
  161. <ids type="enumerant" start="5568" end="5631" vendor="Intel" comment="Contact [email protected]"/>
  162. <ids type="enumerant" start="5632" end="5695" vendor="Google" comment="Contact [email protected]"/>
  163. <ids type="enumerant" start="5696" end="5823" vendor="Intel" comment="Contact [email protected]"/>
  164. <ids type="enumerant" start="5824" end="5951" vendor="Intel" comment="Contact [email protected]"/>
  165. <ids type="enumerant" start="5952" end="6015" vendor="Codeplay" comment="Contact [email protected]"/>
  166. <ids type="enumerant" start="6016" end="6079" vendor="Khronos" comment="Contact @tobski"/>
  167. <ids type="enumerant" start="6080" end="6143" vendor="Intel" comment="Contact [email protected]"/>
  168. <ids type="enumerant" start="6144" end="6271" vendor="Intel" comment="Contact [email protected]"/>
  169. <ids type="enumerant" start="6272" end="6399" vendor="Huawei" comment="Contact [email protected]"/>
  170. <ids type="enumerant" start="6400" end="6463" vendor="Intel" comment="Contact [email protected]"/>
  171. <ids type="enumerant" start="6464" end="6527" vendor="Mikkosoft Productions" comment="Contact Mikko Rasa, [email protected]"/>
  172. <ids type="enumerant" start="6528" end="6591" vendor="Codeplay" comment="Contact [email protected]"/>
  173. <ids type="enumerant" start="6592" end="6655" vendor="Saarland University" comment="Contact [email protected]"/>
  174. <ids type="enumerant" start="6656" end="6719" vendor="Meta" comment="Contact [email protected]"/>
  175. <ids type="enumerant" start="6720" end="6783" vendor="MediaTek" comment="Contact [email protected]"/>
  176. <!-- Enumerants to reserve for future use. To get a block, allocate
  177. multiples of 64 starting at the lowest available point in this
  178. block and add a corresponding <ids> tag immediately above. Make
  179. sure to fill in the vendor attribute, and preferably add a contact
  180. person/address in a comment attribute. -->
  181. <!-- Example new block: <ids type="enumerant" start="XXXX" end="XXXX+64n-1" vendor="Add vendor" comment="Contact TBD"/> -->
  182. <ids type="enumerant" start="6784" end="4294967295" comment="Enumerant range reservable for future use by vendors"/>
  183. <!-- End reservations of enumerants -->
  184. <!-- SECTION: SPIR-V Loop Control Bit Reservations -->
  185. <!-- Reserve ranges of bits in the loop control bitfield.
  186. Each vendor determines the use of values in their own ranges.
  187. Vendors are not required to disclose those uses. If the use of a
  188. value is included in an extension that is adopted by a Khronos
  189. extension or specification, then that value's use may be permanently
  190. fixed as if originally reserved in a Khronos range.
  191. The SPIR Working Group strongly recommends:
  192. - Each value is used for only one purpose.
  193. - All values in a range should be used before allocating a new range.
  194. -->
  195. <!-- Reserved loop control bits -->
  196. <ids type="LoopControl" start="0" end="15" vendor="Khronos" comment="Reserved LoopControl bits, not available to vendors - see the SPIR-V Specification"/>
  197. <ids type="LoopControl" start="16" end="27" vendor="Intel" comment="Contact [email protected]"/>
  198. <ids type="LoopControl" start="28" end="30" comment="Unreserved bits reservable for use by vendors"/>
  199. <ids type="LoopControl" start="31" end="31" vendor="Khronos" comment="Reserved LoopControl bit, not available to vendors"/>
  200. <!-- SECTION: SPIR-V Function Control Bit Reservations -->
  201. <!-- Reserve ranges of bits in the function control bitfield.
  202. Each vendor determines the use of values in their own ranges.
  203. Vendors are not required to disclose those uses. If the use of a
  204. value is included in an extension that is adopted by a Khronos
  205. extension or specification, then that value's use may be permanently
  206. fixed as if originally reserved in a Khronos range.
  207. The SPIR Working Group strongly recommends:
  208. - Each value is used for only one purpose.
  209. - All values in a range should be used before allocating a new range.
  210. -->
  211. <!-- Reserved function control bits -->
  212. <ids type="FunctionControl" start="0" end="15" vendor="Khronos" comment="Reserved FunctionControl bits, not available to vendors - see the SPIR-V Specification"/>
  213. <ids type="FunctionControl" start="16" end="16" vendor="Intel" comment="Contact [email protected]"/>
  214. <ids type="FunctionControl" start="17" end="30" comment="Unreserved bits reservable for use by vendors"/>
  215. <ids type="FunctionControl" start="31" end="31" vendor="Khronos" comment="Reserved FunctionControl bit, not available to vendors"/>
  216. <!-- SECTION: SPIR-V FP Fast Math Mode Bit Reservations -->
  217. <!-- Reserve ranges of bits in the "FP Fast Math Mode" bitfield.
  218. Each vendor determines the use of values in their own ranges.
  219. Vendors are not required to disclose those uses. If the use of a
  220. value is included in an extension that is adopted by a Khronos
  221. extension or specification, then that value's use may be permanently
  222. fixed as if originally reserved in a Khronos range.
  223. The SPIR Working Group strongly recommends:
  224. - Each value is used for only one purpose.
  225. - All values in a range should be used before allocating a new range.
  226. -->
  227. <!-- Reserved FP fast math mode bits -->
  228. <ids type="FPFastMathMode" start="0" end="15" vendor="Khronos" comment="Reserved FPFastMathMode bits, not available to vendors - see the SPIR-V Specification"/>
  229. <ids type="FPFastMathMode" start="16" end="17" vendor="Intel" comment="Contact [email protected]"/>
  230. <ids type="FPFastMathMode" start="18" end="18" vendor="khronos" comment="Reserved FPFastMathMode bit, not available to vendors - see SPV_KHR_float_controls2"/>
  231. <ids type="FPFastMathMode" start="19" end="31" comment="Unreserved bits reservable for use by vendors"/>
  232. <!-- SECTION: SPIR-V Memory Operand Bit Reservations -->
  233. <!-- Reserve ranges of bits in the memory operands bitfield.
  234. Each vendor determines the use of values in their own ranges.
  235. Vendors are not required to disclose those uses. If the use of a
  236. value is included in an extension that is adopted by a Khronos
  237. extension or specification, then that value's use may be permanently
  238. fixed as if originally reserved in a Khronos range.
  239. The SPIR Working Group strongly recommends:
  240. - Each value is used for only one purpose.
  241. - All values in a range should be used before allocating a new range.
  242. -->
  243. <!-- Reserved memory operand bits -->
  244. <ids type="MemoryOperand" start="0" end="15" vendor="Khronos" comment="Reserved MemoryOperand bits, not available to vendors - see the SPIR-V Specification"/>
  245. <ids type="MemoryOperand" start="16" end="18" vendor="Intel" comment="Contact [email protected]"/>
  246. <ids type="MemoryOperand" start="19" end="22" vendor="Arm" comment="Contact [email protected]"/>
  247. <ids type="MemoryOperand" start="23" end="30" comment="Unreserved bits reservable for use by vendors"/>
  248. <ids type="MemoryOperand" start="31" end="31" vendor="Khronos" comment="Reserved MemoryOperand bit, not available to vendors"/>
  249. <!-- SECTION: SPIR-V Image Operand Bit Reservations -->
  250. <!-- Reserve ranges of bits in the image operands bitfield.
  251. Each vendor determines the use of values in their own ranges.
  252. Vendors are not required to disclose those uses. If the use of a
  253. value is included in an extension that is adopted by a Khronos
  254. extension or specification, then that value's use may be permanently
  255. fixed as if originally reserved in a Khronos range.
  256. The SPIR Working Group strongly recommends:
  257. - Each value is used for only one purpose.
  258. - All values in a range should be used before allocating a new range.
  259. -->
  260. <!-- Reserved image operand bits -->
  261. <ids type="ImageOperand" start="0" end="15" vendor="Khronos" comment="Reserved ImageOperand bits, not available to vendors - see the SPIR-V Specification"/>
  262. <ids type="ImageOperand" start="16" end="16" vendor="Nvidia" comment="Contact [email protected]"/>
  263. <ids type="ImageOperand" start="17" end="30" comment="Unreserved bits reservable for use by vendors"/>
  264. <ids type="ImageOperand" start="31" end="31" vendor="Khronos" comment="Reserved ImageOperand bit, not available to vendors"/>
  265. </registry>