summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--launcher/protocol/agl-shell-desktop.xml35
-rw-r--r--launcher/src/shell-desktop.cpp6
2 files changed, 36 insertions, 5 deletions
diff --git a/launcher/protocol/agl-shell-desktop.xml b/launcher/protocol/agl-shell-desktop.xml
index 05a3725..e7b9493 100644
--- a/launcher/protocol/agl-shell-desktop.xml
+++ b/launcher/protocol/agl-shell-desktop.xml
@@ -35,6 +35,9 @@
<enum name="app_role">
<entry name="popup" value="0"/>
<entry name="fullscreen" value="1"/>
+ <entry name="split_vertical" value="2"/>
+ <entry name="split_horizontal" value="3"/>
+ <entry name="remote" value="4"/>
</enum>
<enum name="app_state">
@@ -69,9 +72,31 @@
<request name="set_app_property">
<description summary="set properties for a client identified by app_id">
- Ask the compositor to make a toplevel obey the app_role and, depending
- on the role, to use the the x and y values as initial positional values.
- The x and y values would only make sense for certain roles.
+ Ask the compositor to make a top-level window obey the 'app_role' enum
+ and, depending on that role, to use some of the arguments as initial
+ values to take into account.
+
+ Note that x, y, bx, by, width and height would only make sense for the
+ pop-up role, with the output argument being applicable to all the roles.
+ The width and height values define the maximum area which the
+ top-level window should be placed into. Note this doesn't correspond to
+ top-level surface size, but to a bounding box which will be used to
+ clip the surface to, in case the surface area extends that of this
+ bounding box. Both of these values need to be larger than 0 (zero) to be
+ taken into account by the compositor. Any negative values for the width
+ and height will be discarded.
+
+ The x and y values will serve as the (initial) position values.
+ The bx and by values are the top-left x and y value of the bounding box.
+ Any clipping happening to the bounding box will not affect the surface
+ size or the position of the underlying surface backing the top-level
+ window. The bx and by values, like the positional values, could be
+ both set to zero, or even negative values. The compositor will pass
+ those on without any further validation.
+
+ The initial position values and the bounding rectangle will still be
+ in effect on a subsequent activation request of the 'app_id', assuming
+ it was previously de-activated at some point in time.
See xdg_toplevel.set_app_id from the xdg-shell protocol for a
description of app_id.
@@ -80,6 +105,10 @@
<arg name="role" type="uint" enum="app_role"/>
<arg name="x" type="int"/>
<arg name="y" type="int"/>
+ <arg name="bx" type="int"/>
+ <arg name="by" type="int"/>
+ <arg name="width" type="int"/>
+ <arg name="height" type="int"/>
<arg name="output" type="object" interface="wl_output"/>
</request>
diff --git a/launcher/src/shell-desktop.cpp b/launcher/src/shell-desktop.cpp
index b8e6ef0..8b78f6f 100644
--- a/launcher/src/shell-desktop.cpp
+++ b/launcher/src/shell-desktop.cpp
@@ -85,7 +85,8 @@ Shell::deactivate_app(const QString &app_id)
void
Shell::set_window_props(QWindow *win, const QString &app_id,
- uint32_t props, int x, int y)
+ uint32_t props, int x, int y, int bx, int by,
+ int bwidth, int bheight)
{
QScreen *screen = nullptr;
struct wl_output *output;
@@ -103,5 +104,6 @@ Shell::set_window_props(QWindow *win, const QString &app_id,
output = getWlOutput(screen);
agl_shell_desktop_set_app_property(this->shell.get(),
app_id.toStdString().c_str(),
- props, x, y, output);
+ props, x, y, bx, by,
+ bwidth, bheight, output);
}