Commit Graph

297 Commits

Author SHA1 Message Date
Petr Kraus 4403362d3c Fix formatting of deprecation attributes in schema doc 2018-08-17 20:46:13 +02:00
Jon Leech dd9919749a Change log for August 13, 2018 Vulkan 1.1.83 spec update:
* Update release number to 83.

Public Issues:

  * Use [%inline] directive for all SVGs to reduce file size (public pull
    request 734).
  * Convert XML `value` aliases into \<alias> tags (public pull request
    747).
  * Fix metadoc script showing non-selected extensions (public pull request
    748).
  * Reapply public pull request 742 to make
    ename:VK_PIPELINE_STAGE_CONDITIONAL_RENDERING_BIT_EXT part of the
    graphices pipeline (public pull request 749).
  * Fix numerous typos related to accidental duplication of words (public
    pull request 760).
  * Fix `vk.xml` contact typos (public pull request 761).

Internal Issues:

  * Add images to the <<Standard sample locations>> table (internal issue
    1115).
  * Add a definition of "`Inherited from`" precision in the
    <<spirvenv-precision-operation, Precision and Operation of SPIR-V
    Instructions>> section (internal issue 1314).
  * Clarify that both built-in and user-defined variables count against the
    location limits for shader interfaces in the
    <<interfaces-iointerfaces-locations, Location Assignment>> section
    (internal issue 1316).
  * Merge "`required`" capabilities into the <<spirvenv-capabilities-table,
    list of optional: SPIR-V capabilities>> (internal issue 1320).
  * Relax the layout matching rules of descriptors referring to only a
    single aspect of a depth/stencil image, by reference to the new
    <<resources-image-layouts-matching-rule, Image Layout Matching Rules>>
    section (internal issue 1346).
  * Revert extension metadoc generator warning about name mismatches to a
    diagnostic, due to annoying warnings in build output for conscious
    choices we've made (internal issue 1351).

Other Issues:

  * Reserve bits for pending vendor extensions.
  * Make Vulkan consistent with SPIR-V regarding code:DepthReplacing and
    code:FragDepth in the <<interfaces-builtin-variables, Built-In
    Variables>> section.
  * Add missing ChangeLog entries for the previous three spec updates.
2018-08-13 06:23:03 -07:00
Jon Leech dd7fe79336
Merge pull request #761 from krOoze/fix_broken_contacts
Fix contacts split with comma
2018-08-13 04:42:17 -07:00
Jon Leech ac5eb02b82
Merge pull request #760 from Whenning42/master
Fix small typos
2018-08-13 04:39:34 -07:00
Jon Leech 988a551dcf
Merge pull request #749 from krOoze/reaply_cond_rend_pr
Reapply #742:  Make STAGE_CONDITIONAL_RENDERING part of graphics pipe
2018-08-13 04:38:19 -07:00
Jon Leech 407c1c12c2
Merge pull request #748 from krOoze/fix_depr_script
Fix metadoc script showing non-selected extensions
2018-08-13 04:36:21 -07:00
Jon Leech 74557e6f59
Merge pull request #747 from krOoze/xml_use_alias_for_typos
Convert XML `value` aliases into `alias`
2018-08-13 04:33:47 -07:00
Jon Leech d957f42e8d
Merge pull request #734 from kainino0x/svg-inline
Use [%inline] for all SVGs
2018-08-13 04:29:49 -07:00
William Henning 969fb50f31 Remove doubly typed word typos 2018-08-06 20:19:01 -06:00
William Henning c7a2fcf5ec Fix "a" vs "an" typos occuring across two lines 2018-08-06 17:18:20 -06:00
William Henning 74fc29a0d6 Fix several more "a" vs "an" typos 2018-08-06 16:59:12 -06:00
Petr Kraus cca2f7449c Fix contacts split with comma
comma is a separator and cannot be within single contact item
2018-08-06 23:02:05 +02:00
Petr Kraus 099e7e3011 Convert XML `value` aliases into `alias` 2018-08-06 20:00:58 +02:00
William Henning 27e43d72f4 Fix small typos 2018-08-06 01:10:55 -06:00
Petr Kraus da11059ed2 Reapply #742: Make STAGE_CONDITIONAL_RENDERING part of graphics pipe
VK_PIPELINE_STAGE_CONDITIONAL_RENDERING_BIT_EXT has to be defined as part of graphics pipeline in order for VU modified in #742 to be accurate
2018-07-30 22:25:34 +02:00
Jon Leech ff0c233908 Change log for July 30, 2018 Vulkan 1.1.82 spec update:
* Update release number to 82.

Public Issues:

  * Add flink:vkDestroyPipelineLayout valid usage statement that the layout
    must not have been used with command buffers still in the recording
    state (public issue 730).
  * Correct \<unused> tag for elink:VkResult in `vk.xml` (public merge
    request 746).

Internal Issues:

  * Add a valid usage statement to flink:vkQueueSubmit, and similar language
    to the definitions of <<synchronization-queue-transfers-acquire, acquire
    operations>> requiring that an acquire operation follow a previous
    release of the same subresource (internal issue 1290).
  * Add <<resources-image-format-features,Image Format Features>> and
    <<resources-image-view-format-features,Image View Format Features>>
    sections that precisely define the slink:VkFormatFeatures supported by
    images and image views, and rewrite valid usage statements to reference
    these sections instead of duplicating language (internal issue 1310).
  * Reword and consolidate synchronization valid usage statements for
    flink:vkCmdPipelineBarrier such that they correctly account for mutiple
    possible self-dependencies (internal issue 1322).
  * Change order of <<Standard sample locations>> for 2xMSAA (internal issue
    1347).
  * Add definitions of "`<<Correctly Rounded>>`" and "`<<ULP>>`" in the
    SPIR-V environment appendix, and "`Units in the Last Place (ULP)`" in
    the glossary.

New Extensions:

  * `VK_NV_device_diagnostic_checkpoints`
2018-07-30 03:20:00 -07:00
Jon Leech d5fc0a72f3
Merge pull request #746 from krOoze/bad_xml_unused
Delete wrong <unused> tag
2018-07-30 02:01:28 -07:00
Petr Kraus 9d11e22ab6 Fix metadoc script showing non-selected extensions
mostly comments
`doc += content` -> `doc += innerdoc ` does the fix
2018-07-23 15:40:30 +02:00
Petr Kraus d8f9adb77a Update wrong VkResult <unused> tag 2018-07-23 12:44:38 +02:00
Jon Leech 6377124f37 Change log for July 23, 2018 Vulkan 1.1.81 spec update:
* Update release number to 81.

Public Issues:

  * Fix missing "`valid`" phrasing in some obscure cases (public pull
    request 605).
  * Replace improper use of cannot: referring to the implementation in the
    description of the
    <<features-limits-maxUpdateAfterBindDescriptorsInAllPools,
    pname:maxUpdateAfterBindDescriptorsInAllPools>> limit (public pull
    request 738).
  * Reorder description of bits in elink:VkPipelineStageFlagBits and the
    <<synchronization-pipeline-stages-supported, Supported pipeline stage
    flags>> table to match their definition order (public pull request 740).
  * Add description of ename:VK_BUFFER_USAGE_CONDITIONAL_RENDERING_BIT_EXT
    to elink:VkBufferUsageFlagBits (public pull request 741).
  * Fix value usage statement for slink:VkSubpassDependency stage mask
    parameters (public pull request 742).
  * Fix visible markup in registry schema document (public pull request
    #745).

Internal Issues:

  * Make the <<geometry-invocations, geometry shader invocation
    description>> and <<shaders-geometry-execution, Geometry Shader
    Execution>> descriptions consistent with other pipeline stages (internal
    issue 1325).
  * Mark the `VK_NV_glsl_shader` extension as deprecated.
  * Adjust the per-instance vertex attribute offset formula specified by
    `VK_EXT_vertex_attribute_divisor` for
    slink:VkVertexInputBindingDivisorDescriptionEXT so that the interaction
    between pname:firstInstance and pname:divisor matches the OpenGL
    convention (internal issue 1333).
2018-07-23 02:15:08 -07:00
Jon Leech 0c50f0e8b0
Merge pull request #605 from krOoze/fix_missing_valid
Fix missing "valid" in some obscure cases
2018-07-23 01:11:46 -07:00
Jon Leech f041cd79e7
Merge pull request #740 from krOoze/reorder_barrier_flags
Reorder stage and access flags to match their definition order
2018-07-23 00:56:23 -07:00
Jon Leech 729500018f
Merge pull request #745 from krOoze/markup_schema
Fix visible markup in schema doc
2018-07-23 00:54:18 -07:00
Jon Leech b3d63f6326
Merge pull request #738 from krOoze/bad_cannot_ind_pool
Fix cannot referring to impl in maxUpdateAfterBindDescriptorsInAllPools
2018-07-23 00:49:05 -07:00
Jon Leech 504113cbc1
Merge pull request #741 from krOoze/add_cond_usage_bit_desc
Add VK_BUFFER_USAGE_CONDITIONAL_RENDERING_BIT_EXT description
2018-07-23 00:43:19 -07:00
Jon Leech 6284e052d6
Merge pull request #742 from krOoze/fix_ifdef_in_vu
Fix VkSubpassDependency self-dependency stage VU
2018-07-23 00:41:47 -07:00
Petr Kraus daecfe8006 Fix visible markup in schema doc 2018-07-20 19:23:18 +02:00
Petr Kraus 5a1de0c1de Allow multiple flag bits in subpass self-dependency 2018-07-17 16:10:52 +02:00
Petr Kraus 5c3af4b338 Fix ifdef inside VU entry in VkSubpassDependency 2018-07-17 16:10:39 +02:00
Petr Kraus efb25b267a Add VK_BUFFER_USAGE_CONDITIONAL_RENDERING_BIT_EXT description 2018-07-12 18:24:35 +02:00
Petr Kraus a67969af1f Reorder stage and access flags to match their definition order 2018-07-12 17:43:23 +02:00
Petr Kraus a21ac56a81 Fix cannot referring to impl in maxUpdateAfterBindDescriptorsInAllPools 2018-07-10 15:14:40 +02:00
Petr Kraus 86de8ac805 Fix missing "valid" in some obscure cases
- update script to detect better structs that do not need "valid"
- update vk.xml and schema to say `noautovalidity` as a hint to the
script
- fix missing const in VkValidationFlagsEXT
- update some cases that were probably avoiding the bug
2018-07-09 22:59:20 +02:00
Jon Leech 831e2d4525 Change log for July 7, 2018 Vulkan 1.1.80 spec update:
* Update release number to 80.

Public Issues:

  * Remove unused "`API Order`" term from glossary (public issue 657).
  * Dynamically generate the extension appendix includes based on
    information in `vk.xml`, including new metadata tags describing
    deprecated, obsoleted, and promoted extensions (public pull request
    690).

Internal Issues:

  * Add valid usage statements to flink:vkCmdBindDescriptorSets to keep
    offsets + range less than or equal to the buffer size (internal issue
    1174).

New Extensions:

  * `VK_EXT_conditional_render`
  * `VK_KHR_create_renderpass2` (public issue 736)
  * `VK_KHR_8bit_storage` (public issue 737)
2018-07-07 02:21:56 -07:00
Jon Leech 5ffcd3fa3e Remove partial IMG extension appendix, since IMG hasn't chosen to
publish a spec for that yet, and add a change log to the registry
documentation.
2018-07-07 01:49:34 -07:00
Jon Leech 32a9e2ea3b
Merge pull request #690 from krOoze/organize_extensions
Organize extension appendices
2018-07-07 01:47:23 -07:00
Jon Leech ff9357a4ba Change log for July 1, 2018 Vulkan 1.1.79 spec update:
* Update release number to 79.

Public Issues:

  * Add a note to the <<features-required-format-support, Required Format
    Support>> section clarifying that the required formats don't depend on
    the used flags (public issue 671).
  * Add a valid usage statement for flink:vkUpdateDescriptors that was
    previously described for slink:VkImageSubresourceRange, but not as a
    valid usage statement (public issue 713).
  * Modify implicit valid usage generator script to not emit 'must: not be
    0' for a parameter that is a pointer to a flags field, such as
    pname:pPeerMemoryFeatures (public issue 729).

Internal Issues:

  * Add definitions of "`obsoleted`" and "`deprecated`", and modify the
    definition of "`promoted`" in the <<glossary, Glossary>> (internal issue
    988).
  * Add language for integer texel output conversions (the conversion is
    undefined) to the <<textures-output-format-conversion]] Texel Output
    Format Conversion>> section. Simplify and clarify the floating-point
    conversion language in the <<fundamentals-general, General
    Requirements>> section and the new <<fundamentals-fp-conversion,
    Floating-Point Format Conversions>> section, and remove obsolete
    language in the format-specific floating-point sections (internal issue
    1275).
  * Add the elink:VkVendorId enumerated type to the Vulkan API / XML /
    header, so reserved Khronos vendor IDs can be referred to symbolically
    by clients. Note that only Khronos vendor IDs (e.g. non-PCI vendor IDs)
    are defined (internal issue 1299).
  * Fix typo in the <<fig-non-strict-lines, Non strict lines>> table
    (internal issue 1315).
  * Clean up and simplify the
    <<features-formats-requiring-sampler-ycbcr-conversion, YCbCr format
    properties>> table and use symbols consistently with other tables. Add a
    column for the number of planes.
  * Add code:Float16 to the <<spirvenv-capabilities-table, List of optional
    SPIR-V capabilities>> for the `VK_AMD_gpu_shader_half_float` extension.
2018-07-01 21:26:49 -07:00
Jon Leech 07d059c798
Merge pull request #713 from KhronosGroup/tobin_descriptor_ds_image_vu
Add VU for depth/stencil image descriptor
2018-07-01 17:18:10 -07:00
Kai Ninomiya 4ba7c06e72 Use [%inline] for all SVGs
Provides a 12.6% size savings for vkspec.html
(697770 B -> 609679 B, gzipped), because:
(1) plaintext is smaller than base64-encoded plaintext, and
(2) base64 does not gzip as well as plaintext SVG.
2018-06-28 16:37:10 -07:00
Petr Kraus fe20b27df1 Document 'promotedto', 'deprecatedby' and 'obsoletedby' <extension> attributes 2018-06-27 14:27:56 +02:00
Petr Kraus cbb743537e Organize extension appendices
- hide from toc
- split into "current" extensions, and extensions that have been since
deprecated by a better alternative
- make core promotion list generated
- add information to extension appendix about possible better
alternatives
- split contacts to separate lines
- some general-purpose quality improvements to the script
2018-06-26 21:06:02 +02:00
Jon Leech 9582bcb54e Minor build fixes. 2018-06-18 03:24:40 -07:00
Jon Leech 933a3a3c4a Change log for June 18, 2018 Vulkan 1.1.78 spec update:
* Update release number to 78.

Public Issues:

  * Change markup so parameter descriptions include links to structures,
    instead of just their names (public issue 697).
  * Resume publishing updated Vulkan 1.0 + KHR extensions and Vulkan 1.0 +
    all extensions versions of the specification (public issue 722).
  * Reapply fixes from public pull request 698 for
    `VK_ANDROID_external_memory_android_hardware_buffer`, which accidentally
    were reverted at some point (public pull request 724).
  * Fix undefined format valid usage statements for slink:VkImageCreateInfo
    in the presence of the
    `VK_ANDROID_external_memory_android_hardware_buffer` extension (public
    pull request 725).
  * Miscellaneous markup consistency fixes (public pull request 728).

Internal Issues:

  * When building specifications containing vendor extensions, add terms to
    the Khronos spec copyright specifying that the result is not a ratified
    specification (internal issue 739).
  * Change the value of the
    pname:maxDescriptorSetUpdateAfterBindUniformBuffers minimum limit to 72
    (6 times pname:maxPerStageDescriptorUpdateAfterBindUniformBuffers) in
    the <<features-limits-required, Required Limits>> table (internal issue
    1300).

Other Issues:

  * Fix link to resource image view compatibility table in the valid usage
    statements for slink:VkImageFormatListCreateInfoKHR (internal pull
    request 2711).
2018-06-18 01:46:28 -07:00
Jon Leech 95da63ce68
Merge pull request #728 from krOoze/markup
Random markup fixes
2018-06-18 00:46:57 -07:00
Jon Leech 116c401cf4
Merge pull request #724 from krOoze/android_markup
Reapply #698: VK_ANDROID_external_memory_android_hardware_buffer markup cleanup
2018-06-18 00:03:55 -07:00
Jon Leech 0b2f3376c7
Merge pull request #725 from krOoze/fix_android_image_format_vu
Fix android buffer extension undefined format VUs
2018-06-18 00:00:33 -07:00
Petr Kraus 9adcc2f19f Random markup fixes 2018-06-11 21:04:31 +02:00
Jon Leech 0d5f92c7fa Change log for June 10, 2018 Vulkan 1.1.77 spec update:
* Update release number to 77.

Public Issues:

  * Remove redundant asciidoctor ifdef in slink:VkDeviceCreateInfo valid
    usage statement (public pull request 718).

Internal Issues:

  * Require that the returned slink:VkMemoryRequirements::pname:alignment
    reflect the minimum alignment requirements for the buffer's usages, and
    make dynamic offset alignment valid usage more explicit for
    flink:vkBindBufferMemory and flink:vkCmdBindDescriptorSets (internal
    issue 1170).
  * Explicitly state that objects of type code:OpTypeImage,
    code:OpTypeSampler, and code:OpTypeSampledImage must not be stored to in
    the <<spirvenv-module-validation, Validation Rules within a Module>>
    section (internal issue 1262).
  * Clarify rules about validating descriptor set/binding against storage
    class and descriptor type in the <<spirvenv-module-validation,
    Validation Rules within a Module>> section, and add an anchor for and
    references to the <<interfaces-resources-storage-class-correspondence,
    Shader Resource and Storage Class Correspondence>> table (internal issue
    1266).
  * Use correct spelling of SPIR-V decoration code:NonWritable in several
    places (internal issue 1298).

Other Issues:

  * Update specification links to files in the old
    KhronosGroup/Vulkan-LoaderAndValidationLayers repository with
    corresponding links into the new repositories that replace it.
  * Move validity requirement for slink:VkSamplerCreateInfo into the valid
    usage block instead of the body text, and give it a VUID.
  * Use the full name of the "`style guide`" in a reference in the
    description of slink:vkGetPhysicalDeviceProperties, update the
    <<vulkan-styleguide, link to that document>>, and use the the full name
    in the registry index page.
2018-06-10 19:43:40 -07:00
Jon Leech 1329718aba
Merge pull request #718 from krOoze/neg_vp_ext_extraneous_ifdef
Remove extraneous ifdef in VkDeviceCreateInfo VU
2018-06-08 18:06:14 -07:00
Petr Kraus ab99080c90 Fix android buffer extension undefined format VUs 2018-06-08 19:49:21 +02:00