src/lib/elm_mapbuf.c

   1 #include <Elementary.h>
   2 #include "elm_priv.h"
   3
   4 /**
   5  * @defgroup Mapbuf Mapbuf
   6  * @ingroup Elementary
   7  *
   8  * This holds 1 content object and uses an Evas Map to move/resize etc. it.
   9  */
  10
  11 typedef struct _Widget_Data Widget_Data;
  12
  13 struct _Widget_Data
  14 {
  15    Evas_Object *content;
  16    Eina_Bool enabled : 1;
  17    Eina_Bool alpha : 1;
  18    Eina_Bool smooth : 1;
  19 };
  20
  21 static const char *widtype = NULL;
  22 static void _del_hook(Evas_Object *obj);
  23 static void _theme_hook(Evas_Object *obj);
  24 static void _sizing_eval(Evas_Object *obj);
  25 static void _changed_size_hints(void *data, Evas *e, Evas_Object *obj, void *event_info);
  26 static void _sub_del(void *data, Evas_Object *obj, void *event_info);
  27
  28 static void
  29 _del_hook(Evas_Object *obj)
  30 {
  31    Widget_Data *wd = elm_widget_data_get(obj);
  32    if (!wd) return;
  33    free(wd);
  34 }
  35
  36 static void
  37 _theme_hook(Evas_Object *obj)
  38 {
  39    Widget_Data *wd = elm_widget_data_get(obj);
  40    if (!wd) return;
  41    _sizing_eval(obj);
  42 }
  43
  44 static void
  45 _sizing_eval(Evas_Object *obj)
  46 {
  47    Widget_Data *wd = elm_widget_data_get(obj);
  48    Evas_Coord minw = -1, minh = -1;
  49    Evas_Coord maxw = -1, maxh = -1;
  50    if (!wd) return;
  51    if (wd->content)
  52      {
  53         evas_object_size_hint_min_get(wd->content, &minw, &minh);
  54         evas_object_size_hint_max_get(wd->content, &maxw, &maxh);
  55      }
  56    evas_object_size_hint_min_set(obj, minw, minh);
  57    evas_object_size_hint_max_set(obj, maxw, maxh);
  58 }
  59
  60 static void
  61 _changed_size_hints(void *data, Evas *e __UNUSED__, Evas_Object *obj __UNUSED__, void *event_info __UNUSED__)
  62 {
  63    Widget_Data *wd = elm_widget_data_get(data);
  64    if (!wd) return;
  65    _sizing_eval(data);
  66 }
  67
  68 static void
  69 _sub_del(void *data __UNUSED__, Evas_Object *obj, void *event_info)
  70 {
  71    Widget_Data *wd = elm_widget_data_get(obj);
  72    Evas_Object *sub = event_info;
  73    if (!wd) return;
  74    if (sub == wd->content)
  75      {
  76         evas_object_event_callback_del_full(sub, EVAS_CALLBACK_CHANGED_SIZE_HINTS,
  77                                             _changed_size_hints, obj);
  78         wd->content = NULL;
  79         _sizing_eval(obj);
  80      }
  81 }
  82
  83 static void
  84 _mapbuf(Evas_Object *obj)
  85 {
  86    Widget_Data *wd = elm_widget_data_get(obj);
  87    Evas_Coord x, y, w, h;
  88    if (!wd) return;
  89    evas_object_geometry_get(obj, &x, &y, &w, &h);
  90    if (wd->enabled)
  91      {
  92         Evas_Map *m;
  93
  94         m = evas_map_new(4);
  95         evas_map_util_points_populate_from_geometry(m, x, y, w, h, 0);
  96         evas_map_smooth_set(m, wd->smooth);
  97         evas_map_alpha_set(m, wd->alpha);
  98         evas_object_map_set(wd->content, m);
  99         evas_object_map_enable_set(wd->content, wd->enabled);
 100         evas_map_free(m);
 101      }
 102    else
 103      {
 104         evas_object_map_set(wd->content, NULL);
 105         evas_object_map_enable_set(wd->content, 0);
 106         evas_object_move(wd->content, x, y);
 107         evas_object_resize(wd->content, w, h);
 108      }
 109 }
 110
 111 static void
 112 _configure(Evas_Object *obj)
 113 {
 114    Widget_Data *wd = elm_widget_data_get(obj);
 115    if (!wd) return;
 116    if (wd->content)
 117      {
 118         Evas_Coord x, y, w, h;
 119
 120         evas_object_geometry_get(obj, &x, &y, &w, &h);
 121         if (!wd->enabled) evas_object_move(wd->content, x, y);
 122         evas_object_resize(wd->content, w, h);
 123         _mapbuf(obj);
 124      }
 125 }
 126
 127 static void
 128 _move(void *data __UNUSED__, Evas *e __UNUSED__, Evas_Object *obj, void *event_info __UNUSED__)
 129 {
 130    _configure(obj);
 131 }
 132
 133 static void
 134 _resize(void *data __UNUSED__, Evas *e __UNUSED__, Evas_Object *obj, void *event_info __UNUSED__)
 135 {
 136    _configure(obj);
 137 }
 138
 139 /**
 140  * Add a new mapbuf to the parent
 141  *
 142  * @param parent The parent object
 143  * @return The new object or NULL if it cannot be created
 144  *
 145  * @ingroup Mapbuf
 146  */
 147 EAPI Evas_Object *
 148 elm_mapbuf_add(Evas_Object *parent)
 149 {
 150    Evas_Object *obj;
 151    Evas *e;
 152    Widget_Data *wd;
 153
 154    wd = ELM_NEW(Widget_Data);
 155    e = evas_object_evas_get(parent);
 156    obj = elm_widget_add(e);
 157    ELM_SET_WIDTYPE(widtype, "mapbuf");
 158    elm_widget_type_set(obj, "mapbuf");
 159    elm_widget_sub_object_add(parent, obj);
 160    elm_widget_data_set(obj, wd);
 161    elm_widget_del_hook_set(obj, _del_hook);
 162    elm_widget_theme_hook_set(obj, _theme_hook);
 163
 164    evas_object_smart_callback_add(obj, "sub-object-del", _sub_del, obj);
 165    evas_object_event_callback_add(obj, EVAS_CALLBACK_MOVE, _move, NULL);
 166    evas_object_event_callback_add(obj, EVAS_CALLBACK_RESIZE, _resize, NULL);
 167
 168    wd->enabled = 0;
 169    wd->alpha = 1;
 170    wd->smooth = 1;
 171
 172    _sizing_eval(obj);
 173    return obj;
 174 }
 175
 176 /**
 177  * Set the mapbuf front content
 178  *
 179  * Once the content object is set, a previously set one will be deleted.
 180  * If you want to keep that old content object, use the
 181  * elm_mapbuf_content_unset() function.
 182  *
 183  * @param obj The mapbuf object
 184  * @param content The content will be filled in this mapbuf object
 185  *
 186  * @ingroup Mapbuf
 187  */
 188 EAPI void
 189 elm_mapbuf_content_set(Evas_Object *obj, Evas_Object *content)
 190 {
 191    ELM_CHECK_WIDTYPE(obj, widtype);
 192    Widget_Data *wd = elm_widget_data_get(obj);
 193    if (!wd) return;
 194    if (wd->content == content) return;
 195    if (wd->content) evas_object_del(wd->content);
 196    wd->content = content;
 197    if (content)
 198      {
 199         elm_widget_sub_object_add(content, obj);
 200         evas_object_smart_member_add(content, obj);
 201         evas_object_clip_set(content, evas_object_clip_get(obj));
 202         evas_object_event_callback_add(content,
 203                                        EVAS_CALLBACK_CHANGED_SIZE_HINTS,
 204                                        _changed_size_hints, obj);
 205      }
 206    _sizing_eval(obj);
 207    _configure(obj);
 208 }
 209
 210 /**
 211  * Unset the mapbuf front content
 212  *
 213  * Unparent and return the content object which was set for this widget.
 214  *
 215  * @param obj The mapbuf object
 216  * @return The content that was being used
 217  *
 218  * @ingroup Mapbuf
 219  */
 220 EAPI Evas_Object *
 221 elm_mapbuf_content_unset(Evas_Object *obj)
 222 {
 223    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
 224    Widget_Data *wd = elm_widget_data_get(obj);
 225    Evas_Object *content;
 226    if (!wd) return NULL;
 227    if (!wd->content) return NULL;
 228    content = wd->content;
 229    elm_widget_sub_object_del(obj, wd->content);
 230    evas_object_smart_member_del(wd->content);
 231    evas_object_clip_unset(wd->content);
 232    wd->content = NULL;
 233    return content;
 234 }
 235
 236 /**
 237  * Set the mapbuf enabled state
 238  *
 239  * @param obj The mapbuf object
 240  * @param enabled The value to set the enabled state to
 241  *
 242  * @ingroup Mapbuf
 243  */
 244 EAPI void
 245 elm_mapbuf_enabled_set(Evas_Object *obj, Eina_Bool enabled)
 246 {
 247    ELM_CHECK_WIDTYPE(obj, widtype);
 248    Widget_Data *wd = elm_widget_data_get(obj);
 249    if (!wd) return;
 250    if (wd->enabled == enabled) return;
 251    wd->enabled = enabled;
 252    _configure(obj);
 253 }
 254
 255 /**
 256  * Get the mapbuf enabled state
 257  *
 258  * @param obj The mapbuf object
 259  * @return The value that the enabled state is set to
 260  *
 261  * @ingroup Mapbuf
 262  */
 263 EAPI Eina_Bool
 264 elm_mapbuf_enabled_get(const Evas_Object *obj)
 265 {
 266    ELM_CHECK_WIDTYPE(obj, widtype) EINA_FALSE;
 267    Widget_Data *wd = elm_widget_data_get(obj);
 268    if (!wd) return EINA_FALSE;
 269    return wd->enabled;
 270 }
 271
 272 /**
 273  * Sets the mapbuf smooth state
 274  *
 275  * @param obj The mapbuf object
 276  * @param smooth The value of the smooth state of @p obj
 277  *
 278  * @ingroup Mapbuf
 279  */
 280 EAPI void
 281 elm_mapbuf_smooth_set(Evas_Object *obj, Eina_Bool smooth)
 282 {
 283    ELM_CHECK_WIDTYPE(obj, widtype);
 284    Widget_Data *wd = elm_widget_data_get(obj);
 285    if (!wd) return;
 286    if (wd->smooth == smooth) return;
 287    wd->smooth = smooth;
 288    _configure(obj);
 289 }
 290
 291 /**
 292  * Gets the mapbuf smooth state
 293  *
 294  * @param obj The mapbuf object
 295  * @return The value of the smooth state of @p obj
 296  *
 297  * @ingroup Mapbuf
 298  */
 299 EAPI Eina_Bool
 300 elm_mapbuf_smooth_get(const Evas_Object *obj)
 301 {
 302    ELM_CHECK_WIDTYPE(obj, widtype) EINA_FALSE;
 303    Widget_Data *wd = elm_widget_data_get(obj);
 304    if (!wd) return EINA_FALSE;
 305    return wd->smooth;
 306 }
 307
 308 /**
 309  * Enables/disables the mapbuf alpha channel
 310  *
 311  * @param obj The mapbuf object
 312  * @param alpha The state of the alpha channel
 313  *
 314  * @ingroup Mapbuf
 315  */
 316 EAPI void
 317 elm_mapbuf_alpha_set(Evas_Object *obj, Eina_Bool alpha)
 318 {
 319    ELM_CHECK_WIDTYPE(obj, widtype);
 320    Widget_Data *wd = elm_widget_data_get(obj);
 321    if (!wd) return;
 322    if (wd->alpha == alpha) return;
 323    wd->alpha = alpha;
 324    _configure(obj);
 325 }
 326
 327 /**
 328  * Gets the state of the mapbuf alpha channel
 329  *
 330  * @param obj The mapbuf object
 331  * @return The state of the alpha channel
 332  *
 333  * @ingroup Mapbuf
 334  */
 335 EAPI Eina_Bool
 336 elm_mapbuf_alpha_get(const Evas_Object *obj)
 337 {
 338    ELM_CHECK_WIDTYPE(obj, widtype) EINA_FALSE;
 339    Widget_Data *wd = elm_widget_data_get(obj);
 340    if (!wd) return EINA_FALSE;
 341    return wd->alpha;
 342 }