From 9fc66aeac6fbc5fbc59571ce5d253d24a05974ba Mon Sep 17 00:00:00 2001 From: "Anna (navi) Figueiredo Gomes" Date: Mon, 9 Oct 2023 22:11:34 +0100 Subject: ext-action-binder: remove action-binding, move bind to binder Signed-off-by: Anna (navi) Figueiredo Gomes --- staging/action-binder/action-binder-v1.xml | 237 +++++++++++++++-------------- 1 file changed, 119 insertions(+), 118 deletions(-) diff --git a/staging/action-binder/action-binder-v1.xml b/staging/action-binder/action-binder-v1.xml index 35dfe63..545b917 100644 --- a/staging/action-binder/action-binder-v1.xml +++ b/staging/action-binder/action-binder-v1.xml @@ -1,121 +1,122 @@ - - - Copyright © 2015-2017 Quentin “Sardem FF7” Glidic - - Permission to use, copy, modify, distribute, and sell this - software and its documentation for any purpose is hereby granted - without fee, provided that the above copyright notice appear in - all copies and that both that copyright notice and this permission - notice appear in supporting documentation, and that the name of - the copyright holders not be used in advertising or publicity - pertaining to distribution of the software without specific, - written prior permission. The copyright holders make no - representations about the suitability of this software for any - purpose. It is provided "as is" without express or implied - warranty. - - THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS - SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND - FITNESS, IN NO EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY - SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES - WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN - AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, - ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF - THIS SOFTWARE. - - - - - This interface is designed to allow any application to bind - an action. - - An action is an arbitrary couple of a namespace and a name describing the - wanted behaviour. These two strings are not meant to be user-visible. - Some namespaces are well-known and shared by applications while each - application can have its own namespaces for internal actions. - It is possible to have the same action in several namespaces, e.g. to - allow application-specific bindings in addition to global actions. - - It is left to the compositor to determine which client will get events. - The choice can be based on policy, heuristic, user configuration, or any - other mechanism that may be relevant. - Here are some examples of dispatching choice: all applications, last - focused, user-defined preference order, latest fullscreened application. - - This object is a singleton global. - - - - - Informs the server that the client will not be using this protocol - object anymore. You must destroy any wp_action_binding created from the - wp_action_binder before. - - - - - - Creates a binding object. It will be used by the application to bind - one or more actions and get the corresponding events. - - - - - - - - - This interface represents a binding to a set of actions. - - Depending on the user configuration, an action can be either one-off or - sustained. The client must handle all the three events and either make - sense of them or ignore them properly. - - - - - - - - - The client no longer wants to receive events for these actions. - - - - - - Bind an action to the object. Multiple actions can be bound at the same - time. That means any combination of events can occur. - If the action is reserved by the compositor a protocol error is raised. - - - - - - - - - This event is sent for one-off actions. - - If a binding would trigger both triggered and started events, the - started event must be sent first. - - - - - - This event is sent when a sustained action is started. - - - - - - This event is sent when a sustained action is stopped. - - - + + Copyright © 2015-2017 Quentin “Sardem FF7” Glidic, 2023 Anna "navi" Figueiredo Gomes + + Permission to use, copy, modify, distribute, and sell this + software and its documentation for any purpose is hereby granted + without fee, provided that the above copyright notice appear in + all copies and that both that copyright notice and this permission + notice appear in supporting documentation, and that the name of + the copyright holders not be used in advertising or publicity + pertaining to distribution of the software without specific, + written prior permission. The copyright holders make no + representations about the suitability of this software for any + purpose. It is provided "as is" without express or implied + warranty. + + THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS + SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND + FITNESS, IN NO EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY + SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN + AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, + ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF + THIS SOFTWARE. + + + + + This interface is designed to allow any application to bind + an action. + + An action is an arbitrary couple of a namespace and a name describing the + wanted behaviour. These two strings are not meant to be user-visible. + Some namespaces are well-known and shared by applications while each + application can have its own namespaces for internal actions. + It is possible to have the same action in several namespaces, e.g. to + allow application-specific bindings in addition to global actions. + + It is left to the compositor to determine which client will get events. + The choice can be based on policy, heuristic, user configuration, or any + other mechanism that may be relevant. + Here are some examples of dispatching choice: all applications, last + focused, user-defined preference order, latest fullscreened application. + + This interface is exposed as global + + + + + The client no longer wants to receive events for any action. + + + + + + Bind an action to the object. Multiple actions can be bound at the same + time. That means any combination of events can occur. + After calling bind, the "action_bound" event is fired by the compositor + with the status of the request. + + + + + + + + + + + Removes a specific binding to the object. if the client does not hold any + binding to the namespace:name combo, no operation is performed. + + + + + + + + + + + + + + After the compositor processes a bind request, it should call this + event to notify the client of the result, as well as the trigger, in + case of success. + + + + + + + + Depending on the user configuration, an action can be either one-off or + sustained. The client must handle all the three event types and either make + sense of them or ignore them properly. + + + + + + + + + This event is sent when actions are triggered. + If a binding would trigger both triggered and started events, the + started event must be sent first. + + + + + + -- cgit v1.2.3