Class EXTHdrMetadata

  • public class EXTHdrMetadata
    extends java.lang.Object
    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 Association) 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.

    Name String
    Extension Type
    Device extension
    Registered Extension Number
    Extension and Version Dependencies
    Last Modified Date
    IP Status
    No known IP claims.
    • Courtney Goeltzenleuchter, Google
    • Field Detail


        public static final int VK_EXT_HDR_METADATA_SPEC_VERSION
        The extension specification version.
        See Also:
        Constant Field Values

        public static final java.lang.String VK_EXT_HDR_METADATA_EXTENSION_NAME
        The extension name.
        See Also:
        Constant Field Values

        public static final int VK_STRUCTURE_TYPE_HDR_METADATA_EXT
        Extends VkStructureType.
        See Also:
        Constant Field Values
    • Method Detail

      • nvkSetHdrMetadataEXT

        public static void nvkSetHdrMetadataEXT​(VkDevice device,
                                                int swapchainCount,
                                                long pSwapchains,
                                                long pMetadata)
        Unsafe version of: SetHdrMetadataEXT
        swapchainCount - the number of swapchains included in pSwapchains.
      • vkSetHdrMetadataEXT

        public static void vkSetHdrMetadataEXT​(VkDevice device,
                                               java.nio.LongBuffer pSwapchains,
                                               VkHdrMetadataEXT.Buffer pMetadata)
        function to set Hdr metadata.
        C Specification
         void vkSetHdrMetadataEXT(
             VkDevice                                    device,
             uint32_t                                    swapchainCount,
             const VkSwapchainKHR*                       pSwapchains,
             const VkHdrMetadataEXT*                     pMetadata);
        Valid Usage (Implicit)
        • device must be a valid VkDevice handle
        • pSwapchains must be a valid pointer to an array of swapchainCount valid VkSwapchainKHR handles
        • pMetadata must be a valid pointer to an array of swapchainCount valid VkHdrMetadataEXT structures
        • swapchainCount must be greater than 0
        • Both of device, and the elements of pSwapchains must have been created, allocated, or retrieved from the same VkInstance
        See Also


        device - the logical device where the swapchain(s) were created.
        pSwapchains - a pointer to the array of swapchainCount VkSwapchainKHR handles.
        pMetadata - a pointer to the array of swapchainCount VkHdrMetadataEXT structures.