[RFC wayland-protocols] Add the color-management protocol
Niels Ole Salscheider
niels_ole at salscheider-online.de
Sat Nov 19 16:29:20 UTC 2016
Signed-off-by: Niels Ole Salscheider <niels_ole at salscheider-online.de>
---
Makefile.am | 1 +
unstable/color-management/README | 4 +
.../color-management-unstable-v1.xml | 136 +++++++++++++++++++++
3 files changed, 141 insertions(+)
create mode 100644 unstable/color-management/README
create mode 100644 unstable/color-management/color-management-unstable-v1.xml
diff --git a/Makefile.am b/Makefile.am
index e693afa..ff435d5 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -12,6 +12,7 @@ unstable_protocols = \
unstable/tablet/tablet-unstable-v2.xml \
unstable/xdg-foreign/xdg-foreign-unstable-v1.xml \
unstable/idle-inhibit/idle-inhibit-unstable-v1.xml \
+ unstable/color-management/color-management-unstable-v1.xml \
$(NULL)
stable_protocols = \
diff --git a/unstable/color-management/README b/unstable/color-management/README
new file mode 100644
index 0000000..3bd3e6c
--- /dev/null
+++ b/unstable/color-management/README
@@ -0,0 +1,4 @@
+Color management protocol
+
+Maintainers:
+Niels Ole Salscheider <niels_ole at salscheider-online.de>
diff --git a/unstable/color-management/color-management-unstable-v1.xml b/unstable/color-management/color-management-unstable-v1.xml
new file mode 100644
index 0000000..f2bb3f6
--- /dev/null
+++ b/unstable/color-management/color-management-unstable-v1.xml
@@ -0,0 +1,136 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<protocol name="color_management_unstable_v1">
+
+ <copyright>
+ Copyright © 2014-2016 Niels Ole Salscheider
+
+ Permission to use, copy, modify, distribute, and sell this
+ software and its documentation for any purpose is hereby granted
+ without fee, provided that the above copyright notice appear in
+ all copies and that both that copyright notice and this permission
+ notice appear in supporting documentation, and that the name of
+ the copyright holders not be used in advertising or publicity
+ pertaining to distribution of the software without specific,
+ written prior permission. The copyright holders make no
+ representations about the suitability of this software for any
+ purpose. It is provided "as is" without express or implied
+ warranty.
+
+ THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS
+ SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+ FITNESS, IN NO EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY
+ SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+ WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN
+ AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
+ ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
+ THIS SOFTWARE.
+ </copyright>
+
+ <interface name="zwp_color_management_v1" version="1">
+ <description summary="allows attaching a color space to a wl_surface">
+ This interface allows attaching a color space to a wl_surface. The
+ compositor uses this information to display the colors correctly.
+ For this, the compositor converts any attached surfaces to the blending
+ color space before performing the blending operations. After blending,
+ the output surface is converted to the color space of the output device.
+ This interface also provides requests for the sRGB and the blending color
+ space. It further allows creation of a color space from an ICC profile.
+ The client is informed by an event if the color space of one of the
+ outputs changes.
+ </description>
+
+ <request name="set_colorspace">
+ <description summary="set the color space of a wl_surface">
+ With this request, the color space of a wl_surface can be set.
+ The sRGB colorspace is attached to a surface before set_colorspace is
+ called for the first time.
+ </description>
+ <arg name="surface" type="object" interface="wl_surface" />
+ <arg name="colorspace" type="object" interface="zwp_colorspace_v1" />
+ </request>
+
+ <request name="colorspace_from_fd">
+ <description summary="creates a color space from an ICC profile">
+ This request allows to create a zwp_colorspace_v1 object from an ICC
+ profile. The fd argument is the file descriptor to the ICC profile (ICC
+ V2 or V4).
+ </description>
+ <arg name="fd" type="fd" />
+ <arg name="id" type="new_id" interface="zwp_colorspace_v1" />
+ </request>
+
+ <request name="output_colorspace">
+ <description summary="returns the color space for the requested output">
+ This request returns a zwp_colorspace_v1 object for the requested
+ output. A client can use this when it does not want its surfaces to be
+ color-corrected. In this case it can attach the color space of its main
+ output to its surfaces.
+ </description>
+ <arg name="output" type="object" interface="wl_output" />
+ <arg name="id" type="new_id" interface="zwp_colorspace_v1" />
+ </request>
+
+ <request name="srgb_colorspace">
+ <description summary="tell the client what blending space is used">
+ This request returns a zwp_colorspace_1 object for the sRGB color
+ space. The sRGB color space is initially attached to all surfaces.
+ </description>
+ <arg name="id" type="new_id" interface="zwp_colorspace_v1" />
+ </request>
+
+ <request name="blending_colorspace">
+ <description summary="tell the client what blending space is used">
+ This request returns a zwp_colorspace_v1 object for the blending color
+ space of the compositor. All surfaces are converted by the compositor
+ to the blending color space before the blending operations. Once the
+ blending is performed, a further color conversion to the output color
+ spaces is carried out by the compositor.
+ A client should render in the blending color space returned by this
+ request if it does any color conversion on its own. This allows the
+ compositor to skip the color conversion to the blending color space.
+ </description>
+ <arg name="id" type="new_id" interface="zwp_colorspace_v1" />
+ </request>
+
+ <event name="output_colorspace_changed">
+ <description summary="tell the client what color space an output has">
+ This event will be sent when the color space of an output is changed.
+ </description>
+ <arg name="output" type="object" interface="wl_output" />
+ </event>
+
+ <enum name="error">
+ <entry name="invalid_profile" value="0"
+ summary="the passed icc data is invalid" />
+ </enum>
+ </interface>
+
+ <interface name="zwp_colorspace_v1" version="1">
+ <description summary="represents a color space">
+ This interface represents a color space that can be attached to surfaces.
+ It is used by the zwp_color_management_v1 interface.
+ </description>
+
+ <request name="destroy" type="destructor">
+ <description summary="destroys the zwp_colorspace_v1 object">
+ Informs the server that the client will not be using this protocol
+ object anymore.
+ </description>
+ </request>
+
+ <request name="get_profile_fd">
+ <description summary="get a file descriptor to the profile data">
+ This request will cause a profile_fd event that returns a file
+ descriptor to the ICC profile data of this colorspace.
+ </description>
+ </request>
+
+ <event name="profile_data">
+ <description summary="file descriptor to the profile data">
+ This event occurs after a get_profile_fd request and returns the file
+ descriptor to the ICC profile data of this colorspace.
+ </description>
+ <arg name="fd" type="fd" />
+ </event>
+ </interface>
+</protocol>
--
2.10.2
More information about the wayland-devel
mailing list