| Index: third_party/wayland-protocols/unstable/remote-shell/remote-shell-unstable-v1.xml
|
| diff --git a/third_party/wayland-protocols/unstable/remote-shell/remote-shell-unstable-v1.xml b/third_party/wayland-protocols/unstable/remote-shell/remote-shell-unstable-v1.xml
|
| index 083bd9b1d8b6e2e60f8a0b3cd903a1283b792caa..90c9e96a0ace6439b9de33626b1ff09e1128b29a 100644
|
| --- a/third_party/wayland-protocols/unstable/remote-shell/remote-shell-unstable-v1.xml
|
| +++ b/third_party/wayland-protocols/unstable/remote-shell/remote-shell-unstable-v1.xml
|
| @@ -38,7 +38,7 @@
|
| reset.
|
| </description>
|
|
|
| - <interface name="zwp_remote_shell_v1" version="11">
|
| + <interface name="zcr_remote_shell_v1" version="1">
|
| <description summary="remote_shell">
|
| The global interface that allows clients to turn a wl_surface into a
|
| "real window" which is remotely managed but can be stacked, activated
|
| @@ -101,6 +101,362 @@
|
| See the documentation of remote_surface for more details about what an
|
| remote_surface is and how it is used.
|
| </description>
|
| + <arg name="id" type="new_id" interface="zcr_remote_surface_v1"/>
|
| + <arg name="surface" type="object" interface="wl_surface"/>
|
| + <arg name="container" type="uint"/>
|
| + </request>
|
| +
|
| + <event name="activated">
|
| + <description summary="activated surface changed">
|
| + Notifies client that the activated surface changed.
|
| + </description>
|
| + <arg name="gained_active" type="object" interface="wl_surface" allow-null="true"/>
|
| + <arg name="lost_active" type="object" interface="wl_surface" allow-null="true"/>
|
| + </event>
|
| +
|
| + <request name="get_notification_surface">
|
| + <description summary="create a notification surface from a surface">
|
| + Creates a notification_surface for the given surface, gives it the
|
| + notification_surface role and associated it with a notification id.
|
| + </description>
|
| + <arg name="id" type="new_id" interface="zcr_notification_surface_v1"/>
|
| + <arg name="surface" type="object" interface="wl_surface"/>
|
| + <arg name="notification_id" type="string" />
|
| + </request>
|
| +
|
| + <event name="configuration_changed">
|
| + <description summary="suggests a re-configuration of remote shell">
|
| + Suggests a re-configuration of remote shell.
|
| + </description>
|
| + <arg name="width" type="int"/>
|
| + <arg name="height" type="int"/>
|
| + <arg name="transform" type="int"/>
|
| + <arg name="scale_factor" type="fixed"/>
|
| + <arg name="work_area_inset_left" type="int"/>
|
| + <arg name="work_area_inset_top" type="int"/>
|
| + <arg name="work_area_inset_right" type="int"/>
|
| + <arg name="work_area_inset_bottom" type="int"/>
|
| + <arg name="layout_mode" type="uint"/>
|
| + </event>
|
| + </interface>
|
| +
|
| + <interface name="zcr_remote_surface_v1" version="1">
|
| + <description summary="A desktop window">
|
| + An interface that may be implemented by a wl_surface, for
|
| + implementations that provide a desktop-style user interface
|
| + and allows for remotely managed windows.
|
| +
|
| + It provides requests to treat surfaces like windows, allowing to set
|
| + properties like app id and geometry.
|
| +
|
| + The client must call wl_surface.commit on the corresponding wl_surface
|
| + for the remote_surface state to take effect.
|
| +
|
| + For a surface to be mapped by the compositor the client must have
|
| + committed both an remote_surface state and a buffer.
|
| + </description>
|
| +
|
| + <request name="destroy" type="destructor">
|
| + <description summary="Destroy the remote_surface">
|
| + Unmap and destroy the window. The window will be effectively
|
| + hidden from the user's point of view, and all state will be lost.
|
| + </description>
|
| + </request>
|
| +
|
| + <request name="set_app_id">
|
| + <description summary="set application ID">
|
| + Set an application identifier for the surface.
|
| + </description>
|
| + <arg name="app_id" type="string"/>
|
| + </request>
|
| +
|
| + <request name="set_window_geometry">
|
| + <description summary="set the new window geometry">
|
| + The window geometry of a window is its "visible bounds" from the
|
| + user's perspective. Client-side decorations often have invisible
|
| + portions like drop-shadows which should be ignored for the
|
| + purposes of aligning, placing and constraining windows.
|
| +
|
| + The window geometry is double buffered, and will be applied at the
|
| + time wl_surface.commit of the corresponding wl_surface is called.
|
| +
|
| + Once the window geometry of the surface is set once, it is not
|
| + possible to unset it, and it will remain the same until
|
| + set_window_geometry is called again, even if a new subsurface or
|
| + buffer is attached.
|
| +
|
| + If never set, the value is the full bounds of the output. This
|
| + updates dynamically on every commit.
|
| +
|
| + The arguments are given in the output coordinate space.
|
| +
|
| + The width and height must be greater than zero.
|
| + </description>
|
| + <arg name="x" type="int"/>
|
| + <arg name="y" type="int"/>
|
| + <arg name="width" type="int"/>
|
| + <arg name="height" type="int"/>
|
| + </request>
|
| +
|
| + <request name="set_scale">
|
| + <description summary="set scale">
|
| + Set a scale factor that will be applied to surface and all descendants.
|
| + </description>
|
| + <arg name="scale" type="fixed"/>
|
| + </request>
|
| +
|
| + <request name="set_rectangular_shadow">
|
| + <description summary="set a rectangular shadow">
|
| + Request that surface needs a rectangular shadow.
|
| +
|
| + This is only a request that the surface should have a rectangular
|
| + shadow. The compositor may choose to ignore this request.
|
| +
|
| + The arguments are given in the output coordinate space and specifies
|
| + the inner bounds of the shadow.
|
| +
|
| + The arguments are given in the output coordinate space.
|
| + Specifying zero width and height will disable the shadow.
|
| + </description>
|
| + <arg name="x" type="int"/>
|
| + <arg name="y" type="int"/>
|
| + <arg name="width" type="int"/>
|
| + <arg name="height" type="int"/>
|
| + </request>
|
| +
|
| + <request name="set_rectangular_shadow_background_opacity">
|
| + <description summary="suggests the window's background opacity">
|
| + Suggests the window's background opacity when the shadow is requested.
|
| + </description>
|
| + <arg name="opacity" type="fixed"/>
|
| + </request>
|
| +
|
| + <request name="set_title">
|
| + <description summary="set surface title">
|
| + Set a short title for the surface.
|
| +
|
| + This string may be used to identify the surface in a task bar,
|
| + window list, or other user interface elements provided by the
|
| + compositor.
|
| +
|
| + The string must be encoded in UTF-8.
|
| + </description>
|
| + <arg name="title" type="string"/>
|
| + </request>
|
| +
|
| + <request name="set_top_inset">
|
| + <description summary="set top inset for surface">
|
| + Set distance from the top of the surface to the contents.
|
| +
|
| + This distance typically represents the size of the window caption.
|
| + </description>
|
| + <arg name="height" type="int"/>
|
| + </request>
|
| +
|
| + <request name="activate">
|
| + <description summary="make the surface active">
|
| + Make the surface active and bring it to the front.
|
| + </description>
|
| + <arg name="serial" type="uint" summary="the serial of the user event"/>
|
| + </request>
|
| +
|
| + <request name="maximize">
|
| + <description summary="maximize">
|
| + Request that surface is maximized. The window geometry will be updated
|
| + to whatever the compositor finds appropriate for a maximized window.
|
| +
|
| + This is only a request that the window should be maximized. The
|
| + compositor may choose to ignore this request. The client should
|
| + listen to set_maximized events to determine if the window was
|
| + maximized or not.
|
| + </description>
|
| + </request>
|
| +
|
| + <request name="minimize">
|
| + <description summary="minimize">
|
| + Request that surface is minimized.
|
| +
|
| + This is only a request that the window should be minimized. The
|
| + compositor may choose to ignore this request. The client should
|
| + listen to set_minimized events to determine if the window was
|
| + minimized or not.
|
| + </description>
|
| + </request>
|
| +
|
| + <request name="restore">
|
| + <description summary="restore">
|
| + Request that surface is restored. This restores the window geometry
|
| + to what it was before the window was minimized, maximized or made
|
| + fullscreen.
|
| +
|
| + This is only a request that the window should be restored. The
|
| + compositor may choose to ignore this request. The client should
|
| + listen to unset_maximized, unset_minimize and unset_fullscreen
|
| + events to determine if the window was restored or not.
|
| + </description>
|
| + </request>
|
| +
|
| + <request name="fullscreen">
|
| + <description summary="fullscreen">
|
| + Request that surface is made fullscreen.
|
| +
|
| + This is only a request that the window should be made fullscreen.
|
| + The compositor may choose to ignore this request. The client should
|
| + listen to set_fullscreen events to determine if the window was
|
| + made fullscreen or not.
|
| + </description>
|
| + </request>
|
| +
|
| + <request name="unfullscreen">
|
| + <description summary="unfullscreen">
|
| + Request that surface is made unfullscreen.
|
| +
|
| + This is only a request that the window should be made unfullscreen.
|
| + The compositor may choose to ignore this request. The client should
|
| + listen to unset_fullscreen events to determine if the window was
|
| + made unfullscreen or not.
|
| + </description>
|
| + </request>
|
| +
|
| + <request name="pin">
|
| + <description summary="pin">
|
| + Request that surface is pinned.
|
| +
|
| + This is only a request that the window should be pinned.
|
| + The compositor may choose to ignore this request. The client should
|
| + listen to state_changed events to determine if the window was
|
| + pinned or not. If trusted flag is non-zero, the app can prevent users
|
| + from exiting the pinned mode.
|
| + </description>
|
| + <arg name="trusted" type="int"/>
|
| + </request>
|
| +
|
| + <request name="unpin">
|
| + <description summary="unpin">
|
| + Request that surface is unpinned.
|
| +
|
| + This is only a request that the window should be unpinned.
|
| + The compositor may choose to ignore this request. The client should
|
| + listen to unset_pinned events to determine if the window was
|
| + unpinned or not.
|
| + </description>
|
| + </request>
|
| +
|
| + <request name="set_system_modal">
|
| + <description summary="suggests a re-layout of remote shell input area">
|
| + Suggests a surface should become system modal.
|
| + </description>
|
| + </request>
|
| +
|
| + <request name="unset_system_modal">
|
| + <description summary="suggests a re-layout of remote shell input area">
|
| + Suggests a surface should become non system modal.
|
| + </description>
|
| + </request>
|
| +
|
| + <event name="close">
|
| + <description summary="surface wants to be closed">
|
| + The close event is sent by the compositor when the user
|
| + wants the surface to be closed. This should be equivalent to
|
| + the user clicking the close button in client-side decorations,
|
| + if your application has any...
|
| +
|
| + This is only a request that the user intends to close your
|
| + window. The client may choose to ignore this request, or show
|
| + a dialog to ask the user to save their data...
|
| + </description>
|
| + </event>
|
| +
|
| + <event name="state_type_changed">
|
| + <description summary="surface state type changed">
|
| + The state_type_changed event is sent by the compositor when the surface
|
| + state changed.
|
| +
|
| + This is an event to notify that the window state changed in compositor.
|
| + The state change may be triggered by a client's request, or some user
|
| + action directly handled by the compositor. The client may choose to
|
| + ignore this event.
|
| + </description>
|
| + <arg name="state_type" type="uint"/>
|
| + </event>
|
| + </interface>
|
| +
|
| + <interface name="zcr_notification_surface_v1" version="1">
|
| + <description summary="A notification window">
|
| + An interface that may be implemented by a wl_surface to host
|
| + notification contents.
|
| + </description>
|
| +
|
| + <request name="destroy" type="destructor">
|
| + <description summary="Destroy the notification_surface">
|
| + Unmap and destroy the notification surface.
|
| + </description>
|
| + </request>
|
| + </interface>
|
| +
|
| + <interface name="zwp_remote_shell_v1" version="11">
|
| + <description summary="DEPRECATED">
|
| + The global interface that allows clients to turn a wl_surface into a
|
| + "real window" which is remotely managed but can be stacked, activated
|
| + and made fullscreen by the user.
|
| + </description>
|
| +
|
| + <enum name="container">
|
| + <description summary="containers for remote surfaces">
|
| + Determine how a remote surface should be stacked relative to other
|
| + shell surfaces.
|
| + </description>
|
| + <entry name="default" value="1" summary="default container"/>
|
| + <entry name="overlay" value="2" summary="system modal container"/>
|
| + </enum>
|
| +
|
| + <enum name="state_type">
|
| + <description summary="state types for remote surfaces">
|
| + Defines common show states for shell surfaces.
|
| + </description>
|
| + <entry name="normal" value="1" summary="normal window state"/>
|
| + <entry name="minimized" value="2" summary="minimized window state"/>
|
| + <entry name="maximized" value="3" summary="maximized window state"/>
|
| + <entry name="fullscreen" value="4" summary="fullscreen window state"/>
|
| + <entry name="pinned" value="5" summary="pinned window state"/>
|
| + <entry name="trusted_pinned" value="6" summary="trusted pinned window state"/>
|
| + </enum>
|
| +
|
| + <enum name="error">
|
| + <entry name="role" value="0" summary="given wl_surface has another role"/>
|
| + <entry name="invalid_notification_id" value="1"
|
| + summary="invalid notification id"/>
|
| + </enum>
|
| +
|
| + <enum name="layout_mode">
|
| + <description summary="the layout mode">
|
| + Determine how a client should layout surfaces.
|
| + </description>
|
| + <entry name="windowed" value="1" summary="multiple windows"/>
|
| + <entry name="tablet" value="2" summary="restricted mode for tablet"/>
|
| + </enum>
|
| +
|
| + <request name="destroy" type="destructor">
|
| + <description summary="destroy remote_shell">
|
| + Destroy this remote_shell object.
|
| +
|
| + Destroying a bound remote_shell object while there are surfaces
|
| + still alive created by this remote_shell object instance is illegal
|
| + and will result in a protocol error.
|
| + </description>
|
| + </request>
|
| +
|
| + <request name="get_remote_surface">
|
| + <description summary="create a remote shell surface from a surface">
|
| + This creates an remote_surface for the given surface and gives it the
|
| + remote_surface role. A wl_surface can only be given a remote_surface
|
| + role once. If get_remote_surface is called with a wl_surface that
|
| + already has an active remote_surface associated with it, or if it had
|
| + any other role, an error is raised.
|
| +
|
| + See the documentation of remote_surface for more details about what an
|
| + remote_surface is and how it is used.
|
| + </description>
|
| <arg name="id" type="new_id" interface="zwp_remote_surface_v1"/>
|
| <arg name="surface" type="object" interface="wl_surface"/>
|
| <arg name="container" type="uint"/>
|
| @@ -169,7 +525,7 @@
|
| </interface>
|
|
|
| <interface name="zwp_remote_surface_v1" version="11">
|
| - <description summary="A desktop window">
|
| + <description summary="DEPRECATED">
|
| An interface that may be implemented by a wl_surface, for
|
| implementations that provide a desktop-style user interface
|
| and allows for remotely managed windows.
|
| @@ -526,7 +882,7 @@
|
| <!-- Version 6 additions -->
|
|
|
| <interface name="zwp_notification_surface_v1" version="6">
|
| - <description summary="A notification window">
|
| + <description summary="DEPRECATED">
|
| An interface that may be implemented by a wl_surface to host
|
| notification contents.
|
| </description>
|
|
|