Commit Graph

353 Commits

Author SHA1 Message Date
Jon Leech 894211de5f (The previous commit didn't actually include internal gitlab changes
since 1.1.89; fixed now).

Change log for October 28, 2018 Vulkan 1.1.90 spec update:

  * Update release number to 90.

Public Issues:

  * Tag flink:vkQueueWaitIdle as `externsync` in `vk.xml` (public pull
    request 815).
  * Update README (public pull request 834).
  * `VK_NV_framebuffer_mixed_samples` and `VK_AMD_mixed_attachment_samples`
    had confusing and contradictory valid usage statements when read in the
    all-extensions spec build. Change them to explicitly mention which
    extension each is for (public issue Vulkan-ValidationLayers/issues/353).

Internal Issues:

  * Update `COPYING.md` to clarify how externally generated Vulkan
    Specifications (for translations, annotations, or other reasons) must be
    copyrighted, and acknowledge the Exception Clause on the `vk.xml`
    license (internal issue 1079).
  * Specify that flink:vkGetPhysicalDeviceImageFormatProperties may: return
    pname:maxMipLevels 1 if the format is ycbcr (internal issue 1361).
  * Clarify previously underspecified language for
    flink:vkCmdPushConstants::pname:pStageFlags regarding use of push
    constants across multiple pipelines (internal issue 1403).
  * Fix typo in XML/headers for
    ename:VK_STRUCTURE_TYPE_IMAGE_DRM_FORMAT_MODIFIER_EXPLICIT_CREATE_INFO_EXT,
    which was previously
    etext:VK_STRUCTURE_TYPE_IMAGE_EXCPLICIT_DRM_FORMAT_MODIFIER_CREATE_INFO_EXT
    (internal issue 1428).
  * Fix markup of equations that were sporadically breaking the
    `optimize-pdf` step of PDF generation, due (apparently) to inconsistent
    treatment of unwrapped multicharacter terms by different LaTeX parsers
    (internal issue 1435).
  * For the <<memory-model-synchronizes-with synchronizes-with>> memory
    model relation cases involving a release barrier plus relaxed atomic
    write, treat the atomic as if it were a release atomic and allow the
    acquire side to read from its hypothetical release sequence. This is
    more consistent with how C++ defines synchronization for release fences
    (internal issue cross-api/memory-model#72).
  * Minor editorial changes to the <<memory-model, memory model>> appendix
    based on external feedback.
2018-10-28 23:53:18 -07:00
Jon Leech 1858598fe0 Fix whitespace 2018-10-28 22:11:13 -07:00
Jon Leech 099174883d Change log for October 28, 2018 Vulkan 1.1.90 spec update:
* Update release number to 90.

Public Issues:

  * Tag flink:vkQueueWaitIdle as `externsync` in `vk.xml` (public pull
    request 815).
  * Update README (public pull request 834).
  * `VK_NV_framebuffer_mixed_samples` and `VK_AMD_mixed_attachment_samples`
    had confusing and contradictory valid usage statements when read in the
    all-extensions spec build. Change them to explicitly mention which
    extension each is for (public issue Vulkan-ValidationLayers/issues/353).

Internal Issues:

  * Update `COPYING.md` to clarify how externally generated Vulkan
    Specifications (for translations, annotations, or other reasons) must be
    copyrighted, and acknowledge the Exception Clause on the `vk.xml`
    license (internal issue 1079).
  * Specify that flink:vkGetPhysicalDeviceImageFormatProperties may: return
    pname:maxMipLevels 1 if the format is ycbcr (internal issue 1361).
  * Clarify previously underspecified language for
    flink:vkCmdPushConstants::pname:pStageFlags regarding use of push
    constants across multiple pipelines (internal issue 1403).
  * Fix typo in XML/headers for
    ename:VK_STRUCTURE_TYPE_IMAGE_DRM_FORMAT_MODIFIER_EXPLICIT_CREATE_INFO_EXT,
    which was previously
    etext:VK_STRUCTURE_TYPE_IMAGE_EXCPLICIT_DRM_FORMAT_MODIFIER_CREATE_INFO_EXT
    (internal issue 1428).
  * Fix markup of equations that were sporadically breaking the
    `optimize-pdf` step of PDF generation, due (apparently) to inconsistent
    treatment of unwrapped multicharacter terms by different LaTeX parsers
    (internal issue 1435).
  * For the <<memory-model-synchronizes-with synchronizes-with>> memory
    model relation cases involving a release barrier plus relaxed atomic
    write, treat the atomic as if it were a release atomic and allow the
    acquire side to read from its hypothetical release sequence. This is
    more consistent with how C++ defines synchronization for release fences
    (internal issue cross-api/memory-model#72).
  * Minor editorial changes to the <<memory-model, memory model>> appendix
    based on external feedback.
2018-10-28 21:32:44 -07:00
Jon Leech 3c0abef815
Merge pull request #815 from krOoze/q_idle_externsync
Make vkQueueWaitIdle externsync
2018-10-28 20:30:41 -07:00
Jon Leech 5aafa2bbe5
Merge pull request #834 from krOoze/update_readme
Update README
2018-10-28 20:20:47 -07:00
Petr Kraus 4bea57364f Update README
- make sentence a list for lesser cognitive strain
- add references to Vulkan-Headers repo
- add reference to Vulkan-Ecosystem repo
- separate obsolete and irrelevant info from the basic info
- update directory tree
- add\convert to links (for easier navigation)
- lots of frivolous changes
2018-10-24 16:26:50 +02:00
Jon Leech 8d6a7b23a7 Change log for October 21, 2018 Vulkan 1.1.89 spec update:
* Update release number to 89.

Public Issues:

  * Clarify the reference to <<features-limits-mipmapPrecisionBits, mipmap
    precision bits>> in the <<textures-image-level-selection, Image Level(s)
    Selection>> section (public issue 660).
  * Update <<debugging-object-types,VkObjectType and Vulkan Handle
    Relationship>> table with missing types (public pull request 820).
  * Miscellaneous minor markup cleanup (public pull request 822).
  * Fix copy/paste bugs in the description of how implicit
    availability/visibility operations for atomics/barriers are ordered in
    the <<memory-model-availability-visibility-semantics, Availability and
    Visibility Semantics>> section (public issue 823).
  * Add missing shading_rate_image bit from mesh pipeline list in the
    <<synchronization-pipeline-stages-types>> list (public issue 824).

Internal Issues:

  * Clarify that only statically used members of a push constant block need
    to be in the push constant range, and stop referring to block members as
    "`variables`" in the <<interfaces-resources-pushconst, Push Constant
    Interface>> section. This is related to
    https://github.com/KhronosGroup/Vulkan-ValidationLayers/issues/340
    (internal issue 1401).
  * Clarify interaction between flink:vkCmdSetDeviceMask and render pass
    control commands in the slink:VkDeviceGroupRenderPassBeginInfo section
    (internal issue 1416).
  * Miscellaneous minor markup cleanup.
  * Remove types defined by `"disabled"` extensions from
    validextensionstructs in the XML processing scripts, so downstream code
    generators don't emit them.
2018-10-21 06:08:41 -07:00
Jon Leech 93d65eb125
Merge pull request #822 from krOoze/markup
Random markup fixes
2018-10-21 04:18:00 -07:00
Jon Leech cbc2765f2f
Merge pull request #820 from krOoze/object_type_table
Update the Object Type table
2018-10-21 04:17:13 -07:00
Jon Leech 0a7a04f32b Change log for October 13, 2018 Vulkan 1.1.88 spec update:
* Update release number to 88.

Public Issues:

  * Make clear that
    tname:PFN_vkDebugUtilsMessengerCallbackEXT::pname:messageTypes is a
    bitmask, and correct a typo in the spelling of
    slink:VkDebugUtilsMessengerCreateInfoEXT.txt::pname:messageType (public
    pull request 800).
  * Make an ABI-compatible change of the type of
    slink:VkPhysicalDeviceDriverPropertiesKHR::pname:driverID to use the new
    elink:VkDriverIdKHR type (public issue 811).

Internal Issues:

  * Clarify for the <<features-features-shaderStorageImageExtendedFormats>>
    feature and in the <<spirvenv-capabilities-table>> that the feature
    means that all of the formats are supported, and that otherwise the
    features can be queried per-format (internal issue 1273).
  * Clarified interactions of `VK_EXT_external_memory_host` with host cache
    management commands and structures flink:vkMapMemory,
    flink:vkFlushMappedMemoryRanges, slink:VkMappedMemoryRange, and
    flink:vkUnmapMemory using the new glossary term "`Host Mapped Device
    Memory`" (internal issue 1385).
  * Update the language for flink:vkCreateViSurfaceNN.txt describing the
    pname:currentExtent of a VI surface to more accurately reflect current
    capabilities, replacing "`undefined`" with more explicit behavior
    (internal issue 1410).

New Extensions:

  * `VK_EXT_calibrated_timestamps`
  * `VK_EXT_image_drm_format_modifier` (this extension was previously
    disabled in vk.xml, and has now been enabled after some changes to fix
    performance issues).
  * `VK_EXT_pci_bus_info`
  * `VK_EXT_transform_feedback`
  * `VK_GOOGLE_hlsl_functionality1`, exposing support for
    `SPV_GOOGLE_hlsl_functionality1`.
  * `VK_GOOGLE_decorate_string`, exposing support for
    `SPV_GOOGLE_decorate_string`.
2018-10-13 03:23:03 -07:00
Jon Leech ed15235082
Merge pull request #800 from krOoze/fix788_debug_bit_vs_bitmask
Fix #788: make clear messageTypes is a bitmask + name fix
2018-10-12 23:40:14 -07:00
Petr Kraus d9e73159f2 Convert to pretty quotes 2018-10-09 01:41:40 +02:00
Petr Kraus 6af7805e91 Fix visible markup 2018-10-09 01:38:12 +02:00
Petr Kraus 8afc5d6c67 Fix Device lifetime list VkValidationCacheEXT markup 2018-10-09 01:38:12 +02:00
Petr Kraus 915882b93b Fix markup of asciiart labeled as C++ 2018-10-09 01:38:12 +02:00
Jon Leech 911a764694 Change log for October 7, 2018 Vulkan 1.1.87 spec update:
* Update release number to 87.

Public Issues:

  * Merge flink:vkCmdPipelineBarrier self-dependency barrier VUs referring
    to the same subpass dependency (public pull request 756).
  * Describe default value of `"optional"` attribute in the registry schema
    document (public issue 769)
  * Fix links in <<VK_NVX_raytracing>> extension (public pull request 805).
  * Mark the <<VK_KHR_mir_surface>> extension obsolete (see public issue 814
    - does not close this, however).
  * Fix missing endif in Image Creation block (public issue 817).

Internal Issues:

  * Clarify that the compressed texture formats corresponding to
    <<features-features-textureCompressionETC2>>,
    <<features-features-textureCompressionASTC_LDR>>, and
    <<features-features-textureCompressionBC>> is not contingent on the
    feature bits, and may be supported even if the features are not enabled
    (internal issue 663).
  * Clarify that code:FragStencilRefEXT is output only in the
    <<interfaces-builtin-variables, Built-In Variables>> section (internal
    issue 1173).
  * Identify and correct many overly-aggressive uses of "`undefined`", and
    narrow them down, where straightforward to do so. Mark such resolved
    uses of "`undefined`" with the custom undefined: macro. Add a new
    <<writing-undefined, Describing Undefined Behavior>> section (internal
    issue 1267).
  * Don't require code:inline_uniform_block descriptors to be populated
    before use in the flink:vkAllocateDescriptorSets section (internal issue
    1380).
  * Allow suppressing inline SVG images by controlling this with an
    attribute set in the Makefile, rather than the explicit [%inline]
    directive (internal issue 1391).
  * Mark 'Khronos' as a registered trademark in several places, now that it
    is one.
  * Fix typo in the <<VK_KHR_shader_atomic_int64>> appendix using the GLSL
    naming of the compare exchange op when referring to the SPIR-V op.
  * Specify in the flink:vkGetPhysicalDeviceQueueFamilyProperties section
    that all implementations must support at least one queue family, and
    that every queue family must contain at least one queue.
  * Make slink:VkPipelineDynamicStateCreateInfo::pname:dynamicStateCount,
    slink:VkSampleLocationsInfoEXT::pname:sampleLocationsPerPixel, and
    slink:VkSampleLocationsInfoEXT::pname:sampleLocationsCount optional, to
    fix bogus implicit valid usage checks that were causing failures in the
    conformance tests.
  * Fix vendor tag in reserved extension 237 constants. Does not affect
    anything since it's just a placeholder, but this should avoid further
    comments.
  * Minor markup fixes in some extension appendices.

New Extensions:

  * `<<VK_FUCHSIA_imagepipe_surface>>`
2018-10-07 06:10:21 -07:00
Jon Leech c75ae4fb18
Merge pull request #756 from krOoze/selfdependency_barrier_vu
Merge self-dependency barrier VUs referring to the same subpass dependency
2018-10-06 03:31:42 -07:00
Jon Leech f9e2fcf09a
Merge pull request #805 from krOoze/fix_spv_ray_link
Fix raytracing GLSL and SPV links
2018-10-06 03:27:20 -07:00
Jon Leech f1aa87e598
Merge pull request #817 from krOoze/fix_1_0_spec
Fix missing endif in Image Creation block
2018-10-03 23:26:39 -07:00
Petr Kraus 68c29453f6 Update the Object Type table 2018-10-03 17:55:15 +02:00
Petr Kraus ecb5f957d8 Fix missing endif in Image Creation block
which breaks 1.0 no-extension spec
2018-10-02 17:20:57 +02:00
Petr Kraus 6fe6fb3c28 Make vkQueueWaitIdle externsync 2018-10-01 18:57:18 +02:00
Jon Leech 7ea62a02a9 Change log for September 29, 2018 Vulkan 1.1.86 spec update:
* Update release number to 86.

Internal Issues:

  * Add new <<resources-image-creation-limits, Image Creation Limits>>
    section and reference that from valid usage statements, reducing
    combinatorial complexity of extension-dependent VUs. Also fixes some
    underspecified limits (such as pname:maxMipLevels) in the VUs for
    slink:VkImageCreateInfo when
    slink:VkExternalMemoryImageCreateInfo::pname:externalMemoryHandles
    contains multiple bits, and fixes incorrectly (and underspecified)
    limits when an Android external format is used (internal issue 1370).
  * Remove unused "`Fragment Area Granularity`" glossary entry accidentally
    introduced in the 1.1.85 update.

New Extensions:

  * `VK_KHR_driver_properties`
  * `VK_KHR_shader_atomic_int64`
  * The specification sources contain text for another extension,
    `VK_EXT_image_drm_format_modifier`, but this extension is not yet
    complete, and is marked disabled in `vk.xml`. The extension will be
    enabled, and become part of the spec, only when the authors decide it is
    ready.
2018-09-29 03:23:41 -07:00
Khronos Group Webmaster 9f2171b411
Add CODE_OF_CONDUCT.md 2018-09-24 10:55:10 -04:00
Petr Kraus 869d12c74f Fix raytracing GLSL and SPV links 2018-09-21 11:45:25 +02:00
Jon Leech 9858c1e89e Change log for September 19, 2018 Vulkan 1.1.85 spec update:
* Update release number to 85.

Public Issues:

  * Add self-dependency ename:VK_DEPENDENCY_BY_REGION_BIT valid usage
    statements for slink:VkSubpassDependency(public pull request 778).
  * Apply fix from pull request 742 to slink:VkSubpassDependency and
    slink:VkSubpassDependency2 (public pull request 779).
  * Specify the units of slink:VkBufferImageCopy::pname:bufferRowLength and
    pname:bufferImageHeight as texels (public pull request 781).
  * Better specify promoted parameter mapping in the
    `<<VK_KHR_create_renderpass2>>` appendix (public pull request 782).

Internal Issues:

  * Only include the <<fundamentals-validusage-versions, Valid Usage for
    Newer Core Versions>> section in Vulkan 1.1 or later (internal issue
    1381).

Other Issues:

  * Clean up redundant valid usage language for the
    `VK_ANDROID_external_memory_android_hardware_buffer` extension
    interaction with slink:VkImageCreateInfo.
  * Fix error in a flag name within valid usage statements for
    slink:VkMemoryAllocateInfo.
  * Clarify that memory types are not totally ordered in
    slink:VkPhysicalDeviceMemoryProperties.
  * For slink:VkWriteDescriptorSetInlineUniformBlockEXT, set
    structextends="VkWriteDescriptorSet" in `vk.xml`, and make
    slink:VkDescriptorSetLayoutBindingFlagsCreateInfoEXT::pname:pBindingFlags
    optional.
  * Add documentation of 'provisional' XML attribute to registry.txt.

New Extensions:

  * `VK_NV_compute_shader_derivatives`
  * `VK_NV_corner_sampled_image`
  * `VK_NV_fragment_shader_barycentric`
  * `VK_NV_mesh_shader`
  * `VK_NV_representative_fragment_test`
  * `VK_NV_scissor_exclusive`
  * `VK_NV_shader_image_footprint`
  * `VK_NV_shading_rate_image`
  * `VK_NVX_raytracing`
2018-09-15 18:35:16 -07:00
Jon Leech 2d900062e2
Merge pull request #778 from krOoze/subpass_dependency_missing_vu
Add self-dependency `VK_DEPENDENCY_BY_REGION_BIT` VU
2018-09-15 18:22:47 -07:00
Jon Leech 8c5de0a387
Merge pull request #779 from krOoze/reapply_742
Apply #742 to `VkSubpassDependency2`: allow |, allow cond. rend.
2018-09-15 18:21:18 -07:00
Jon Leech 848dd8ed28
Merge pull request #781 from MarkCallow/issue752
Specify the units of buffer{RowLength,imageHeight}. Issue 752.
2018-09-15 18:19:07 -07:00
Jon Leech 68d4e193a8
Merge pull request #782 from KhronosGroup/736-mapping-clarification
Better specify parameter mapping for VK_KHR_create_renderpass2
2018-09-15 18:17:15 -07:00
Petr Kraus dce08232aa Fix #788: make clear messageTypes is a bitmask + name fix 2018-09-13 23:33:25 +02:00
Petr Kraus a790efe5f3 Apply #742 to `VkSubpassDependency2`: allow |, allow cond. rend. 2018-09-11 14:55:26 +02:00
Jon Leech 9d4ae0fcf4 Fix missing endif construct. 2018-09-08 19:44:35 -07:00
Jon Leech adadfce8a3 Change log for September 8, 2018 Vulkan 1.1.84 spec update:
* Update release number to 84.

Public Issues:

  * Fix code sample in the `<<VK_EXT_debug_utils>>` extension (public issue
    751).
  * Fix misleading comment in `vk.xml` for
    slink:VkDescriptorBufferInfo::pname:buffer (public pull request 762).
  * Fix formatting of deprecation attributes in schema doc (public pull
    request 767).
  * Change `can` to `may` in the description of
    elink:VkSparseImageFormatFlagBits, which are return values from queries
    (public pull request 768).
  * Prettify generated contact list in extension appendices, adding logos
    and a New Issue link (public pull request 770).
  * Enable sRGB conversion based on the image view format, not the image
    format, in the <<textures-format-conversion, Format Conversion>> section
    (public pull request 773).
  * Fix typo in equation in the <<primsrast-lines-basic, Basic Line Segment
    Rasterization>> section (public pull request 780).
  * Fix special characters in GitHub contacts links (public pull request
    783).
  * Make clean_pdf target remove pdf folder (public pull request 784).
  * Fix styleguide bad markup of block continuation (public pull request
    792).

Other Issues:

  * Allow a zero vertex attribute divisor in the
    `<<VK_EXT_vertex_attribute_divisor>>` extension, exposed via the
    slink:VkPhysicalDeviceVertexAttributeDivisorFeaturesEXT feature.
  * Add missing `structextends="VkDeviceCreateInfo"` to
    slink:VkPhysicalDeviceShaderDrawParameterFeatures and
    slink:VkPhysicalDeviceBlendOperationAdvancedFeaturesEXT.

New Extensions:

  * `VK_KHR_memory_model`
  * `VK_EXT_astc_decode_mode`
  * `VK_EXT_inline_uniform_block`
2018-09-08 15:52:13 -07:00
Jon Leech 89155faa62
Merge pull request #767 from krOoze/schema_deprecation_attr_editing
Fix formatting of deprecation attributes in schema doc
2018-09-08 13:31:20 -07:00
Jon Leech 7985bc1473
Merge pull request #780 from Richard-Yunchao/typo-in-chapter24
Fix a small typo in chapter 24.6.1: Basic Line Segment Rasterization
2018-09-08 13:30:39 -07:00
Jon Leech 9e51f57289
Merge pull request #783 from krOoze/fix_gh_link_script
Fix special characters in GitHub contacts links (fix PR #770)
2018-09-08 13:28:58 -07:00
Jon Leech 8d9dedd89d
Merge pull request #784 from krOoze/make_clean_pdf_dir
Clean pdf folder on make clean
2018-09-08 13:28:19 -07:00
Jon Leech 8afdf7ddce
Merge pull request #792 from krOoze/styleguide_markup_typo
Fix styleguide bad markup of block continuation
2018-09-08 13:26:24 -07:00
Petr Kraus a3bf9dac4d Fix styleguide bad markup of block continuation 2018-09-07 22:04:11 +02:00
Petr Kraus 56561f2689 Clean pdf folder on make clean 2018-09-03 22:59:40 +02:00
Petr Kraus 42fa313636 Fix special characters in GitHub contacts links (fix PR #770) 2018-09-03 17:54:53 +02:00
Jon Leech 2c1fd883e0
Merge pull request #773 from alexandret-unity/fix/srgb-based-on-image-view-format
sRGB enabled based on image view format
2018-09-03 06:04:25 -07:00
Jon Leech 0b4801a3f4
Merge pull request #770 from krOoze/pretty_ext_contacts
Pretty contacts in extension appendices
2018-09-03 06:02:40 -07:00
Jon Leech bcbfcb876d
Merge pull request #768 from krOoze/sparse_can_vs_may
'can' to 'may' in the `returnedonly` `VkSparseImageFormatProperties`
2018-09-03 06:01:50 -07:00
Jon Leech 2bb2bd7ca1
Merge pull request #762 from Ralith/cleanup
Remove misleading wording in VkDescriptorBufferInfo::buffer comment
2018-09-03 06:00:38 -07:00
Tobski 56e4ed839f
Better specify promoted parameter mapping
The appendix now points explicitly at structures and parameters mapped into the new extension.
2018-08-31 17:11:30 +01:00
MarkCallow 5cf880295c Specify the units of buffer{RowLength,imageHeight}. Issue 752. 2018-08-28 16:20:04 -07:00
Yunchao He fe10c9647c Fix a small typo in chapter 24.6.1: Basic Line Segment Rasterization 2018-08-28 10:02:20 -06:00
Petr Kraus e0271372d2 Add self-dependency `VK_DEPENDENCY_BY_REGION_BIT` VU 2018-08-28 15:46:08 +02:00