FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.
</copyright>
- <interface name="agl_shell" version="2">
+ <interface name="agl_shell" version="4">
<description summary="user interface for Automotive Grade Linux platform">
Starting with version 2 of the protocol, the client is required to wait
for the 'bound_ok' or 'bound_fail' events in order to proceed further.
<entry name="right" value="3"/>
</enum>
+ <enum name="app_state" since="4">
+ <entry name="started" value="0"/>
+ <entry name="activated" value="1"/>
+ <entry name="deactivated" value="2"/>
+ <entry name="destroyed" value="3"/>
+ </enum>
+
+ <enum name="app_role" since="4">
+ <entry name="float" value="0"/>
+ <entry name="remote" value="1"/>
+ </enum>
+
<request name="ready">
<description summary="client is ready to be shown">
Tell the server that this client is ready to be shown. The server
<arg name="output" type="object" interface="wl_output"/>
</request>
+ <request name="deactivate_app" since="3">
+ <description summary="de-activate/hide window identified by app_id">
+ Ask the compositor to hide the toplevel window for window
+ management purposes. Depending on the window role, this request
+ will either display the previously active window (or the background
+ in case there's no previously active surface) or temporarily (or
+ until a 'activate_app' is called upon) hide the surface. All
+ the surfaces are identifiable by using the app_id, and no actions are
+ taken in case the app_id is not/was not present.
+
+ See xdg_toplevel.set_app_id from the xdg-shell protocol for a
+ description of app_id.
+ </description>
+ <arg name="app_id" type="string"/>
+ </request>
+
<event name="bound_ok" since="2">
<description>
Informs the client that it was able to bind the agl_shell
</description>
</event>
+ <event name="app_state" since="4">
+ <description summary="event sent when application has suffered state modification">
+ Notifies application(s) when other application have suffered state modifications.
+ </description>
+ <arg name="app_id" type="string"/>
+ <arg name="state" type="uint" enum="app_state"/>
+ <arg name="role" type="uint" enum="app_role"/>
+ </event>
+
</interface>
</protocol>