352 Commits

Author SHA1 Message Date
Alexandre Thibodeau
2587c97687 Added potentially missing word, assuming that sRGB is enabled based on the image view format, not based on the image format. 2018-08-23 12:58:27 -04:00
Petr Kraus
ff6122475b Make GitHub contacts point to prefilled Issue tracker 2018-08-18 17:52:31 +02:00
Petr Kraus
09902e3490 Add GitHub and GitLab icons to contacts 2018-08-18 16:24:13 +02:00
Petr Kraus
a82de4e523 'can' to 'may' in the returnedonly VkSparseImageFormatProperties 2018-08-17 21:10:29 +02:00
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.
v1.1.83
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
Benjamin Saunders
7feed056d6 Remove misleading wording in VkDescriptorBufferInfo::buffer comment 2018-08-06 18:09:24 -07: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`
v1.1.82
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).
v1.1.81
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)
v1.1.80
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.
v1.1.79
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. v1.1.78 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