2019-04-16 05:19:43 -07:00
|
|
|
// Copyright (c) 2017-2019 Khronos Group. This work is licensed under a
|
|
|
|
|
// Creative Commons Attribution 4.0 International License; see
|
|
|
|
|
// http://creativecommons.org/licenses/by/4.0/
|
|
|
|
|
|
2019-10-06 12:42:12 -07:00
|
|
|
include::{generated}/meta/VK_EXT_headless_surface.txt[]
|
2019-04-16 05:19:43 -07:00
|
|
|
|
|
|
|
|
*Last Modified Date*::
|
|
|
|
|
2019-03-21
|
|
|
|
|
*IP Status*::
|
|
|
|
|
No known IP claims.
|
|
|
|
|
*Contributors*::
|
|
|
|
|
- Ray Smith, Arm
|
|
|
|
|
|
Change log for August 17, 2019 Vulkan 1.1.120 spec update:
* Update release number to 120.
Github Issues:
* Add slink:VkAccelerationStructureTypeNV explicitly to extension XML for
`<<VK_NV_ray_tracing>>` (public issue 848).
* Add missing valid usage statements for feature flags in
slink:VkCommandBufferInheritanceInfo (public pull request 1017).
Internal Issues:
* Clarify behavior of non-premultiplied destination colors for
`<<VK_EXT_blend_operation_advanced>>` prior to the definition of
slink:VkBlendOverlapEXT (internal issue 1766).
* Fix the confusing phrasing "`no other queue must: be (doing something)`"
for flink:vkQueuePresentKHR, flink:vkQueueSubmit, and
flink:vkQueueBindSparse (internal issue 1774).
* Add `<<VK_EXT_validation_features>>` flag to enable best practices
checks, which will soon be available in the validation layer (internal
issue 1779).
* Specify allowed characters for VUID tag name components in the style
guide (internal issue 1788).
* Update links to SPIR-V extension specifications, and parameterize their
markup in case the URLs change in the future (internal issue 1797).
* Fix an off-by-one error in the valid usage statement for
slink:VkPipelineExecutableInfoKHR (internal merge request 3303).
* Clean up markup indentation not matching the style guide (internal merge
request 3314).
* Minor script updates to allow refpage aliases, generate a dynamic TOC
for refpages, generate Apache rewrite rules for aliases, open external
links from refpages in a new window, and synchronize with the OpenCL
scripts. This will shortly enable a paned navigation setup for refpages,
similar to the OpenCL 2.2 refpages (internal merge request 3322).
* Script updates to add tests to the checker, refactor and reformat code,
generate better text for some valid usage statements, use more Pythonic
idioms, and synchronize with the OpenXR scripts (internal merge request
3239).
* Script updates and minor fixes in spec language to not raise checker
errors for refpage markup of pages not existing in the API, such as
VKAPI_NO_STDINT_H. Remove corresponding suppression of some
check_spec_links.py tests from .gitlab-ci.yml and 'allchecks' target
(internal merge request 3315).
2019-08-17 15:33:21 -07:00
|
|
|
The `VK_EXT_headless_surface` extension is an instance extension.
|
|
|
|
|
It provides a mechanism to create slink:VkSurfaceKHR objects independently
|
|
|
|
|
of any window system or display device.
|
2019-04-16 05:19:43 -07:00
|
|
|
The presentation operation for a swapchain created from a headless surface
|
|
|
|
|
is by default a no-op, resulting in no externally-visible result.
|
|
|
|
|
|
|
|
|
|
Because there is no real presentation target, future extensions can layer on
|
|
|
|
|
top of the headless surface to introduce arbitrary or customisable sets of
|
|
|
|
|
restrictions or features.
|
|
|
|
|
These could include features like saving to a file or restrictions to
|
|
|
|
|
emulate a particular presentation target.
|
|
|
|
|
|
|
|
|
|
This functionality is expected to be useful for application and driver
|
|
|
|
|
development because it allows any platform to expose an arbitrary or
|
|
|
|
|
customisable set of restrictions and features of a presentation engine.
|
|
|
|
|
This makes it a useful portable test target for applications targeting a
|
|
|
|
|
wide range of presentation engines where the actual target presentation
|
|
|
|
|
engines might be scarce, unavailable or otherwise undesirable or
|
|
|
|
|
inconvenient to use for general Vulkan application development.
|
|
|
|
|
|
|
|
|
|
=== New Object Types
|
|
|
|
|
|
|
|
|
|
None
|
|
|
|
|
|
|
|
|
|
=== New Enum Constants
|
|
|
|
|
|
|
|
|
|
* Extending elink:VkStructureType:
|
|
|
|
|
** ename:VK_STRUCTURE_TYPE_HEADLESS_SURFACE_CREATE_INFO_EXT
|
|
|
|
|
|
|
|
|
|
=== New Enums
|
|
|
|
|
|
|
|
|
|
None
|
|
|
|
|
|
|
|
|
|
=== New Structures
|
|
|
|
|
|
|
|
|
|
* slink:VkHeadlessSurfaceCreateInfoEXT
|
|
|
|
|
|
|
|
|
|
=== New Functions
|
|
|
|
|
|
|
|
|
|
* flink:vkCreateHeadlessSurfaceEXT
|
|
|
|
|
|
|
|
|
|
=== Issues
|
|
|
|
|
|
|
|
|
|
None
|
|
|
|
|
|
|
|
|
|
=== Version History
|
|
|
|
|
|
Change log for August 25, 2019 Vulkan 1.1.121 spec update:
* Update release number to 121.
Github Issues:
* Add missing `structextends` attribute in `vk.xml` for
slink:VkPhysicalDevicePipelineExecutablePropertiesFeaturesKHR (public
issue 1018).
* Change attributes of flink:vkCmdCopyAccelerationStructureNV,
flink:vkCmdWriteAccelerationStructuresPropertiesNV,
flink:vkCmdBuildAccelerationStructureNV, and flink:vkCmdTraceRaysNV to
require that these commands execute outside renderpasses (public issue
1021).
* Add an issue to the `<<VK_EXT_buffer_device_address>>` appendix
discussing the introduction of new names and aliasing by equivalent old
names (public pull request 1024).
Internal Issues:
* Protect the `VK_KHR_sampler_mirror_clamp_to_edge` extension with
asciidoctor conditionals, and remove it from the core-only specification
builds, where it had previously been force-included in the Makefile. It
is now treated like any other extension (internal issue 1776).
* Edit some asciidoctor anchor names starting with `features-features-` to
just start with `features-`, since the old chapters was split into 3
pieces. There are still some mild naming inconsistencies with anchors
which may be addressed in the future (internal issue 1792).
* Add `KHR` alias for the non-suffixed extension token
ename:VK_SAMPLER_ADDRESS_MODE_MIRROR_CLAMP_TO_EDGE, for compatibility
with naming rules for extensions (internal issue 1796).
* Clarify requirements for external memory in NOTEs for
sname:VkExternalMemoryBufferCreateInfo, and valid usage statements for
flink:vkBindBufferMemory, slink:VkBindBufferMemoryInfo,
flink:vkBindImageMemory, and slink:VkBindImageMemoryInfo (internal merge
request 3301).
* Make extension version numbers in `vk.xml` and extension appendices
consistent. In a few cases, we could not recover history at this
granularity, and left the summary of a version's change undefined
(internal merge request 3323).
* Fix invocation of `CodeInlineMacro` in the Ruby extension backing the
`code:` macro, which was delegating to the wrong base class (internal
merge request 3331).
* Modify `reg.py` to do a better job of recognizing equivalent <enum>
definitions.
* Add a `sortorder` attribute to XML feature and extension tags.
New Extensions
* `<<VK_AMD_device_coherent_memory>>`
2019-08-25 03:57:09 -07:00
|
|
|
* Revision 1, 2019-03-21 (Ray Smith)
|
2019-04-16 05:19:43 -07:00
|
|
|
- Initial draft
|