Lines Matching +full:storage +full:- +full:repo +full:- +full:branch +full:- +full:coverage
1 Copyright 2016-2021 The Khronos Group Inc.
2 SPDX-License-Identifier: CC-BY-4.0
4 Update Log for the Vulkan-Docs repository on Github. Updates are in reverse
12 -----------------------------------------------------
22 * Remove max-width attribute from document headers, causing CSS to limit
36 * Generate refpages to SPIR-V builtins, which were marked up in the spec
55 -----------------------------------------------------
77 * Clarify <<resources-external-sharing, ownership transfers on external
84 ** Use an API alias map to substitute promoted API names for promoted-to
86 promoted-to API is not included
92 change in https://github.com/KhronosGroup/Vulkan-Loader/pull/685
94 * Re-remove etext:VkVideoEncodeH265CapabilityFlagBitsEXT, which was
103 * Add -version option to 'makeSpec' frontend build script.
109 -----------------------------------------------------
135 * Add subsection titles and anchors in the <<fxvertex, Fixed-Function
144 -----------------------------------------------------
160 opening links to avoid link-checkers being interpreted as DOS attacks;
162 macro to replace `<<VK_KHR_extension_name>>`-style extension links
166 * Match `Cull Mask` SPIR-V name to pname:mask parameter name in the
167 <<acceleration-structure, Acceleration Structures>> chapter (internal
171 <<spirvenv-module-validation-runtime, Runtime SPIR-V Validation>>
176 <<spirvenv-module-validation-runtime, Runtime SPIR-V Validation>>
185 -----------------------------------------------------
206 <<formats-packed, table of packed formats>> and improve description of
213 -----------------------------------------------------
225 non-NULL instance parameter (public issue 1605).
237 * Fix markup for core version (`VK_VERSION_1_0`, etc.) refpages -
257 -----------------------------------------------------
274 * Turn <<spirvenv-module-validation-runtime, Runtime SPIR-V Validation>>
286 <<ray-intersection-candidate-determination, Ray Intersection Candidate
289 the <<interfaces-resources-correspondence, Shader Resource and
293 ename:VK_KHR_MAINTENANCE1_SPEC_VERSION ->
305 chapter to the <<fragops-shader, Fragment Shading>> section of the
311 * Make the <<features-primitiveTopologyListRestart,
315 * Edit <<limits-types, Required Limit Types>> table to add Vulkan 1.2
320 ename:VK_FORMAT_R12X4_UNORM_PACK16 to the list of 16-bit packed formats,
331 -----------------------------------------------------
353 -----------------------------------------------------
369 <<ray-intersection-candidate-determination, Ray Intersection Candidate
371 * Update `-validate` logic in registry scripts to validate the `limittype`
379 <<spirvenv-module-validation-runtime, Runtime SPIR-V Validation>> valid
386 `VK_KHR_storage_buffer_storage_class`, not needed because the SPIR-V
387 specification is unified and `spirv-val` will throw an error if trying
396 -----------------------------------------------------
407 the <<resources-image-layouts, Image Layouts>> section (public issue
414 * Fix typo in <<fxvertex-input-extraction>> section (public pull request
427 improves overall PDF generation time about 15-20%, and final PDF size by
434 * Clarify that transforms are consumed only if transformData is non-null
442 -----------------------------------------------------
458 Vulkan-ValidationLayers pull request 3139).
462 * Clarify the role of <<ray-traversal-culling-face, face winding>> in the
469 * Use the term <<acceleration-structure-def, "`constructed`">> to refer to
483 -----------------------------------------------------
493 * Limit the code:OpTypeImage code:Unknown format restriction to storage
494 images in the <<spirvenv-module-validation-runtime, Runtime SPIR-V
503 <<fragops-depth, Depth Test>> section and adding a new "`Depth Clamping
515 non-common VUID, and add a duplicate number detection test to CI to
520 <<attachment-type-imagelayout, input attachments>>,
521 <<descriptorsets-sampleimage, sampled images>>, and
522 <<descriptorsets-combinedimagesampler, combined image samplers>> to
527 * Update to asciidoctor-chunker 1.0.4, adding support for `aria-label`
542 -----------------------------------------------------
556 * Fix XML capabilities for new code:*Float*Atomic* SPIR-V capabilities to
575 the <<spirvenv-module-validation, Validation Rules within a Module>> and
576 <<interfaces-inputattachment, Fragment Input Attachment Interface>>
582 <<spirvenv-module-validation-runtime, Runtime SPIR-V Validation>>
585 -----------------------------------------------------
605 KhronosGroup/Vulkan-Portability issue 27).
609 * Document in the <<extendingvulkan-extensions-extensiondependencies,
626 storage class restriction in the
627 <<spirvenv-module-validation-standalone, Standalone SPIR-V Validation>>
632 <<fundamentals-execmodel, Execution Model>> and
633 <<fundamentals-queueoperation, Queue Operation>> sections (internal
641 (non-normative) "`optionally`" with normative "`can:`". Update style
648 * Minor fixes for the <<resources-image-views-compatibility, image view
663 -----------------------------------------------------
684 * Replace the old <<resources-image-views-compatibility>> table with a
700 -----------------------------------------------------
708 * Rewrite and simplify the <<interfaces-iointerfaces-matching, Interface
714 * Add a NOTE to the <<interfaces, Shader Interfaces>> chapter that SPIR-V
717 these keywords appear in the unified SPIR-V specification without such
737 "`pre-rasterization shader stage`" throughout the specification, link to
738 a single definition, and add "`pre-rasterization`" to the glossary
742 * Fix typo `vkCmdResetEvent` -> `vkResetEvent` in flink:vkResetEvent valid
748 * Require support for pname:shaderInt64 in the <<features-requirements,
755 <<shader-binding-table, Shader Binding Table>> section (internal issue
762 * Move SPIR-V valid usage statement from the
763 <<spirvenv-module-validation-runtime, Runtime SPIR-V Validation>>
764 section to <<spirvenv-module-validation-standalone]] Standalone SPIR-V
766 * Add a new <<spirvenv-image-signedness, Signedness of SPIR-V Image
773 * Remove nonexistent pname:minFragmentSize from the <<limits-minmax, Limit
778 -----------------------------------------------------
795 * Fix hpp-compile CI stage after recent changes to Vulkan-Headers
806 -----------------------------------------------------
824 <<fxvertex-attrib-location, Attribute Location and Component
825 Assignment>> and <<fxvertex-input-extraction>> sections (internal issue
827 * Add text about the <<interfaces-alignment-requirements, base alignment
829 * Clarify the use of rasterization order <<primsrast-order,
832 <<synchronization-queue-transfers, Queue Family Ownership Transfer>>
842 <<features-requirements, Feature Requirements>> section and for
849 * Add level 3 headings in <<pipelines-cache, Pipeline Cache>> section
861 -----------------------------------------------------
880 that AABB intersections may be false-positives (internal issue 2597).
882 <<appendix-compressedtex-astc, ASTC Compressed Image Formats>> and the
896 * Clarify <<[[queries-wait-bit-not-set, the cases in which
902 into the <<spirvenv-module-validation-standalone, Standalone SPIR-V
917 * Use "`implementation-dependent`" spelling consistently, and update the
919 * Update <<ray-intersection-candidate-determination, ray tracing
921 distinguished in practice (internal vk-gl-cts issue 2846).
928 -----------------------------------------------------
940 so NV tokens don't show up in a KHR-only specification build
942 * Split the new <<fundamentals-validusage, Valid Usage>> section off from
943 its previous location within the <<fundamentals-errors, Errors>> section
953 `len="null-terminated"` in `vk.xml` (public issue 1526).
954 * Fix `:anchor-prefix:` markup showing up in spec outputs due to
957 (public Vulkan-Headers issue 4).
968 * Add missing common, non-indirect shared valid usage statements for
971 <<vertexpostproc-viewport, Controlling the Viewport>> section (internal
973 * Do not allow code:RayPayloadKHR on any-hit shaders in the
974 <<spirvenv-module-validation-standalone, Standalone SPIR-V Validation>>
985 host-cachable memory for host acceleration structure builds (internal
991 code:shaderImageInt64Atomics SPIR-V feature in `vk.xml` (internal SPIR-V
997 * Add *GlCompute* to the disallowed *Output* storage classes in shared valid
1004 usage statements and the <<features-requirements, Feature Requirements>>
1008 * Make array count and pointer-to-array parameter / member descriptions
1010 * Add third-level section headings to the <<memory-device, Device Memory>>
1022 the <<spirvenv-module-validation-standalone, Standalone SPIR-V
1025 -----------------------------------------------------
1039 members, and incorrect SPIR-V opcodes (public issue 1483).
1048 <<deferred-host-operations-requesting, Requesting Deferral>> section
1054 <<ray-intersection-candidate-determination, Ray Intersection Candidate
1059 <<interfaces-raypipeline, Ray Tracing Pipeline Interface>> section
1061 * Try to use consistently-phrased descriptions of etext:*FlagBits* members
1069 * Clarify consistent <<descriptorsets-updates-consecutive, consecutive
1072 code:ShaderRecordBufferKHR storage class in the
1073 <<interfaces-resources-standard-layout, Standard Buffer Layout>> section
1081 * Add missing `R64ui` and `R64i` entries to the SPIR-V
1082 <<spirvenv-format-type-matching tables, image format matching tables>>
1084 Tracker/vk-gl-cts#2885).
1088 * `<<VK_NVX_binary_import>>` (only appendix and XML - no spec language
1091 -----------------------------------------------------
1101 (public Vulkan-ValidationLayers issue 2718).
1111 <<ray-intersection-candidate-determination, ray/triangle sidedness
1116 * Don't generate etext:*_MAX_ENUM tokens for 64-bit flag types. Note that
1120 pointless for the 64-bit flag types, which are defined as integer
1133 -----------------------------------------------------
1163 -----------------------------------------------------
1176 * Fix description of <<vertexpostproc-clipping, Primitive Clipping>>
1194 * Split the <<extendingvulkan-coreversions-versionnumbers, major version
1201 in-development Vulkan SC API. It is purely a future-proofing measure and
1202 no near-term further use is planned. To support this split, a set of new
1215 <<spirvenv-module-validation-standalone, Standalone SPIR-V Validation>>
1219 * Require compile-time constants be explicitly tagged as unsigned or float
1225 * Disallow code:*Offset* decorations on storage images
1226 in the <<spirvenv-module-validation-standalone, Standalone SPIR-V
1250 -----------------------------------------------------
1259 compile time whether non-dispatchable handles are declared using a
1260 64-bit pointer type, or a 64-bit unsigned interger type. NOTE: it is
1261 possible that the complex platform-dependent C preprocessor block will
1262 move from vk.xml into the static (non-generated) vk_platform.h header in
1270 * Add valid usage statements restricting bitfield operations to 32-bit
1271 types in the <<spirvenv-module-validation-standalone, Standalone SPIR-V
1274 of `enum` tags when they are specifying compile-time constants, and
1276 type names, instead of schema-specific names. The XML schema itself
1280 * Document in the style guide that bits reserved in corresponding 32- and
1281 64-bit bitmasks should be reserved in both types (internal merge issue
1283 * Add output generator options to generate MISRA-friendly headers, and
1284 check generator scripts to avoid generating etext:RESERVED 64-bit
1289 <<copies-buffers-images-addressing, Buffer and Image Addressing>>
1292 -----------------------------------------------------
1312 * Document requirements for extension <<extensions-feature-structures,
1320 top-level acceleration structures for
1327 <<spirvenv-module-validation-standalone Standalone SPIR-V>> valid usage
1329 * Use new version of the HTML asciidoctor-chunker, which runs much faster,
1332 * Fix <<devsandqueues-devices, logical device creation language>> for
1338 * Fix valid usage statement extractor (vu-to-json) to add padding after
1342 <<spirvenv-module-validation-standalone, Standalone SPIR-V Validation>>
1351 -----------------------------------------------------
1360 <<spirvenv-module-validation-standalone, Standalone SPIR-V valid usage
1366 code:Uniform storage class; and update the 16-bit storage feature
1367 validation rules to refer to 16-bit floating-point, similarly to the
1369 <<spirvenv-module-validation-runtime, Runtime SPIR-V Validation>>
1370 <<features-requirements, Feature Requirements>> sections (internal issue
1389 -----------------------------------------------------
1409 * Correct the <<interfaces-resources-setandbinding, DescriptorSet and
1414 restricted relative to pname:maxDepth (Vulkan-Headers public issue 180).
1415 * Add valid usage statement to <<spirvenv-module-validation-standalone,
1416 Standalone SPIR-V Validation>> specifying that push constant array
1418 (SPIRV-Tools public issue 2909)
1419 * Add valid usage statement to <<spirvenv-module-validation-standalone,
1420 Standalone SPIR-V Validation>> specifying when the code:Flat decoration
1421 must be used (SPIRV-Tools public issue 3154)
1435 <<ray-intersection-confirmation, Ray Intersection Confirmation>> section
1437 * Add a new <<raytraversal-ray-intersection-candidate-diagram, basic ray
1441 <<primsrast-fragment-shading-rate-combining final combined shading
1444 <<ray-intersection-candidate-determination, triangle intersection
1457 * Add valid usage statements to <<spirvenv-module-validation-standalone,
1458 Standalone SPIR-V Validation>> for pname:minTexelGatherOffset and
1460 * Make <<spirvenv-module-validation-standalone, Standalone SPIR-V
1469 -----------------------------------------------------
1477 * Add missing language for zero hit groups to the <<shader-binding-table,
1485 -----------------------------------------------------
1493 * Fix typos in language in the <<vertexpostproc-renderpass-transform,
1498 * Fix equations in the <<ray-intersection-candidate-determination, Ray
1514 <<spirvenv-module-validation-standalone, Standalone SPIR-V Validation>>
1522 <<spirvenv-module-validation-standalone, Standalone SPIR-V Validation>>
1524 * Fix typos in SPIR-V capability names
1533 -----------------------------------------------------
1542 non-linear, and slink:VkAccelerationStructureKHR is neither linear nor
1543 non-linear. This affects the memory classification for purposes of
1544 <<resources-bufferimagegranularity,bufferImageGranularity>> (internal
1546 * Specify which storage classes are affected by code:scalarBlockLayout in
1547 the <<interfaces-resources-standard-layout, Standard Buffer Layout>>
1550 <<spirvenv-module-validation-runtime, Runtime SPIR-V Validation>>
1559 -----------------------------------------------------
1574 Vulkan-ValidationLayers issue 2448).
1575 * Add missing `SPV_KHR_multiview` SPIR-V extension to `vk.xml` (public
1576 Vulkan-ValidationLayers issue 2456).
1582 ray tracing sub-chapters (internal issue 2249).
1596 * Clarify that Dref values are supposed to be clamped for fixed-point
1597 accesses in the <<textures-depth-compare-operation, Depth Compare
1603 code:OpImageQueryLevels to require a sampler (not storage image) in the
1604 <<spirvenv-module-validation-standalone, Standalone SPIR-V Validation>>
1623 Vulkan Environment for SPIR-V>> appendix (internal merge request 4265).
1627 the <<introduction-conventions, Document Conventions>> section (internal
1629 * Add code:PhysicalStorageBuffer as a valid atomic storage class in the
1630 <<spirvenv-module-validation-standalone, Standalone SPIR-V Validation>>
1633 <<spirvenv-module-validation-standalone, Standalone SPIR-V Validation>>
1636 pname:bufferRowLength to fit in a signed 32-bit integer (internal merge
1641 * Fix typo `SkipTrianglesKHR` -> `SkipAABBsKHR` in the
1642 <<ray-traversal-culling-primitive, Ray Primitive Culling>> section
1645 -----------------------------------------------------
1658 * Clarify in the <<extendingvulkan-extensions-extensiondependencies,
1667 Overview>> and <<textures-queries, Image Query Instructions>> sections
1670 <<primsrast-fragment-shading-rate-combining, Combining the Fragment
1672 * Move even-size requirements for planar formats to valid usage statements
1674 descriptions of <<formats-definition, the corresponding formats>>
1679 * Clarify behavior of the <<features-alphaToOne, pname:alphaToOne>>
1680 feature by linking the enable to the corresponding <<fragops-covg,
1681 Multisample Coverage>> fragment operation language, and specifying in
1695 <<interfaces-iointerfaces-limits, Shader Input and Output Locations>>
1698 -----------------------------------------------------
1709 <<resources-image-inherited-usage>> section (public issue 1391).
1719 <<spirvenv-module-validation-standalone, Standalone SPIR-V Validation>>
1730 terms of size being non-zero, instead of pname:deviceAddress (internal
1735 <<spirvenv-module-validation-runtime, Runtime SPIR-V Validation>>
1742 * Fix internal xrefs to the SPIR-V capabilities tables, which broke as a
1750 * Remove trailing periods from SPIR-V valid usage statements (internal
1756 -----------------------------------------------------
1775 * Move the un-numbered glossary / abbreviations / prefixes pseudo-chapters
1780 * Add missing <<features-inlineUniformBlock>> valid usage statement to
1784 * Capitalize code:LaunchIdKHR the same as in SPIR-V. code:LaunchSizeKHR
1800 -----------------------------------------------------
1830 -----------------------------------------------------
1841 valid usage statement explicit (public Vulkan-ValidationLayers issue
1849 physical device-level commands (internal issue 2344).
1850 * Tweak CI test for SPEC_VERSION to always succeed when the branch name
1855 * Add final (non-provisional) versions of the Vulkan Ray Tracing
1863 -----------------------------------------------------
1871 * Add some missing types to the table of handle type <->
1878 preprocessing for chunked HTML target and make PDF / single-page HTML
1895 * Only allow forward pointers for physical storage buffers in the
1896 <<spirvenv-module-validation>> section (internal merge request 4206).
1901 -----------------------------------------------------
1920 * Clarify update-after-bind limits for dynamic buffers in the
1921 <<limits-maxDescriptorSetUpdateAfterBindUniformBuffersDynamic>> and
1922 <<limits-maxDescriptorSetUpdateAfterBindStorageBuffersDynamic>> sections
1924 * Clarify slink:VkFramebufferCreateInfo to allow read-only use of depth
1925 images as attachments and non-attachments (internal merge request 4191).
1942 -----------------------------------------------------
1951 <<fundamentals-objectmodel-overview, Object Model>> section (public
1964 * Add a note to the <<memory-model-synchronizes-with, Synchronizes-With>>
1970 * Dynamically generate SPIR-V <<spirvenv-capabilities-table,
1971 Capabilities>> and <<spirvenv-extensions-table, Extensions>> tables from
1974 * Clarify when a <<renderpass-feedbackloop, feedback loop>> creates a data
1976 * Remove un-needed `noautovalidity` attributes on pname:pNext structure
1980 * Clarify treatment of most-negative signed normalized fixed-point values
1981 in the <<fundamentals-fixedfpconv, Conversion from Normalized
1982 Fixed-Point to Floating-Point>> section (internal issue 2367).
1984 behavior in the introduction to the <<extendingvulkan-extensions,
1993 * Clarify <<interfaces, SPIR-V rules on decorations>> (internal
1994 spirv/SPIR-V issue 444).
2003 -----------------------------------------------------
2018 and refer to the <<attachment-type-imagelayout>> section
2025 Vulkan-ValidationLayers issue 2197).
2032 -----------------------------------------------------
2046 <<textures-texel-anisotropic-filtering, Texel Anisotropic Filtering>>
2052 pname:aspectMask values (public Vulkan-ValidationLayers issue 2113).
2063 -----------------------------------------------------
2073 <<synchronization-semaphores-payloads, the semaphore payload section>>,
2081 -----------------------------------------------------
2091 -----------------------------------------------------
2099 * Specification default branch for updates and PRs is now `main` instead
2100 of `master`. `master` branch still exists, but is frozen at the 1.2.152
2102 from `master` to `main` branch (internal issue 1351).
2116 <<interfaces-resources-descset, Descriptor Set Interface>> section
2123 appropriate in the <<fundamentals-objectmodel-lifetime, Object
2125 * Move GLSL and SPIR-V extension references in the extension appendices
2129 -----------------------------------------------------
2153 <<textures-operation-validation, Instruction/Sampler/Image View
2154 Validation>> and <<textures-texel-replacement, Texel Replacement>>
2156 * Clarify in the <<spirvenv-module-validation-standalone, Standalone
2157 SPIR-V Validation>> section that the value of code:XfbBuffer cannot
2160 allowed uses of built-in SPIR-V variables (internal merge requests 3933,
2162 * Refactor <<spirvenv-module-validation-standalone, Standalone SPIR-V
2165 <<spirvenv-module-validation-runtime, Runtime SPIR-V Validation>>
2170 paragraph in the <<versions-1.2, Version 1.2>> appendix (internal merge
2174 KhronosGroup/Vulkan-ValidationLayers issue 2105).
2179 <<formats-mandatory-features-subbyte, Mandatory format support: sub-byte
2180 channels>> and <<formats-requiring-sampler-ycbcr-conversion, Formats
2189 * Add the a <<valid-imageview-imageusage>> definition to capture which
2199 description of the <<limits-framebufferColorSampleCounts>> feature if
2202 -----------------------------------------------------
2210 * Clarify that the <<memory-protected-memory,Protected Memory>> is not
2211 cross-physical device (public issue 1335).
2217 * Also build core-only HTML spec in internal CI, to try and catch
2220 * Add internal CI test for un-tagged uses of "`undefined`", to help make
2227 * Explicitly state that SPIR-V modules must be valid after specialization
2229 <<spirvenv-module-validation-runtime, Runtime SPIR-V Validation>>
2232 SPIR-V capabilities (internal merge request 4047).
2233 * Add missing features to the <<[spirvenv-module-validation-runtime,
2234 Runtime SPIR-V Validation>> section (internal merge request 4048).
2239 -----------------------------------------------------
2267 https://source.android.com/setup/contribute/respectful-code[Coding with
2278 -----------------------------------------------------
2295 * Clarify wording around non-uniform and non-constant descriptor access in
2296 <<interfaces-resources-descset, Descriptor Set Interface>> (internal
2298 * Add a missing code:StorageBuffer reference in the <<interface-resources,
2303 * Copy over import/export behavior for sync file descriptor value `-1`
2307 <<shaders-derivative-operations, Derivative Operations>> section
2314 -----------------------------------------------------
2336 * Add <<interfaces-raypipeline, Ray Tracing Pipeline Interface>> section
2354 * Remove un-needed dependency of `<<VK_EXT_filter_cubic>>` on
2359 array lengths with a chain of parameters (e.g. pname:pFoo->bar), don'
2360 non-zero values are not required if any parameter in the chain is
2373 -----------------------------------------------------
2381 * Allow physical-device-level structures in pname:pNext chains (public
2388 * Require that variables with code:HitAttributeKHR storage class must:
2389 <<spirvenv-module-validation-standalone, only be written in intersection
2400 * Split <<fragops-coverage-reduction, Coverage Reduction>> section into
2401 multiple steps when multi-pixel fragments are involved: first per-pixel
2402 coverage is separated out, then per-sample coverage is generated for
2403 each color sample from per-pixel coverage. dditionally, the definition
2405 favour of the per-color-sample coverage. (internal merge request 3951).
2407 as well as the <<textures-chroma-reconstruction, Chroma Reconstruction>>
2426 <<limits-required, Required Limits>> must be at least the corresponding
2427 non- ptext:UpdateAfterBind limits (internal merge request 3992).
2429 -----------------------------------------------------
2438 non-optional array (public pull request 1228).
2449 * Fix link markup in <<ray-traversal, Ray Traversal>> chapter, nested link
2451 <<textures-unnormalized-to-integer>> (public pull requests 1305, 1306,
2461 <<spirvenv-module-validation-standalone, Standalone SPIR-V Validation>>
2465 * Clarify definition of <<limits-maxFragmentCombinedOutputResources,
2469 * Clarify <<features-extentperimagetype, allowed extent values based on
2470 image type>> and the related <<limits-maxImageDimension1D>>,
2471 <<limits-maxImageDimension2D>>, <<limits-maxImageDimension3D>>,
2472 <<limits-maxImageDimensionCube>> limits (internal merge request 3922).
2474 VUID-VkFramebufferCreateInfo-flags-03188 (internal merge request 3934).
2484 -----------------------------------------------------
2493 SPIR-V and GLSL functionality in the extension appendix (public issue
2498 * Break SPIR-V validation into two sections,
2499 <<spirvenv-module-validation-standalone, Standalone SPIR-V Validation>>
2500 and <<spirvenv-module-validation-runtime, Runtime SPIR-V Validation>>
2506 such as KTX2 to use these values as part of their internal cross-API
2521 <<spirvenv-capabilities, Capabilities>> section, and specify that if
2528 <features-customBorderColorWithoutFormat>> is enabled (internal merge
2530 * Add new <<spirvenv-format-type-matching, Image Format and Type
2534 * Fix typo sname:VkImageFormatProperties -> slink:VkFormatProperties
2536 * Move <<sparsememory-examples, sparse image examples>> to the Vulkan
2547 -----------------------------------------------------
2555 * Require `volatile` semantics for loading <<builtin-volatile-semantics,
2557 <<spirvenv-module-validation, Validation Rules within a Module>> and
2558 also the <<ray-tracing-shader-call, Shader Call Instructions>> section
2560 * Created new <<potential-format-features, Potential Format Features>>
2571 `config/vu-to-json/extension.rb` to match (internal issue 2215).
2576 * Add a new <<spirvenv-extensions, SPIR-V Extensions>> subsection
2578 API required to support each of the SPIR-V extensions, replacing a
2579 harder-to-read list of extensions (internal merge request 3876).
2582 * Make repository REUSE-compliant, and run the `reuse` license checker as
2589 <<features-shaderStorageImageMultisample>> feature (internal merge
2595 future-proofing (internal merge requests 3906, 3907, 3908, 3909, 3910).
2600 -----------------------------------------------------
2607 valid usage statements, for future-proofing (internal merge requests
2619 ** Replace the "`Exceptions`" clause on `vk.xml` with a dual Apache-2.0 OR
2623 ** Use `SPDX-License-Identifier` tags in place of longer license text.
2632 * Add new <<resources-image-views-identity-mappings, text describing the
2640 * Added XML schema and generator script extensions to support 64-bit flags
2642 * Correct <<interfaces-resources-standard-layout, Standard Buffer Layout>>
2644 * Relax non-strict line constraints in the <<primsrast-lines-basic>> and
2645 <<primsrast-lines-bresenham>> sections (internal merge request 3792).
2656 * Require the <<features-customBorderColors>> feature be enabled when
2660 -----------------------------------------------------
2682 * Update <<fundamentals-validusage-pNext, description of pname:pNext
2697 <<extendingvulkan-compatibility-specialuse, Special Use Extensions>>
2706 of unused IDs for each extension branch under development, instead of
2719 <<interfaces-resources-layout, Offset and Stride Assignment>> section
2732 built-in variables (internal merge request 3853).
2738 <<synchronization-image-barrier-layout-transition-order>> section
2741 ename:VK_PIPELINE_STAGE_BOTTOM_OF_PIPE_BIT as pseudo-stages in multiple
2748 valid usage statements, for future-proofing (internal merge requests
2751 -----------------------------------------------------
2759 overridden using the `-genpath` option to the frontend scripts like
2770 * Fix a typo in the <<fragops-stencil, Stencil Test>> section, removing a
2784 $(GENERATED) directory, add -genpath option to scripts requiring them,
2791 -----------------------------------------------------
2830 * Add transitive language to the <<formats-compatible-planes, Compatible
2831 formats of planes of multi-planar formats>> section to pull in format
2841 <<fundamentals-objectmodel-lifetime-cmdbuffers>> section (internal issue
2851 * Add a Note to the <<framebuffer-blending, Blending>> section to stop
2862 appendix, the `Coverage*` and `Sample Index` glossary entries, the
2864 <<interfaces-builtin-variables, Built-In Variables>> section, and the
2865 <<shaders-fragment-execution, Fragment Shader Execution>>,
2866 <<shaders-fragment-earlytest, Early Fragment Tests>>, and
2867 <<textures-texel-coordinate-systems, Texel Coordinate Systems>> sections
2886 -----------------------------------------------------
2903 the style guide into the <<fundamentals-validusage-enums, Valid Usage
2912 * Update references to the SPIR-V Specification to version 1.5.3 (internal
2915 slink:VkAccelerationStructureInstanceKHR in `vk.xml` are non-normative
2932 -----------------------------------------------------
2946 * Add language to the <<features-requirements, Feature Requirements>>
2959 <<resources-sampler-ycbcr-conversion-format-features, Sampler Ycbcr
2961 * Add a constraint to the <<memory-external-android-hardware-buffer,
2971 <<memory-device-bitmask-list>> section (internal merge request 3738).
2974 <<memory-external-android-hardware-buffer-usage, AHardwareBuffer Usage
2982 <<spirvenv-module-validation, Validation Rules within a Module>>
2990 -----------------------------------------------------
2999 load-time scripts which pre-render KaTeX math, pre-fetch fonts, and
3001 time for the single-page HTML specification. In our internal evaluation
3007 code:OpTypeStruct in the <<interfaces-iointerfaces-locations, Location
3011 * Add the `null-terminated` attribute to
3028 <<acceleration-structure-inactive-prims, Inactive Primitives and
3040 extension in the <<shaders-scope-device, Device>>,
3041 <<shaders-scope-queue-family, Queue Family>>, and
3042 <<shaders-scope-command, Command>> sections of the shader
3043 <<shaders-scope, Scope>> section (internal issue 1955).
3051 <<spirvenv-module-validation, Validation Rules within a Module>> section
3054 avoid complaints from prawn-svg during PDF spec builds (internal issue
3057 <<features-variableMultisampleRate>> section and the related
3059 <<limits-framebufferNoAttachmentsSampleCounts>>
3060 <<renderpass-noattachments>> sections (internal issue 2066).
3067 * Require <<features-subgroup-extended-types,
3087 <<spirvenv-capabilities-table, List of SPIR-V Capabilities and enabling
3100 requirements in the <<resources-association, Resource Memory
3115 -----------------------------------------------------
3123 * Generate per-extension refpages from the extension appendices in the
3135 * Add a new <<resources-sampler-ycbcr-conversion-format-features, Sampler
3149 Inkscape's insistence. This reduces warnings from prawn-svg during PDF
3151 * Remove reference in the <<devsandqueues-lost-device, Lost Device>>
3152 section to a non-existent list of functions returning
3158 * Document the Khronos-provided Docker image, whose use is recommended
3167 -----------------------------------------------------
3182 * Update the <<spirvenv-module-validation, Validation Rules within a
3183 Module>> section of the SPIR-V environment appendix to allow the
3188 * Amend rules in the <<extensions-vendor-id, Registering a Vendor ID with
3191 (public KhronosGroup/OpenCL-Docs pull request 203).
3196 <<extendingvulkan-layers, Layers>> chapter following the specification
3198 * Simplify markup for SPIR-V versions required by different Vulkan
3199 versions in the <<spirvenv, Vulkan Environment for SPIR-V>> appendix
3248 -----------------------------------------------------
3259 * Change use of "`happens before`" to glossary term "`happens-before`"
3272 <<synchronization-image-layout-transitions, Image Layout Transitions>>
3293 * Clarify that flink:vkGetDeviceProcAddr can be used for device-level
3295 * Add a note to the <<primsrast-lines-bresenham, Bresenham Line Segment
3315 * Simplify a hard-to-parse sentence in the <<textures-RGB-sexp, RGB to
3318 around a crash occurring in recent versions of asciidoctor-pdf (internal
3325 -----------------------------------------------------
3333 * Clarify language describing the <<commandbuffers-lifecycle, command
3348 <<fundamentals-validusage-flags, Valid Usage for Flags>> section
3354 <<interfaces-resources-descset, Descriptor Set Interface>> section, to
3365 * Generate implicit pname:sType-unique valid usage statements from
3386 * Fix conditional markup in the <<shaders-scope-device>> and
3387 <<shaders-scope-queue-family>> sections to apply to Vulkan 1.2, as well
3397 -----------------------------------------------------
3405 * Move and reword a NOTE in the <<extendingvulkan-extensions, Extensions>>
3408 flink:vkMapMemory into a non-normative NOTE (public pull request 1143).
3424 KhronosGroup/Vulkan-ValidationLayers issue 1470).
3429 <<synchronization-pipeline-stages-transfer,
3433 * Clarify that <<pipelines-dynamic-state, Dynamic State>> can be set
3436 * Clarify the behavior of floating-point divide by zero in the
3437 <<spirvenv-precision-operation, Precision and Operation of SPIR-V
3442 * Refactor specification of shader scopes into the new <<shaders-scope,
3450 commands in the <<synchronization-signal-operation-order>> section
3456 -----------------------------------------------------
3470 * Expand the <<extendingvulkan-extensions-extensiondependencies, Extension
3475 * Clarify the <<features-shaderStorageImageExtendedFormats,
3477 formats to the <<formats-mandatory-features-2byte>>,
3478 <<formats-mandatory-features-10bit>>,
3479 <<formats-mandatory-features-16bit>>, and
3480 <<formats-mandatory-features-64bit>> tables (public pull request 1098).
3495 * Fix macros that consume codelike text like pname:foo\->bar (public pull
3500 * Add a new <<fundamentals-errorcodes, error code>>,
3506 <<features-required-format-support, Required Format Support>> section
3517 -----------------------------------------------------
3544 constants in the <<spirvenv-module-validation, Validation Rules within a
3558 storage class in all but compute, mesh, and task shaders in the
3559 <<spirvenv-module-validation, Validation Rules within a Module>>
3574 -----------------------------------------------------
3585 * Fix styleguide em-dash example (public pull request 1088).
3589 chapter - split into sections, reordered orphaned paragraphs, simplify
3601 -----------------------------------------------------
3613 language in the <<synchronization-queue-transfers-release>> section, to
3632 code:LocalInvocationIndex to the <<interfaces-builtin-variables-sgli,
3638 * Fix the basis matrix for <<textures-texel-cubic-filtering, Texel Cubic
3642 member non-const, like other feature structures (internal issue 1880).
3644 <<memory-model-memory-location, Memory Location>> appendix (internal
3645 cross-api/memory-model issue 113).
3651 <<renderpass-compatibility, Render Pass Compatibility>> section
3656 that coverage modulation has no effect when using the
3665 -----------------------------------------------------
3684 * Require <<features-features-timelineSemaphore, pname:timelineSemaphore>>
3689 * Minor non-semantic markup and diagram fixes (internal merge request
3691 * Clarify that <<interfaces-iointerfaces-locations, Location>> values are
3703 -----------------------------------------------------
3715 <<synchronization-access-types-supported, supported access types>> table
3717 * Remove misleading NOTE in the <<synchronization-dependencies-chains>>
3725 * Markup fix to <<features-features-timelineSemaphore>> section (public
3734 * Restrict the SPIR-V code:Invariant decoration to only be used with
3735 code:Output variables in the <<spirvenv-module-validation, Validation
3737 * Clarify that the <<features-independentResolve, independentResolve>>
3738 feature implies support for the <<features-independentResolveNone,
3740 * Clarify self-contradictory language for slink:VkSubpassDescription to
3749 -----------------------------------------------------
3766 transfers in the <<devsandqueues-index, Queue Family Index>> section
3778 * Correct some <<Precision of GLSL.std.450 Instructions, SPIR-V
3787 -----------------------------------------------------
3806 * Add a new <<synchronization-signal-operation-order, _signal operation
3818 -----------------------------------------------------
3829 in same-parent valid usage statements (public pull request 1030).
3837 * Require that <<interfaces-builtin-variables-sgs, code:SubgroupSize>> be
3839 * Clarify that shaderFloat64 and shaderInt64 enable all storage classes,
3841 non-interface storage classes. in the <<features-shaderFloat64>>,
3842 <<features-shaderInt64>>, and <<features-shaderInt16>> descriptions and
3846 <<spirvenv-module-validation, Validation Rules within a Module>>
3852 * Cleanup string descriptions to consistently refer to "`null-terminated
3853 UTF-8`" strings (internal issue 1813).
3859 pname:maxTriangleCount in the <<limits-required, Required Limits>>
3861 * Update SPIR-V image op sign-matching rules in the
3862 <<spirvenv-module-validation, Validation Rules within a Module>>
3863 section, the <<formats-numericformat>> table, and the
3864 <<interfaces-resources-descset, Descriptor Set Interface>> section
3865 (internal spirv/SPIR-V issue 332).
3872 -----------------------------------------------------
3885 to the SPIR-V "`constant instruction`" definition (internal issue 1225).
3888 * Clarify that <<fragops-depth-write, depth writes are not performed>> if
3891 <<primsrast-lines-bresenham, wide Bresenham lines>>, though replicating
3903 * Correct "`an`" -> "`a`" prepositions where needed (internal merge
3905 * Clarify that the <<features-uniformBufferStandardLayout,
3909 comments to docstrings where appropriate, and add gen-scripts-docs.sh
3911 * Correct pname:maxDrawMeshTasksCount to 2^16^-1 in the <<limits-required,
3918 -----------------------------------------------------
3941 asciidoctor conditionals, and remove it from the core-only specification
3942 builds, where it had previously been force-included in the Makefile. It
3944 * Edit some asciidoctor anchor names starting with `features-features-` to
3945 just start with `features-`, since the old chapters was split into 3
3948 * Add `KHR` alias for the non-suffixed extension token
3971 -----------------------------------------------------
3986 * Clarify behavior of non-premultiplied destination colors for
3997 * Update links to SPIR-V extension specifications, and parameterize their
3999 * Fix an off-by-one error in the valid usage statement for
4015 check_spec_links.py tests from .gitlab-ci.yml and 'allchecks' target
4018 -----------------------------------------------------
4030 -----------------------------------------------------
4054 * Clarify that use-defined code:Input and code:Output variables cannot be
4055 code:Boolean in the <<interfaces-iointerfaces-user, User-defined
4065 <<features-requirements, Feature Requirements>> section and the
4085 -----------------------------------------------------
4101 <<renderpass-layout-transitions>> section to eliminate the need for a
4103 they're both read-only (relates to
4104 https://github.com/KhronosGroup/Vulkan-ValidationLayers/issues/948).
4108 * Document that <<extendingvulkan-compatibility-promotion, backwards
4128 -----------------------------------------------------
4145 * Minor language tweaks in the <<spirvenv-module-validation, Validation
4172 -----------------------------------------------------
4197 usage in the <<textures-gather, Texel Gathering>> and
4198 <<spirvenv-module-validation, Validation Rules within a Module>>
4199 sections, and for the <<limits-minTexelGatherOffset>> and
4200 <<limits-maxTexelGatherOffset>> limits (internal issue 1723).
4202 operand in the <<spirvenv-module-validation, Validation Rules within a
4208 * Remove stext:KHR suffix from some structure cross-references that were
4224 -----------------------------------------------------
4240 -----------------------------------------------------
4258 <<spirvenv-module-validation, Validation Rules within a Module>> section
4260 * Clarify the descriptions of <<limits-computeUnitsPerShaderArray,
4261 pname:computeUnitsPerShaderArray>> and <<limits-wavefrontSize,
4270 -----------------------------------------------------
4278 * Clarify that it is possible to use the <<memory-host, Host Memory>>
4285 scale factor and level-of-detail operation in the
4286 <<textures-normalized-operations, Normalized Texel Coordinate
4298 * Clean up error output from the `optimize-pdf` build script on success.
4299 * Fix an internal link to the <<spirvenv-correctly-rounded, Correctly
4300 Rounded>> section in the SPIR-V appendix by adding and referring to that
4306 <<spirvenv-precision-operation, Precision and Operation of SPIR-V
4309 -----------------------------------------------------
4320 surface, and rearrange some validation-related language (public issue
4323 <<interfaces-resources-descset, Descriptor Set Interface>> section
4331 * Remove the "`block`" language around <<features-robustBufferAccess,
4334 the <<interfaces-resources-descset, Descriptor Set Interface>> section
4338 <<fundamentals-errorcodes>> section (internal issue 1679).
4342 * Various subgroup-related fixes in the <<spirvenv-capabilities,
4343 Capabilities>>, <<shaders-subgroup-arithmetic, Arithmetic Subgroup
4344 Operations>>, <<shaders-subgroup-clustered, Clustered Subgroup
4345 Operations>>, and <<shaders-subgroup-partitioned, Partitioned Subgroup
4348 core SPIR-V Instructions>> table (internal merge request 3166).
4352 * Fix a non-sentence in the introduction to the <<textures, Image
4358 filters, immediately following the <<formats-mandatory-features-astc,
4361 -----------------------------------------------------
4377 -----------------------------------------------------
4386 <<devsandqueues-devices, Devices>> section (public issue 695).
4387 * Fix typo in an equation in the <<fragmentdensitymap-fetch-density-value,
4393 * Allow <<renderpass-compatibility, compatibility of single-subpass
4397 * Add a "`SPIR-V Sampled Type`" column to the <<formats-numericformat,
4401 <<interfaces-resources-descset, Descriptor Set Interface>> section
4403 * Fix a typo in the <<tessellation-quad-tessellation, Quad Tessellation>>
4408 * Add R10X6 and R12X4 formats to the <<formats-mandatory-features-10bit>>
4426 -----------------------------------------------------
4455 SPIR-V <<spirvenv-module-validation, Validation Rules within a Module>>
4459 ** Consistently specify which function (OETF or Inverse-EOTF) is being
4472 -----------------------------------------------------
4482 * Make <<synchronization-pipeline-barriers-subpass-self-dependencies,
4483 subpass self-dependencies>> less restrictive (public issue 777).
4486 * Remove single-page (`apispec.html`) refpage sub-targets from the
4489 single-page document and do not promise it will work. The full
4495 * De-duplicate common valid usage statements shared by multiple commands
4513 <<descriptorsets-accelerationstructure, Acceleration Structure>>
4525 -----------------------------------------------------
4547 sname:VkPhysicalDeviceShaderDrawParameterFeatures ->
4549 sname:VkPhysicalDeviceVariablePointerFeatures ->
4551 sname:VkPhysicalDeviceVariablePointerFeaturesKHR ->
4553 sname:VkPhysicalDeviceBufferAddressFeaturesEXT ->
4556 ->
4558 etext:VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_VARIABLE_POINTER_FEATURES ->
4560 etext:VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_VARIABLE_POINTER_FEATURES_KHR ->
4563 ->
4578 <<appendix-compressedtex-astc,appendix>> to the recently updated
4583 -----------------------------------------------------
4600 -----------------------------------------------------
4609 <<commandbuffer-lifecycle-diagram, Lifecycle of a command buffer>>
4611 * Add Fuchsia platform to <<boilerplate-wsi-header-table, Window System
4616 typedefs of code:uint64_t, so it is an ABI-compatible change (public
4622 the headers for use by the hpp-generate / hpp-compile CI stages. Targets
4628 <<writing-undefined, Describing Undefined Behavior>> section of the
4647 -----------------------------------------------------
4656 model <<memory-model-location-ordered, location-ordered>> definition
4658 * Add an <<memory-model-acyclicity, acyclicity>> axiom to the memory model
4663 * Fix reversed logic of slink:VkFormatProperties discussion of multi-plane
4669 * Update <<spirvenv-precision-operation, Precision and Operation of SPIR-V
4676 -----------------------------------------------------
4686 * Fix typo in markup of the <<textures-texel-coordinate-systems-diagrams,
4703 <<synchronization-access-types-supported>> table.
4709 1.0, in the <<memory-external-android-hardware-buffer-formats>> table.
4712 a lot of refactoring and cleanup in the <<drawing-primitive-topologies,
4713 Primitive Topologies>>, <<geometry-input, Geometry Shader Input
4714 Primitives>> sections, and <<vertexpostproc-transform-feedback Transform
4724 -----------------------------------------------------
4735 * Make <<interfaces-resources-layout, WARNING block>> into a NOTE block,
4740 * Make <<textures-output-format-conversion, computation of derivatives in
4741 non-uniform flow control>> have undefined behavior (internal issue
4744 <<textures-layout-validation, reads from inconsistent YCbCr layouts>>
4747 <<extended-functionality, Extended Functionality>> appendix, While a
4752 <<features-limits-types, Required Limit Types>> and
4753 <<features-limits-required, Required Limits>> tables (internal issue
4755 * Disallow <<memory-protected-memory, indirect calls within protected
4772 * Rearrange and simplify the <<interfaces-resources-layout, block layout
4780 -----------------------------------------------------
4789 <<memory-model-atomic-operation, atomic writes>> (public pull request
4800 enumerated types, instead of as #defines (Vulkan-Headers issue 40).
4808 * Clarify allowed values of <<spirv-precision-operation, SPIR-V operations
4815 -----------------------------------------------------
4832 <<formats-requiring-sampler-ycbcr-conversion>> table as well as
4835 * Correct type of the code:FragSizeEXT built-in in the
4836 <<interfaces-builtin-variables, Built-In Variables>> section (internal
4845 <<features-features-requirements, Feature Requirements>> section.
4847 <<shader-binding-table-indexing-rules, Indexing Rules>> section, and use
4848 spelling "`any-hit`" consistently.
4851 (https://github.com/KhronosGroup/Vulkan-ValidationLayers/issues/551).
4852 * Make SPIR-V code:OpConvertUToPtr and code:OpConvertPtrToU operations
4853 require a 64-bit integer for physical storage buffer pointers in the
4854 <<spirvenv-module-validation, Validation Rules within a Module>>
4863 -----------------------------------------------------
4883 <<fundamentals-validusage-versions, Valid Usage for Newer Core
4888 * Add optional <<memory-model-availability-visibility, transitive
4893 * Add the code:StorageBuffer storage class to those in the
4894 <<interfaces-resources-descset, Descriptor Set Interface>> (internal
4903 code:OpMatrixTimesScalar SPIR-V operations in the <<Precision of core
4904 SPIR-V Instructions>> table (internal merge request 2996).
4911 https://github.com/KhronosGroup/Vulkan-ValidationLayers/issues/480).
4913 SPIR-V capabilities from the <<spirvenv-capabilities, Capabilities>>
4918 -----------------------------------------------------
4926 * Add a special case to the <<renderpass-compatibility, Render Pass
4927 Compatibility>> rules allowing single-subpass renderpasses to be
4931 <<shader-binding-table-indexing-rules, Miss Shaders>> section to index
4940 externally-defined metadata properties (internal issue 1514).
4941 * Remove restrictions on the `mask` parameter of SPIR-V's
4942 code:OpGroupNonUniformXor in the <<spirvenv-module-validation,
4948 * Update copyright dates on Khronos-copyrighted files to 2019 (internal
4959 -----------------------------------------------------
4976 Core Revisions>> and <<initialization-functionpointers, Command Function
4985 <<features-required-format-support, Required Format Support>> section
4986 and the <<formats-requiring-sampler-ycbcr-conversion, Formats
4999 polled the mesa-dev list in case there are use cases we missed (internal
5003 * Remove redundant valid usage statement `VkImageCreateInfo-pNext-02395`
5008 corresponding updates to per-platform build instructions (internal MR
5016 -----------------------------------------------------
5039 <<features-limits-maxComputeSharedMemorySize,
5049 statement 01778 (Vulkan-ValidationLayers!15)
5050 * Fix descriptions of <<interfaces-builtin-variables-launchid,
5051 code:LaunchIDNV>> and <<interfaces-builtin-variables-launchsize,
5059 -----------------------------------------------------
5069 In addition to the terminology changes, retitled the <<texel-block-size,
5072 <<features-formats-compatibility, Compatible Formats>> table. There is
5080 * Specify in <<shaders-invocationgroups, Invocation and Derivative
5081 Groups>> and <<textures-output-format-conversion, Texel Output Format
5097 -----------------------------------------------------
5116 * Restrict the storage classes permitted for SPIR-V atomics to what is
5117 actually supported, in the <<spirvenv-module-validation, Validation
5123 * Modify optimize-pdf script and Makefile to retain non-optimized original
5125 * Add <<spirvenv-module-validation, SPIR-V validation rules>> stating that
5149 -----------------------------------------------------
5161 * Fix math markup in <<textures-texel-anisotropic-filtering, Texel
5175 * Cleanup extension-specific properties
5190 -----------------------------------------------------
5202 near-EOL of Mir itself (public issue 814).
5222 doubly-nested bullet points up one level, accomodating limitations of
5235 -----------------------------------------------------
5248 all-extensions spec build. Change them to explicitly mention which
5249 extension each is for (public issue Vulkan-ValidationLayers/issues/353).
5268 `optimize-pdf` step of PDF generation, due (apparently) to inconsistent
5271 * For the <<memory-model-synchronizes-with synchronizes-with>> memory
5276 (internal issue cross-api/memory-model#72).
5277 * Minor editorial changes to the <<memory-model, memory model>> appendix
5280 -----------------------------------------------------
5288 * Clarify the reference to <<features-limits-mipmapPrecisionBits, mipmap
5289 precision bits>> in the <<textures-image-level-selection, Image Level(s)
5291 * Update <<debugging-object-types,VkObjectType and Vulkan Handle
5296 the <<memory-model-availability-visibility-semantics, Availability and
5299 the mesh shading list of the <<synchronization-pipeline-graphics,
5306 "`variables`" in the <<interfaces-resources-pushconst, Push Constant
5308 https://github.com/KhronosGroup/Vulkan-ValidationLayers/issues/340
5318 -----------------------------------------------------
5331 * Make an ABI-compatible change of the type of
5337 * Clarify for the <<features-features-shaderStorageImageExtendedFormats>>
5338 feature and in the <<spirvenv-capabilities-table>> that the feature
5340 features can be queried per-format (internal issue 1273).
5364 -----------------------------------------------------
5372 * Merge flink:vkCmdPipelineBarrier self-dependency barrier VUs referring
5378 - does not close this, however).
5384 <<features-features-textureCompressionETC2>>,
5385 <<features-features-textureCompressionASTC_LDR>>, and
5386 <<features-features-textureCompressionBC>> is not contingent on the
5390 <<interfaces-builtin-variables, Built-In Variables>> section (internal
5392 * Identify and correct many overly-aggressive uses of "`undefined`", and
5395 <<writing-undefined, Describing Undefined Behavior>> section (internal
5406 naming of the compare exchange op when referring to the SPIR-V op.
5424 -----------------------------------------------------
5432 * Add new <<resources-image-creation-limits, Image Creation Limits>>
5434 combinatorial complexity of extension-dependent VUs. Also fixes some
5453 -----------------------------------------------------
5461 * Add self-dependency ename:VK_DEPENDENCY_BY_REGION_BIT valid usage
5472 * Only include the <<fundamentals-validusage-versions, Valid Usage for
5503 -----------------------------------------------------
5523 format, in the <<textures-format-conversion, Format Conversion>> section
5525 * Fix typo in equation in the <<primsrast-lines-basic, Basic Line Segment
5548 -----------------------------------------------------
5560 * Fix metadoc script showing non-selected extensions (public pull request
5575 <<spirvenv-precision-operation, Precision and Operation of SPIR-V
5577 * Clarify that both built-in and user-defined variables count against the
5579 <<interfaces-iointerfaces-locations, Location Assignment>> section
5581 * Merge "`required`" capabilities into the <<spirvenv-capabilities-table,
5582 list of optional: SPIR-V capabilities>> (internal issue 1320).
5585 <<resources-image-layouts-matching-rule, Image Layout Matching Rules>>
5594 * Make Vulkan consistent with SPIR-V regarding code:DepthReplacing and
5595 code:FragDepth in the <<interfaces-builtin-variables, Built-In
5599 -----------------------------------------------------
5616 to the definitions of <<synchronization-queue-transfers-acquire, acquire
5619 * Add <<resources-image-format-features,Image Format Features>> and
5620 <<resources-image-view-format-features,Image View Format Features>>
5626 possible self-dependencies (internal issue 1322).
5630 SPIR-V environment appendix, and "`Units in the Last Place (ULP)`" in
5637 -----------------------------------------------------
5649 <<features-limits-maxUpdateAfterBindDescriptorsInAllPools,
5653 <<synchronization-pipeline-stages-supported, Supported pipeline stage
5664 * Make the <<geometry-invocations, geometry shader invocation
5665 description>> and <<shaders-geometry-execution, Geometry Shader
5669 * Adjust the per-instance vertex attribute offset formula specified by
5675 -----------------------------------------------------
5701 -----------------------------------------------------
5709 * Add a note to the <<features-required-format-support, Required Format
5725 undefined) to the <<textures-output-format-conversion]] Texel Output
5726 Format Conversion>> section. Simplify and clarify the floating-point
5727 conversion language in the <<fundamentals-general, General
5728 Requirements>> section and the new <<fundamentals-fp-conversion,
5729 Floating-Point Format Conversions>> section, and remove obsolete
5730 language in the format-specific floating-point sections (internal issue
5734 by clients. Note that only Khronos vendor IDs (e.g. non-PCI vendor IDs)
5736 * Fix typo in the <<fig-non-strict-lines, Non strict lines>> table
5739 <<formats-requiring-sampler-ycbcr-conversion, YCbCr format
5742 * Add code:Float16 to the <<spirvenv-capabilities-table, List of optional
5743 SPIR-V capabilities>> for the `VK_AMD_gpu_shader_half_float` extension.
5745 -----------------------------------------------------
5774 the <<features-limits-required, Required Limits>> table (internal issue
5783 -----------------------------------------------------
5803 the <<spirvenv-module-validation, Validation Rules within a Module>>
5805 * Clarify rules about validating descriptor set/binding against storage
5806 class and descriptor type in the <<spirvenv-module-validation,
5808 references to the <<interfaces-resources-storage-class-correspondence,
5809 Shader Resource and Storage Class Correspondence>> table (internal issue
5811 * Use correct spelling of SPIR-V decoration code:NonWritable in several
5817 KhronosGroup/Vulkan-LoaderAndValidationLayers repository with
5823 <<vulkan-styleguide, link to that document>>, and use the full name
5826 -----------------------------------------------------
5835 with GPL-based projects (internal issue 1017).
5845 * Modify the <<spirvenv-module-validation, Validation Rules within a
5847 SPIR-V code for images with an image format of code:Unknown if one of
5856 -----------------------------------------------------
5881 server by adding a .gitlab-ci.yml file. Note: this does not implement CI
5883 * Add link from description of depth clamping in the <<fragops-depth,
5889 <<interfaces-resources-descset, Descriptor Set Interface>> and
5890 <<interfaces-resources-setandbinding, DescriptorSet and Binding
5905 only applies to external-format images. Add references to this in valid
5911 * Add a NOTE to the <<interfaces-resources-setandbinding, DescriptorSet
5913 a storage class may use identical descriptor set and bindings.
5916 binding (internal SPIR-V issue 264).
5919 <<interfaces-resources-descset, Descriptor Set Interface>> section. This
5921 array indexing operation (internal SPIR-V issue 289).
5929 * Move YCbCr-related VU statements from slink:VkDescriptorImageInfo to
5932 * Move SPIR-V restriction that images be of either sampled or storage
5933 types from the <<interfaces-resources-descset, Descriptor Set
5934 Interface>> section to the <<spirvenv-module-validation, Validation
5935 Rules within a Module>> section of the SPIR-V appendix.
5937 -----------------------------------------------------
5947 * Refine description of <<extended-functionality-extensions-dependencies,
5949 <<extended-functionality-extensions, Extensions>> section, and
5966 -----------------------------------------------------
5976 discussion following the <<swapchain-wsi-image-create-info>> table
5978 * Re-remove several valid usage statements from slink:VkImageCreateInfo
5982 from the old `1.0` branch to the current `master` branch (public issue
5998 pages - but not the single-page HTML / PDF versions, which are even
6012 * Clarify the interaction of sRGB images used as storage or texel buffers
6013 with <<textures-output-format-conversion, Texel Output Format
6021 "`non-sparse resources must be bound to memory before being recorded to
6024 -----------------------------------------------------
6053 * Fix typo etext:VK_EXTERNAL_SEMAPHORE_HANDLE_TYPE_FENCE_FD_BIT ->
6055 <<external-semaphore-handle-types-compatibility, External semaphore
6085 -----------------------------------------------------
6094 the <<sparsememory-standard-shapes, Standard Sparse Image Block Shapes>>
6097 in the <<interfaces-builtin-variables, Built-In Variables>> section
6100 Pipelines>> section and the new <<pipelines-dynamic-state, Dynamic
6109 * Remove description of <<primsrast-points, rasterization point size>>
6113 * Define <<copies-images-format-size-compatibility, _size-compatible_
6121 <<synchronization-submission-order, submission order>> at numerous
6124 * Clarify statement in the <<interfaces-resources-setandbinding,
6137 VUID-VkMemoryDedicatedAllocateInfo-image-01797 (internal issue 1184).
6142 other words, these operations are not defined to work with storage
6158 * Fix a few broken links in the <<versions-1.1, Version 1.1>> appendix.
6165 stext:VkBind*MemoryInfo, and fix a pname:image -> pname:buffer typo in a
6175 -----------------------------------------------------
6189 NOTE: The GitHub KhronosGroup/Vulkan-Docs repository now maintains the
6190 current specification in the `master` branch. The `1.0` branch is out of
6192 and 1.0 specifications from the `master` branch in the future.
6198 * Specify that <<synchronization-pipeline-stages, Pipeline Stages>> are a
6208 look-and-feel, and adjust image size attributes so they're all legible,
6235 * Updated the <<textures-texel-replacement, Texel Replacement>> section to
6240 * Clarify and unify language describing physical device-level core and
6241 extension functionality in the <<fundamentals-validusage-extensions,
6242 Valid Usage for Extensions>>, <<fundamentals-validusage-versions, Valid
6243 Usage for Newer Core Versions>>, <<initialization-functionpointers
6244 Command Function Pointers>>, <<initialization-phys-dev-extensions,
6246 <<extended-functionality-instance-extensions-and-devices, Instance
6249 instance-level functionality is tied to the loader, and independent of
6250 the ICD; physical device-level functionality is tied to the ICD, and
6254 * Updated the <<commandbuffers-lifecycle, Command Buffer Lifecycle>>
6264 * Remove near-duplicate NOTEs about when to query function pointers
6266 replace by extending the NOTE in the <<fundamentals-abi, Application
6272 its subsections, and the <<interfaces-resources-descset, Descriptor Set
6278 <<textures-implict-reconstruction, Implicit Reconstruction>> (internal
6291 ** Removed non-normative uses of the phrase "`not required`"
6303 * Explicitly state in the <<fundamentals-objectmodel-lifetime-acquire,
6309 * Updated the <<textures-scale-factor, Scale Factor Operation>> section to
6313 * Update `vulkan_ext.c` to include all platform-related definitions from
6315 platform-specific and non-platform-specific files.
6323 * Document mapping of subgroup barrier functions to SPIR-V, and clarify a
6324 place where subgroupBarrier sounds like it's execution-only in the
6327 the default Arial font family replaced by the sans-serif Noto font
6339 -----------------------------------------------------
6355 * Clarify that flink:vkGetDeviceProcAddr only supports device-level
6374 * Resolve contradictions and use of undefined "`per-sample shading`" term
6375 in the <<primsrast-sampleshading, Sample Shading>> and
6376 <<shaders-fragment-execution, Fragment Shader Execution>> sections; for
6377 the <<features-features-sampleRateShading, sampleRateShading feature>>;
6381 of the <<features-limits-required,Required Limits>> table (internal
6389 `VK_KHR_maintenance1` extension is enabled to allow multi-slice 2D <->
6395 <<spirvenv-module-validation, Validation Rules within a Module>> section
6397 synchronization semantics, and only storage class semantics (internal
6407 <<interfaces-builtin-variables,Built-In Variables>> section to clarify
6409 * Disallow disjoint images from being used with dedicated-memory images in
6412 "ruby-gems" packages for use on Cygwin.
6419 -----------------------------------------------------
6428 <<extended-functionality-extensions-compatibility, Extension
6434 * Only include extension-dependent valid usage statement for
6436 header files described in the <<boilerplate-wsi-header, Window
6437 System-Specific Header Control>> section are only valid links, when the
6448 * Add "`general-purpose`" to the style guide, and correct existing uses of
6460 * Move the <<boilerplate-sType, pname:sType>> definition from the
6469 -----------------------------------------------------
6501 token from VK_KHR_maintenance2 from the non-extension VU path for
6503 * Miscellaneous minor markup fixes - extension name strings (public pull
6524 * Add memory semantics validity rules to the <<spirvenv-module-validation,
6525 Validation Rules within a Module>> section of the SPIR-V environment
6529 * Document mapping of OpenGL Shading Language barriers to SPIR-V scope and
6536 -----------------------------------------------------
6553 * Fix code:BuiltIn decoration typo in the <<fxvertex-attrib, Vertex
6567 each branch of the conditional appears as a standalone statement which
6581 * Remove the noise functions from GLSL for SPIR-V for Vulkan in the
6590 -----------------------------------------------------
6602 <<fundamentals-errors, Errors>> section (public issue 147).
6603 * Update the <<memory-device,Device Memory>> section with clarifications
6605 * Fix typo VkDeviceCreateInfo -> slink:VkDebugMarkerObjectNameInfoEXT in
6612 Also unified the sparse and non-sparse source-destination overlap rules,
6613 since the non-sparse rules were technically inaccurate in the face of
6614 aliasing in flink:vkBindMemory2 - the new rules are true regardless
6616 * Clarified the <<features-features-samplerAnisotropy,
6623 <<fundamentals-validusage-pointers,Valid Usage for Pointers>> section
6627 conditions in the new <<textures-integer-coordinate-operations, Integer
6651 -----------------------------------------------------
6679 * Define how framebuffer-local dependencies work between subpasses with
6681 slink:VkSubpassDescription and <<synchronization-framebuffer-regions,
6684 framebuffer-local dependency (internal issue 915).
6685 * Specify which storage classes can have an initializer in the
6686 <<spirvenv-module-validation, Validation Rules within a Module>> section
6688 * Use "LOD" consistently for "level-of-detail", to eliminate spelling
6695 deleting partially-made targets.
6701 -----------------------------------------------------
6727 * Specify a list of supported SPIR-V Storage Classes in the
6728 <<spirvenv-module-validation, Validation Rules within a Module>>
6729 appendix (internal SPIR-V issue 166).
6731 <<synchronization-semaphores-importing, Importing Semaphore Payloads>>
6733 * Update the <<textures-image-level-selection, Image Level(s) Selection>>
6734 equations so that the parameters returned by the level-of-detail query
6744 * Clarify in <<textures-operation-validation,Image View Validation>> that
6753 -----------------------------------------------------
6769 the <<synchronization-fences-importing, Importing Fence Payloads>> and
6770 <<synchronization-semaphores-waiting-state, Semaphore State Requirements
6774 flink:VkSwapchainCreateInfoKHR, the <<swapchain-wsi-image-create-info>>
6777 * Describe in the <<writing-arrays, Describing Properties of Array
6781 * Clarified that events cannot be used for cross-queue synchronization in
6782 the <<synchronization-events, Events>> section and for
6786 * Clarify aspect mask usage for image memory barriers of multi-plane
6788 the <<textures-layout-validation, Layout Validation>> section (internal
6816 -----------------------------------------------------
6834 * Add the <<fundamentals-abi,Application Binary Interface>> section
6837 <<boilerplate-platform-specific-calling-conventions, Platform-Specific
6850 * Add a note to the <<fundamentals-validusage-enums, Valid Usage for
6880 -----------------------------------------------------
6888 * Document that <<queries-timestamps, Timestamp Queries>> can only be
6892 non-disabled extensions (derived from, but does not close public issue
6899 * Replace as much of the hand-written extension appendix metadata as
6907 * Add a prototype tool for generating in-place difference markup for
6917 <<external-memory-handle-types-compatibility, External memory handle
6918 types compatibility>>, <<external-semaphore-handle-types-compatibility,
6920 <<external-fence-handle-types-compatibility, External fence handle types
6938 -----------------------------------------------------
6957 * Add an explanation to the <<interfaces-builtin-variables-layer,
6964 non-fragment stages (internal issue 933).
6969 the <<renderpass-load-store-ops>> section.
6975 -----------------------------------------------------
6983 * Update the <<interfaces-resources-descset,Descriptor Set Interface>>
6994 * Specify in the <<interfaces-fragmentoutput, Fragment Output Interface>>
7015 <<synchronization-pipeline-stages-masks, access and synchronization
7027 -----------------------------------------------------
7050 subresources used as attachments must not be accessed as non-attachments
7061 -----------------------------------------------------
7078 * Document use of code: macro for non-Vulkan APIs in the style guide
7082 * Fix <<spirvenv,SPIR-V appendix>> to say
7094 -----------------------------------------------------
7106 non-zero (public issue 491).
7113 <<textures-image-level-selection,Image Level(s) Selection>> (public
7117 * Fix link to floating/normalized fixed-point conversion from
7118 <<interfaces-fragmentoutput,Fragment Output Interface>> (public issue
7138 * Modify <<synchronization-framebuffer-regions, Framebuffer Region
7152 -----------------------------------------------------
7162 * Fix tessellation domain to have an upper-left origin in the
7163 <<img-tessellation-topology-ul, tessellation toplogy image>> and related
7165 just a documentation bug that it was flipped to lower-left (internal
7198 -----------------------------------------------------
7212 only required on systems that support multi-GPU (internal issue 835).
7232 * Simplify and/or split "`non-atomic`" valid usage statements.
7241 -----------------------------------------------------
7251 * Clarify behavior when non-coherent memory has
7252 <<memory-device-unmap-does-not-flush, not been flushed before being
7269 CC-BY 4.0, and update the proprietary Khronos copyright applied to the
7271 re-use and modification of the Vulkan specification sources, while not
7280 -----------------------------------------------------
7290 * Specify that a code:char* parameter must: be a valid null-terminated
7291 string in the <<fundamentals-implicit-validity, implicit valid usage>>
7300 the <<extended-functionality-extensions-dependencies, Extension
7318 * Re-sort extension appendices to be in alphabetical order within each
7323 -----------------------------------------------------
7339 out-of-host/out-of-device-memory, and improve the
7340 <<fundamentals-errorcodes, description of those errors (internal issue
7353 * Update style guide to prohibit writing non-self-contained (on a single
7369 -----------------------------------------------------
7380 * Fix GL_KHR_vulkan_glsl typo and add a nor-normative mapping to the newly
7389 pname:apiVersion specifies a non-supported version. That means that the
7408 <<extended-functionality-instance-extensions-and-devices, Instance
7410 * Require that SPIR-V run-time arrays are only used with the
7414 * Fix SPIR-V code sample for ename:VK_DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER
7415 in the <<descriptorsets-uniformtexelbuffer, Uniform Texel Buffer>>
7418 <<fragops-ds-state, Depth and Stencil Operations>> section (internal
7423 * Note that only 32-bit atomic operations are supported in the
7424 <<spirvenv-module-validation, Validation Rules within a Module>>
7427 the <<spirvenv-module-validation, Validation Rules within a Module>>
7438 -----------------------------------------------------
7451 -----------------------------------------------------
7459 * Allow <<synchronization-pipeline-barriers-subpass-self-dependencies,
7460 self-dependencies>> (also described for slink:VkSubpassDependency) to
7462 framebuffer-space (public issue 125).
7474 * Clarify facingness of non-polygon fragments for slink:VkStencilOpState
7475 and in the code:FrontFacing <<interfaces-builtin-variables,built-in
7480 (<<features-features-textureCompressionASTC_LDR,ASTC>>,
7481 <<features-features-textureCompressionETC2,ETC2>>,
7482 <<features-features-textureCompressionBC,BC>>) are supported, and that
7489 * Re-remove KHX variants of KHR structure types after promotion (internal
7492 -----------------------------------------------------
7500 * Add language to the <<fundamentals-validusage-enums, Valid Usage for
7504 <<fundamentals-validusage-flags, Valid Usage for Flags>> section (public
7506 * *Important*: run `gem update --pre asciidoctor-pdf` before trying to
7507 build this version of the spec - 1.5.0.alpha15 is required for this
7510 was incorporated into Asciidoctor-PDF for the latest release, so the
7519 slink:VkPhysicalDeviceDiscardRectanglePropertiesEXT to be a non-const
7521 non-const.
7535 -----------------------------------------------------
7553 a non-const pointer. Properties structures return values, so the chain
7554 should be non-const.
7556 "linear" and "non-linear" when referring to resources, and define what
7570 -----------------------------------------------------
7578 * Fix description of <<features-extentperimagetype, Allowed Extent Values
7586 * Fix all dangling internal cross-references in the 1.0-extensions
7615 <<fundamentals-validusage-flags,permitted to return 'undefined' bit
7629 the Input storage class (internal issue 733).
7631 from Python 3.0-3.2 using `future` package (internal issue 737).
7638 -----------------------------------------------------
7648 <<framebuffer-color-write-mask,Color Write Mask>> section (public issue
7675 * Remove undocumented KHX-variants of vkGetPhysicalDeviceProperties2KHR
7685 -----------------------------------------------------
7694 * Changed asciidoctor macros so cross-page links in the standalone
7701 <<synchronization-framebuffer-regions,Framebuffer Region Dependencies>>
7741 -----------------------------------------------------
7761 * Fix inter-page links in multi-file reference pages (public issue 454).
7774 texture <<textures-image-level-selection,Image Level(s) Selection>>
7783 -----------------------------------------------------
7789 Ruby-based ``asciidoctor'' implementation, rather than the Python-based
7793 because we now use an experimental direct-to-PDF backend for Asciidoctor
7794 instead of Docbook->dblatex->PDF. It is no longer possible to build the
7803 * Updated sample code for the <<sparsememory-examples-basic,sparse
7806 <<vertexpostproc-clipping, Primitive Clipping>> section to allow for
7807 pop-free behavior. The ability to check for which behavior is
7811 particular in the new sections <<drawing-primitive-order, Primitive
7812 Order>>, <<primsrast-order, Rasterization Order>>, and
7813 <<synchronization-implicit, Implicit Synchronization Guarantees>>; the
7814 discussion of <<synchronization-submission-order, submission order>>;
7816 * Clarify <<descriptorsets-compatibility,Pipeline Layout Compatibility>>
7835 * Update style guide to describe where to put new extensions-specific
7838 into the 1.0-extensions specification, instead of maintaining the index
7869 -----------------------------------------------------
7892 * Update the texture level-of-detail equation in the
7893 <<textures-scale-factor,Scale Factor Operation>> section to better
7895 * Forbid non-explicitly allowed uses of interface decorations in the
7898 * Replace use of MathJax with KaTeX, for improved load-time performance as
7899 well as avoiding the scrolling-and-scrolling behavior due to MathJax
7924 are defined in the <<features-features-multiViewport,multiple
7930 -----------------------------------------------------
7945 <<synchronization-semaphores-waiting,Semaphore Waiting and Unsignaling>>
7957 -----------------------------------------------------
7979 * Expand requirements memory binding of non-sparse images and buffers from
7980 the <<resources-association,Resource Memory Association>> section into
7988 -----------------------------------------------------
8004 <<synchronization-access-types-supported,supported access types>>
8007 github.com/KhronosGroup/Vulkan-LoaderAndValidationLayers/issues/1006 ).
8013 <<synchronization-pipeline-stages-supported>> section to prevent
8034 -----------------------------------------------------
8042 * Document in the <<memory-device-hostaccess,Host Access>> section that
8050 in the <<synchronization-dependencies,Execution and Memory
8057 indicating that the WSI-specific structure parameters must be valid, and
8070 * Fix Python scripts to always read/write files in utf-8 encoding, and a
8074 -----------------------------------------------------
8085 * Require that slink:VkImageSubresourceRange always define a non-empty
8094 * Shorten the table of contents in the single-page ref page HTML output.
8097 -----------------------------------------------------
8107 synchronization from per-command lists (public issue 398).
8109 'v1.0.32-core', instead of tags including the date of release, such as
8110 'v1.0-core-20161025' (public issue 405).
8125 <<resources-association,Resource Memory Association>> section
8138 -----------------------------------------------------
8148 references to MEMORY_READ that referenced WSI - they no longer make
8150 * Document valid non-boolean +externsync+ attribute values for <param>
8175 -----------------------------------------------------
8189 make it accurate, but still generic (non-exhaustive). Remove two Valid
8193 * The <<interfaces-builtin-variables,built-in variable>> code:PrimitiveId
8194 in a fragment shader needs the code:Input storage class (public issue
8204 pname:sampleCounts when for pname:usage only includes transfer-related
8211 glossary entry pointing to the SPIR-V Specification's definition of the
8214 -----------------------------------------------------
8239 * Modify the <<features-supported-sample-counts,Supported Sample Counts>>
8240 language to allow multisampled depth-stencil images (internal issue
8243 -----------------------------------------------------
8255 <<extended-functionality-instance-extensions-and-devices, Instance
8273 body, easing work in the single-branch model. Specify the distinction
8276 each command and structure - handcoded "Valid Usage" and the implicit
8288 in the +Makefile+ instead of the shorthand -R option, which doesn't work
8296 -----------------------------------------------------
8308 <<features-limits-required,Required Limits>> table are n *
8311 * Minor cleanup to <<boilerplate-platform-macros,Platform-Specific
8321 * Extend the table in the <<boilerplate-wsi-header, Window System-Specific
8342 * The <<features-limits-viewportboundsrange,viewportBoundsRange>> is
8351 extensions added in return for one-time pain. This has no perceptible
8355 -----------------------------------------------------
8371 * Be more clear in the <<interfaces-resources-layout-std140, uniform
8381 <<features-limits-required,Required Limits>> section from 128 to 256
8391 * Expand style guide and make it more self-consistent.
8398 -----------------------------------------------------
8410 * Add a new <<fundamentals-commandsyntax-results-lifetime,Lifetime of
8425 description in the <<boilerplate-wsi-header,Window System-Specific
8429 <<fundamentals-objectmodel-lifetime,Object Lifetime>> section. Disallow
8435 * Note that <<extended-functionality-layers,Layers>> may wrap object
8440 should: not to get rid of non-English words while still highlighting
8444 validity language and the <<features-supported-sample-counts,Supported
8449 * Reorganize the per-extension information sections to all be in the
8457 <<features-formats-non-packed,byte mapping tables>> for color formats.
8459 the <<textures-texel-replacement,Texel Replacement>> section.
8462 elink:VkExternalMemoryFeatureFlagBitsNV (KhronosGroup/Vulkan-Hpp issue
8466 -----------------------------------------------------
8472 included in the +1.0+ git branch, and specifications will include or not
8477 * Register and publish new extensions in the single-branch form:
8487 * Add SPIR-V <<textures-operation-validation, instruction validation>> for
8488 single-sampled images (public issue 316).
8498 * Convert link to the SPIR-V Specification for
8509 <<textures-image-level-selection,texture image level selection>> section
8513 with their own binary-compatible definition (internal issue 439).
8516 * Implement the single-branch model as described above (internal issue
8519 -----------------------------------------------------
8529 * Fix a copy-and-paste error in the description of
8541 <<boilerplate-platform-macros,platform macros>> section (public
8546 * Normalize the language for the remaining built-in variables in the
8547 <<interfaces-builtin-variables,Built-In Variables>> section. Fix
8557 -----------------------------------------------------
8569 * Fix a copy-and-paste error in the description of
8578 * Clean up the <<resources-image-views-compatibility,image and image view
8583 * Modify description of <<resources-memory-aliasing,memory aliasing>> to
8585 <<resources-bufferimagegranularity,buffer image granularity>> (public
8593 <<features-features-robustBufferAccess,pname:robustBufferAccess>>
8614 -----------------------------------------------------
8622 * Translate the subpass self-dependency language into concrete
8633 * Changed 64-bit definition for
8654 code:CullDistance, the SPIR-V capability is required to be declared
8659 get translated to SPIR-V's code:RelaxedPrecision decoration as they
8664 multisampled images must be two-dimensional, optimally tiled, and
8680 (Vulkan-LoaderAndValidationLayers/issues/601).
8689 -----------------------------------------------------
8697 * Clarify how <<features-supported-sample-counts,sample count queries>>
8700 * Clarify in the <<interfaces-iointerfaces,Shader Input and Output
8717 not set a mode, in the VK_KHR_display extension. This is a round-about
8727 <<fxvertex,Fixed-Function Vertex Processing>> section (internal issue
8746 * Update vk_platform.h to handle 32-bit ARMv8 binaries.
8749 -----------------------------------------------------
8772 -----------------------------------------------------
8790 are usually no-ops if the formats are the same (public issue 253).
8791 * Remove 'non-sparse' from description of
8797 flink:vkAcquireNextImageKHR is called in the VK_KHR_swapchain branch
8802 placed in the <<[tessellation-tessellator-spacing,Tessellator Spacing>>
8807 * Normalize the language of all the compute shader built-ins in the
8808 <<interfaces-builtin-variables,Built-in Variables>> section (internal
8817 "Khronos-provided" since the Android loader is not (internal issue 380)
8827 -----------------------------------------------------
8844 <<devsandqueues-submission>>.
8846 the synchronization chapter <<synchronization-semaphores-waiting>>,
8847 <<synchronization-semaphores-signaling>> and
8848 <<synchronization-fences-waiting>>.
8858 *** The "host writes" section of this is still there for now - in its
8863 <<fundamentals-queueoperation>>
8873 Vulkan API, instead of the pre-1.0-release internal revisions
8875 * Specified that <<interfaces-fragmentoutput,undeclared fragment
8888 <<pipelines-specialization-constants,Specialization Constants>>
8891 syntax) for vertex shader built-ins (internal issue 368).
8893 apispec.txt for the single-page version of the ref pages (internal
8902 -----------------------------------------------------
8912 <<shaders-vertex-execution>> (public issue 106).
8914 pname:ppEnabledLayerNames (in the <<initialization-instances>> and
8915 <<devsandqueues-device-creation>> sections) (public issue 214).
8924 <<interfaces-builtin-variables,Built-In Variables>> section as two and
8944 -----------------------------------------------------
8954 integer texture lookups are sign-extended in the
8955 <<textures-format-conversion,Format Conversion>> and
8956 <<textures-texel-replacement,Texel Replacement>> sections (public
8959 command-line client, needed when building from a tarball or another
8960 source of the Vulkan tree rather than a cloned git repo. Remove
8976 <<extended-functionality-instance-extensions-and-devices, Instance
8982 <<interfaces-builtin-variables,Built-in Variables>> section
8989 <<features-extentperimagetype,Allowed Extent Values>> section
8991 * Disallow recursion under SPIR-V entry points in the
8992 <<spirvenv-module-validation,Validation Rules within a Module>>
8993 section (internal SPIR-V issue 37).
9001 -----------------------------------------------------
9011 Interface to specify code:UniformConstant storage class (public issue
9016 * Fix output variable names in the <<fundamentals-fpfixedconv,Conversion
9017 from Floating-Point to Normalized Fixed-Point>> section and related
9025 * Update the <<sparsememory-sparse-memory-aliasing,Sparse Resource
9029 -----------------------------------------------------
9042 * Fix two copy-and-paste errors in the WSI queries, where the wrong
9051 <<queries-pipestats,Pipeline Statistics Queries>> (internal issue
9057 <<interfaces-builtin-variables,Built-in Variables>> section such
9058 that they match the SPIR-V specification.
9060 -----------------------------------------------------
9086 the <<drawing-primitive-topologies,Primitive Topologies>> section
9091 * Clarify in the <<pipelines-cache,Pipeline Cache>> section that
9109 variables in the <<interfaces-builtin-variables,Built-in Variables>>
9111 * Clarify in the <<fundamentals-returncodes,Return Codes>> section that
9115 -----------------------------------------------------
9124 * Change valid usage statements intended to be "sub-points" to
9125 be actual sub-points (public issue 66).
9135 * Fix various "a image" -> "an image" typos (public issue 191).
9136 * Note in the <<fundamentals-validusage,Valid Usage>> and
9137 <<extensions-interactions,Extension Interactions>> sections that
9149 * Clarify the host-side data validity rules and behavior of
9170 -----------------------------------------------------
9180 "ownership" language to more-consistent "acquire" language (public
9184 <<synchronization-execution-and-memory-dependencies,Execution And
9187 <<fundamentals-execmodel,Execution Model>> section (public issue
9193 consistent style for SPIR-V codewords, and tag normative terms that
9205 <<fundamentals-validusageValid Usage>> section (internal issue 254).
9210 * Modify the <<features-extentperimagetype,Allowed Extent Values Based
9214 * Clarify in the <<spirvenv-module-validation,Validation Rules within
9231 -----------------------------------------------------
9240 * Slightly tweak the <<memory-allocation,Host Memory>> allocator language
9242 functions is still correct - the previous language was too strong with
9243 regards to freeing memory. Also made certain scenarios clearer - an
9248 <<sparsememory-miptail,Mip Tail Regions>> section and related commands
9254 <<interfaces-builtin-variables,Built-In Variables>> section, and update
9255 the <<compute-shaders,Compute Shaders>> section to further clarify how
9259 except for the special case of *host-accessible subresource*, which may
9271 * Fix a few minor internally-detected typos.
9277 -----------------------------------------------------
9292 "ownership" language to more-consistent "acquire" language (public issue
9295 duration of any API command in the <<memory-allocation,Memory
9298 location in the <<interfaces-iointerfaces-locations,Location
9310 spec-const arrays in initializers (internal issue 248).
9311 * Clarify <<interfaces-iointerfaces-matching,Interface Matching>> section
9312 to state that user-defined variable interface must match too (internal
9315 -----------------------------------------------------
9328 in the <<textures-depth-compare-operation,Depth Compare Operation>>
9341 * Fix SPIR-V example code in the
9342 <<descriptorsets-inputattachment,Input Attachment>> section to
9350 * Link to the fixed-function vertex chapter from the drawing chapter
9353 ptext:maxExtent.sampleCounts -> pname:sampleCounts (internal issue
9355 * Explain why the non-core token etext:VK_IMAGE_LAYOUT_PRESENT_SRC_KHR
9357 <<synchronization-semaphores,Semaphores>> section (internal issue
9361 that there is no Android-specific WSI query, and why (internal issue
9370 -----------------------------------------------------
9383 * Add stub reference pages so xrefs to not-yet-written pages do not
9390 <<features-limits-bufferImageGranularity,bufferImageGranularity>>
9397 <<textures-texel-replacement,Texel Replacement>> section
9399 * Add the <<fundamentals-architecture-model,Architecture Model>>
9412 the <<interfaces-inputattachment,Fragment Input Attachment
9419 <<appendix-compressedtex-bc,Block Compressed Image Formats>> section
9422 auto-generation code in the scripts to infer it instead, to ensure
9440 -----------------------------------------------------
9454 <<interfaces-iointerfaces-locations,Location Assignment>>
9456 * Editorial fixes for <<commandbuffer-allocation,Command Buffer
9458 * Clarify behavior of depth test in the <<fragops-depth,Depth Test>>
9467 * Remove confusing wording in the <<features-limits,Limits>>
9475 re-wording to avoid "color space" when actively incorrect, now that
9481 * Cleanup minor editorial issues in chapters 14-17 (public issue 100).
9486 parameter to be a pointer to a null-terminated UTF-8 string (public
9496 in the PDF title. Fix label on <<fig-non-strict-lines,Non
9498 tables in the <<features-required-format-support,Required
9501 <<extensions-naming-conventions, Extension and Layer Naming
9518 parameter, struct member, or SPIR-V variable, but not when speaking
9527 a null-terminated UTF-8 string" (internal issue 197).
9542 -----------------------------------------------------
9564 * Fix typos in chapters 7-9 (public issue 14).
9567 <<shaders-execution-memory-ordering,shader memory acces
9572 <<memory-allocation,memory allocation>> section (public issue
9582 <<interfaces-resources-layout,Offset and Stride Assignment>>
9585 <<textures-RGB-sexp,RGB to shared exponent conversion>>.
9589 the <<interfaces-builtin-variables,Built-In Variables>>
9592 <<textures-level-of-detail-operation,bias added to the scale
9596 <<features-limits-bufferImageGranularity,the
9631 -----------------------------------------------------
9639 variable-length array queries. Properly tag enumerants so they come
9644 * Use standards-compliant preprocessor guard symbols on headers
9651 * Add VK_KHR_mirror_clamp_to_edge extension to core API branch, as an
9655 not refer to nonexistent (GL-specific) state (internal issue 111).
9664 * Typo fixed in <<sparsememory-examples-advanced,Advanced Sparse
9674 * Fix a handful of broken cross-references in the
9688 -----------------------------------------------------
9690 February 16, 2016 - Vulkan 1.0 initial public release