From e70a18f8c2de9f6d287bd852ac9f12edb0c91c1b Mon Sep 17 00:00:00 2001 From: KeremSoke Date: Thu, 12 Nov 2026 10:36:09 -0700 Subject: build: Add wlr-foreign-toplevel protocol for mate-screenshot --- mate-screenshot/Makefile.am | 3 +- ...wlr-foreign-toplevel-management-unstable-v1.xml | 266 +++++++++++++++++++++ mate-screenshot/src/Makefile.am | 12 + 3 files changed, 280 insertions(+), 1 deletion(-) create mode 100644 mate-screenshot/protocols/wlr-foreign-toplevel-management-unstable-v1.xml diff --git a/mate-screenshot/Makefile.am b/mate-screenshot/Makefile.am index 943eedad..0226a979 100644 --- a/mate-screenshot/Makefile.am +++ b/mate-screenshot/Makefile.am @@ -15,6 +15,7 @@ SUBDIRS = data src -EXTRA_DIST = protocols/wlr-screencopy-unstable-v1.xml +EXTRA_DIST = protocols/wlr-screencopy-unstable-v1.xml \ + protocols/wlr-foreign-toplevel-management-unstable-v1.xml -include $(top_srcdir)/git.mk diff --git a/mate-screenshot/protocols/wlr-foreign-toplevel-management-unstable-v1.xml b/mate-screenshot/protocols/wlr-foreign-toplevel-management-unstable-v1.xml new file mode 100644 index 00000000..4c6b17b1 --- /dev/null +++ b/mate-screenshot/protocols/wlr-foreign-toplevel-management-unstable-v1.xml @@ -0,0 +1,266 @@ + + + + Copyright © 2018 Ilia Bozhinov + + 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. + + + + + The purpose of this protocol is to enable the creation of taskbars + and docks by providing them with a list of opened applications and + letting them request certain actions on them, like maximizing, etc. + + After a client binds the zwlr_foreign_toplevel_manager_v1, each opened + toplevel window will be sent via the toplevel event + + + + + This event is emitted whenever a new toplevel window is created. It + is emitted for all toplevels, regardless of the app that has created + them. + + All initial details of the toplevel(title, app_id, states, etc.) will + be sent immediately after this event via the corresponding events in + zwlr_foreign_toplevel_handle_v1. + + + + + + + Indicates the client no longer wishes to receive events for new toplevels. + However the compositor may emit further toplevel_created events, until + the finished event is emitted. + + The client must not send any more requests after this one. + + + + + + This event indicates that the compositor is done sending events to the + zwlr_foreign_toplevel_manager_v1. The server will destroy the object + immediately after sending this request, so it will become invalid and + the client should free any resources associated with it. + + + + + + + A zwlr_foreign_toplevel_handle_v1 object represents an opened toplevel + window. Each app may have multiple opened toplevels. + + Each toplevel has a list of outputs it is visible on, conveyed to the + client with the output_enter and output_leave events. + + + + + This event is emitted whenever the title of the toplevel changes. + + + + + + + This event is emitted whenever the app-id of the toplevel changes. + + + + + + + This event is emitted whenever the toplevel becomes visible on + the given output. A toplevel may be visible on multiple outputs. + + + + + + + This event is emitted whenever the toplevel stops being visible on + the given output. It is guaranteed that an entered-output event + with the same output has been emitted before this event. + + + + + + + Requests that the toplevel be maximized. If the maximized state actually + changes, this will be indicated by the state event. + + + + + + Requests that the toplevel be unmaximized. If the maximized state actually + changes, this will be indicated by the state event. + + + + + + Requests that the toplevel be minimized. If the minimized state actually + changes, this will be indicated by the state event. + + + + + + Requests that the toplevel be unminimized. If the minimized state actually + changes, this will be indicated by the state event. + + + + + + Request that this toplevel be activated on the given seat. + There is no guarantee the toplevel will be actually activated. + + + + + + + The different states that a toplevel can have. These have the same meaning + as the states with the same names defined in xdg-toplevel + + + + + + + + + + + This event is emitted immediately after the zlw_foreign_toplevel_handle_v1 + is created and each time the toplevel state changes, either because of a + compositor action or because of a request in this protocol. + + + + + + + + This event is sent after all changes in the toplevel state have been + sent. + + This allows changes to the zwlr_foreign_toplevel_handle_v1 properties + to be seen as atomic, even if they happen via multiple events. + + + + + + Send a request to the toplevel to close itself. The compositor would + typically use a shell-specific method to carry out this request, for + example by sending the xdg_toplevel.close event. However, this gives + no guarantees the toplevel will actually be destroyed. If and when + this happens, the zwlr_foreign_toplevel_handle_v1.closed event will + be emitted. + + + + + + The rectangle of the surface specified in this request corresponds to + the place where the app using this protocol represents the given toplevel. + It can be used by the compositor as a hint for some operations, e.g + minimizing. The client is however not required to set this, in which + case the compositor is free to decide some default value. + + If the client specifies more than one rectangle, only the last one is + considered. + + The dimensions are given in surface-local coordinates. + Setting width=height=0 removes the already-set rectangle. + + + + + + + + + + + + + + + + This event means the toplevel has been destroyed. It is guaranteed there + won't be any more events for this zwlr_foreign_toplevel_handle_v1. The + toplevel itself becomes inert so any requests will be ignored except the + destroy request. + + + + + + Destroys the zwlr_foreign_toplevel_handle_v1 object. + + This request should be called either when the client does not want to + use the toplevel anymore or after the closed event to finalize the + destruction of the object. + + + + + + Requests that the toplevel be fullscreened on the given output. If the + fullscreen state and/or the outputs the toplevel is visible on actually + change, this will be indicated by the state and output_enter/leave + events. + + The output parameter is only a hint to the compositor. Also, if output + is NULL, the compositor should decide which output the toplevel will be + fullscreened on, if at all. + + + + + + + Requests that the toplevel be unfullscreened. If the fullscreen state + actually changes, this will be indicated by the state event. + + + + + + This event is emitted whenever the parent of the toplevel changes. + + No event is emitted when the parent handle is destroyed by the client. + + + + + diff --git a/mate-screenshot/src/Makefile.am b/mate-screenshot/src/Makefile.am index ded207c8..3dcffb26 100644 --- a/mate-screenshot/src/Makefile.am +++ b/mate-screenshot/src/Makefile.am @@ -76,6 +76,7 @@ EXT_IMAGE_CAPTURE_SOURCE_XML = $(WAYLAND_PROTOCOLS_DIR)/staging/ext-image-captur EXT_IMAGE_COPY_CAPTURE_XML = $(WAYLAND_PROTOCOLS_DIR)/staging/ext-image-copy-capture/ext-image-copy-capture-v1.xml EXT_FOREIGN_TOPLEVEL_XML = $(WAYLAND_PROTOCOLS_DIR)/staging/ext-foreign-toplevel-list/ext-foreign-toplevel-list-v1.xml WLR_SCREENCOPY_XML = $(srcdir)/../protocols/wlr-screencopy-unstable-v1.xml +WLR_FOREIGN_TOPLEVEL_XML = $(srcdir)/../protocols/wlr-foreign-toplevel-management-unstable-v1.xml # Generate per-protocol client headers and code ext-image-capture-source-client.h: $(EXT_IMAGE_CAPTURE_SOURCE_XML) @@ -96,6 +97,12 @@ wlr-screencopy-client.h: $(WLR_SCREENCOPY_XML) wlr-screencopy-client.c: $(WLR_SCREENCOPY_XML) $(AM_V_GEN) $(WAYLAND_SCANNER) private-code $< $@ +wlr-foreign-toplevel-client.h: $(WLR_FOREIGN_TOPLEVEL_XML) + $(AM_V_GEN) $(WAYLAND_SCANNER) client-header $< $@ + +wlr-foreign-toplevel-client.c: $(WLR_FOREIGN_TOPLEVEL_XML) + $(AM_V_GEN) $(WAYLAND_SCANNER) private-code $< $@ + ext-foreign-toplevel-list-client.h: $(EXT_FOREIGN_TOPLEVEL_XML) $(AM_V_GEN) $(WAYLAND_SCANNER) client-header $< $@ @@ -111,6 +118,8 @@ WAYLAND_PROTOCOL_SRCS = \ wlr-screencopy-client.h \ ext-foreign-toplevel-list-client.c \ ext-foreign-toplevel-list-client.h \ + wlr-foreign-toplevel-client.c \ + wlr-foreign-toplevel-client.h \ $(NULL) # Add Wayland-specific sources and flags @@ -127,6 +136,7 @@ BUILT_SOURCES += \ ext-image-copy-capture-client.h \ wlr-screencopy-client.h \ ext-foreign-toplevel-list-client.h \ + wlr-foreign-toplevel-client.h \ $(NULL) mate_screenshot_CFLAGS += \ @@ -154,6 +164,8 @@ CLEANFILES = \ wlr-screencopy-client.c \ ext-foreign-toplevel-list-client.h \ ext-foreign-toplevel-list-client.c \ + wlr-foreign-toplevel-client.h \ + wlr-foreign-toplevel-client.c \ $(NULL) install-exec-local: -- cgit v1.2.1