1// Copyright 2016-2024 The Khronos Group Inc. 2// 3// SPDX-License-Identifier: CC-BY-4.0 4 5include::{generated}/meta/{refprefix}VK_EXT_hdr_metadata.adoc[] 6 7=== Other Extension Metadata 8 9*Last Modified Date*:: 10 2018-12-19 11*IP Status*:: 12 No known IP claims. 13*Contributors*:: 14 - Courtney Goeltzenleuchter, Google 15 16=== Description 17 18This extension defines two new structures and a function to assign SMPTE 19(the Society of Motion Picture and Television Engineers) 2086 metadata and 20CTA (Consumer Technology Association) 861.3 metadata to a swapchain. 21The metadata includes the color primaries, white point, and luminance range 22of the reference monitor, which all together define the color volume 23containing all the possible colors the reference monitor can produce. 24The reference monitor is the display where creative work is done and 25creative intent is established. 26To preserve such creative intent as much as possible and achieve consistent 27color reproduction on different viewing displays, it is useful for the 28display pipeline to know the color volume of the original reference monitor 29where content was created or tuned. 30This avoids performing unnecessary mapping of colors that are not 31displayable on the original reference monitor. 32The metadata also includes the pname:maxContentLightLevel and 33pname:maxFrameAverageLightLevel as defined by CTA 861.3. 34 35While the intended purpose of the metadata is to assist in the 36transformation between different color volumes of different displays and 37help achieve better color reproduction, it is not in the scope of this 38extension to define how exactly the metadata should be used in such a 39process. 40It is up to the implementation to determine how to make use of the metadata. 41 42include::{generated}/interfaces/VK_EXT_hdr_metadata.adoc[] 43 44=== Issues 45 461) Do we need a query function? 47 48*PROPOSED*: No, Vulkan does not provide queries for state that the 49application can track on its own. 50 512) Should we specify default if not specified by the application? 52 53*PROPOSED*: No, that leaves the default up to the display. 54 55=== Version History 56 57 * Revision 1, 2016-12-27 (Courtney Goeltzenleuchter) 58 ** Initial version 59 * Revision 2, 2018-12-19 (Courtney Goeltzenleuchter) 60 ** Correct implicit validity for VkHdrMetadataEXT structure 61