mirrors/wlroots
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/wlroots/wlroots.git synced 2026-02-15 22:05:31 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions

xdg-cutouts-v1: New protocol implementation

Browse source 
See https://gitlab.freedesktop.org/wayland/wayland-protocols/-/merge_requests/372

The compositor implemention can connect to the `new_cutouts` signal which
is invoked whenever a client binds the protocol. It then listens for the
`send_cutouts` signal on the received `cutouts` object and when received
sends the cutout information via any number of
`wlr_xdg_cutouts_v1_send_{cutout,corner}` calls followed by a
`wlr_xdg_cutouts_v1_send_cutouts_done` call. The ids used in these calls
are up to the compositor implementation.

The `unhandled_update` signal is invoked when the client reports any
sent ids as unhandled.

Signed-off-by: Guido Günther <agx@sigxcpu.org>
This commit is contained in:
Guido Günther 2025-01-01 22:13:54 +01:00
parent a962d58727
commit dc597cec78
5 changed files with 693 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

82
include/wlr/types/wlr_xdg_cutouts_v1.h Normal file
View file

@ -0,0 +1,82 @@
#ifndef WLR_TYPES_WLR_XDG_CUTOUTS_V1
#define WLR_TYPES_WLR_XDG_CUTOUTS_V1
#include <wayland-server-core.h>
#include <wlr/types/wlr_compositor.h>
#include <wlr/types/wlr_xdg_shell.h>
#include <wlr/util/edges.h>
enum wlr_cutouts_type {
WLR_CUTOUTS_TYPE_CUTOUT = 0,
WLR_CUTOUTS_TYPE_NOTCH = 1 << 0,
WLR_CUTOUTS_TYPE_WATERFALL = 1 << 1,
};
struct wlr_xdg_cutouts_manager_v1 {
struct wl_global *global;
struct wl_list cutouts; // wlr_xdg_cutouts_v1.link
struct {
struct wl_signal new_cutouts; // struct wlr_xdg_cutouts
struct wl_signal destroy;
} events;
void *data;
struct {
uint32_t next_id;
struct wl_listener display_destroy;
} WLR_PRIVATE;
};
struct wlr_xdg_cutouts_v1_configure {
struct wl_list link; // wlr_xdg_cutouts.configure_list
struct wlr_surface_configure *surface_configure;
// Ids valid in this configure sequence
struct wl_array valid_ids;
};
struct wlr_xdg_cutouts_v1_state {
struct wl_array unhandled;
};
/**
* Cutouts interface.
*
* Emits `send_coutouts` when cutout information should be sent for the associated toplevel.
* Emits `unhandled_updated` when the list of unhandled ids got updated.
*/
struct wlr_xdg_cutouts_v1 {
struct wl_resource *resource;
struct wlr_xdg_toplevel *toplevel;
struct wlr_xdg_cutouts_manager_v1 *manager;
struct wl_list link; // wlr_xdg_cutouts_manager_v1.link
struct wlr_xdg_cutouts_v1_state current, pending;
struct {
struct wl_signal destroy;
struct wl_signal send_cutouts;
struct wl_signal unhandled_updated;
} events;
void *data;
struct {
// ids sent in the current configure sequence
struct wl_list configure_list; // wlr_xdg_cutouts_v1_configure.link
struct wl_array sent_ids; // uint32_t
struct wl_listener toplevel_destroy;
struct wl_listener surface_configure;
struct wl_listener surface_ack_configure;
} WLR_PRIVATE;
};
struct wlr_xdg_cutouts_manager_v1 *wlr_xdg_cutouts_manager_v1_create(struct wl_display *display);
void wlr_xdg_cutouts_v1_send_cutout(struct wlr_xdg_cutouts_v1 *cutouts, const struct wlr_box *box,
enum wlr_cutouts_type type, uint32_t id);
void wlr_xdg_cutouts_v1_send_corner(struct wlr_xdg_cutouts_v1 *cutouts, enum wlr_edges position,
uint32_t radius, uint32_t id);
void wlr_xdg_cutouts_v1_send_cutouts_done(struct wlr_xdg_cutouts_v1 *cutouts);
#endif