src/policy-default.c

   1 /*
   2  * Copyright © 2020 Collabora, Ltd.
   3  *
   4  * Permission is hereby granted, free of charge, to any person obtaining
   5  * a copy of this software and associated documentation files (the
   6  * "Software"), to deal in the Software without restriction, including
   7  * without limitation the rights to use, copy, modify, merge, publish,
   8  * distribute, sublicense, and/or sell copies of the Software, and to
   9  * permit persons to whom the Software is furnished to do so, subject to
  10  * the following conditions:
  11  *
  12  * The above copyright notice and this permission notice (including the
  13  * next paragraph) shall be included in all copies or substantial
  14  * portions of the Software.
  15  *
  16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  17  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  18  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  19  * NONINFRINGEMENT.  IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
  20  * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
  21  * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
  22  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  23  * SOFTWARE.
  24  */
  25
  26 #include "ivi-compositor.h"
  27 #include "policy.h"
  28
  29 /*
  30  * default policy implementation allows every action to be possible
  31  *
  32  * This is an example, that implements the API
  33  *
  34  * For injecting rules back in the compositor one should use ivi_policy_add()
  35  * - policy_rule_allow_to_add is required in order to add further policy rules
  36  * - policy_rule_try_event will be callback executed when handling the state
  37  *   change
  38  */
  39 static bool
  40 ivi_policy_default_surface_create(struct ivi_surface *surf, void *user_data)
  41 {
  42         /* verify that the surface should be created */
  43         return true;
  44 }
  45
  46 static bool
  47 ivi_policy_default_surface_commmited(struct ivi_surface *surf, void *user_data)
  48 {
  49         /* verify that the surface should be committed */
  50         return true;
  51 }
  52
  53 static bool
  54 ivi_policy_default_surface_activate(struct ivi_surface *surf, void *user_data)
  55 {
  56         /* verify that the surface should be switched to */
  57         return true;
  58 }
  59
  60 static bool
  61 ivi_policy_default_surface_deactivate(struct ivi_surface *surf, void *user_data)
  62 {
  63         /* verify that the surface should be de-activated to */
  64         return true;
  65 }
  66
  67 static bool
  68 ivi_policy_default_surface_activate_default(struct ivi_surface *surf, void *user_data)
  69 {
  70         /* verify that the surface should be switched to */
  71         return true;
  72 }
  73
  74 static bool
  75 ivi_policy_default_allow_to_add(void *user_data)
  76 {
  77         /* verify that policy rules can be added with ivi_policy_add() */
  78         return true;
  79 }
  80
  81 /*
  82  * Policy rules added by ivi_policy_add() will be handled by this callback, and
  83  * should be treated depending on the event. Note this is just an example.
  84  */
  85 static void
  86 ivi_policy_default_try_event(struct ivi_a_policy *a_policy)
  87 {
  88         uint32_t event = a_policy->event;
  89
  90         switch (event) {
  91         case AGL_SHELL_POLICY_EVENT_SHOW:
  92                 ivi_layout_activate(a_policy->output, a_policy->app_id);
  93                 break;
  94         case AGL_SHELL_POLICY_EVENT_HIDE:
  95                 ivi_layout_deactivate(a_policy->policy->ivi, a_policy->app_id);
  96         default:
  97                 break;
  98         }
  99 }
 100
 101 static const struct ivi_policy_api policy_api = {
 102         .struct_size = sizeof(policy_api),
 103         .surface_create = ivi_policy_default_surface_create,
 104         .surface_commited = ivi_policy_default_surface_commmited,
 105         .surface_activate = ivi_policy_default_surface_activate,
 106         .surface_deactivate = ivi_policy_default_surface_deactivate,
 107         .surface_activate_by_default = ivi_policy_default_surface_activate_default,
 108         .policy_rule_allow_to_add = ivi_policy_default_allow_to_add,
 109         .policy_rule_try_event = ivi_policy_default_try_event,
 110 };
 111
 112 int
 113 ivi_policy_init(struct ivi_compositor *ivi)
 114 {
 115         ivi->policy = ivi_policy_create(ivi, &policy_api, ivi);
 116         if (!ivi->policy)
 117                 return -1;
 118
 119         return 0;
 120 }