Update protocol for xdg-shell stable to version 2
This is just the protocol, it doesn't implement any new interfaces or behavior. Also update the project url, xdg-shell is now part of wayland-protocols, not Weston. Change-Id: I719cc99fc2c59af9abfc0c9abcb9c1daf9b43c74 Reviewed-by: David Edmundson <davidedmundson@kde.org> Reviewed-by: Pier Luigi Fiorini <pierluigi.fiorini@liri.io>
This commit is contained in:
parent
ece34c57f8
commit
03414a616b
@ -166,16 +166,19 @@ Copyright 2015-2016 © Red Hat, Inc."
|
||||
"Files": " xdg-shell-unstable-v5.xml xdg-shell-unstable-v6.xml xdg-shell.xml ../../compositor/extensions/pregenerated/3rdparty/qwayland-server-xdg-shell-unstable-v5.cpp ../../compositor/extensions/pregenerated/3rdparty/qwayland-server-xdg-shell-unstable-v5_p.h ../../compositor/extensions/pregenerated/3rdparty/wayland-xdg-shell-unstable-v5-protocol.c ../../compositor/extensions/pregenerated/3rdparty/wayland-xdg-shell-unstable-v5-server-protocol_p.h ../../plugins/shellintegration/xdg-shell-v5/pregenerated/3rdparty/qwayland-xdg-shell-unstable-v5.cpp ../../plugins/shellintegration/xdg-shell-v5/pregenerated/3rdparty/qwayland-xdg-shell-unstable-v5_p.h ../../plugins/shellintegration/xdg-shell-v5/pregenerated/3rdparty/wayland-xdg-shell-unstable-v5-client-protocol_p.h ../../plugins/shellintegration/xdg-shell-v5/pregenerated/3rdparty/wayland-xdg-shell-unstable-v5-protocol.c",
|
||||
|
||||
"Description": "The XDG-Shell protocol is an extended way to manage surfaces under Wayland compositors.",
|
||||
"Homepage": "https://wayland.freedesktop.org",
|
||||
"Version": "1.9.0",
|
||||
"DownloadLocation": "https://cgit.freedesktop.org/wayland/weston/tag/?id=1.9.0",
|
||||
"Homepage": "https://gitlab.freedesktop.org/wayland/wayland-protocols/",
|
||||
"Version": "1.18",
|
||||
"DownloadLocation": "https://gitlab.freedesktop.org/wayland/wayland-protocols/tree/1.18/",
|
||||
"LicenseId": "MIT",
|
||||
"License": "MIT License",
|
||||
"LicenseFile": "MIT_LICENSE.txt",
|
||||
"Copyright": "Copyright © 2008-2013 Kristian Høgsberg
|
||||
Copyright © 2013 Rafael Antognolli
|
||||
Copyright © 2013 Jasper St. Pierre
|
||||
Copyright © 2010-2013 Intel Corporation"
|
||||
Copyright © 2010-2013 Intel Corporation
|
||||
Copyright © 2015-2017 Samsung Electronics Co., Ltd
|
||||
Copyright © 2015-2017 Red Hat Inc.
|
||||
"
|
||||
},
|
||||
|
||||
{
|
||||
|
91
src/3rdparty/wayland/protocols/xdg-shell.xml
vendored
91
src/3rdparty/wayland/protocols/xdg-shell.xml
vendored
@ -29,7 +29,7 @@
|
||||
DEALINGS IN THE SOFTWARE.
|
||||
</copyright>
|
||||
|
||||
<interface name="xdg_wm_base" version="1">
|
||||
<interface name="xdg_wm_base" version="2">
|
||||
<description summary="create desktop-style surfaces">
|
||||
The xdg_wm_base interface is exposed as a global object enabling clients
|
||||
to turn their wl_surfaces into windows in a desktop environment. It
|
||||
@ -101,7 +101,7 @@
|
||||
<description summary="check if the client is alive">
|
||||
The ping event asks the client if it's still alive. Pass the
|
||||
serial specified in the event back to the compositor by sending
|
||||
a "pong" request back with the specified serial. See xdg_wm_base.ping.
|
||||
a "pong" request back with the specified serial. See xdg_wm_base.pong.
|
||||
|
||||
Compositors can use this to determine if the client is still
|
||||
alive. It's unspecified what will happen if the client doesn't
|
||||
@ -115,7 +115,7 @@
|
||||
</event>
|
||||
</interface>
|
||||
|
||||
<interface name="xdg_positioner" version="1">
|
||||
<interface name="xdg_positioner" version="2">
|
||||
<description summary="child surface positioner">
|
||||
The xdg_positioner provides a collection of rules for the placement of a
|
||||
child surface relative to a parent surface. Rules can be defined to ensure
|
||||
@ -359,7 +359,7 @@
|
||||
</request>
|
||||
</interface>
|
||||
|
||||
<interface name="xdg_surface" version="1">
|
||||
<interface name="xdg_surface" version="2">
|
||||
<description summary="desktop user interface surface base interface">
|
||||
An interface that may be implemented by a wl_surface, for
|
||||
implementations that provide a desktop-style user interface.
|
||||
@ -528,7 +528,7 @@
|
||||
</event>
|
||||
</interface>
|
||||
|
||||
<interface name="xdg_toplevel" version="1">
|
||||
<interface name="xdg_toplevel" version="2">
|
||||
<description summary="toplevel surface">
|
||||
This interface defines an xdg_surface role which allows a surface to,
|
||||
among other things, set window-like properties such as maximize,
|
||||
@ -604,6 +604,9 @@
|
||||
For example, "org.freedesktop.FooViewer" where the .desktop file is
|
||||
"org.freedesktop.FooViewer.desktop".
|
||||
|
||||
Like other properties, a set_app_id request can be sent after the
|
||||
xdg_toplevel has been mapped to update the property.
|
||||
|
||||
See the desktop-entry specification [0] for more details on
|
||||
application identifiers and how they relate to well-known D-Bus
|
||||
names and .desktop files.
|
||||
@ -724,6 +727,9 @@
|
||||
<description summary="the surface is maximized">
|
||||
The surface is maximized. The window geometry specified in the configure
|
||||
event must be obeyed by the client.
|
||||
|
||||
The client should draw without shadow or other
|
||||
decoration outside of the window geometry.
|
||||
</description>
|
||||
</entry>
|
||||
<entry name="fullscreen" value="2" summary="the surface is fullscreen">
|
||||
@ -750,6 +756,30 @@
|
||||
keyboard or pointer focus.
|
||||
</description>
|
||||
</entry>
|
||||
<entry name="tiled_left" value="5" since="2">
|
||||
<description summary="the surface is tiled">
|
||||
The window is currently in a tiled layout and the left edge is
|
||||
considered to be adjacent to another part of the tiling grid.
|
||||
</description>
|
||||
</entry>
|
||||
<entry name="tiled_right" value="6" since="2">
|
||||
<description summary="the surface is tiled">
|
||||
The window is currently in a tiled layout and the right edge is
|
||||
considered to be adjacent to another part of the tiling grid.
|
||||
</description>
|
||||
</entry>
|
||||
<entry name="tiled_top" value="7" since="2">
|
||||
<description summary="the surface is tiled">
|
||||
The window is currently in a tiled layout and the top edge is
|
||||
considered to be adjacent to another part of the tiling grid.
|
||||
</description>
|
||||
</entry>
|
||||
<entry name="tiled_bottom" value="8" since="2">
|
||||
<description summary="the surface is tiled">
|
||||
The window is currently in a tiled layout and the bottom edge is
|
||||
considered to be adjacent to another part of the tiling grid.
|
||||
</description>
|
||||
</entry>
|
||||
</enum>
|
||||
|
||||
<request name="set_max_size">
|
||||
@ -839,12 +869,11 @@
|
||||
Maximize the surface.
|
||||
|
||||
After requesting that the surface should be maximized, the compositor
|
||||
will respond by emitting a configure event with the "maximized" state
|
||||
and the required window geometry. The client should then update its
|
||||
content, drawing it in a maximized state, i.e. without shadow or other
|
||||
decoration outside of the window geometry. The client must also
|
||||
acknowledge the configure when committing the new content (see
|
||||
ack_configure).
|
||||
will respond by emitting a configure event. Whether this configure
|
||||
actually sets the window maximized is subject to compositor policies.
|
||||
The client must then update its content, drawing in the configured
|
||||
state. The client must also acknowledge the configure when committing
|
||||
the new content (see ack_configure).
|
||||
|
||||
It is up to the compositor to decide how and where to maximize the
|
||||
surface, for example which output and what region of the screen should
|
||||
@ -854,8 +883,8 @@
|
||||
a configure event with the "maximized" state.
|
||||
|
||||
If the surface is in a fullscreen state, this request has no direct
|
||||
effect. It will alter the state the surface is returned to when
|
||||
unmaximized if not overridden by the compositor.
|
||||
effect. It may alter the state the surface is returned to when
|
||||
unmaximized unless overridden by the compositor.
|
||||
</description>
|
||||
</request>
|
||||
|
||||
@ -864,13 +893,13 @@
|
||||
Unmaximize the surface.
|
||||
|
||||
After requesting that the surface should be unmaximized, the compositor
|
||||
will respond by emitting a configure event without the "maximized"
|
||||
state. If available, the compositor will include the window geometry
|
||||
dimensions the window had prior to being maximized in the configure
|
||||
event. The client must then update its content, drawing it in a
|
||||
regular state, i.e. potentially with shadow, etc. The client must also
|
||||
acknowledge the configure when committing the new content (see
|
||||
ack_configure).
|
||||
will respond by emitting a configure event. Whether this actually
|
||||
un-maximizes the window is subject to compositor policies.
|
||||
If available and applicable, the compositor will include the window
|
||||
geometry dimensions the window had prior to being maximized in the
|
||||
configure event. The client must then update its content, drawing it in
|
||||
the configured state. The client must also acknowledge the configure
|
||||
when committing the new content (see ack_configure).
|
||||
|
||||
It is up to the compositor to position the surface after it was
|
||||
unmaximized; usually the position the surface had before maximizing, if
|
||||
@ -880,8 +909,8 @@
|
||||
emit a configure event without the "maximized" state.
|
||||
|
||||
If the surface is in a fullscreen state, this request has no direct
|
||||
effect. It will alter the state the surface is returned to when
|
||||
unmaximized if not overridden by the compositor.
|
||||
effect. It may alter the state the surface is returned to when
|
||||
unmaximized unless overridden by the compositor.
|
||||
</description>
|
||||
</request>
|
||||
|
||||
@ -890,10 +919,10 @@
|
||||
Make the surface fullscreen.
|
||||
|
||||
After requesting that the surface should be fullscreened, the
|
||||
compositor will respond by emitting a configure event with the
|
||||
"fullscreen" state and the fullscreen window geometry. The client must
|
||||
also acknowledge the configure when committing the new content (see
|
||||
ack_configure).
|
||||
compositor will respond by emitting a configure event. Whether the
|
||||
client is actually put into a fullscreen state is subject to compositor
|
||||
policies. The client must also acknowledge the configure when
|
||||
committing the new content (see ack_configure).
|
||||
|
||||
The output passed by the request indicates the client's preference as
|
||||
to which display it should be set fullscreen on. If this value is NULL,
|
||||
@ -919,8 +948,9 @@
|
||||
Make the surface no longer fullscreen.
|
||||
|
||||
After requesting that the surface should be unfullscreened, the
|
||||
compositor will respond by emitting a configure event without the
|
||||
"fullscreen" state.
|
||||
compositor will respond by emitting a configure event.
|
||||
Whether this actually removes the fullscreen state of the client is
|
||||
subject to compositor policies.
|
||||
|
||||
Making a surface unfullscreen sets states for the surface based on the following:
|
||||
* the state(s) it may have had before becoming fullscreen
|
||||
@ -989,7 +1019,7 @@
|
||||
</event>
|
||||
</interface>
|
||||
|
||||
<interface name="xdg_popup" version="1">
|
||||
<interface name="xdg_popup" version="2">
|
||||
<description summary="short-lived, popup surfaces for menus">
|
||||
A popup surface is a short-lived, temporary surface. It can be used to
|
||||
implement for example menus, popovers, tooltips and other similar user
|
||||
@ -1007,9 +1037,6 @@
|
||||
surface of their own is clicked should dismiss the popup using the destroy
|
||||
request.
|
||||
|
||||
The parent surface must have either the xdg_toplevel or xdg_popup surface
|
||||
role.
|
||||
|
||||
A newly created xdg_popup will be stacked on top of all previously created
|
||||
xdg_popup surfaces associated with the same xdg_toplevel.
|
||||
|
||||
|
Loading…
x
Reference in New Issue
Block a user