Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(166)

Unified Diff: third_party/wayland-protocols/unstable/remote-shell/remote-shell-unstable-v1.xml

Issue 2350633002: third_party: Switch to zcr prefix for downstream wayland interfaces. (Closed)
Patch Set: Created 4 years, 3 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
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>

Powered by Google App Engine
This is Rietveld 408576698