<?xml version="1.0" encoding="UTF-8"?> | |
<protocol name="hdr10_metadata_unstable_v1"> | |
<copyright> | |
Copyright 2018 NXP | |
Permission is hereby granted, free of charge, to any person obtaining a | |
copy of this software and associated documentation files (the "Software"), | |
to deal in the Software without restriction, including without limitation | |
the rights to use, copy, modify, merge, publish, distribute, sublicense, | |
and/or sell copies of the Software, and to permit persons to whom the | |
Software is furnished to do so, subject to the following conditions: | |
The above copyright notice and this permission notice (including the next | |
paragraph) shall be included in all copies or substantial portions of the | |
Software. | |
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | |
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | |
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL | |
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | |
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING | |
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER | |
DEALINGS IN THE SOFTWARE. | |
</copyright> | |
<description summary="Protocol for sending hdr10 metadata to compositor"> | |
This protocol specifies a set of interfaces used to set and control | |
hdr10 metadata of video contents. | |
Warning! The protocol described in this file is experimental and backward | |
incompatible changes may be made. Backward compatible changes may be added | |
together with the corresponding interface version bump. Backward | |
incompatible changes are done by bumping the version number in the protocol | |
and interface names and resetting the interface version. Once the protocol | |
is to be declared stable, the 'z' prefix and the version number in the | |
protocol and interface names are removed and the interface version number is | |
reset. | |
</description> | |
<interface name="zwp_hdr10_metadata_v1" version="1"> | |
<description summary="hdr10_metadata"> | |
The global interface exposing hdr10 metadata capabilities is | |
used to instantiate an interface extension for compositor. | |
This extended interface will then allow the client to pass hdr10 metadata | |
to compositor and send to display driver if supported. | |
</description> | |
<request name="destroy" type="destructor"> | |
<description summary="unbind from the hdr10 metadata interface"> | |
Informs the server that the client will not be using this | |
protocol object anymore. This does not affect any other objects. | |
</description> | |
</request> | |
<enum name="error"> | |
<entry name="sending_meta_error" value="0" | |
summary="error occurs when compositor handle metadata"/> | |
</enum> | |
<request name="set_metadata"> | |
<description summary="interface of setting and controling hdr10 metadata"> | |
client can use this interface pass hdr10 metadata to server. Server need | |
use the recived metadata to enable hdr mode. | |
</description> | |
<arg name="eotf" type="uint" summary="supported eotf"/> | |
<arg name="type" type="uint" summary="supported type"/> | |
<arg name="display_primaries_red" type="uint" | |
summary="display primaries of red, high 16bits for x, and low 16bits for y"/> | |
<arg name="display_primaries_green" type="uint" | |
summary="display primaries of green, high 16bits for x, and low 16bits for y"/> | |
<arg name="display_primaries_blue" type="uint" | |
summary="display primaries of blue, high 16bits for x, and low 16bits for y"/> | |
<arg name="white_point" type="uint" | |
summary="white point, high 16bits for x, and low 16bits for blue"/> | |
<arg name="mastering_display_luminance" type="uint" | |
summary="max and min mastering display luminance, high 16 bits for max, and low 16 bits for min"/> | |
<arg name="max_cll" type="uint" summary="max content light level"/> | |
<arg name="max_fall" type="uint" summary="max frame average light level"/> | |
</request> | |
</interface> | |
</protocol> |