mirror of
https://github.com/status-im/Vulkan-Docs.git
synced 2025-01-12 06:54:14 +00:00
dbfd1b68c4
* Bump API patch number and header version number to 54 for this update. Github Issues: Internal Issues: * Fix tessellation domain to have an upper-left origin in the <<img-tessellation-topology-ul, tessellation toplogy image>> and related language. CTS and all implementations were already doing this, it was just a documentation bug that it was flipped to lower-left (internal issue 603). * Add a section to the style guide describing how VUID tags are changed and removed when the corresponding Valid Usage statements are modified (internal issue 829). * Add explicit Valid Usage statement to slink:VkPipelineDynamicStateCreateInfo to require that members of pname:pDynamicStates must be unique (internal issue 851). New Extensions: * `VK_KHR_16bit_storage` * `VK_KHR_dedicated_allocation` * `VK_KHR_external_fence` * `VK_KHR_external_fence_capabilities` * `VK_KHR_external_fence_fd` * `VK_KHR_external_fence_win32` * `VK_KHR_get_memory_requirements2` * `VK_KHR_storage_buffer_storage_class` * `VK_KHR_variable_pointers` Extensions Promoted From KHX To KHR Status: * `VK_KHR_external_memory` * `VK_KHR_external_memory_capabilities` * `VK_KHR_external_memory_fd` * `VK_KHR_external_memory_win32` * `VK_KHR_external_semaphore` * `VK_KHR_external_semaphore_capabilities` * `VK_KHR_external_semaphore_fd` * `VK_KHR_external_semaphore_win32` * `VK_KHR_win32_keyed_mutex`
76 lines
2.4 KiB
Plaintext
76 lines
2.4 KiB
Plaintext
[[VK_EXT_hdr_metadata]]
|
|
== VK_EXT_hdr_metadata
|
|
|
|
*Name String*::
|
|
+VK_EXT_hdr_metadata+
|
|
*Extension Type*::
|
|
Device
|
|
*Registered Extension Number*::
|
|
106
|
|
*Last Modified Date*::
|
|
2017-03-04
|
|
*Revision*::
|
|
1
|
|
*IP Status*::
|
|
No known IP claims.
|
|
*Dependencies*::
|
|
- This extension is written against version 1.0 of the Vulkan API.
|
|
- This extension requires +VK_KHR_surface+.
|
|
*Contributors*::
|
|
- Courtney Goeltzenleuchter, Google
|
|
*Contacts*::
|
|
- Courtney Goeltzenleuchter, Google
|
|
|
|
This extension defines two new structures and a function to assign SMPTE
|
|
(the Society of Motion Picture and Television Engineers) 2086 metadata and
|
|
CTA (Consumer Technology Assocation) 861.3 metadata to a swapchain.
|
|
The metadata includes the color primaries, white point, and luminance range
|
|
of the mastering display, which all together define the color volume that
|
|
contains all the possible colors the mastering display can produce.
|
|
The mastering display is the display where creative work is done and
|
|
creative intent is established.
|
|
To preserve such creative intent as much as possible and achieve consistent
|
|
color reproduction on different viewing displays, it is useful for the
|
|
display pipeline to know the color volume of the original mastering display
|
|
where content was created or tuned.
|
|
This avoids performing unnecessary mapping of colors that are not
|
|
displayable on the original mastering display.
|
|
The metadata also includes the maxContentLightLevel and
|
|
maxFrameAverageLightLevel as defined by CTA 861.3.
|
|
|
|
While the general purpose of the metadata is to assist in the transformation
|
|
between different color volumes of different displays and help achieve
|
|
better color reproduction, it is not in the scope of this extension to
|
|
define how exactly the metadata should be used in such a process.
|
|
It is up to the implementation to determine how to make use of the metadata.
|
|
|
|
=== New Enum Constants
|
|
|
|
* Extending elink:VkStructureType:
|
|
** ename:VK_STRUCTURE_TYPE_HDR_METADATA_EXT
|
|
|
|
=== New Structures
|
|
|
|
* slink:VkXYColorEXT
|
|
* slink:VkHdrMetadataEXT
|
|
|
|
=== New Functions
|
|
|
|
* flink:vkSetHdrMetadataEXT
|
|
|
|
=== Issues
|
|
|
|
1) Do we need a query function?
|
|
|
|
*PROPOSED*: No, Vulkan does not provide queries for state that the
|
|
application can track on its own.
|
|
|
|
2) Should we specify default if not specified by the application?
|
|
|
|
*PROPOSED*: No, that leaves the default up to the display.
|
|
|
|
=== Version History
|
|
|
|
* Revision 1, 2016-12-27 (Courtney Goeltzenleuchter)
|
|
- Initial version
|