Vulkan-Docs/vkspec.txt
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

153 lines
3.0 KiB
Plaintext

// Copyright (c) 2014-2018 Khronos Group. This work is licensed under a
// Creative Commons Attribution 4.0 International License; see
// http://creativecommons.org/licenses/by/4.0/
= Vulkan^®^ {revnumber} - A Specification {apititle}
The Khronos^®^ Vulkan Working Group
:data-uri:
:icons: font
:toc2:
:toclevels: 2
:max-width: 100
:numbered:
:source-highlighter: coderay
// Various special / math symbols. This is easier to edit with than Unicode.
include::config/attribs.txt[]
//:editing-notes:
<<<<
include::copyright-spec.txt[]
<<<<
// Table of contents is inserted here
toc::[]
:leveloffset: 1
:test: 0
ifeval::["{test}"=="1"]
// include::config/mathtest.txt[]
include::chapters/fundamentals.txt[]
include::chapters/memory.txt[]
endif::[]
ifeval::["{test}"!="1"]
include::chapters/introduction.txt[]
include::chapters/fundamentals.txt[]
include::chapters/initialization.txt[]
include::chapters/devsandqueues.txt[]
include::chapters/cmdbuffers.txt[]
include::chapters/synchronization.txt[]
include::chapters/renderpass.txt[]
include::chapters/shaders.txt[]
include::chapters/pipelines.txt[]
include::chapters/memory.txt[]
include::chapters/resources.txt[]
include::chapters/samplers.txt[]
include::chapters/descriptorsets.txt[]
include::chapters/interfaces.txt[]
include::chapters/textures.txt[]
include::chapters/queries.txt[]
// Transfer operations
include::chapters/clears.txt[]
include::chapters/copies.txt[]
// Graphics Operations
include::chapters/drawing.txt[]
include::chapters/fxvertex.txt[]
include::chapters/tessellation.txt[]
include::chapters/geometry.txt[]
ifdef::VK_NV_mesh_shader[]
include::chapters/VK_NV_mesh_shader/mesh.txt[]
endif::VK_NV_mesh_shader[]
include::chapters/vertexpostproc.txt[]
include::chapters/primsrast.txt[]
include::chapters/fragops.txt[]
include::chapters/framebuffer.txt[]
// Compute
include::chapters/dispatch.txt[]
// Device Generated Commands
ifdef::VK_NVX_device_generated_commands[]
include::chapters/VK_NVX_device_generated_commands/generatedcommands.txt[]
endif::VK_NVX_device_generated_commands[]
// Sparse
include::chapters/sparsemem.txt[]
ifdef::VK_KHR_surface[]
include::chapters/VK_KHR_surface/wsi.txt[]
endif::VK_KHR_surface[]
// Raytracing
ifdef::VK_NVX_raytracing[]
include::chapters/VK_NVX_raytracing/raytracing.txt[]
endif::VK_NVX_raytracing[]
// Sort of an appendix
include::chapters/extensions.txt[]
include::chapters/features.txt[]
include::chapters/debugging.txt[]
// Appendices
:numbered!:
include::appendices/spirvenv.txt[]
ifdef::VK_KHR_vulkan_memory_model[]
include::appendices/memorymodel.txt[]
endif::VK_KHR_vulkan_memory_model[]
include::appendices/compressedtex.txt[]
ifdef::VK_VERSION_1_1[]
include::appendices/versions.txt[]
endif::VK_VERSION_1_1[]
// Extension appendices are now included from extensions.txt
include::appendices/extensions.txt[]
include::appendices/boilerplate.txt[]
include::appendices/invariance.txt[]
include::appendices/glossary.txt[]
include::appendices/credits.txt[]
endif::[]