src/lib/elm_slideshow.c

   1 #include <Elementary.h>
   2 #include "elm_priv.h"
   3
   4 /**
   5  * @defgroup Slideshow slideshow
   6  *
   7  * This object display a list of object (generally a list of images) and some actions like
   8  * next/previous are used to navigate. The animations are defined in the theme,
   9  * consequently new animations can be added without having to update the
  10  * applications.
  11  *
  12  * The slideshow use 2 callbacks to create and delete the objects displayed. When an item
  13  * is displayed the function itc->func.get() is called. This function should create the object,
  14  * for example the object can be an evas_object_image or a photocam. When a object is no more
  15  * displayed the function itc->func.del() is called, the user can delete the dana associated to the item.
  16  */
  17
  18 typedef struct _Widget_Data Widget_Data;
  19
  20 struct _Elm_Slideshow_Item
  21 {
  22    Elm_Widget_Item base;
  23
  24    Eina_List *l, *l_built;
  25
  26    const Elm_Slideshow_Item_Class *itc;
  27 };
  28
  29 struct _Widget_Data
  30 {
  31    Evas_Object *slideshow;
  32
  33    // list of Elm_Slideshow_Item*
  34    Eina_List *items;
  35    Eina_List *items_built;
  36
  37    Elm_Slideshow_Item *current;
  38    Elm_Slideshow_Item *previous;
  39
  40    Eina_List *transitions;
  41    const char *transition;
  42
  43    Ecore_Timer *timer;
  44    double timeout;
  45    Eina_Bool loop:1;
  46
  47    struct {
  48            const char *current;
  49            Eina_List *list; //list of const char *
  50    } layout;
  51 };
  52
  53 static const char *widtype = NULL;
  54 static void _del_hook(Evas_Object *obj);
  55 static void _mirrored_set(Evas_Object *obj, Eina_Bool rtl);
  56 static void _theme_hook(Evas_Object *obj);
  57 static void _sizing_eval(Evas_Object *obj);
  58 static void _changed_size_hints(void *data, Evas *e, Evas_Object *obj, void *event_info);
  59 static Eina_Bool _timer_cb(void *data);
  60 static void _on_focus_hook(void *data, Evas_Object *obj);
  61 static Eina_Bool _event_hook(Evas_Object *obj, Evas_Object *src,
  62                              Evas_Callback_Type type, void *event_info);
  63
  64 static Eina_Bool
  65 _event_hook(Evas_Object *obj, Evas_Object *src __UNUSED__, Evas_Callback_Type type, void *event_info)
  66 {
  67    if (type != EVAS_CALLBACK_KEY_DOWN) return EINA_FALSE;
  68    Evas_Event_Key_Down *ev = event_info;
  69    Widget_Data *wd = elm_widget_data_get(obj);
  70    if (!wd) return EINA_FALSE;
  71    if (ev->event_flags & EVAS_EVENT_FLAG_ON_HOLD) return EINA_FALSE;
  72    if (elm_widget_disabled_get(obj)) return EINA_FALSE;
  73    if ((!strcmp(ev->keyname, "Left")) || (!strcmp(ev->keyname, "KP_Left")))
  74      {
  75         elm_slideshow_previous(obj);
  76         ev->event_flags |= EVAS_EVENT_FLAG_ON_HOLD;
  77         return EINA_TRUE;
  78      }
  79    if ((!strcmp(ev->keyname, "Right")) || (!strcmp(ev->keyname, "KP_Right")))
  80      {
  81         elm_slideshow_next(obj);
  82         ev->event_flags |= EVAS_EVENT_FLAG_ON_HOLD;
  83         return EINA_TRUE;
  84      }
  85    if ((!strcmp(ev->keyname, "Return")) ||
  86        (!strcmp(ev->keyname, "KP_Enter")) ||
  87        (!strcmp(ev->keyname, "space")))
  88      {
  89         if (wd->timeout)
  90           {
  91              if (wd->timer)
  92                {
  93                   ecore_timer_del(wd->timer);
  94                   wd->timer = NULL;
  95                }
  96              else
  97                elm_slideshow_timeout_set(obj, wd->timeout);
  98           }
  99         ev->event_flags |= EVAS_EVENT_FLAG_ON_HOLD;
 100         return EINA_TRUE;
 101      }
 102    return EINA_FALSE;
 103 }
 104
 105 static void
 106 _del_hook(Evas_Object *obj)
 107 {
 108    const char *layout;
 109    Widget_Data *wd = elm_widget_data_get(obj);
 110    if (!wd) return;
 111    elm_slideshow_clear(obj);
 112    elm_widget_stringlist_free(wd->transitions);
 113    if (wd->timer) ecore_timer_del(wd->timer);
 114    EINA_LIST_FREE(wd->layout.list, layout)
 115            eina_stringshare_del(layout);
 116    free(wd);
 117 }
 118
 119 static void
 120 _on_focus_hook(void *data __UNUSED__, Evas_Object *obj)
 121 {
 122    Widget_Data *wd = elm_widget_data_get(obj);
 123    if (!wd) return;
 124    if (elm_widget_focus_get(obj))
 125      {
 126        edje_object_signal_emit(wd->slideshow, "elm,action,focus", "elm");
 127        evas_object_focus_set(wd->slideshow, EINA_TRUE);
 128      }
 129    else
 130      {
 131        edje_object_signal_emit(wd->slideshow, "elm,action,unfocus", "elm");
 132        evas_object_focus_set(wd->slideshow, EINA_FALSE);
 133      }
 134 }
 135
 136 static void
 137 _mirrored_set(Evas_Object *obj, Eina_Bool rtl)
 138 {
 139    Widget_Data *wd = elm_widget_data_get(obj);
 140    if (!wd) return;
 141    edje_object_mirrored_set(wd->slideshow, rtl);
 142 }
 143
 144 static void
 145 _theme_hook(Evas_Object *obj)
 146 {
 147    Widget_Data *wd = elm_widget_data_get(obj);
 148    if (!wd) return;
 149    _elm_widget_mirrored_reload(obj);
 150    _mirrored_set(obj, elm_widget_mirrored_get(obj));
 151    _elm_theme_object_set(obj, wd->slideshow, "slideshow", "base", elm_widget_style_get(obj));
 152    edje_object_scale_set(wd->slideshow, elm_widget_scale_get(obj) *
 153                          _elm_config->scale);
 154    _sizing_eval(obj);
 155 }
 156
 157 static void
 158 _sizing_eval(Evas_Object *obj)
 159 {
 160    Widget_Data *wd = elm_widget_data_get(obj);
 161    Evas_Coord minw = -1, minh = -1;
 162    if (!wd) return;
 163    edje_object_size_min_calc(wd->slideshow, &minw, &minh);
 164    evas_object_size_hint_min_set(obj, minw, minh);
 165    evas_object_size_hint_max_set(obj, minw, minh);
 166 }
 167
 168
 169 static Elm_Slideshow_Item* _item_prev_get(Elm_Slideshow_Item* item)
 170 {
 171         Widget_Data *wd = elm_widget_data_get(item->base.widget);
 172         Elm_Slideshow_Item* prev = eina_list_data_get(eina_list_prev(item->l));
 173         if((!prev) && (wd->loop))
 174                 prev = eina_list_data_get(eina_list_last(item->l));
 175         return prev;
 176 }
 177
 178 static Elm_Slideshow_Item* _item_next_get(Elm_Slideshow_Item* item)
 179 {
 180         Widget_Data *wd = elm_widget_data_get(item->base.widget);
 181         Elm_Slideshow_Item* next = eina_list_data_get(eina_list_next(item->l));
 182         if((!next) && (wd->loop))
 183                 next = eina_list_data_get(wd->items);
 184         return next;
 185 }
 186
 187
 188 static void
 189 _changed_size_hints(void *data, Evas *e __UNUSED__, Evas_Object *obj __UNUSED__, void *event_info __UNUSED__)
 190 {
 191    _sizing_eval(data);
 192 }
 193
 194 static void
 195 _sub_del(void *data __UNUSED__, Evas_Object *obj __UNUSED__, void *event_info __UNUSED__)
 196 {
 197    ;
 198 }
 199
 200 static void
 201 _item_realize(Elm_Slideshow_Item *item)
 202 {
 203    Elm_Slideshow_Item *_item;
 204    Evas_Object *obj = item->base.widget;
 205    Widget_Data *wd = elm_widget_data_get(obj);
 206
 207    if (!wd) return;
 208    if ((!item->base.view) && (item->itc->func.get))
 209      {
 210         item->base.view = item->itc->func.get((void*)item->base.data, obj);
 211         evas_object_smart_member_add(item->base.view, obj);
 212         item->l_built = eina_list_append(NULL, item);
 213         wd->items_built = eina_list_merge(wd->items_built, item->l_built);
 214         evas_object_hide(item->base.view);
 215      }
 216    else if (item->l_built)
 217      wd->items_built = eina_list_demote_list(wd->items_built, item->l_built);
 218
 219    //pre-create previous and next item
 220    _item = _item_next_get(item);
 221    if ((_item) && (!_item->base.view) && (_item->itc->func.get))
 222      {
 223         _item->base.view = _item->itc->func.get((void*)_item->base.data, obj);
 224         evas_object_smart_member_add(_item->base.view, obj);
 225         _item->l_built = eina_list_append(NULL, _item);
 226         wd->items_built = eina_list_merge(wd->items_built, _item->l_built);
 227         evas_object_hide(_item->base.view);
 228      }
 229    else if ((_item) && (_item->l_built))
 230      wd->items_built = eina_list_demote_list(wd->items_built, _item->l_built);
 231
 232    _item = _item_prev_get(item);
 233    if ((_item) && (!_item->base.view) && (_item->itc->func.get))
 234      {
 235         _item->base.view = _item->itc->func.get((void*)_item->base.data, obj);
 236         evas_object_smart_member_add(_item->base.view, obj);
 237         _item->l_built = eina_list_append(NULL, _item);
 238         wd->items_built = eina_list_merge(wd->items_built, _item->l_built);
 239         evas_object_hide(_item->base.view);
 240      }
 241    else if ((_item) && (_item->l_built))
 242      wd->items_built = eina_list_demote_list(wd->items_built, _item->l_built);
 243
 244    //delete unused items
 245    while (eina_list_count(wd->items_built) > 3)
 246      {
 247         _item = eina_list_data_get(wd->items_built);
 248         wd->items_built = eina_list_remove_list(wd->items_built, wd->items_built);
 249         if(item->itc->func.del)
 250           item->itc->func.del((void*)item->base.data, _item->base.view);
 251         evas_object_del(_item->base.view);
 252         _item->base.view = NULL;
 253      }
 254 }
 255
 256 static void
 257 _end(void *data, Evas_Object *obj __UNUSED__, const char *emission __UNUSED__, const char *source __UNUSED__)
 258 {
 259         Elm_Slideshow_Item *item;
 260         Widget_Data *wd = elm_widget_data_get(data);
 261         if (!wd) return;
 262
 263         item = wd->previous;
 264         if(item)
 265         {
 266                 edje_object_part_unswallow(NULL, item->base.view);
 267                 evas_object_hide(item->base.view);
 268                 wd->previous = NULL;
 269         }
 270
 271
 272         item = wd->current;
 273         if ((!item) || (!item->base.view)) return;
 274
 275         _item_realize(item);
 276         edje_object_part_unswallow(NULL, item->base.view);
 277         evas_object_show(item->base.view);
 278
 279         edje_object_signal_emit(wd->slideshow, "anim,end", "slideshow");
 280         edje_object_part_swallow(wd->slideshow, "elm.swallow.1", item->base.view);
 281 }
 282
 283
 284 static Eina_Bool
 285 _timer_cb(void *data)
 286 {
 287    Evas_Object *obj = data;
 288    Widget_Data *wd = elm_widget_data_get(obj);
 289    if (!wd) return ECORE_CALLBACK_CANCEL;
 290    wd->timer = NULL;
 291    elm_slideshow_next(obj);
 292    return ECORE_CALLBACK_CANCEL;
 293 }
 294
 295
 296
 297 /**
 298  * Add a new slideshow to the parent
 299  *
 300  * @param parent The parent object
 301  * @return The new object or NULL if it cannot be created
 302  *
 303  * @ingroup Slideshow
 304  */
 305 EAPI Evas_Object *
 306 elm_slideshow_add(Evas_Object *parent)
 307 {
 308    Evas_Object *obj;
 309    Evas *e;
 310    Widget_Data *wd;
 311
 312    EINA_SAFETY_ON_NULL_RETURN_VAL(parent, NULL);
 313
 314    wd = ELM_NEW(Widget_Data);
 315    e = evas_object_evas_get(parent);
 316    if (!e) return NULL;
 317    obj = elm_widget_add(e);
 318    ELM_SET_WIDTYPE(widtype, "slideshow");
 319    elm_widget_type_set(obj, "slideshow");
 320    elm_widget_sub_object_add(parent, obj);
 321    elm_widget_on_focus_hook_set(obj, _on_focus_hook, NULL);
 322    elm_widget_data_set(obj, wd);
 323    elm_widget_del_hook_set(obj, _del_hook);
 324    elm_widget_theme_hook_set(obj, _theme_hook);
 325    elm_widget_can_focus_set(obj, EINA_TRUE);
 326    elm_widget_event_hook_set(obj, _event_hook);
 327
 328    wd->current = NULL;
 329    wd->previous = NULL;
 330
 331    wd->slideshow = edje_object_add(e);
 332    _elm_theme_object_set(obj, wd->slideshow, "slideshow", "base", "default");
 333    evas_object_smart_member_add(wd->slideshow, obj);
 334    elm_widget_resize_object_set(obj, wd->slideshow);
 335    evas_object_show(wd->slideshow);
 336
 337    wd->transitions = elm_widget_stringlist_get(edje_object_data_get(wd->slideshow, "transitions"));
 338    if (eina_list_count(wd->transitions) > 0)
 339      wd->transition = eina_stringshare_add(eina_list_data_get(wd->transitions));
 340
 341    wd->layout.list = elm_widget_stringlist_get(edje_object_data_get(wd->slideshow, "layouts"));
 342    if (eina_list_count(wd->layout.list) > 0)
 343        wd->layout.current = eina_list_data_get(wd->layout.list);
 344
 345    edje_object_signal_callback_add(wd->slideshow, "end", "slideshow", _end, obj);
 346
 347    evas_object_smart_callback_add(obj, "sub-object-del", _sub_del, obj);
 348    evas_object_event_callback_add(obj, EVAS_CALLBACK_CHANGED_SIZE_HINTS, _changed_size_hints, obj);
 349
 350    _mirrored_set(obj, elm_widget_mirrored_get(obj));
 351    _sizing_eval(obj);
 352    return obj;
 353 }
 354
 355 /**
 356  * Add a object in the list. The object can be a evas object image or a elm photo for example.
 357  *
 358  * @param obj The slideshow object
 359  * @aram itc Callbacks used to create the object and delete the data associated when the item is deleted.
 360  * @param data Data used by the user to identified the item
 361  * @return Returns The slideshow item
 362  *
 363  * @ingroup Slideshow
 364  */
 365 EAPI Elm_Slideshow_Item*
 366 elm_slideshow_item_add(Evas_Object *obj, const Elm_Slideshow_Item_Class *itc, const void *data)
 367 {
 368    Elm_Slideshow_Item *item;
 369    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
 370    Widget_Data *wd = elm_widget_data_get(obj);
 371
 372    if (!wd) return NULL;
 373    item = elm_widget_item_new(obj, Elm_Slideshow_Item);
 374    item->base.data = data;
 375    item->itc = itc;
 376    item->l = eina_list_append(item->l, item);
 377
 378    wd->items = eina_list_merge(wd->items, item->l);
 379
 380    if (!wd->current) elm_slideshow_show(item);
 381
 382    return item;
 383 }
 384
 385 /**
 386  * Go to the item
 387  *
 388  * @param obj The slideshow object
 389  * @param item The item
 390  *
 391  * @ingroup Slideshow
 392  */
 393 EAPI void
 394 elm_slideshow_show(Elm_Slideshow_Item *item)
 395 {
 396    char buf[1024];
 397    Elm_Slideshow_Item *next = NULL;
 398    Widget_Data *wd;
 399    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item);
 400    wd = elm_widget_data_get(item->base.widget);
 401    if (!wd)
 402      return;
 403    if (item == wd->current)
 404      return;
 405
 406    next = item;
 407    _end(item->base.widget, item->base.widget, NULL, NULL);
 408
 409    if (wd->timer) ecore_timer_del(wd->timer);
 410    if (wd->timeout > 0.0)
 411            wd->timer = ecore_timer_add(wd->timeout, _timer_cb, item->base.widget);
 412    _item_realize(next);
 413    edje_object_part_swallow(wd->slideshow, "elm.swallow.2", next->base.view);
 414    evas_object_show(next->base.view);
 415    snprintf(buf, sizeof(buf), "%s,next", wd->transition);
 416    edje_object_signal_emit(wd->slideshow, buf, "slideshow");
 417    wd->previous = wd->current;
 418    wd->current = next;
 419    evas_object_smart_callback_call(item->base.widget, "changed", wd->current);
 420 }
 421
 422 /**
 423  * Go to the next item
 424  *
 425  * @param obj The slideshow object
 426  *
 427  * @ingroup Slideshow
 428  */
 429 EAPI void
 430 elm_slideshow_next(Evas_Object *obj)
 431 {
 432    char buf[1024];
 433    Elm_Slideshow_Item *next = NULL;
 434    ELM_CHECK_WIDTYPE(obj, widtype);
 435    Widget_Data *wd = elm_widget_data_get(obj);
 436
 437    if (!wd) return;
 438
 439    if (wd->current)
 440            next = _item_next_get(wd->current);
 441
 442    if ((!next) || (next == wd->current)) return;
 443
 444    _end(obj, obj, NULL, NULL);
 445
 446    if (wd->timer) ecore_timer_del(wd->timer);
 447    if (wd->timeout > 0.0)
 448            wd->timer = ecore_timer_add(wd->timeout, _timer_cb, obj);
 449
 450    _item_realize(next);
 451
 452    edje_object_part_swallow(wd->slideshow, "elm.swallow.2", next->base.view);
 453    evas_object_show(next->base.view);
 454
 455    snprintf(buf, sizeof(buf), "%s,next", wd->transition);
 456    edje_object_signal_emit(wd->slideshow, buf, "slideshow");
 457
 458    wd->previous = wd->current;
 459    wd->current = next;
 460    evas_object_smart_callback_call(obj, "changed", wd->current);
 461 }
 462
 463 /**
 464  * Go to the previous item
 465  *
 466  * @param obj The slideshow object
 467  *
 468  * @ingroup Slideshow
 469  */
 470 EAPI void
 471 elm_slideshow_previous(Evas_Object *obj)
 472 {
 473    char buf[1024];
 474    Elm_Slideshow_Item *prev = NULL;
 475    ELM_CHECK_WIDTYPE(obj, widtype);
 476    Widget_Data *wd = elm_widget_data_get(obj);
 477
 478    if (!wd) return;
 479
 480    if (wd->current)
 481      prev = _item_prev_get(wd->current);
 482
 483    if ((!prev) ||  (prev == wd->current)) return;
 484
 485    _end(obj, obj, NULL, NULL);
 486
 487    if (wd->timer) ecore_timer_del(wd->timer);
 488    if (wd->timeout > 0.0)
 489            wd->timer = ecore_timer_add(wd->timeout, _timer_cb, obj);
 490
 491    _item_realize(prev);
 492
 493    edje_object_part_swallow(wd->slideshow, "elm.swallow.2", prev->base.view);
 494    evas_object_show(prev->base.view);
 495
 496    snprintf(buf, 1024, "%s,previous", wd->transition);
 497    edje_object_signal_emit(wd->slideshow, buf, "slideshow");
 498
 499    wd->previous = wd->current;
 500    wd->current = prev;
 501    evas_object_smart_callback_call(obj, "changed", wd->current);
 502 }
 503
 504 /**
 505  * Returns the list of transitions available.
 506  *
 507  * @param obj The slideshow object
 508  * @return Returns the list of transitions (list of const char*)
 509  *
 510  * @ingroup Slideshow
 511  */
 512 EAPI const Eina_List *
 513 elm_slideshow_transitions_get(const Evas_Object *obj)
 514 {
 515    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
 516    Widget_Data *wd = elm_widget_data_get(obj);
 517    if (!wd) return NULL;
 518    return wd->transitions;
 519 }
 520
 521 /**
 522  * Returns the list of layouts available.
 523  *
 524  * @param obj The slideshow object
 525  * @return Returns the list of layout (list of const char*)
 526  *
 527  * @ingroup Slideshow
 528  */
 529 EAPI const Eina_List *
 530 elm_slideshow_layouts_get(const Evas_Object *obj)
 531 {
 532    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
 533    Widget_Data *wd = elm_widget_data_get(obj);
 534    if (!wd) return NULL;
 535    return wd->layout.list;
 536 }
 537
 538 /**
 539  * Set the transition to use
 540  *
 541  * @param obj The slideshow object
 542  * @param transition the new transition
 543  *
 544  * @ingroup Slideshow
 545  */
 546 EAPI void
 547 elm_slideshow_transition_set(Evas_Object *obj, const char *transition)
 548 {
 549    ELM_CHECK_WIDTYPE(obj, widtype);
 550    Widget_Data *wd = elm_widget_data_get(obj);
 551    if (!wd) return;
 552    eina_stringshare_replace(&wd->transition, transition);
 553 }
 554
 555 /**
 556  * Returns the transition to use
 557  *
 558  * @param obj The slideshow object
 559  * @return the transition set
 560  *
 561  * @ingroup Slideshow
 562  */
 563 EAPI const char *
 564 elm_slideshow_transition_get(const Evas_Object *obj)
 565 {
 566    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
 567    Widget_Data *wd = elm_widget_data_get(obj);
 568    if (!wd) return NULL;
 569    return wd->transition;
 570 }
 571
 572 /**
 573  * The slideshow can go to the next item automatically after a few seconds.
 574  * This method set the timeout to use. A timeout <=0 disable the timer.
 575  *
 576  * @param obj The slideshow object
 577  * @param timeout The new timeout
 578  *
 579  * @ingroup Slideshow
 580  */
 581 EAPI void
 582 elm_slideshow_timeout_set(Evas_Object *obj, double timeout)
 583 {
 584    ELM_CHECK_WIDTYPE(obj, widtype);
 585    Widget_Data *wd = elm_widget_data_get(obj);
 586    if (!wd) return;
 587    wd->timeout = timeout;
 588    if (wd->timer) ecore_timer_del(wd->timer);
 589    wd->timer = NULL;
 590    if (timeout > 0.0)
 591      wd->timer = ecore_timer_add(timeout, _timer_cb, obj);
 592 }
 593
 594 /**
 595  * Returns the timeout value
 596  *
 597  * @param obj The slideshow object
 598  * @return Returns the timeout
 599  *
 600  * @ingroup Slideshow
 601  */
 602 EAPI double
 603 elm_slideshow_timeout_get(const Evas_Object *obj)
 604 {
 605    ELM_CHECK_WIDTYPE(obj, widtype) -1.0;
 606    Widget_Data *wd = elm_widget_data_get(obj);
 607    if (!wd) return -1.0;
 608    return wd->timeout;
 609 }
 610
 611 /**
 612  * Set if the first item should follow the last and vice versa
 613  *
 614  * @param obj The slideshow object
 615  * @param loop if EINA_TRUE, the first item will follow the last and vice versa
 616  *
 617  * @ingroup Slideshow
 618  */
 619 EAPI void
 620 elm_slideshow_loop_set(Evas_Object *obj, Eina_Bool loop)
 621 {
 622    ELM_CHECK_WIDTYPE(obj, widtype);
 623    Widget_Data *wd = elm_widget_data_get(obj);
 624    if (!wd) return;
 625    wd->loop = loop;
 626 }
 627
 628 /**
 629  * Returns the current layout name
 630  *
 631  * @param obj The slideshow object
 632  * @returns Returns the layout name
 633  *
 634  * @ingroup Slideshow
 635  */
 636 EAPI const char *
 637 elm_slideshow_layout_get(const Evas_Object *obj)
 638 {
 639    ELM_CHECK_WIDTYPE(obj, widtype) EINA_FALSE;
 640    Widget_Data *wd = elm_widget_data_get(obj);
 641    if (!wd) return EINA_FALSE;
 642    return wd->layout.current;
 643 }
 644
 645 /**
 646  * Set the layout
 647  *
 648  * @param obj The slideshow object
 649  * @param layout the new layout
 650  *
 651  * @ingroup Slideshow
 652  */
 653 EAPI void
 654 elm_slideshow_layout_set(Evas_Object *obj, const char *layout)
 655 {
 656    char buf[PATH_MAX];
 657    ELM_CHECK_WIDTYPE(obj, widtype);
 658    Widget_Data *wd = elm_widget_data_get(obj);
 659    if (!wd) return;
 660
 661    wd->layout.current = layout;
 662    snprintf(buf, sizeof(buf), "layout,%s", layout);
 663    edje_object_signal_emit(wd->slideshow, buf, "slideshow");
 664 }
 665
 666 /**
 667  * Return if the first item should follow the last and vice versa
 668  *
 669  * @param obj The slideshow object
 670  * @returns Returns the loop flag
 671  *
 672  * @ingroup Slideshow
 673  */
 674 EAPI Eina_Bool
 675 elm_slideshow_loop_get(const Evas_Object *obj)
 676 {
 677    ELM_CHECK_WIDTYPE(obj, widtype) EINA_FALSE;
 678    Widget_Data *wd = elm_widget_data_get(obj);
 679    if (!wd) return EINA_FALSE;
 680    return wd->loop;
 681 }
 682
 683 /**
 684  * Delete all the items
 685  *
 686  * @param obj The slideshow object
 687  *
 688  * @ingroup Slideshow
 689  */
 690 EAPI void
 691 elm_slideshow_clear(Evas_Object *obj)
 692 {
 693         Elm_Slideshow_Item *item;
 694         ELM_CHECK_WIDTYPE(obj, widtype);
 695         Widget_Data *wd = elm_widget_data_get(obj);
 696         if (!wd) return;
 697         wd->previous = NULL;
 698         wd->current = NULL;
 699         EINA_LIST_FREE(wd->items_built, item)
 700         {
 701            if (item->itc->func.del)
 702              item->itc->func.del((void*)item->base.data, item->base.view);
 703            evas_object_del(item->base.view);
 704            item->base.view = NULL;
 705         }
 706
 707         EINA_LIST_FREE(wd->items, item)
 708           {
 709              elm_widget_item_del(item);
 710           }
 711 }
 712
 713
 714 /**
 715  * Delete the item
 716  *
 717  * @param item The slideshow item
 718  *
 719  * @ingroup Slideshow
 720  */
 721 EAPI void
 722 elm_slideshow_item_del(Elm_Slideshow_Item *item)
 723 {
 724    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item);
 725         Widget_Data *wd = elm_widget_data_get(item->base.widget);
 726         if (!wd) return;
 727         if (wd->previous == item) wd->previous = NULL;
 728         if (wd->current == item)
 729         {
 730                 Eina_List *l = eina_list_data_find_list(wd->items, item);
 731                 Eina_List *l2 = eina_list_next(l);
 732                 wd->current = NULL;
 733                 if (!l2)
 734                         l2 = eina_list_nth_list(wd->items, eina_list_count(wd->items) - 1);
 735                 if (l2)
 736                         elm_slideshow_show(eina_list_data_get(l2));
 737         }
 738
 739         wd->items = eina_list_remove_list(wd->items, item->l);
 740         wd->items_built = eina_list_remove_list(wd->items_built, item->l_built);
 741
 742         if ((item->base.view) && (item->itc->func.del))
 743                 item->itc->func.del((void*)item->base.data, item->base.view);
 744         if (item->base.view)
 745                 evas_object_del(item->base.view);
 746         free(item);
 747 }
 748
 749 /**
 750  * Returns the list of items
 751  * @param obj The slideshow object
 752  * @return Returns the list of items (list of Elm_Slideshow_Item).
 753  *
 754  * @ingroup Slideshow
 755  */
 756 EAPI const Eina_List *
 757 elm_slideshow_items_get(const Evas_Object *obj)
 758 {
 759    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
 760    Widget_Data *wd = elm_widget_data_get(obj);
 761    if (!wd) return NULL;
 762    return wd->items;
 763 }
 764
 765
 766 /**
 767  * Returns the current item displayed
 768  *
 769  * @param obj The slideshow object
 770  * @return Returns the current item displayed
 771  *
 772  * @ingroup Slideshow
 773  */
 774 EAPI Elm_Slideshow_Item *
 775 elm_slideshow_item_current_get(const Evas_Object *obj)
 776 {
 777    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
 778    Widget_Data *wd = elm_widget_data_get(obj);
 779    if (!wd) return NULL;
 780    return wd->current;
 781 }
 782
 783 /**
 784  * Returns the evas object associated to an item
 785  *
 786  * @param item The slideshow item
 787  * @return Returns the evas object associated to this item
 788  *
 789  * @ingroup Slideshow
 790  */
 791 EAPI Evas_Object *
 792 elm_slideshow_item_object_get(const Elm_Slideshow_Item * item)
 793 {
 794    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item, NULL);
 795    return item->base.view;
 796 }
 797
 798 /**
 799  * Returns the data associated to an item
 800  *
 801  * @param item The slideshow item
 802  * @return Returns the data associated to this item
 803  *
 804  * @ingroup Slideshow
 805  */
 806 EAPI void *
 807 elm_slideshow_item_data_get(const Elm_Slideshow_Item * item)
 808 {
 809    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item, NULL);
 810    return elm_widget_item_data_get(item);
 811 }