fdo-mirrors/wayland-protocols
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/wayland/wayland-protocols.git synced 2026-05-05 12:18:15 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

color: reword set_image_description

Browse source 
Drop the old notes about performance benefits, they are already
explained with preferred_changed. Also don't emphasize getting image
descriptions from outputs, that should not be a usual option. Only
display profiling software should use output-specific image
descriptions.

Maybe a good idea to mention that clients must understand the image
description and not just get_preferred, blindly slap it on the
wl_surface, and render without any adjustments.

Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.com>
This commit is contained in:
Pekka Paalanen 2023-03-06 15:22:48 +02:00 • committed by Sebastian Wick
parent 35dce6bb98
commit c1a988a2d8
1 changed files with 6 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

13
staging/color-management/color-management-v1.xml
View file

@ -229,6 +229,12 @@
description and rendering intent are double-buffered state, see
wl_surface.commit.
Image description objects can be created through the various global
factory interfaces, from outputs, or by compositor suggestion via the
get_preferred request. It is the client's responsibility to understand
the image description object it sets on a surface, and to provide
content that matches that image description.
A rendering intent provides the client's preference on how content
colors should be mapped to each output. The render_intent value must
be one advertised by the compositor with
@ -238,13 +244,6 @@
By default, a surface does not have an associated image description
nor a rendering intent. The handling of color on such surfaces is
compositor implementation defined.
If the image description of the surface matches the image description of an output
it is shown on the performance and color accuracy might improve. To find
those image descriptions the client can listen to the preferred_image_description or
the wl_surface.enter/leave events. This improvement may require using
the image description object created by
wp_color_management_output_v1.get_image_description.
</description>
<arg name="image_description" type="object" interface="wp_image_description_v1"/>