mirror of
https://github.com/status-im/Vulkan-Docs.git
synced 2025-02-16 08:17:20 +00:00
35e7bee5f0
* Update release number to 102.
Public Issues:
* Simplify flink:vkGetImageMemoryRequirements constraint for
ename:VK_MEMORY_PROPERTY_LAZILY_ALLOCATED_BIT (public pull request 817).
* Fix typo in markup of the <<textures-texel-coordinate-systems-diagrams,
Texel Coordinate Systems, Corner Sampling>> image that was generating
complaints from chunked HTML output generation (public pull request
928).
Internal Issues:
* Split the old <<features, Features>> chapter into four chapters:
<<features, Features>>, <<limits, Limits>>, <<formats, Formats>>, and
<<capabilities, Capabilities>>, with minor edits to the introductory
paragraph of each chapter. Anchor names in these chapters were changed,
with corresponding effects to xrefs to these anchors elsewhere in spec
markup . The purpose is to make the chunked HTML spec output load faster
on what was previously a single, gigantic chapter (internal issue 1554).
* Add ename:VK_PIPELINE_STAGE_RAY_TRACING_SHADER_BIT_NV, to the supported
pipeline stages for ename:VK_ACCESS_UNIFORM_READ,
ename:VK_ACCESS_SHADER_READ, and ename:VK_ACCESS_SHADER_WRITE in the
<<synchronization-access-types-supported>> table.
* Correct legal name of Google, LLC in vk.xml \<tags> section and a
copyright statement.
* Clarify that Vulkan treats the Android
code:AHARDWAREBUFFER_FORMAT_R8G8B8X8_UNORM format as RGBA, and the
application is responsible for forcing the X/A component to be read as
1.0, in the <<memory-external-android-hardware-buffer-formats>> table.
* Clarify the vertex order of various primitive topologies, and define the
order of transform feedback vertex capture based on that. This involves
a lot of refactoring and cleanup in the <<drawing-primitive-topologies,
Primitive Topologies>>, <<geometry-input, Geometry Shader Input
Primitives>> sections, and <<vertexpostproc-transform-feedback Transform
Feedback>> sections, and numerous places in the <<tessellation>>
chapter,
New Extensions:
* `VK_EXT_metal_surface`
* `VK_EXT_ycbcr_image_arrays` (internal issue 1361).
* `VK_NVX_image_view_handle`
166 lines
3.4 KiB
Plaintext
166 lines
3.4 KiB
Plaintext
// Copyright (c) 2014-2019 Khronos Group. This work is licensed under a
|
|
// Creative Commons Attribution 4.0 International License; see
|
|
// http://creativecommons.org/licenses/by/4.0/
|
|
|
|
// The mysterious :regtitle: attribute is explained in
|
|
// http://discuss.asciidoctor.org/How-to-add-markup-to-author-information-in-document-title-td6488.html
|
|
|
|
= Vulkan^®^ {revnumber} - A Specification {apititle}
|
|
:regtitle: pass:q,r[^®^]
|
|
The Khronos{regtitle} 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 or insert trivial test markup here, to bypass building full spec
|
|
// include::chapters/textest.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[]
|
|
|
|
ifdef::VK_EXT_fragment_density_map[]
|
|
include::chapters/fragmentdensitymapops.txt[]
|
|
endif::VK_EXT_fragment_density_map[]
|
|
|
|
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_NV_ray_tracing[]
|
|
include::chapters/VK_NV_ray_tracing/raytracing.txt[]
|
|
endif::VK_NV_ray_tracing[]
|
|
|
|
// Sort of an appendix
|
|
include::chapters/extensions.txt[]
|
|
|
|
include::chapters/features.txt[]
|
|
|
|
include::chapters/limits.txt[]
|
|
|
|
include::chapters/formats.txt[]
|
|
|
|
include::chapters/capabilities.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::[]
|