zwp_color_space_v1 was replaced with zwp_image_description_v1, but we
need this one paragraph too.
Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.com>
vscode really does not handle tab width being different from indent
width. Simpler is better, let's not mix tabs and spaces especially when
indent is not 8 wide.
Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.com>
Adds the API definitions for the Coding-independent code point spec.
Based on the discussions here:
https://gitlab.freedesktop.org/swick/wayland-protocols/-/merge_requests/18#note_1271085
This patch is adding an image state creator to define the transfer
function, primaries, and matrix coefficients for a Wayland surface,
either via coding-independent code points defined in ITU-T H.273, via
custom gamma or primaries definitions, or via an ICC profile.
Describes the API definitions for the following
zwp_image_description_creator_icc_v1/zwp_image_description_creator_params_v1
*Image state creator
request create_image_description_params()
*iCreate a image state object based on params.
request create_image_description_icc()
*Create a image state object based on icc profile.
request set_tf_cicp(uint cicp_transfer_characteristics)
*Set the OETF/EOTF^-1
request set_tf_gamma(uint gamma)
*Sets the Gamma curve
request set_primaries_cicp(uint cicp_color_primaries)
*Sets the CICP color primaries
request set_primaries(uint r_x, uint r_y, uint g_x, uint g_y, uint b_x, uint b_y, uint w_x, uint w_y)
*Sets the color primaries
request set_icc(fd icc_profile)
*Set the ICC profile
v2:
- Add errors enum for creation errors
- Clean up some descriptions
v3:
- split icc/param into 2 interfaces
- fix protocol/graceful failures errors
- remove ycbcr matrix an corresponding requests
- add create_image_description_* requests
v4:
- Remove create_color_space_* requests
- Remove zwp_color_space_creator_v1 and zwp_color_space_v1
- rename color_space related requests/interfaces to image state
- move set_extended_dynamic_range into image state
v5:
- Moved Extended dynamic range from color_managment to image_description
- Fixed some typos and updated descriptions
- Added CICP enums for transfer characteristics and color primaries
v6:
- Reworked CICP enums for transfer characteristics and color primaries
v7:
- Renamed "image state" to "image description"
- Removed unnessasry ENUMS
- Updated descptions/summaries
v8:
- Re add zwp_color_space_v1
Signed-off-by: Bhawanpreet Lakha <Bhawanpreet.Lakha@amd.com>
This patch:
* Addresses feedback & suggestions from Pekka, Swick
* This adds well-known EOTF, chromaticity and whitepoint names in
the protocol
* updates color.rst doc with list of tables & short description for
most of the well-known names
Signed-off-by: Naveen Kumar <naveen1.kumar@intel.com>
* creating a color space now leads through the color_space_creator
object which allows us to fail at ceating the color space
* there are now three ways to create a color space. From an ICC profile,
from well-known names and parametrically.
* multiple color_management_outputs can now be created for a single
wl_output
* color_space_changed is not send when the object is created anymore
* clearify that destroying a color space has no effect on the color
space state associated with surfaces and outputs
* preferred color space is send only after it is determined or changed
* preferred color space is send to all matching wl_outputs
Signed-off-by: Sebastian Wick <sebastian@sebastianwick.net>
This adds a very high level overview of how color management is supposed
to work on Wayland, compared to how it worked on X11. The aim is to get
people discussing this protocol extension to the same page about the
general approach which is fundamentally different from X11.
Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.com>
This protocol specifies a way for a client to set the color space and
HDR metadata of a surface and to get information about the color spaces
and HDR capabilities of outputs.
For more information, see color.rst.
Signed-off-by: Sebastian Wick <sebastian@sebastianwick.net>
[Pekka: added color.rst]
Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.com>
This protocol extension is ubiquitous. It's time to mark it as
stable.
The interface names are left unchanged, so that compositors and
clients don't need to be updated. In particular, the legacy "z"
prefix is still part of the interface name.
Signed-off-by: Simon Ser <contact@emersion.fr>
Stable protocols used to not have a version. But with the new
rules, they have one. Accomodate the build script for the new
rules.
Signed-off-by: Simon Ser <contact@emersion.fr>
EFL/Enlightenment hasn't been active in a while, doesn't seem to
have interest in the near future, and Mike is fine with ceasing
their membership. They can always be added back when interest
sparks again.
Signed-off-by: Simon Ser <contact@emersion.fr>
Closes: https://gitlab.freedesktop.org/wayland/wayland-protocols/-/issues/146
Specifically that after calling create_listener the only valid operation
on the sockets is to close them. They also must stay open and valid
until a round-trip after the call.
Signed-off-by: Sebastian Wick <sebastian.wick@redhat.com>
Clarify how and when initial wl_surface state provided by the core
protocol or by extensions to the wl_surface, like as
wp_fractional_scale_v1, is being delivered.
The motivation for such change is to make it clear that the first frame
for xdg-shell will be perfect, which implies that scaling and similar
properties affecting presentation would be delivered in time.
Signed-off-by: Kirill Chibisov <contact@kchibisov.com>
This is a variation of the unveil protocol I suggested in the Weston
issue about security contexts. This lets sandbox engines such as Flatpak
attach a security context to sandboxed clients. The compositor can then
restrict which features are made available to that client.
The protocol is designed around the assumption that the sandbox engine
uses this protocol when setting up the sandboxed application. After this
inital setup, the sandbox engine isn't necessarily running anymore.
For this reason, a special "close FD" is used to indicate when to stop
the security context listener: the sandbox engine can leak the FD into
the sandboxed app's process, and the OS will automatically close the FD
when the sandboxed app exits.
Signed-off-by: Simon Ser <contact@emersion.fr>
References: https://gitlab.freedesktop.org/wayland/weston/-/issues/206
Add a toplevel state to indicate that surface repaints have been
suspended. This may arise due to occlusion, output power state, etc.
In this state, clients can choose to take meaningful action such as
suspending any processing which would drive a repaint loop, or
communicating to the active browser tab that the tab is not
system-visible, or any other action that would be taken by a client not
expecting to repaint until further notice.
cf. discussion in wayland/wayland-protocols!99
Signed-off-by: Daniel Stone <daniels@collabora.com>
This should fix the following problem when I targeted a MR to
branch 'color' in Sebastian's fork of wayland-protocols:
$ ci-fairy check-commits --signed-off-by --junit-xml=results.xml
Traceback (most recent call last):
File "/usr/bin/ci-fairy", line 33, in <module>
sys.exit(load_entry_point('ci-fairy==0.1', 'console_scripts', 'ci-fairy')())
File "/usr/lib/python3.9/site-packages/click/core.py", line 1137, in __call__
return self.main(*args, **kwargs)
File "/usr/lib/python3.9/site-packages/click/core.py", line 1062, in main
rv = self.invoke(ctx)
File "/usr/lib/python3.9/site-packages/click/core.py", line 1668, in invoke
return _process_result(sub_ctx.command.invoke(sub_ctx))
File "/usr/lib/python3.9/site-packages/click/core.py", line 1404, in invoke
return ctx.invoke(self.callback, **ctx.params)
File "/usr/lib/python3.9/site-packages/click/core.py", line 763, in invoke
return __callback(*args, **kwargs)
File "/usr/lib/python3.9/site-packages/click/decorators.py", line 26, in new_func
return f(get_current_context(), *args, **kwargs)
File "/usr/lib/python3.9/site-packages/ci_fairy.py", line 1335, in check_commits
for commit in repo.iter_commits(commit_range):
File "/usr/lib/python3.9/site-packages/git/objects/commit.py", line 318, in _iter_from_process_or_stream
finalize_process(proc_or_stream)
File "/usr/lib/python3.9/site-packages/git/util.py", line 370, in finalize_process
proc.wait(**kwargs)
File "/usr/lib/python3.9/site-packages/git/cmd.py", line 447, in wait
raise GitCommandError(remove_password_if_present(self.args), status, errstr)
git.exc.GitCommandError: Cmd('git') failed due to: exit code(128)
cmdline: git rev-list cifairy/color..HEAD --
stderr: 'fatal: bad revision 'cifairy/color..HEAD'
'
Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.com>
This interface has no "enter" event. This was likely copy-pasted
from wl_pointer.set_cursor.
The event which indicates focus is proximity_in.
Signed-off-by: Simon Ser <contact@emersion.fr>
We merged a commit by mistake which doesn't have S-o-b. ci-fairy is
unhappy about it and will fail the check. Skip it if we aren't
running in a merge request context.
Signed-off-by: Simon Ser <contact@emersion.fr>
The xdg_surface window geometry can extend outside the base wl_surface
to e.g. accompany subsurfaces that extend outside it but is part of the
window itself. Spell out this bit explicitly.
Signed-off-by: Jonas Ådahl <jadahl@gmail.com>
The spec says that
When applied, the effective window geometry will be the set
window geometry clamped to the bounding rectangle of the combined
geometry of the surface of the xdg_surface and the associated
subsurfaces.
Thus, a client cannot assume the geometry will adapt to any subsequent
changes to any conditions that constrained the geometry.
Signed-off-by: Jonas Ådahl <jadahl@gmail.com>
Make it explicit in the protocol that [un]set_maximized and
the following configure event can't be reliably matched, and the
clients shouldn't try to do it.
Closes#106
Signed-off-by: Mikhail Gusarov <dottedmag@dottedmag.net>
This will let command-line Git tools re-map my name and e-mail address properly.
I'm using my personal e-mail address and not my Collabora address because I'm
not actively contributing to Wayland anymore and this is mostly for letting
people find me should they dig me up in the project history.
Signed-off-by: Faith Ekstrand <faith@gfxstrand.net>
The "logical size" as stated by the first paragraph corresponds to the
monitor size in the global compositor space.
To most clients, this is unnecessary information, and should be ignored,
but some used the listed examples to derive information that contradicts
the very definition of what this event communicates.
One example tried to add surface size assumptions, which was not
correct. Remove this part completely, clients should not try to
configure their surface sizes from the logical size of a monitor.
The other is the list of size examples; it tried to communicate that a
compositor sometimes may not scale the viewport of the monitor in its
global compositor coordinate space, in which case, the logical size
itself matches the actual resolution. Tweak this wording to make that
clear that it does not related to any surface size.
Signed-off-by: Jonas Ådahl <jadahl@gmail.com>
In the past, xdg-output had only the logical_position and
logical_size events, then the name and description events were
added. Later on, they were moved inside wl_output since they aren't
desktop-specific. However the goals section of the protocol overview
hasn't been updated accordingly.
Make it clear that this protocol's name and description events should
not be preferred over wl_output.
Signed-off-by: Simon Ser <contact@emersion.fr>
