mirror of
https://github.com/status-im/Vulkan-Docs.git
synced 2025-02-22 02:58:16 +00:00
ce60b9c887
* Vulkan 1.1 initial release. Bump API patch number and header version
number to 70 for this update. The patch number will be used for both
Vulkan 1.1 and Vulkan 1.0 updates, and continues to increment
continuously from the previous Vulkan 1.0.69 update.
NOTE: We are not publishing an updated 1.0.70 specification, or 1.1
reference pages, along with 1.1.70. There are still minor issues to work
out with those build targets. However, we will soon generate all three
types of documents as part of the regular spec update cycle.
NOTE: The GitHub KhronosGroup/Vulkan-Docs repository now maintains the
current specification in the `master` branch. The `1.0` branch is out of
date and will not be maintained, since we will be generating both 1.1
and 1.0 specifications from the `master` branch in the future.
Github Issues:
* Clarify how mapped memory ranges are flushed in
flink:vkFlushMappedMemoryRanges (public issue 127).
* Specify that <<synchronization-pipeline-stages, Pipeline Stages>> are a
list of tasks that each command performs, rather than necessarily being
discrete pieces of hardware that one task flows through. Add a
"`synchronization command`" pipeline type which all synchronization
command execute (it's just TOP + BOTTOM), with an explanatory note
(public issue 554).
Internal Issues:
* Regenerate all images used in the spec in Inkscape with a consistent
look-and-feel, and adjust image size attributes so they're all legible,
and not too large with respect to the spec body text (internal issue
701).
* Document in the <<extensions,extensions>> appendix and in the style
guide that `KHX` extensions are no longer supported or used in the
Vulkan 1.1 timeframe (internal issue 714).
* Remove the leftover equations_temp directory after PDF build completes
(internal issue 925).
* Update the <<credits, Credits (Informative)>> appendix to include
contributors to Vulkan 1.1, and to list them according to the API
version(s) they contributed to (internal issue 987).
* Add a NOTE to the introduction explaining that interfaces defined by
extensions which were promoted to Vulkan 1.1 are now expressed as
aliases of the Vulkan 1.1 type (internal issue 991).
* Instrument spec source conditionals so spec can be built with 1.1
features, extensions promoted to 1.1, or both (internal issues 992,
998).
* Modify the XML schema and tools to support explicit aliasing of types,
structures, and commands, and use this to express the promotion of 1.0
extensions to 1.1 core features, by making the extension interfaces
aliases of the core features they were promoted to. Mark up promoted
interfaces to allow still generating 1.0 + extension specifications
(internal issue 991).
* Platform names, along with corresponding preprocessor symbols to enable
extensions specific to those platforms, are now reserved in vk.xml using
the <platform> tag. Update the registry schema and schema specification
to match (internal issue 1011).
* Updated the <<textures-texel-replacement, Texel Replacement>> section to
clarify that reads from invalid texels for image resources result in
undefined values (internal issue 1014).
* Modify description of patch version so it continues to increment across
minor version changes (internal issue 1033).
* Clarify and unify language describing physical device-level core and
extension functionality in the <<fundamentals-validusage-extensions,
Valid Usage for Extensions>>, <<fundamentals-validusage-versions, Valid
Usage for Newer Core Versions>>, <<initialization-functionpointers
Command Function Pointers>>, <<initialization-phys-dev-extensions,
Extending Physical Device From Device Extensions>>
<<extended-functionality-instance-extensions-and-devices, Instance
Extensions and Device Extensions>> sections and for
flink:vkGetPhysicalDeviceImageFormatProperties2. This documents that
instance-level functionality is tied to the loader, and independent of
the ICD; physical device-level functionality is tied to the ICD, and
associated with device extensions; physical devices are treated more
uniformly between core and extensions; and instance and physical
versions can be different (internal issue 1048).
* Updated the <<commandbuffers-lifecycle, Command Buffer Lifecycle>>
section to clarify the ability for pending command buffers to transition
to the invalid state after submission, and add a command buffer
lifecycle diagram (internal issue 1050).
* Clarify that some flink:VkDescriptorUpdateTemplateCreateInfo parameters
are ignored when push descriptors are not supported (internal issue
1054).
* Specify that flink:vkCreateImage will return an error if the image is
too large, in a NOTE in the slink:VkImageFormatProperties description
(internal issue 1078).
* Remove near-duplicate NOTEs about when to query function pointers
dynamically in the <<initialization, Initialization>> chapter and
replace by extending the NOTE in the <<fundamentals-abi, Application
Binary Interface>> section (internal issue 1085).
* Restore missing references to "`Sparse Resource Features`" in the
flink:VkBufferCreateFlagBits description (internal issue 1086).
* Tidy up definitions of descriptor types in the `GL_KHR_vulkan_glsl`
specification, the <<descriptorsets, Resource Descriptors>> section and
its subsections, and the <<interfaces-resources-descset, Descriptor Set
Interface>> for consistency, reduction of duplicate information, and
removal of GLSL correspondance/examples (internal issue 1090).
* Correctly describe code:PrimitiveId as an Input for tessellation control
and evaluation shaders, not an Output (internal issue 1109).
* Relax the requirements on chroma offsets for nearest filtering in
<<textures-implict-reconstruction, Implicit Reconstruction>> (internal
issue 1116).
Other Issues:
* Clarify the intended relationship between specification language and
certain terms defined in the Khronos Intellectual Property Rights
policy. Specific changes include:
** Rewrote IP/Copyright preamble and introduction to better agree with
normative language both as laid out in the introduction, and the
Khronos IPR policy.
** Added notion of fully informative sections, which are now tagged with
"`(Informative)`" in their titles.
** Removed non-normative uses of the phrase "`not required`"
** Clarified the distinction between terms "`optional`" and "`not
required:`" as they relate to the IPR Policy, and updated specification
text to use terms consistent with the intent.
** Reduced additions to RFC 2119, and ensured the specification agreed
with the leaner language.
** Removed the terms "`hardware`", "`software`", "`CPU`", and "`GPU`" from
normative text.
** Moved several paragraphs that should not have been normative to
informative notes.
** Clarified a number of definitions in the Glossary.
** Updated the document writing guide to match new terminology changes.
* Explicitly state in the <<fundamentals-objectmodel-lifetime-acquire,
application memory lifetime>> language that that for objects other than
descriptor sets, a slink:VkDescriptorSetLayout object used in the
creation of another object (such as slink:VkPipelineLayout or
slink:VkDescriptorUpdateTemplateKHR) is only in use during the creation
of that object and can be safely destroyed afterwards.
* Updated the <<textures-scale-factor, Scale Factor Operation>> section to
use the ratio of anisotropy, rather than the integer sample rate, to
perform the LOD calculation. The spec still allows use of the sample
rate as the value used to calculate the LOD, but no longer requires it.
* Update `vulkan_ext.c` to include all platform-related definitions from
the Vulkan platform headers, following the split of the headers into
platform-specific and non-platform-specific files.
* Fix bogus anchor name in the <<commandbuffers, Command Buffers>> chapter
which accidentally duplicated an anchor in the pipelines chapter. There
were no reference to this anchor, fortunately.
* Add valid usage statement for slink:VkWriteDescriptorSet and
slink:VkCopyDescriptorSet requiring that the slink:VkDescriptorSetLayout
used to allocate the source and destination sets must not have been
destroyed at the time flink:vkUpdateDescriptorSets is called.
* Document mapping of subgroup barrier functions to SPIR-V, and clarify a
place where subgroupBarrier sounds like it's execution-only in the
standalone `GL_KHR_shader_subgroup` specification.
* Use an HTML stylesheet derived from the Asciidoctor `colony` theme, with
the default Arial font family replaced by the sans-serif Noto font
family.
* Numerous minor updates to README.adoc, build scripts, Makefiles, and
registry and style guide specifications to support Vulkan 1.1 outputs,
use them as defaults, and remove mention of `KHX` extensions, which are
no longer supported.
New Extensions:
* `VK_EXT_vertex_attrib_divisor`
243 lines
7.9 KiB
Plaintext
243 lines
7.9 KiB
Plaintext
// Copyright (c) 2015-2018 Khronos Group. This work is licensed under a
|
|
// Creative Commons Attribution 4.0 International License; see
|
|
// http://creativecommons.org/licenses/by/4.0/
|
|
|
|
[appendix]
|
|
[[credits]]
|
|
= Credits (Informative)
|
|
|
|
Vulkan 1.1 is the result of contributions from many people and companies
|
|
participating in the Khronos Vulkan Working Group, as well as input from the
|
|
Vulkan Advisory Panel.
|
|
|
|
Members of the Working Group, including the company that they represented at
|
|
the time of their most recent contribution, are listed in the following
|
|
sections.
|
|
Some specific contributions made by individuals are listed together with
|
|
their name.
|
|
|
|
== Working Group Contributors to Vulkan 1.1 and 1.0
|
|
|
|
* Adam Jackson, Red Hat
|
|
* Alexander Galazin, Arm
|
|
* Alex Bourd, Qualcomm Technologies, Inc.
|
|
* Alon Or-bach, Samsung Electronics (WSI technical sub-group chair)
|
|
* Andrew Garrard, Samsung Electronics (format wrangler)
|
|
* Andrew Woloszyn, Google
|
|
* Antoine Labour, Google
|
|
* Bill Licea-Kane, Qualcomm Technologies, Inc.
|
|
* Cass Everitt, Oculus VR
|
|
* Chad Versace, Google
|
|
* Christophe Riccio, Unity Technologies
|
|
* Dan Baker, Oxide Games
|
|
* Dan Ginsburg, Valve Software
|
|
* Daniel Johnston, Intel
|
|
* Daniel Koch, NVIDIA (<<interfaces,Shader Interfaces>>; <<features,Features, Limits, and Formats>>)
|
|
* Daniel Rakos, AMD
|
|
* David Airlie, Red Hat
|
|
* David Miller, Miller & Mattson (Vulkan reference card)
|
|
* David Neto, Google
|
|
* Dominik Witczak, AMD
|
|
* Graeme Leese, Broadcom
|
|
* Graham Sellers, AMD
|
|
* Ian Romanick, Intel
|
|
* James Jones, NVIDIA
|
|
* Jan-Harald Fredriksen, Arm
|
|
* Jan Hermes, Continental Corporation
|
|
* Jason Ekstrand, Intel
|
|
* Jeff Bolz, NVIDIA (extensive contributions, exhaustive review and rewrites for technical correctness)
|
|
* Jeff Juliano, NVIDIA
|
|
* Jesse Barker, Unity Technologies
|
|
* Jesse Hall, Google
|
|
* Johannes van Waveren, Oculus VR
|
|
* John Kessenich, Google (SPIR-V and GLSL for Vulkan spec author)
|
|
* John McDonald, Valve Software
|
|
* Jonas Gustavsson, Samsung Electronics
|
|
* Jon Ashburn, LunarG
|
|
* Jon Leech, Independent (XML toolchain, normative language, release wrangler)
|
|
* Jungwoo Kim, Samsung Electronics
|
|
* Kathleen Mattson, Miller & Mattson (Vulkan reference card)
|
|
* Kenneth Benzie, Codeplay Software Ltd.
|
|
* Kerch Holt, NVIDIA (SPIR-V technical sub-group chair)
|
|
* Kristian Kristensen, Intel
|
|
* Mark Lobodzinski, LunarG
|
|
* Mathias Heyer, NVIDIA
|
|
* Mathias Schott, NVIDIA
|
|
* Maurice Ribble, Qualcomm Technologies, Inc.
|
|
* Michael Worcester, Imagination Technologies
|
|
* Mika Isojarvi, Google
|
|
* Mitch Singer, AMD
|
|
* Neil Henning, Codeplay Software Ltd.
|
|
* Neil Trevett, NVIDIA
|
|
* Norbert Nopper, Independent
|
|
* Pierre Boudier, NVIDIA
|
|
* Pierre-Loup Griffais, Valve Software
|
|
* Piers Daniell, NVIDIA (dynamic state, copy commands, memory types)
|
|
* Pyry Haulos, Google (Vulkan conformance test subcommittee chair)
|
|
* Ray Smith, Arm
|
|
* Robert Simpson, Qualcomm Technologies, Inc.
|
|
* Rolando Caloca Olivares, Epic Games
|
|
* Sean Harmer, KDAB Group
|
|
* Shannon Woods, Google
|
|
* Slawomir Cygan, Intel
|
|
* Slawomir Grajewski, Intel
|
|
* Stuart Smith, Imagination Technologies
|
|
* Timothy Lottes, AMD
|
|
* Tobias Hector, Imagination Technologies (validity language and toolchain)
|
|
* Tom Olson, Arm (working group chair)
|
|
* Tony Barbour, LunarG
|
|
* Yanjun Zhang, VeriSilicon
|
|
|
|
== Working Group Contributors to Vulkan 1.1
|
|
|
|
* Aaron Greig, Codeplay Software Ltd.
|
|
* Aaron Hagan, AMD
|
|
* Alan Ward, Google
|
|
* Alejandro Piñeiro, Igalia
|
|
* Andres Gomez, Igalia
|
|
* Baldur Karlsson, Independent
|
|
* Barthold Lichtenbelt, NVIDIA
|
|
* Bas Nieuwenhuizen, Google
|
|
* Bill Hollings, Brenwill
|
|
* Colin Riley, AMD
|
|
* Cort Stratton, Google
|
|
* Courtney Goeltzenleuchter, Google
|
|
* Dae Kim, Imagination Technologies
|
|
* Daniel Stone, Collabora
|
|
* David Pinedo, LunarG
|
|
* Dejan Mircevski, Google
|
|
* Dzmitry Malyshau, Mozilla
|
|
* Erika Johnson, LunarG
|
|
* Greg Fischer, LunarG
|
|
* Hans-Kristian Arntzen, Arm
|
|
* Iago Toral, Igalia
|
|
* Ian Elliott, Google
|
|
* Jeff Leger, Qualcomm Technologies, Inc.
|
|
* Jeff Vigil, Samsung Electronics
|
|
* Jens Owen, Google
|
|
* Joe Davis, Samsung Electronics
|
|
* John Zulauf, LunarG
|
|
* Jordan Justen, Intel
|
|
* Jörg Wagner, Arm
|
|
* Kalle Raita, Google
|
|
* Karen Ghavam, LunarG
|
|
* Karl Schultz, LunarG
|
|
* Kenneth Russell, Google
|
|
* Kevin O'Neil, AMD
|
|
* Lauri Ilola, Nokia
|
|
* Lenny Komow, LunarG
|
|
* Lionel Landwerlin, Intel
|
|
* Maciej Jesionowski, AMD
|
|
* Mais Alnasser, AMD
|
|
* Marcin Rogucki, Mobica
|
|
* Mark Callow, Independent
|
|
* Mark Kilgard, NVIDIA
|
|
* Markus Tavenrath, NVIDIA
|
|
* Mark Young, LunarG
|
|
* Matthäus Chajdas, AMD
|
|
* Matt Netsch, Qualcomm Technologies, Inc.
|
|
* Michael O'Hara, AMD
|
|
* Michael Wong, Codeplay Software Ltd.
|
|
* Mike Schuchardt, LunarG
|
|
* Mike Weiblen, LunarG
|
|
* Nicolai Hähnle, AMD
|
|
* Nuno Subtil, NVIDIA
|
|
* Patrick Cozzi, Independent
|
|
* Petros Bantolas, Imagination Technologies
|
|
* Ralph Potter, Codeplay Software Ltd.
|
|
* Rob Barris, NVIDIA
|
|
* Ruihao Zhang, Qualcomm Technologies, Inc.
|
|
* Sorel Bosan, AMD
|
|
* Stephen Huang, Mediatek
|
|
* Tilmann Scheller, Samsung Electronics
|
|
* Tomasz Bednarz, Independent
|
|
* Victor Eruhimov, ???
|
|
* Wolfgang Engel, ???
|
|
|
|
== Working Group Contributors to Vulkan 1.0
|
|
|
|
* Adam Śmigielski, Mobica
|
|
* Allen Hux, Intel
|
|
* Andrew Cox, Samsung Electronics
|
|
* Andrew Poole, Samsung Electronics
|
|
* Andrew Rafter, Samsung Electronics
|
|
* Andrew Richards, Codeplay Software Ltd.
|
|
* Aras Pranckevičius, Unity Technologies
|
|
* Ashwin Kolhe, NVIDIA
|
|
* Ben Bowman, Imagination Technologies
|
|
* Benj Lipchak
|
|
* Bill Hollings, The Brenwill Workshop
|
|
* Brent E. Insko, Intel
|
|
* Brian Ellis, Qualcomm Technologies, Inc.
|
|
* Cemil Azizoglu, Canonical
|
|
* Chang-Hyo Yu, Samsung Electronics
|
|
* Chia-I Wu, LunarG
|
|
* Chris Frascati, Qualcomm Technologies, Inc.
|
|
* Cody Northrop, LunarG
|
|
* Courtney Goeltzenleuchter, LunarG
|
|
* Damien Leone, NVIDIA
|
|
* David Mao, AMD
|
|
* David Yu, Pixar
|
|
* Frank (LingJun) Chen, Qualcomm Technologies, Inc.
|
|
* Fred Liao, Mediatek
|
|
* Gabe Dagani, Freescale
|
|
* Graham Connor, Imagination Technologies
|
|
* Hwanyong Lee, Kyungpook National University
|
|
* Ian Elliott, LunarG
|
|
* James Hughes, Oculus VR
|
|
* Jeff Vigil, Qualcomm Technologies, Inc.
|
|
* Jens Owen, LunarG
|
|
* Jeremy Hayes, LunarG
|
|
* Jonathan Hamilton, Imagination Technologies
|
|
* Krzysztof Iwanicki, Samsung Electronics
|
|
* Larry Seiler, Intel
|
|
* Lutz Latta, Lucasfilm
|
|
* Maria Rovatsou, Codeplay Software Ltd.
|
|
* Mark Callow
|
|
* Mateusz Przybylski, Intel
|
|
* Maxim Lukyanov, Samsung Electronics
|
|
* Michael Lentine, Google
|
|
* Michal Pietrasiuk, Intel
|
|
* Mike Stroyan, LunarG
|
|
* Minyoung Son, Samsung Electronics
|
|
* Mythri Venugopal, Samsung Electronics
|
|
* Naveen Leekha, Google
|
|
* Nick Penwarden, Epic Games
|
|
* Niklas Smedberg, Unity Technologies
|
|
* Pat Brown, NVIDIA
|
|
* Patrick Doane, Blizzard Entertainment
|
|
* Peter Lohrmann, Valve Software
|
|
* Piotr Bialecki, Intel
|
|
* Prabindh Sundareson, Samsung Electronics
|
|
* Rob Stepinski, Transgaming
|
|
* Roy Ju, Mediatek
|
|
* Rufus Hamede, Imagination Technologies
|
|
* Sean Ellis, Arm
|
|
* Stefanus Du Toit, Google
|
|
* Steve Hill, Broadcom
|
|
* Steve Viggers, Core Avionics & Industrial Inc.
|
|
* Tim Foley, Intel
|
|
* Timo Suoranta, AMD
|
|
* Tobin Ehlis, LunarG
|
|
* Tomasz Kubale, Intel
|
|
* Wayne Lister, Imagination Technologies
|
|
|
|
== Other Credits
|
|
|
|
In addition to the Working Group, the Vulkan Advisory Panel members provided
|
|
important real-world usage information and advice that helped guide design
|
|
decisions.
|
|
|
|
Administrative support to the Working Group for Vulkan 1.1 was provided by
|
|
Khronos staff including Angela Cheng, Ann Thorsnes, Emily Stearns, Liz
|
|
Maitral, and Dominic Agoro-Ombaka; and by Alex Crabb of Caster
|
|
Communications.
|
|
|
|
Administrative support for Vulkan 1.0 was provided by Andrew Riegel,
|
|
Elizabeth Riegel, Glenn Fredericks, Kathleen Mattson and Michelle Clark of
|
|
Gold Standard Group.
|
|
|
|
Technical support was provided by James Riordon, webmaster of Khronos.org
|
|
and OpenGL.org.
|
|
|