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  * Signals that you can add callbacks for are:
  18  *
  19  * "changed" - when the slideshow switch to another item
  20  */
  21
  22 typedef struct _Widget_Data Widget_Data;
  23
  24 struct _Elm_Slideshow_Item
  25 {
  26    Elm_Widget_Item base;
  27
  28    Eina_List *l, *l_built;
  29
  30    const Elm_Slideshow_Item_Class *itc;
  31 };
  32
  33 struct _Widget_Data
  34 {
  35    Evas_Object *slideshow;
  36
  37    // list of Elm_Slideshow_Item*
  38    Eina_List *items;
  39    Eina_List *items_built;
  40
  41    Elm_Slideshow_Item *current;
  42    Elm_Slideshow_Item *previous;
  43
  44    Eina_List *transitions;
  45    const char *transition;
  46
  47    Ecore_Timer *timer;
  48    double timeout;
  49    Eina_Bool loop:1;
  50
  51    struct {
  52         const char *current;
  53         Eina_List *list; //list of const char *
  54    } layout;
  55 };
  56
  57 static const char *widtype = NULL;
  58 static void _del_hook(Evas_Object *obj);
  59 static void _mirrored_set(Evas_Object *obj, Eina_Bool rtl);
  60 static void _theme_hook(Evas_Object *obj);
  61 static void _sizing_eval(Evas_Object *obj);
  62 static void _changed_size_hints(void *data, Evas *e, Evas_Object *obj, void *event_info);
  63 static Eina_Bool _timer_cb(void *data);
  64 static void _on_focus_hook(void *data, Evas_Object *obj);
  65 static Eina_Bool _event_hook(Evas_Object *obj, Evas_Object *src,
  66                              Evas_Callback_Type type, void *event_info);
  67
  68 static Eina_Bool
  69 _event_hook(Evas_Object *obj, Evas_Object *src __UNUSED__, Evas_Callback_Type type, void *event_info)
  70 {
  71    if (type != EVAS_CALLBACK_KEY_DOWN) return EINA_FALSE;
  72    Evas_Event_Key_Down *ev = event_info;
  73    Widget_Data *wd = elm_widget_data_get(obj);
  74    if (!wd) return EINA_FALSE;
  75    if (ev->event_flags & EVAS_EVENT_FLAG_ON_HOLD) return EINA_FALSE;
  76    if (elm_widget_disabled_get(obj)) return EINA_FALSE;
  77    if ((!strcmp(ev->keyname, "Left")) || (!strcmp(ev->keyname, "KP_Left")))
  78      {
  79         elm_slideshow_previous(obj);
  80         ev->event_flags |= EVAS_EVENT_FLAG_ON_HOLD;
  81         return EINA_TRUE;
  82      }
  83    if ((!strcmp(ev->keyname, "Right")) || (!strcmp(ev->keyname, "KP_Right")))
  84      {
  85         elm_slideshow_next(obj);
  86         ev->event_flags |= EVAS_EVENT_FLAG_ON_HOLD;
  87         return EINA_TRUE;
  88      }
  89    if ((!strcmp(ev->keyname, "Return")) ||
  90        (!strcmp(ev->keyname, "KP_Enter")) ||
  91        (!strcmp(ev->keyname, "space")))
  92      {
  93         if (wd->timeout)
  94           {
  95              if (wd->timer)
  96                {
  97                   ecore_timer_del(wd->timer);
  98                   wd->timer = NULL;
  99                }
 100              else
 101                elm_slideshow_timeout_set(obj, wd->timeout);
 102           }
 103         ev->event_flags |= EVAS_EVENT_FLAG_ON_HOLD;
 104         return EINA_TRUE;
 105      }
 106    return EINA_FALSE;
 107 }
 108
 109 static void
 110 _del_hook(Evas_Object *obj)
 111 {
 112    const char *layout;
 113    Widget_Data *wd = elm_widget_data_get(obj);
 114    if (!wd) return;
 115    elm_slideshow_clear(obj);
 116    elm_widget_stringlist_free(wd->transitions);
 117    if (wd->timer) ecore_timer_del(wd->timer);
 118    EINA_LIST_FREE(wd->layout.list, layout)
 119       eina_stringshare_del(layout);
 120    free(wd);
 121 }
 122
 123 static void
 124 _on_focus_hook(void *data __UNUSED__, Evas_Object *obj)
 125 {
 126    Widget_Data *wd = elm_widget_data_get(obj);
 127    if (!wd) return;
 128    if (elm_widget_focus_get(obj))
 129      {
 130         edje_object_signal_emit(wd->slideshow, "elm,action,focus", "elm");
 131         evas_object_focus_set(wd->slideshow, EINA_TRUE);
 132      }
 133    else
 134      {
 135         edje_object_signal_emit(wd->slideshow, "elm,action,unfocus", "elm");
 136         evas_object_focus_set(wd->slideshow, EINA_FALSE);
 137      }
 138 }
 139
 140 static void
 141 _mirrored_set(Evas_Object *obj, Eina_Bool rtl)
 142 {
 143    Widget_Data *wd = elm_widget_data_get(obj);
 144    if (!wd) return;
 145    edje_object_mirrored_set(wd->slideshow, rtl);
 146 }
 147
 148 static void
 149 _theme_hook(Evas_Object *obj)
 150 {
 151    Widget_Data *wd = elm_widget_data_get(obj);
 152    if (!wd) return;
 153    _elm_widget_mirrored_reload(obj);
 154    _mirrored_set(obj, elm_widget_mirrored_get(obj));
 155    _elm_theme_object_set(obj, wd->slideshow, "slideshow", "base", elm_widget_style_get(obj));
 156    edje_object_scale_set(wd->slideshow, elm_widget_scale_get(obj) *
 157                          _elm_config->scale);
 158    _sizing_eval(obj);
 159 }
 160
 161 static void
 162 _sizing_eval(Evas_Object *obj)
 163 {
 164    Widget_Data *wd = elm_widget_data_get(obj);
 165    Evas_Coord minw = -1, minh = -1;
 166    if (!wd) return;
 167    edje_object_size_min_calc(wd->slideshow, &minw, &minh);
 168    evas_object_size_hint_min_set(obj, minw, minh);
 169    evas_object_size_hint_max_set(obj, minw, minh);
 170 }
 171
 172
 173 static Elm_Slideshow_Item* _item_prev_get(Elm_Slideshow_Item* item)
 174 {
 175    Widget_Data *wd = elm_widget_data_get(item->base.widget);
 176    Elm_Slideshow_Item* prev = eina_list_data_get(eina_list_prev(item->l));
 177    if((!prev) && (wd->loop))
 178      prev = eina_list_data_get(eina_list_last(item->l));
 179    return prev;
 180 }
 181
 182 static Elm_Slideshow_Item* _item_next_get(Elm_Slideshow_Item* item)
 183 {
 184    Widget_Data *wd = elm_widget_data_get(item->base.widget);
 185    Elm_Slideshow_Item* next = eina_list_data_get(eina_list_next(item->l));
 186    if((!next) && (wd->loop))
 187      next = eina_list_data_get(wd->items);
 188    return next;
 189 }
 190
 191
 192 static void
 193 _changed_size_hints(void *data, Evas *e __UNUSED__, Evas_Object *obj __UNUSED__, void *event_info __UNUSED__)
 194 {
 195    _sizing_eval(data);
 196 }
 197
 198 static void
 199 _sub_del(void *data __UNUSED__, Evas_Object *obj __UNUSED__, void *event_info __UNUSED__)
 200 {
 201    ;
 202 }
 203
 204 static void
 205 _item_realize(Elm_Slideshow_Item *item)
 206 {
 207    Elm_Slideshow_Item *_item;
 208    Evas_Object *obj = item->base.widget;
 209    Widget_Data *wd = elm_widget_data_get(obj);
 210
 211    if (!wd) return;
 212    if ((!item->base.view) && (item->itc->func.get))
 213      {
 214         item->base.view = item->itc->func.get((void*)item->base.data, obj);
 215         evas_object_smart_member_add(item->base.view, obj);
 216         item->l_built = eina_list_append(NULL, item);
 217         wd->items_built = eina_list_merge(wd->items_built, item->l_built);
 218         evas_object_hide(item->base.view);
 219      }
 220    else if (item->l_built)
 221      wd->items_built = eina_list_demote_list(wd->items_built, item->l_built);
 222
 223    //pre-create previous and next item
 224    _item = _item_next_get(item);
 225    if ((_item) && (!_item->base.view) && (_item->itc->func.get))
 226      {
 227         _item->base.view = _item->itc->func.get((void*)_item->base.data, obj);
 228         evas_object_smart_member_add(_item->base.view, obj);
 229         _item->l_built = eina_list_append(NULL, _item);
 230         wd->items_built = eina_list_merge(wd->items_built, _item->l_built);
 231         evas_object_hide(_item->base.view);
 232      }
 233    else if ((_item) && (_item->l_built))
 234      wd->items_built = eina_list_demote_list(wd->items_built, _item->l_built);
 235
 236    _item = _item_prev_get(item);
 237    if ((_item) && (!_item->base.view) && (_item->itc->func.get))
 238      {
 239         _item->base.view = _item->itc->func.get((void*)_item->base.data, obj);
 240         evas_object_smart_member_add(_item->base.view, obj);
 241         _item->l_built = eina_list_append(NULL, _item);
 242         wd->items_built = eina_list_merge(wd->items_built, _item->l_built);
 243         evas_object_hide(_item->base.view);
 244      }
 245    else if ((_item) && (_item->l_built))
 246      wd->items_built = eina_list_demote_list(wd->items_built, _item->l_built);
 247
 248    //delete unused items
 249    while (eina_list_count(wd->items_built) > 3)
 250      {
 251         _item = eina_list_data_get(wd->items_built);
 252         wd->items_built = eina_list_remove_list(wd->items_built, wd->items_built);
 253         if(item->itc->func.del)
 254           item->itc->func.del((void*)item->base.data, _item->base.view);
 255         evas_object_del(_item->base.view);
 256         _item->base.view = NULL;
 257      }
 258 }
 259
 260 static void
 261 _end(void *data, Evas_Object *obj __UNUSED__, const char *emission __UNUSED__, const char *source __UNUSED__)
 262 {
 263    Elm_Slideshow_Item *item;
 264    Widget_Data *wd = elm_widget_data_get(data);
 265    if (!wd) return;
 266
 267    item = wd->previous;
 268    if(item)
 269      {
 270         edje_object_part_unswallow(NULL, item->base.view);
 271         evas_object_hide(item->base.view);
 272         wd->previous = NULL;
 273      }
 274
 275
 276    item = wd->current;
 277    if ((!item) || (!item->base.view)) return;
 278
 279    _item_realize(item);
 280    edje_object_part_unswallow(NULL, item->base.view);
 281    evas_object_show(item->base.view);
 282
 283    edje_object_signal_emit(wd->slideshow, "anim,end", "slideshow");
 284    edje_object_part_swallow(wd->slideshow, "elm.swallow.1", item->base.view);
 285 }
 286
 287
 288 static Eina_Bool
 289 _timer_cb(void *data)
 290 {
 291    Evas_Object *obj = data;
 292    Widget_Data *wd = elm_widget_data_get(obj);
 293    if (!wd) return ECORE_CALLBACK_CANCEL;
 294    wd->timer = NULL;
 295    elm_slideshow_next(obj);
 296    return ECORE_CALLBACK_CANCEL;
 297 }
 298
 299
 300
 301 /**
 302  * Add a new slideshow to the parent
 303  *
 304  * @param parent The parent object
 305  * @return The new object or NULL if it cannot be created
 306  *
 307  * @ingroup Slideshow
 308  */
 309 EAPI Evas_Object *
 310 elm_slideshow_add(Evas_Object *parent)
 311 {
 312    Evas_Object *obj;
 313    Evas *e;
 314    Widget_Data *wd;
 315
 316    ELM_WIDGET_STANDARD_SETUP(wd, Widget_Data, parent, e, obj, NULL);
 317
 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 }