aboutsummaryrefslogtreecommitdiff
AgeCommit message (Collapse)Author
2021-03-26build: Fix wayland-protocols.pc when using autotoolsJonas Ådahl
"datadir" is not the same thing in meson and autotools. In autoconf "datadir" is "${datarootdir}", which expands to "${prefix}/share". @datarootdir@ expands to "${prefix}/share". There seems to be no variable that expands to "share". In meson "datadir" is "share". So, avoid the "datadir" variable, just expand "datarootdir" it manually instead. This unbreaks the recently broken autotools setup. Signed-off-by: Jonas Ådahl <jadahl@gmail.com> Reviewed-by: Simon Ser <contact@emersion.fr>
2021-03-26ci: Add test-meson stepJonas Ådahl
Apart from the autotools build system, also test the meson build system. Signed-off-by: Jonas Ådahl <jadahl@gmail.com>
2021-03-26ci: Switch to upstream ci-templates and use Debian bullseyeJonas Ådahl
This switches to the ci-templates that is found on https://gitlab.freedesktop.org/freedesktop/ci-templates/ While at it, switch to Debian bullseye, as this contains more reasonably versioned build tools, i.e. a new enough version of meson. Signed-off-by: Jonas Ådahl <jadahl@gmail.com>
2021-03-26tests: Add compile testsJonas Ådahl
Only tested by the meson build system. Signed-off-by: Jonas Ådahl <jadahl@gmail.com> Reviewed-by: Simon Ser <contact@emersion.fr>
2021-03-26Add meson build system supportJonas Ådahl
Signed-off-by: Jonas Ådahl <jadahl@gmail.com> Reviewed-by: Simon Ser <contact@emersion.fr>
2021-02-16linux-dmabuf: no buffer errors on device disappearancePekka Paalanen
This was prompted by the discussion from https://lists.freedesktop.org/archives/dri-devel/2020-May/266611.html which is not the final wording. When a DRM device is hot-unplugged, particularly if it is the Wayland compositor's compositing GPU, EGL may start returning errors from trying to use the client's dmabuf. Or, if the client is rendering on another GPU which gets hot-unplugged, the dmabuf the compositor already has may start failing. Hot-unplug is an abrupt global action, and there is no way a client or a compositor could ensure they clean up before things start failing. It is not the client's fault, so the client should not get disconnected if already existing wl_buffer objects start failing. This patch add the wording to the protocol to this effect. The intention is that the compositor replaces the failed buffers with some placeholder content. There is no way this could be glitch-free. In its own pace the client should discover the DRM device is gone, clean up, and perhaps use something else. How exactly that should happen depends on the rendering API the client is using. This is a tiny step towards making DRM device hot-unplug not crash applications that wish to handle the unplug gracefully. Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.com>
2021-01-05text-input: Add enum attributes to various argumentsonox
Signed-off-by: onox <denkpadje@gmail.com>
2021-01-05fullscreen-shell: Add enum attributes to various argumentsonox
Signed-off-by: onox <denkpadje@gmail.com>
2021-01-05linux-dmabuf: Add enum attribute to 'flags'onox
Signed-off-by: onox <denkpadje@gmail.com>
2021-01-03pointer-constraints: Add enum attribute to 'lifetime'onox
Signed-off-by: onox <denkpadje@gmail.com>
2021-01-03presentation-time: Add enum attribute to 'flags'onox
Signed-off-by: onox <denkpadje@gmail.com>
2020-11-03text-input: document behavior regarding multiple text-inputsBhushan Shah
Currently protocol does not specify what should happen if multiple text-inputs are created by same client, which is why this is more or less undefined behavior currently in compositor implementations. If client has created more than one text-input objects and surface owned by the client is focused, then compositor must send enter event to all text-input objects, in case of enable request however only one text-input must be enabled per client per seat. Signed-off-by: Bhushan Shah <bshah@kde.org>
2020-10-15Update point-of-contact for KDERoman Gilg
2020-10-14README.md: Add some merge request triaging conventionsJonas Ådahl
Add documented Gitlab procedures to help protocol reviewers and maintainers to get a better picture of the state of merge requests. To make this more reliable, document procedures how to triage and manage merge requests using labels. Signed-off-by: Jonas Ådahl <jadahl@gmail.com>
2020-06-19Use correct indefinite article before "xdg"Vlad Zahorodnii
Since the abbreviation "XDG" starts with a vowel sound, the correct article is "an." Signed-off-by: Vlad Zahorodnii <vlad.zahorodnii@kde.org>
2020-04-07xdg-shell: explain how clients need to perform an initial commitSimon Ser
This wasn't explicit reading the mapping requirements. Signed-off-by: Simon Ser <contact@emersion.fr>
2020-04-07xdg-shell: describe how to re-map an unmapped toplevelSimon Ser
Signed-off-by: Simon Ser <contact@emersion.fr>
2020-02-29configure.ac: Bump version to 1.20Jonas Ådahl
Signed-off-by: Jonas Ådahl <jadahl@gmail.com>
2020-02-29Makefile.am: Also distribute README.md, GOVERNANCE.md and MEMBERS.mdJonas Ådahl
README was distributed by default due to implicit autotools rules, so when we renamed to README.md, it stopped being included. While at it, also add the two other new files. Signed-off-by: Jonas Ådahl <jadahl@gmail.com>
2020-02-29configure.ac: Bump version to 1.19Jonas Ådahl
Signed-off-by: Jonas Ådahl <jadahl@gmail.com>
2020-02-29xdg-shell: Add support for explicit popup repositioningJonas Ådahl
This commit adds protocol additions making it possible to request that a popup should be repositioned according to a new xdg_positioner object. Explicit popup moving is done using a new request on xdg_popup: xdg_popup.reposition. What it does is change the parameters used for positioning a popup by providing a new xdg_positioner object. This request is coupled with a new event; xdg_popup.repositioned, sent together with the configure events (xdg_popup.configure and xdg_surface.configure) to notify about the completion of the reposition request. The reposition request also takes a token that is later passed via the repositioned event; this is done so that a client may determine for which reposition request the compositor has sent configure events. Synchronization between surfaces to avoid state application race condition are deliberately left out, and should be handled by an external protocol. To brief the compositor of the future dimension of the parent that the compositor should position the popup against, a xdg_positioner.set_parent_size request is added. Lastly, a request to couple a xdg_positioner object with a parent configure event is added (xdg_positioner.set_parent_configure) in order for a compositor to pair a popup reposition request with a pending configure event, and it's resulting window geometry. This is necessary to, for example, properly constrain a popup given a future parent state. An example of when this may be necessary is an interactive resize where both the toplevel position and the relative popup position changes. Signed-off-by: Jonas Ådahl <jadahl@gmail.com> Reviewed-by: Mike Blumenkrantz <michael.blumenkrantz@gmail.com> Reviewed-by: Simon Ser <contact@emersion.fr>
2020-02-29xdg-shell: Add support for implicit popup repositioningJonas Ådahl
This commit adds protocol additions making it possible to implicitly reposition an already mapped popup if the conditions for the constraint changed (e.g. toplevel moved). Implicit popup moving is done by setting a adjustment flag on the positioner used to create it that will cause the compositor to adjust the position as the conditions used to constrain it change. These changes may include, for example, changes in the position of the parent window or the geometry of the work area. To allow the client to update its content in response to the updated position, the client must ack the configure event, optionally with new content. Until the client acks this configure event, the existing positioner will continue to be used. Implicit repositioning by itself is racy regarding inter-surface synchronization of applied state. Inter-surface synchronization is deliberately left out of xdg-shell, and left to be handled externally. Signed-off-by: Jonas Ådahl <jadahl@gmail.com> Reviewed-by: Mike Blumenkrantz <michael.blumenkrantz@gmail.com> Reviewed-by: Simon Ser <contact@emersion.fr>
2020-02-29xdg-shell: Remove left-over paragraph from pre positioner versionsJonas Ådahl
It mentioned the now removed x, y parameters of xdg_surface.get_popup. The xdg_positioner now has the relevant documentation that was previously documented by the now removed paragraph. Signed-off-by: Jonas Ådahl <jadahl@gmail.com> Reviewed-by: Simon Ser <contact@emersion.fr>
2020-02-25Update point-of-contact for QtJohan Klokkhammer Helsing
Eskil is the team lead for the Qt Oslo Graphics team.
2020-01-22xdg-shell: add missing enum attribute to resizeIvan Molodetskikh
This helps binding generators such as the one in wayland-rs. Signed-off-by: Ivan Molodetskikh <yalterz@gmail.com>
2019-12-18Convert plaintext documents to MarkdownSimon Ser
This converts GOVERNANCE, MEMBERS and README to Markdown documents. These are only cosmetic changes, the actual contents and wording have been retained. GitLab pretty-prints Markdown and adds anchors. We can now add links from one document to another. Unfortunately GOVERNANCE lettered lists have been converted to numbered lists, because Markdown doesn't support the former. Signed-off-by: Simon Ser <contact@emersion.fr> Closes: https://gitlab.freedesktop.org/wayland/wayland-protocols/issues/3
2019-11-21Add .gitlab-ci.ymlSimon Ser
The script runs automated protocol validation checks. The image is generated using fd.o CI templates [1]. [1]: https://gitlab.freedesktop.org/wayland/ci-templates Signed-off-by: Simon Ser <contact@emersion.fr> Closes: https://gitlab.freedesktop.org/wayland/wayland-protocols/issues/5
2019-11-21readme: changes should be submitted via GitLabSimon Ser
510188250ea8 ("Add governance document") adds a GOVERNANCE document describing development based on GitLab merge requests. Update the README file accordingly. Some information is duplicated across README and GOVERNANCE, this is intentional to make README provide a more human-friendly, less bureaucratic version. GOVERNANCE is still the authoritative version. Signed-off-by: Simon Ser <contact@emersion.fr>
2019-11-20Add .editorconfigSimon Ser
This allows editors to pick up the correct indent style for *.xml files. Signed-off-by: Simon Ser <contact@emersion.fr>
2019-11-20Add governance documentSimon Ser
The idea of a better-defined governance model for wayland-protocols has been discussed for quite a while [1]. A new GOVERNANCE document describes how changes to the wayland-protocols repository are accepted. A set of members representing projects can vote on merge requests sent via GitLab. The initial list of members is available in the MEMBERS file. [1]: https://lists.freedesktop.org/archives/wayland-devel/2019-February/040076.html Signed-off-by: Drew DeVault <sir@cmpwn.com> Signed-off-by: Simon Ser <contact@emersion.fr> Acked-by: Daniel Stone <daniels@collabora.com> Acked-by: Pekka Paalanen <pekka.paalanen@collabora.com> Acked-by: Johan Helsing <johan.helsing@qt.io> Acked-by: Roman Gilg <subdiff@gmail.com> Acked-by: Christopher James Halse Rogers <raof@ubuntu.com> Acked-by: Alan Griffiths <alan.griffiths@canonical.com> Acked-by: Jonas Ådahl <jadahl@gmail.com> Cc: Mike Blumenkrantz <michael.blumenkrantz@gmail.com> Cc: Carlos Garnacho <carlosg@gnome.org> Cc: David Edmundson <david@davidedmundson.co.uk>
2019-09-06presentation-time: add missing bitfield markerIvan Molodetskikh
Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.com> Reviewed-by: Simon Ser <contact@emersion.fr> Acked-by: Daniel Stone <daniels@collabora.com> Acked-by: Victor Berger <victor.berger@m4x.org>
2019-07-25configure.ac: Bump version to 1.18Jonas Ådahl
Signed-off-by: Jonas Ådahl <jadahl@gmail.com>
2019-07-25xdg-output: make xdg_output.description mutableSimon Ser
The output description is a human-readable text describing the output. Unlike the name which uniquely identifies the output, it's intended to be displayed to the user. It might be desirable for a compositor to update an output's description. For instance, when only one output is plugged in, it's not necessary to dump make, model, serial and connector to the description, something like "Dell U2717D" is enough. However when two identical outputs are plugged in it's necessary to add e.g. the connector type to tell them apart ("Dell U2717D on HDMI"). See [1] for a discussion about this. This commit bumps xdg_output's version to allow compositors to update the property. [1]: https://github.com/swaywm/wlroots/issues/1623 Signed-off-by: Simon Ser <contact@emersion.fr> Reviewed-by: Jonas Ådahl <jadahl@gmail.com> Acked-by: Olivier Fourdan <ofourdan@redhat.com>
2019-07-17xdg-shell: use case to change the app ID at runtimeJan-Marek Glogowski
LibreOffice is one big binary with explicit brandings for different application modules. This is represented in X11 by a different WM_CLASS setting for a window. The WM_CLASS is changed based on the loaded document at runtime. As a result LibreOffice already offers multiple desktop files with different icons, StartupWMClass entries and application names. This amendment of the set_app_id request just explicitly specifies the use case to change a surfaces' app ID at runtime, so a compositor implementor is made aware of it. Just as the WM_CLASS, a change of the app ID should result in an update of the propertes of a surface depending on the app ID, like the window icon specified in the desktop file or a re-grouping of the surfaces in a task manager. Signed-off-by: Jan-Marek Glogowski <glogow@fbihome.de> Reviewed-by: Jonas Ådahl <jadahl@gmail.com> Reviewed-by: Simon Ser <contact@emersion.fr>
2019-07-17pointer-gestures: add a release requestSimon Ser
This allows clients to destroy a gesture object before they disconnect. The request isn't named "destroy", as this would conflict with wayland-scanner's auto-generated destructor (which just destroys the client-side object without sending any request). Signed-off-by: Simon Ser <contact@emersion.fr> Reviewed-by: Jonas Ådahl <jadahl@gmail.com>
2019-07-17xdg-output: deprecate the xdg_output.done eventSimon Ser
This commit makes it so a wl_output.done event is guaranteed to be sent with a xdg_output.done event. This protocol change has been discussed in a recent xorg-devel discussions [1]. First let's recap why a change is needed: Xwayland listens to both wl_output and xdg_output changes. When an output's properties change, Xwayland expects to receive both a wl_output.done event and an xdg_output.done event. If that's not the case, Xwayland doesn't update its state (so old state is still exposed to X11 clients). Most of the time, both objects will be updated at the same time (e.g. the current mode is changed, so both wl_output.mode and xdg_output.logical_size are sent) so this won't be an issue. However in some situations only one of wl_output or xdg_output changes. For instance: - The mode is changed at the same time as the scale, resulting in the same logical_size. - The compositor doesn't expose the outputs' position via wl_output, so whenever the position changes only xdg_output is updated. Both KDE [2] and wlroots [3] have experienced this issue. For this reason, I'd like to update the xdg-output protocol to make it mandatory to always send a wl_output.done event after xdg_output changes. This effectively makes wl_output.done atomically apply all output state (including the state of add-on objects like xdg_output). This approach is pretty similar to wl_surface.commit: this request will atomically apply surface state including the state of e.g. the xdg_surface object tied to the wl_surface. To update the protocol to reflect this new requirement we can either: - **Bump xdg_output version**. The current protocol doesn't specify that wl_output.done must be sent, adding this new requirement would be a breaking change. We need to fix Xwayland for the current xdg_output version (maybe make it non-atomic for the current version, atomic for the new one?). Should we deprecate xdg_output.done in the new version? - **Don't bump xdg_output version**. This clarifies what is expected in practice by Xwayland, a major xdg_output consumer, and what is currently implemented by all compositors. There's one issue with the "don't bump" approach: indeed in practice compositors always send wl_output.done and xdg_output.done in pairs, however the ordering between those two events is not guaranteed. This means some compositors might send this sequence: wl_output.geometry(…) wl_output.done() xdg_output.logical_position(…) xdg_output.done() In this case the wl_output.done event fails to atomically apply the xdg_output state. For this reason, I think bumping the version is a better approach. This commit also deprecates xdg_output.done, which doesn't have any purpose anymore. [1]: https://lists.x.org/archives/xorg-devel/2019-April/058148.html [2]: https://phabricator.kde.org/D19253 [3]: https://github.com/swaywm/sway/issues/4064 Signed-off-by: Simon Ser <contact@emersion.fr> Reviewed-by: Olivier Fourdan <ofourdan@redhat.com> Reviewed-by: Jonas Ådahl <jadahl@gmail.com>
2019-05-22xdg-shell/README: Update E-mail addressJonas Ådahl
As requested by Mike, update the E-mail address listed in the README. Signed-off-by: Jonas Ådahl <jadahl@gmail.com>
2019-05-02linux-dmabuf: clarify DRM_FORMAT_MOD_INVALIDChia-I Wu
DRM_FORMAT_MOD_INVALID means to derive the modifier from the dmabuf. It provides legacy support and makes it easier to replace wl_drm. v3: DRM_FORMAT_MOD_INVALID must be advertised to be supported (which requires a version bump) v4: no version bump, but a note for now Signed-off-by: Chia-I Wu <olvaffe@gmail.com> Reviewed-by: Pekka Paalanen <pekka.paalanen@collabora.com> Reviewed-by: Simon Ser <contact@emersion.fr> Reviewed-by: Daniel Stone <daniels@collabora.com>
2019-01-17xdg-shell: fix a typoSebastian Krzyszkowiak
Signed-off-by: Sebastian Krzyszkowiak <dos@dosowisko.net> Reviewed-by: Pekka Paalanen <pekka.paalanen@collabora.com>
2018-12-14linux-explicit-synchronization: Clarify implicit synchronization guarantees ↵Alexandros Frantzis
of release events Clarify that after zwp_buffer_release_v1 events, otherwise unused buffers can be reused without any additional implicit synchronization. This is in contrast to wl_buffer.release, which doesn't guarantee that implicit synchronization is not required to safely use a buffer after the event is received. Signed-off-by: Alexandros Frantzis <alexandros.frantzis@collabora.com> Reviewed-by: Pekka Paalanen <pekka.paalanen@collabora.com>
2018-12-14linux-explicit-synchronization: Warn about using the protocol while using ↵Alexandros Frantzis
graphics APIs Graphics APIs are expected to use this protocol under the hood, and since there can only be one user of explicit synchronization per surface, warn about using the protocol directly in such cases. Signed-off-by: Alexandros Frantzis <alexandros.frantzis@collabora.com> Reviewed-by: Pekka Paalanen <pekka.paalanen@collabora.com>
2018-12-14linux-explicit-synchronization: Allow fences with opaque EGL buffersAlexandros Frantzis
Add opaque EGL buffers to the supported buffer types for use with the explicit synchronization protocol. Opaque EGL buffers rely on the same EGL implementation in both the compositor and clients, which makes it straightforward to manage client expectations about fence support for such buffers. Also make it clearer that implementations are free to support other buffer types beyond the required ones. Signed-off-by: Alexandros Frantzis <alexandros.frantzis@collabora.com> Reviewed-by: Pekka Paalanen <pekka.paalanen@collabora.com>
2018-11-12configure.ac: Bump version to 1.17Jonas Ådahl
Signed-off-by: Jonas Ådahl <jadahl@gmail.com>
2018-11-12unstable: add primary-selection protocolemersion
This primary selection is similar in spirit to the eponimous in X11, allowing a quick "select text + middle click" shortcut to copying and pasting. It's otherwise very similar to its Wayland counterpart, and explicitly made consistent with it. Signed-off-by: Simon Ser <contact@emersion.fr> Reviewed-by: Jonas Ådahl <jadahl@gmail.com> Reviewed-by: Carlos Garnacho <carlosg@gnome.org>
2018-11-12Add zwp_linux_explicit_synchronization_v1Alexandros Frantzis
This protocol enables explicit synchronization of asynchronous graphics operations on buffers on a per-commit basis. Support is currently limited to dmabuf buffers and dma_fence fence FDs. Explicit synchronization provides a more versatile notification mechanism for buffer readiness and availability, and can be used to improve efficiency by integrating with related functionality in display and graphics APIs. This protocol is also useful in ChromeOS ARC++ (running Android apps inside ChromeOS, using Wayland as the communication protocol), where it can enable integration of the ChromeOS compositor with the explicit synchronization mechanisms of the Android display subsystem. Finally, the per-commit nature of the release events provided by this protocol potentially offers a solution to a deficiency of the wl_buffer.release event (see https://gitlab.freedesktop.org/wayland/wayland/issues/46). Signed-off-by: Alexandros Frantzis <alexandros.frantzis@collabora.com> Reviewed-by: Simon Ser <contact@emersion.fr> Reviewed-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk> Reviewed-by: Daniel Stone <daniels@collabora.com> [Pekka: dropped Reveman from maintainers] Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.com>
2018-07-31fullscreen-shell: Add missing license tagJohan Klokkhammer Helsing
Although it would probably default to the license at the root of the repository anyway, it's best to be explicit about it, and also be consistent with the other extensions. The copyright holders have been assembled from git history and the README. Signed-off-by: Johan Klokkhammer Helsing <johan.helsing@qt.io> Acked-by: Jason Ekstrand <jason@jlekstrand.net>
2018-07-30configure.ac: Bump version to 1.16Jonas Ådahl
Signed-off-by: Jonas Ådahl <jadahl@gmail.com>
2018-07-30xdg-shell: Make sure wording reflects expectationsMarkus Ongyerth
The wording in xdg-shell's `set_*` requests implies the compositor *will* honour the client's request. This would give clients the control over their actual state, while the general expectation is that clients kindly ask for state changes which the compositor may follow. This patch ensures the actual protocol text reflects these expectations. Reviewed-by: Simon Ser <contact@emersion.fr> Reviewed-by: Jonas Ådahl <jadahl@gmail.com>
2018-07-30xdg-shell: move maximized state definition togetherMarkus Ongyerth
The xdg-shell documentation had part of the maximized state render implications in the `set_maximized` request documentation, not the actual state. This moves the relevant lines into the state description. Signed-off-by: Markus Ongyerth <wl@ongy.net> Reviewed-by: Mike Blumenkrantz <zmike@osg.samsung.com> Reviewed-by: Simon Ser <contact@emersion.fr> Reviewed-by: Jonas Ådahl <jadahl@gmail.com>
2018-07-30text-input: Add v3 of the text-input protocolCarlos Garnacho
This new protocol description is an evolution of v2. - All pre-edit text styling is gone. - Pre-edit cursor can span characters. - No events regarding input panel (OSK) state nor covered rectangle. Compositors are still free to handle situations where the keyboard focus rectangle is covered by the input panel. - No set_preferred_language request for clients. - There is no event to send keysyms. Compositors can use wl_keyboard interface instead. - All state is double-buffered, with specified defaults. - The compositor can be notified about external changes to the state. - The client can detect outdated requests. Signed-off-by: Dorota Czaplejewicz <dorota.czaplejewicz@puri.sm> Signed-off-by: Carlos Garnacho <carlosg@gnome.org> Reviewed-by: Jonas Ådahl <jadahl@gmail.com> Reviewed-by: Simon Ser <contact@emersion.fr>