diff options
| -rw-r--r-- | app/protocol/agl-shell-desktop.xml | 32 | ||||
| -rw-r--r-- | app/shell-desktop.cpp | 2 |
2 files changed, 30 insertions, 4 deletions
diff --git a/app/protocol/agl-shell-desktop.xml b/app/protocol/agl-shell-desktop.xml index 4f942f5..e7b9493 100644 --- a/app/protocol/agl-shell-desktop.xml +++ b/app/protocol/agl-shell-desktop.xml @@ -72,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. @@ -83,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/app/shell-desktop.cpp b/app/shell-desktop.cpp index f0a54e5..7e6e1d2 100644 --- a/app/shell-desktop.cpp +++ b/app/shell-desktop.cpp @@ -45,6 +45,6 @@ Shell::set_window_on_screen(QScreen *screen, const QString &app_id) agl_shell_desktop_set_app_property(this->shell.get(), app_id.toStdString().c_str(), AGL_SHELL_DESKTOP_APP_ROLE_REMOTE, - 0, 0, output); + 0, 0, 0, 0, 0, 0, output); } |