X-Git-Url: https://gerrit.automotivelinux.org/gerrit/gitweb?a=blobdiff_plain;f=protocol%2Fagl-shell-desktop.xml;h=e4445bd071f242b229789c68dc71d04ea2eed140;hb=HEAD;hp=e8ae153d0753d513a6b30b8ab92900a2568c79f0;hpb=40da59d00a7f0e7ec48c32cb1f8ef18e5c08f471;p=src%2Fagl-compositor.git diff --git a/protocol/agl-shell-desktop.xml b/protocol/agl-shell-desktop.xml index e8ae153..e4445bd 100644 --- a/protocol/agl-shell-desktop.xml +++ b/protocol/agl-shell-desktop.xml @@ -22,11 +22,11 @@ FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. - + This extension can be used by regular application to instruct to compositor to activate or switch to other running (regular) applications. The client - is responsbile for filtering their own app_id when receiving application id. + is responsible for filtering their own app_id when receiving application id. The compositor will allow clients to bind to this interface only if the policy engine allows it. @@ -43,6 +43,7 @@ + @@ -117,7 +118,7 @@ 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 activate surface) or temporarly (or + 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. @@ -138,5 +139,25 @@ + + + + Use this request to inform the compositor to maintain a pending state + for an app_id being set with set_app_property() request. Any + subsequent application matching that app_id would survive a potential + application destruction. Note that this request will take effect + globally on all applications. + + To turn it on, or off, use the 'permanent' argument. Initially, + the compositor will have this option set to off. Note that it + doesn't matter the order of this request with respect to + set_app_property() request, as the changes will only take effect + when the application itself does the commit with an app_id set, + therefore the only requirement is to call this request before + the app_id client does its first commit. + + + +