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_event_callback_add(content, EVAS_CALLBACK_CHANGED_SIZE_HINTS,
 202                                        _changed_size_hints, obj);
 203      }
 204    _sizing_eval(obj);
 205    _configure(obj);
 206 }
 207
 208 /**
 209  * Unset the mapbuf front content
 210  *
 211  * Unparent and return the content object which was set for this widget.
 212  *
 213  * @param obj The mapbuf object
 214  * @return The content that was being used
 215  *
 216  * @ingroup Mapbuf
 217  */
 218 EAPI Evas_Object *
 219 elm_mapbuf_content_unset(Evas_Object *obj)
 220 {
 221    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
 222    Widget_Data *wd = elm_widget_data_get(obj);
 223    Evas_Object *content;
 224    if (!wd) return NULL;
 225    if (!wd->content) return NULL;
 226    content = wd->content;
 227    elm_widget_sub_object_del(obj, wd->content);
 228    evas_object_smart_member_del(wd->content);
 229    wd->content = NULL;
 230    return content;
 231 }
 232
 233 /**
 234  * Set the mapbuf enabled state
 235  *
 236  * @param obj The mapbuf object
 237  * @param enabled The value to set the enabled state to
 238  *
 239  * @ingroup Mapbuf
 240  */
 241 EAPI void
 242 elm_mapbuf_enabled_set(Evas_Object *obj, Eina_Bool enabled)
 243 {
 244    ELM_CHECK_WIDTYPE(obj, widtype);
 245    Widget_Data *wd = elm_widget_data_get(obj);
 246    if (!wd) return;
 247    if (wd->enabled == enabled) return;
 248    wd->enabled = enabled;
 249    _configure(obj);
 250 }
 251
 252 /**
 253  * Get the mapbuf enabled state
 254  *
 255  * @param obj The mapbuf object
 256  * @return The value that the enabled state is set to
 257  *
 258  * @ingroup Mapbuf
 259  */
 260 EAPI Eina_Bool
 261 elm_mapbuf_enabled_get(const Evas_Object *obj)
 262 {
 263    ELM_CHECK_WIDTYPE(obj, widtype) EINA_FALSE;
 264    Widget_Data *wd = elm_widget_data_get(obj);
 265    if (!wd) return EINA_FALSE;
 266    return wd->enabled;
 267 }
 268
 269 /**
 270  * Sets the mapbuf smooth state
 271  *
 272  * @param obj The mapbuf object
 273  * @param smooth The value of the smooth state of @p obj
 274  *
 275  * @ingroup Mapbuf
 276  */
 277 EAPI void
 278 elm_mapbuf_smooth_set(Evas_Object *obj, Eina_Bool smooth)
 279 {
 280    ELM_CHECK_WIDTYPE(obj, widtype);
 281    Widget_Data *wd = elm_widget_data_get(obj);
 282    if (!wd) return;
 283    if (wd->smooth == smooth) return;
 284    wd->smooth = smooth;
 285    _configure(obj);
 286 }
 287
 288 /**
 289  * Gets the mapbuf smooth state
 290  *
 291  * @param obj The mapbuf object
 292  * @return The value of the smooth state of @p obj
 293  *
 294  * @ingroup Mapbuf
 295  */
 296 EAPI Eina_Bool
 297 elm_mapbuf_smooth_get(const Evas_Object *obj)
 298 {
 299    ELM_CHECK_WIDTYPE(obj, widtype) EINA_FALSE;
 300    Widget_Data *wd = elm_widget_data_get(obj);
 301    if (!wd) return EINA_FALSE;
 302    return wd->smooth;
 303 }
 304
 305 /**
 306  * Enables/disables the mapbuf alpha channel
 307  *
 308  * @param obj The mapbuf object
 309  * @param alpha The state of the alpha channel
 310  *
 311  * @ingroup Mapbuf
 312  */
 313 EAPI void
 314 elm_mapbuf_alpha_set(Evas_Object *obj, Eina_Bool alpha)
 315 {
 316    ELM_CHECK_WIDTYPE(obj, widtype);
 317    Widget_Data *wd = elm_widget_data_get(obj);
 318    if (!wd) return;
 319    if (wd->alpha == alpha) return;
 320    wd->alpha = alpha;
 321    _configure(obj);
 322 }
 323
 324 /**
 325  * Gets the state of the mapbuf alpha channel
 326  *
 327  * @param obj The mapbuf object
 328  * @return The state of the alpha channel
 329  *
 330  * @ingroup Mapbuf
 331  */
 332 EAPI Eina_Bool
 333 elm_mapbuf_alpha_get(const Evas_Object *obj)
 334 {
 335    ELM_CHECK_WIDTYPE(obj, widtype) EINA_FALSE;
 336    Widget_Data *wd = elm_widget_data_get(obj);
 337    if (!wd) return EINA_FALSE;
 338    return wd->alpha;
 339 }