} \
} while (0)
-/**
- *
- * @defgroup Transit Transit
- * @ingroup Elementary
- *
- * Transit (see Warning below) is designed to set the various effects for the
- * Evas_Object such like translation, rotation, etc. For using Effects, Create
- * transit and insert effects which are interesting.
- * Once effects are inserted into transit, transit will manage those effects.
- * (ex deleting).
- *
- * Example:
- * @code
- * Elm_Transit *trans = elm_transit_add();
- * elm_transit_object_add(trans, obj);
- * void *effect_context = elm_transit_effect_translation_context_new(0.0, 0.0,
- * 280.0, 280.0);
- * elm_transit_effect_add(transit,
- * elm_transit_effect_translation_op, effect_context,
- * elm_transit_effect_translation_context_free);
- * elm_transit_duration_set(transit, 1);
- * elm_transit_auto_reverse_set(transit, EINA_TRUE);
- * elm_transit_tween_mode_set(transit, ELM_TRANSIT_TWEEN_MODE_DECELERATE);
- * elm_transit_repeat_times_set(transit, 3);
- * @endcode
- *
- * @warning We strongly recomend to use elm_transit just when edje can not do
- * the trick. Edje has more advantage than Elm_Transit, it has more flexibility and
- * animations can be manipulated inside the theme.
- */
#define _TRANSIT_FOCAL 2000
Ecore_Animator *animator;
Eina_Inlist *effect_list;
Eina_List *objs;
- Eina_Hash *objs_data_hash;
Elm_Transit *prev_chain_transit;
Eina_List *next_chain_transits;
Elm_Transit_Tween_Mode tween_mode;
struct {
- Elm_Transit_Effect_End_Cb func;
+ Elm_Transit_Del_Cb func;
void *arg;
} del_data;
struct {
Eina_Bool event_enabled : 1;
Eina_Bool deleted : 1;
Eina_Bool state_keep : 1;
+ Eina_Bool finished : 1;
};
struct _Elm_Transit_Effect_Module
Eina_Bool deleted : 1;
};
-struct _Elm_Obj_State
+struct _Elm_Transit_Obj_State
{
Evas_Coord x, y, w, h;
int r,g,b,a;
Eina_Bool visible : 1;
};
-struct _Elm_Obj_Data
+struct _Elm_Transit_Obj_Data
{
- struct _Elm_Obj_State *state;
- Eina_Bool pass_events : 1;
+ struct _Elm_Transit_Obj_State *state;
+ Eina_Bool freeze_events : 1;
};
typedef struct _Elm_Transit_Effect_Module Elm_Transit_Effect_Module;
-typedef struct _Elm_Obj_Data Elm_Obj_Data;
-typedef struct _Elm_Obj_State Elm_Obj_State;
+typedef struct _Elm_Transit_Obj_Data Elm_Transit_Obj_Data;
+typedef struct _Elm_Transit_Obj_State Elm_Transit_Obj_State;
+
+static void _transit_obj_data_update(Elm_Transit *transit, Evas_Object *obj);
+static void _transit_obj_data_recover(Elm_Transit *transit, Evas_Object *obj);
+static void _transit_obj_states_save(Evas_Object *obj, Elm_Transit_Obj_Data *obj_data);
+static void _transit_obj_remove_cb(void *data, Evas *e __UNUSED__, Evas_Object *obj, void *event_info __UNUSED__);
+static void _transit_obj_remove(Elm_Transit *transit, Evas_Object *obj);
+static void _transit_effect_del(Elm_Transit *transit, Elm_Transit_Effect_Module *effect_module);
+static void _transit_remove_dead_effects(Elm_Transit *transit);
+static void _transit_chain_go(Elm_Transit *transit);
+static void _transit_del(Elm_Transit *transit);
+static Eina_Bool _transit_animate_op(Elm_Transit *transit, double progress);
+static Eina_Bool _transit_animate_cb(void *data);
+
+static char *_transit_key= "_elm_transit_key";
static void
-_elm_transit_obj_states_save(Evas_Object *obj, Elm_Obj_Data *obj_data)
+_transit_obj_data_update(Elm_Transit *transit, Evas_Object *obj)
{
- Elm_Obj_State *state;
+ Elm_Transit_Obj_Data *obj_data = evas_object_data_get(obj, _transit_key);
- if (obj_data->state) return;
- state = calloc(1, sizeof(Elm_Obj_State));
- if (!state) return;
- evas_object_geometry_get(obj, &state->x, &state->y, &state->w, &state->h);
- evas_object_color_get(obj, &state->r, &state->g, &state->b, &state->a);
- state->visible = evas_object_visible_get(obj);
- state->map_enabled = evas_object_map_enable_get(obj);
- if (evas_object_map_get(obj))
- state->map = evas_map_dup(evas_object_map_get(obj));
- obj_data->state = state;
-}
-
-static Eina_Bool
-_hash_foreach_pass_events_set(const Eina_Hash *hash __UNUSED__, const void *key, void *data __UNUSED__, void *fdata)
-{
- Elm_Transit *transit = fdata;
- evas_object_pass_events_set((Evas_Object*) key, transit->event_enabled);
- return EINA_TRUE;
-}
+ if (!obj_data)
+ obj_data = ELM_NEW(Elm_Transit_Obj_Data);
-static Eina_Bool
-_hash_foreach_obj_states_save(const Eina_Hash *hash __UNUSED__, const void *key, void *data, void *fdata __UNUSED__)
-{
- _elm_transit_obj_states_save((Evas_Object *) key, (Elm_Obj_Data *) data);
- return EINA_TRUE;
-}
+ obj_data->freeze_events = evas_object_freeze_events_get(obj);
-static void
-_elm_transit_object_remove_cb(void *data, Evas *e __UNUSED__, Evas_Object *obj, void *event_info __UNUSED__)
-{
- Elm_Transit *transit;
- Elm_Obj_Data *obj_data;
- Eina_List *list;
+ if ((!transit->state_keep) && (obj_data->state))
+ {
+ free(obj_data->state);
+ obj_data->state = NULL;
+ }
+ else
+ {
+ _transit_obj_states_save(obj, obj_data);
+ }
- transit = data;
- list = eina_list_data_find_list(transit->objs, obj);
- obj_data = eina_hash_find(transit->objs_data_hash, list);
- if (!obj_data) return;
- eina_hash_del_by_key(transit->objs_data_hash, list);
- evas_object_pass_events_set(obj, obj_data->pass_events);
- if (obj_data->state)
- free(obj_data->state);
- free(obj_data);
- transit->objs = eina_list_remove(transit->objs, obj);
- if (!transit->objs) elm_transit_del(transit);
+ evas_object_data_set(obj, _transit_key, obj_data);
}
-//TODO: Remove!
-//Since evas map have a afterimage bug for this time.
-//This function is added temporary.
static void
-_obj_damage_area_set(Evas_Object *obj)
+_transit_obj_states_save(Evas_Object *obj, Elm_Transit_Obj_Data *obj_data)
{
- const Evas_Map *map;
- Evas_Coord_Point coords;
- Evas_Coord_Point min, max;
- int i;
-
- map = evas_object_map_get(obj);
- if (!map) return;
-
- evas_map_point_coord_get(map, 0, &coords.x, &coords.y, NULL);
-
- max = min = coords;
+ Elm_Transit_Obj_State *state = obj_data->state;
- for (i = 1; i < 4; ++i)
- {
- evas_map_point_coord_get(map, i, &coords.x, &coords.y, NULL);
-
- if (coords.x < min.x)
- min.x = coords.x;
- else if (coords.x > max.x)
- max.x = coords.x;
-
- if (coords.y < min.y)
- min.y = coords.y;
- else if (coords.y > max.y)
- max.y = coords.y;
- }
+ if (!state)
+ state = calloc(1, sizeof(Elm_Transit_Obj_State));
+ if (!state) return;
- evas_damage_rectangle_add(evas_object_evas_get(obj),
- min.x, min.y,
- max.x - min.x, max.y - min.y);
+ evas_object_geometry_get(obj, &state->x, &state->y, &state->w, &state->h);
+ evas_object_color_get(obj, &state->r, &state->g, &state->b, &state->a);
+ state->visible = evas_object_visible_get(obj);
+ state->map_enabled = evas_object_map_enable_get(obj);
+ if (evas_object_map_get(obj))
+ state->map = evas_map_dup(evas_object_map_get(obj));
+ obj_data->state = state;
}
static void
_remove_obj_from_list(Elm_Transit *transit, Evas_Object *obj)
{
- evas_object_event_callback_del_full(obj, EVAS_CALLBACK_DEL,
- _elm_transit_object_remove_cb,
- transit);
-
//Remove duplicated objects
//TODO: Need to consider about optimizing here
while(1)
if (!eina_list_data_find_list(transit->objs, obj))
break;
transit->objs = eina_list_remove(transit->objs, obj);
+ evas_object_event_callback_del_full(obj, EVAS_CALLBACK_DEL,
+ _transit_obj_remove_cb,
+ transit);
}
}
static void
-_elm_transit_object_remove(Elm_Transit *transit, Evas_Object *obj)
+_transit_obj_remove_cb(void *data, Evas *e __UNUSED__, Evas_Object *obj, void *event_info __UNUSED__)
{
- Elm_Obj_Data *obj_data;
- Elm_Obj_State *state;
- Eina_List *list;
-
- list = eina_list_data_find_list(transit->objs, obj);
- obj_data = eina_hash_find(transit->objs_data_hash, list);
- if (!obj_data)
+ Elm_Transit *transit = data;
+ Elm_Transit_Obj_Data *obj_data = evas_object_data_get(obj, _transit_key);
+ if (obj_data)
{
- _remove_obj_from_list(transit, obj);
- return;
+ if (obj_data->state)
+ free(obj_data->state);
+ free(obj_data);
}
- eina_hash_del_by_key(transit->objs_data_hash, list);
_remove_obj_from_list(transit, obj);
- evas_object_pass_events_set(obj, obj_data->pass_events);
+ if (!transit->objs) elm_transit_del(transit);
+}
+
+static void
+_transit_obj_data_recover(Elm_Transit *transit, Evas_Object *obj)
+{
+ Elm_Transit_Obj_Data *obj_data;
+ Elm_Transit_Obj_State *state;
+
+ obj_data = evas_object_data_get(obj, _transit_key);
+ if (!obj_data) return;
+ evas_object_data_del(obj, _transit_key);
+ evas_object_freeze_events_set(obj, obj_data->freeze_events);
state = obj_data->state;
if (state)
{
evas_object_map_enable_set(obj, EINA_FALSE);
if (state->map)
evas_object_map_set(obj, state->map);
-
- //TODO: Remove!
- //Since evas map have a afterimage bug for this time.
- //This line is added temporary.
- _obj_damage_area_set(obj);
-
}
free(state);
}
free(obj_data);
+}
+static void
+_transit_obj_remove(Elm_Transit *transit, Evas_Object *obj)
+{
+ _remove_obj_from_list(transit, obj);
+ _transit_obj_data_recover(transit, obj);
}
static void
-_elm_transit_effect_del(Elm_Transit *transit, Elm_Transit_Effect_Module *effect_module)
+_transit_effect_del(Elm_Transit *transit, Elm_Transit_Effect_Module *effect_module)
{
if (effect_module->end_cb)
effect_module->end_cb(effect_module->effect, transit);
}
static void
-_remove_dead_effects(Elm_Transit *transit)
+_transit_remove_dead_effects(Elm_Transit *transit)
{
Elm_Transit_Effect_Module *effect_module;
{
if (effect_module->deleted)
{
- _elm_transit_effect_del(transit, effect_module);
+ _transit_effect_del(transit, effect_module);
transit->effects_pending_del--;
if (!transit->effects_pending_del) return;
}
}
static void
-_elm_transit_del(Elm_Transit *transit)
+_transit_chain_go(Elm_Transit *transit)
+{
+ ELM_TRANSIT_CHECK_OR_RETURN(transit);
+ elm_transit_go(transit);
+ _transit_animate_cb(transit);
+}
+
+static void
+_transit_del(Elm_Transit *transit)
{
Elm_Transit_Effect_Module *effect_module;
Elm_Transit *chain_transit;
Eina_List *elist, *elist_next;
- EINA_LIST_FOREACH_SAFE(transit->next_chain_transits, elist, elist_next, chain_transit)
- {
- if (transit->prev_chain_transit)
- transit->prev_chain_transit->next_chain_transits = eina_list_remove(transit->prev_chain_transit->next_chain_transits, transit);
- chain_transit->prev_chain_transit = NULL;
- }
-
- eina_list_free(transit->next_chain_transits);
-
if (transit->animator)
ecore_animator_del(transit->animator);
+ //remove effects
while (transit->effect_list)
{
effect_module = EINA_INLIST_CONTAINER_GET(transit->effect_list, Elm_Transit_Effect_Module);
transit->effect_list = eina_inlist_remove(transit->effect_list, transit->effect_list);
- _elm_transit_effect_del(transit, effect_module);
+ _transit_effect_del(transit, effect_module);
}
+ //remove objects.
while (transit->objs)
- _elm_transit_object_remove(transit, eina_list_data_get(transit->objs));
+ _transit_obj_remove(transit, eina_list_data_get(transit->objs));
transit->deleted = EINA_TRUE;
if (transit->del_data.func)
transit->del_data.func(transit->del_data.arg, transit);
- eina_hash_free(transit->objs_data_hash);
+ //cut off the chain transit relationship
+ EINA_LIST_FOREACH_SAFE(transit->next_chain_transits, elist, elist_next, chain_transit)
+ chain_transit->prev_chain_transit = NULL;
- EINA_MAGIC_SET(transit, EINA_MAGIC_NONE);
- free(transit);
-}
+ if (transit->prev_chain_transit)
+ transit->prev_chain_transit->next_chain_transits =
+ eina_list_remove(transit->prev_chain_transit->next_chain_transits, transit);
-static void
-_chain_transits_go(Elm_Transit *transit)
-{
- Eina_List *elist, *elist_next;
- Elm_Transit *chain_transit;
+ // run chain transits
+ if (transit->finished && transit->next_chain_transits)
+ {
+ EINA_LIST_FOREACH_SAFE(transit->next_chain_transits, elist, elist_next, chain_transit)
+ _transit_chain_go(chain_transit);
- EINA_LIST_FOREACH_SAFE(transit->next_chain_transits, elist, elist_next, chain_transit)
- elm_transit_go(chain_transit);
+ }
+
+ eina_list_free(transit->next_chain_transits);
+
+ EINA_MAGIC_SET(transit, EINA_MAGIC_NONE);
+ free(transit);
}
-static void
+//If the transit is deleted then EINA_FALSE is retruned.
+static Eina_Bool
_transit_animate_op(Elm_Transit *transit, double progress)
{
Elm_Transit_Effect_Module *effect_module;
}
transit->walking--;
- if (transit->walking) return;
+ if (transit->walking) return EINA_TRUE;
+
+ if (transit->deleted)
+ {
+ _transit_del(transit);
+ return EINA_FALSE;
+ }
- if (transit->deleted) _elm_transit_del(transit);
- else if (transit->effects_pending_del) _remove_dead_effects(transit);
+ else if (transit->effects_pending_del) _transit_remove_dead_effects(transit);
+
+ return EINA_TRUE;
}
static Eina_Bool
-_animator_animate_cb(void *data)
+_transit_animate_cb(void *data)
{
Elm_Transit *transit = data;
double elapsed_time, duration;
transit->progress = elapsed_time / duration;
switch (transit->tween_mode)
{
+ case ELM_TRANSIT_TWEEN_MODE_LINEAR:
+ transit->progress = ecore_animator_pos_map(transit->progress,
+ ECORE_POS_MAP_LINEAR,
+ 0, 0);
case ELM_TRANSIT_TWEEN_MODE_ACCELERATE:
- transit->progress = 1.0 - sin((ELM_PI / 2.0) + (transit->progress * ELM_PI / 2.0));
- break;
+ transit->progress = ecore_animator_pos_map(transit->progress,
+ ECORE_POS_MAP_ACCELERATE,
+ 0, 0);
+ break;
case ELM_TRANSIT_TWEEN_MODE_DECELERATE:
- transit->progress = sin(transit->progress * ELM_PI / 2.0);
- break;
+ transit->progress = ecore_animator_pos_map(transit->progress,
+ ECORE_POS_MAP_DECELERATE,
+ 0, 0);
+ break;
case ELM_TRANSIT_TWEEN_MODE_SINUSOIDAL:
- transit->progress = (1.0 - cos(transit->progress * ELM_PI)) / 2.0;
- break;
+ transit->progress = ecore_animator_pos_map(transit->progress,
+ ECORE_POS_MAP_SINUSOIDAL,
+ 0, 0);
+ break;
default:
- break;
+ break;
}
/* Reverse? */
if (transit->repeat.reverse) transit->progress = 1 - transit->progress;
- if (transit->time.duration > 0) _transit_animate_op(transit, transit->progress);
+ if (transit->time.duration > 0)
+ {
+ if (!_transit_animate_op(transit, transit->progress))
+ return ECORE_CALLBACK_CANCEL;
+ }
/* Not end. Keep going. */
if (elapsed_time < duration) return ECORE_CALLBACK_RENEW;
(transit->repeat.current == transit->repeat.count) &&
((!transit->auto_reverse) || transit->repeat.reverse))
{
- /* run chain transit */
- if (transit->next_chain_transits)
- _chain_transits_go(transit);
-
+ transit->finished = EINA_TRUE;
elm_transit_del(transit);
return ECORE_CALLBACK_CANCEL;
}
return ECORE_CALLBACK_RENEW;
}
-/**
- * Add new transit.
- *
- * @note Is not necessary to delete the transit object, it will be deleted at
- * the end of its operation.
- * @note The transit will start playing when the program enter in the main loop, is not
- * necessary to give a start to the transit.
- *
- * @param duration The duration of the transit in seconds. When transit starts
- * to run, it will last a @p duration time.
- * @return The transit object.
- *
- * @ingroup Transit
- */
EAPI Elm_Transit *
elm_transit_add(void)
{
Elm_Transit *transit = ELM_NEW(Elm_Transit);
- if (!transit) return NULL;
+ if (!transit)
+ {
+ ERR("Failed to allocate a elm_transit object!");
+ return NULL;
+ }
EINA_MAGIC_SET(transit, ELM_TRANSIT_MAGIC);
elm_transit_tween_mode_set(transit, ELM_TRANSIT_TWEEN_MODE_LINEAR);
- transit->objs_data_hash = eina_hash_int32_new(NULL);
-
return transit;
}
-/**
- * Stops the animation and delete the @p transit object.
- *
- * Call this function if you wants to stop the animation before the duration
- * time. Make sure the @p transit object is still alive with
- * elm_transit_del_cb_set() function.
- * All added effects will be deleted, calling its repective data_free_cb
- * functions. The function setted by elm_transit_del_cb_set() will be called.
- *
- * @see elm_transit_del_cb_set()
- *
- * @param transit The transit object to be deleted.
- *
- * @ingroup Transit
- * @warning Just call this function if you are sure the transit is alive.
- */
+
EAPI void
elm_transit_del(Elm_Transit *transit)
{
ELM_TRANSIT_CHECK_OR_RETURN(transit);
if (transit->walking) transit->deleted = EINA_TRUE;
- else _elm_transit_del(transit);
-}
-
-/**
- * Add a new effect to the transit.
- *
- * @note The cb function and the data are the key to the effect. If you try to
- * add an already added effect, nothing is done.
- * @note After the first addition of an effect in @p transit, if its
- * effect list become empty again, the @p transit will be killed by
- * elm_transit_del(transit) function.
- *
- * Exemple:
- * @code
- * Elm_Transit *transit = elm_transit_add();
- * elm_transit_effect_add(transit,
- * elm_transit_effect_blend_op,
- * elm_transit_effect_blend_context_new(),
- * elm_transit_effect_blend_context_free);
- * @endcode
- *
- * @param transit The transit object.
- * @param cb The operation function. It is called when the animation begins,
- * it is the function that actually performs the animation. It is called with
- * the @p data, @p transit and the time progression of the animation (a double
- * value between 0.0 and 1.0).
- * @param data The context data of the effect.
- * @param data_free_cb The function to free the context data, it will be called
- * at the end of the effect, it must finalize the animation and free the
- * @p data.
- *
- * @ingroup Transit
- * @warning The transit free the context data at the and of the transition with
- * the data_free_cb function, do not use the context data in another transit.
- */
+ else _transit_del(transit);
+}
+
EAPI void
elm_transit_effect_add(Elm_Transit *transit, Elm_Transit_Effect_Transition_Cb transition_cb, Elm_Transit_Effect *effect, Elm_Transit_Effect_End_Cb end_cb)
{
Elm_Transit_Effect_Module *effect_module;
EINA_INLIST_FOREACH(transit->effect_list, effect_module)
- if ((effect_module->transition_cb == transition_cb) && (effect_module->effect == effect)) return;
+ if ((effect_module->transition_cb == transition_cb) && (effect_module->effect == effect))
+ {
+ WRN("elm_transit does not allow to add the duplicated effect! : transit=%p", transit);
+ return;
+ }
effect_module = ELM_NEW(Elm_Transit_Effect_Module);
- if (!effect_module) return;
+ if (!effect_module)
+ {
+ ERR("Failed to allocate a new effect!: transit=%p", transit);
+ return;
+ }
effect_module->end_cb = end_cb;
effect_module->transition_cb = transition_cb;
transit->effect_list = eina_inlist_append(transit->effect_list, (Eina_Inlist*) effect_module);
}
-/**
- * Delete an added effect.
- *
- * This function will remove the effect from the @p transit, calling the
- * data_free_cb to free the @p data.
- *
- * @see elm_transit_effect_add()
- *
- * @note If the effect is not found, nothing is done.
- * @note If the effect list become empty, this function will call
- * elm_transit_del(transit), that is, it will kill the @p transit.
- *
- * @param transit The transit object.
- * @param cb The operation function.
- * @param data The context data of the effect.
- *
- * @ingroup Transit
- */
EAPI void
elm_transit_effect_del(Elm_Transit *transit, Elm_Transit_Effect_Transition_Cb transition_cb, Elm_Transit_Effect *effect)
{
}
else
{
- _elm_transit_effect_del(transit, effect_module);
+ _transit_effect_del(transit, effect_module);
if (!transit->effect_list) elm_transit_del(transit);
}
return;
}
}
-/**
- * Add new object to apply the effects.
- *
- * @note After the first addition of an object in @p transit, if its
- * object list become empty again, the @p transit will be killed by
- * elm_transit_del(transit) function.
- * @note If the @p obj belongs to another transit, the @p obj will be
- * removed from it and it will only belong to the @p transit. If the old
- * transit stays without objects, it will die.
- * @note When you add an object into the @p transit, its state from
- * evas_object_pass_events_get(obj) is saved, and it is applied when the
- * transit ends, if you change this state whith evas_object_pass_events_set()
- * after add the object, this state will change again when @p transit stops to
- * run.
- *
- * @param transit The transit object.
- * @param obj Object to be animated.
- *
- * @ingroup Transit
- * @warning It is not allowed to add a new object after transit begins to go.
- */
EAPI void
elm_transit_object_add(Elm_Transit *transit, Evas_Object *obj)
{
ELM_TRANSIT_CHECK_OR_RETURN(transit);
EINA_SAFETY_ON_NULL_RETURN(obj);
- Elm_Obj_Data *obj_data;
- Eina_List * list;
-//TODO: Check the remove case of the same objects in this transit.
- obj_data = ELM_NEW(Elm_Obj_Data);
- obj_data->pass_events = evas_object_pass_events_get(obj);
- if (!transit->event_enabled)
- evas_object_pass_events_set(obj, EINA_TRUE);
+ if (transit->animator)
+ {
+ if (!evas_object_data_get(obj, _transit_key))
+ {
+ _transit_obj_data_update(transit, obj);
+ evas_object_freeze_events_set(obj, EINA_TRUE);
+ }
+ }
evas_object_event_callback_add(obj, EVAS_CALLBACK_DEL,
- _elm_transit_object_remove_cb,
+ _transit_obj_remove_cb,
transit);
transit->objs = eina_list_append(transit->objs, obj);
- list = eina_list_last(transit->objs);
- eina_hash_add(transit->objs_data_hash, list, obj_data);
-
- if (!transit->state_keep)
- _elm_transit_obj_states_save(obj, obj_data);
-}
-
-/**
- * Removes an added object from the transit.
- *
- * @note If the @p obj is not in the @p transit, nothing is done.
- * @note If the list become empty, this function will call
- * elm_transit_del(transit), that is, it will kill the @p transit.
- *
- * @param transit The transit object.
- * @param obj Object to be removed from @p transit.
- *
- * @ingroup Transit
- * @warning It is not allowed to remove objects after transit begins to go.
- */
+}
+
EAPI void
elm_transit_object_remove(Elm_Transit *transit, Evas_Object *obj)
{
ELM_TRANSIT_CHECK_OR_RETURN(transit);
EINA_SAFETY_ON_NULL_RETURN(obj);
- _elm_transit_object_remove(transit, obj);
+ _transit_obj_remove(transit, obj);
if (!transit->objs) elm_transit_del(transit);
}
-/**
- * Get the objects of the transit.
- *
- * @param transit The transit object.
- * @return a Eina_List with the objects from the transit.
- *
- * @ingroup Transit
- */
EAPI const Eina_List *
elm_transit_objects_get(const Elm_Transit *transit)
{
return transit->objs;
}
-/**
- * Set the event enabled when transit is operating.
- *
- * If @p enabled is EINA_TRUE, the objects of the transit will receives
- * events from mouse and keyboard during the animation.
- * @note When you add an object with elm_transit_object_add(), its state from
- * evas_object_pass_events_get(obj) is saved, and it is applied when the
- * transit ends, if you change this state with evas_object_pass_events_set()
- * after adding the object, this state will change again when @p transit stops
- * to run.
- *
- * @param transit The transit object.
- * @param enabled Disable or enable.
- *
- * @ingroup Transit
- */
EAPI void
elm_transit_event_enabled_set(Elm_Transit *transit, Eina_Bool enabled)
{
ELM_TRANSIT_CHECK_OR_RETURN(transit);
+ Eina_List *list;
+ Evas_Object *obj;
+
if (transit->event_enabled == enabled) return;
transit->event_enabled = !!enabled;
- eina_hash_foreach(transit->objs_data_hash, _hash_foreach_pass_events_set, transit);
-}
-
-/**
- * Get the value of event enabled status.
- *
- * @see elm_transit_event_enabled_set()
- *
- * @param transit The Transit object
- * @return EINA_TRUE, when event is enabled. If @p transit is NULL
- * EINA_FALSE is returned
- *
- * @ingroup Transit
- */
+ if (!transit->animator) return;
+
+ EINA_LIST_FOREACH(transit->objs, list, obj)
+ evas_object_freeze_events_set(obj, enabled);
+}
+
EAPI Eina_Bool
elm_transit_event_enabled_get(const Elm_Transit *transit)
{
return transit->event_enabled;
}
-
-/**
- * Set the event enabled when transit is operating.
- *
- * If @p disabled is EINA_TRUE, the objects of the transit will receives
- * events from mouse and keyboard during the animation.
- * @note When you add an object with elm_transit_object_add(), its state from
- * evas_object_pass_events_get(obj) is saved, and it is applied when the
- * transit ends, if you change this state with evas_object_pass_events_set()
- * after add the object, this state will change again when @p transit stops to
- * run.
- *
- * @see elm_transit_event_enabled_set()
- *
- * @param transit The transit object.
- * @param disabled Disable or enable.
- *
- * @ingroup Transit
- */
-EINA_DEPRECATED EAPI void
-elm_transit_event_block_set(Elm_Transit *transit, Eina_Bool disabled)
-{
- elm_transit_event_enabled_set(transit, disabled);
-}
-
-
-/**
- * Get the value of event block enabled status.
- *
- * @see elm_transit_event_enabled_set(), elm_transit_event_enabled_get()
- *
- * @param transit The Transit object
- * @return EINA_TRUE, when event is enabled. If @p transit is NULL
- * EINA_FALSE is returned
- *
- * @ingroup Transit
- */
-EINA_DEPRECATED EAPI Eina_Bool
-elm_transit_event_block_get(const Elm_Transit *transit)
-{
- return !elm_transit_event_enabled_get(transit);
-}
-
-/**
- * Set the user-callback function when the transit is deleted.
- *
- * @note Using this function twice will overwrite the first function setted.
- * @note the @p transit object will be deleted after call @p cb function.
- *
- * @param transit The transit object.
- * @param cb Callback function pointer. This function will be called before
- * the deletion of the transit.
- * @param data Callback funtion user data. It is the @p op parameter.
- *
- * @ingroup Transit
- */
EAPI void
elm_transit_del_cb_set(Elm_Transit *transit, void (*cb) (void *data, Elm_Transit *transit), void *data)
{
transit->del_data.arg = data;
}
-/**
- * Set reverse effect automatically.
- *
- * If auto reverse is setted, after running the effects with the progress
- * parameter from 0 to 1, it will call the effecs again with the progress
- * from 1 to 0. The transit will last for a time iqual to (2 * duration * repeat),
- * where the duration was setted with the function elm_transit_add and
- * the repeat with the function elm_transit_repeat_times_set().
- *
- * @param transit The transit object.
- * @param reverse EINA_TRUE means the auto_reverse is on.
- *
- * @ingroup Transit
- */
EAPI void
elm_transit_auto_reverse_set(Elm_Transit *transit, Eina_Bool reverse)
{
transit->auto_reverse = reverse;
}
-/**
- * Get if the auto reverse is on.
- *
- * @see elm_transit_auto_reverse_set()
- *
- * @param transit The transit object.
- * @return EINA_TRUE means auto reverse is on. If @p transit is NULL
- * EINA_FALSE is returned
- *
- * @ingroup Transit
- */
EAPI Eina_Bool
elm_transit_auto_reverse_get(const Elm_Transit *transit)
{
return transit->auto_reverse;
}
-/**
- * Set the transit repeat count. Effect will be repeated by repeat count.
- *
- * This function sets the number of repetition the transit will run after
- * the first one, that is, if @p repeat is 1, the transit will run 2 times.
- * If the @p repeat is a negative number, it will repeat infinite times.
- *
- * @note If this function is called during the transit execution, the transit
- * will run @p repeat times, ignoring the times it already performed.
- *
- * @param transit The transit object
- * @param repeat Repeat count
- *
- * @ingroup Transit
- */
EAPI void
elm_transit_repeat_times_set(Elm_Transit *transit, int repeat)
{
transit->repeat.current = 0;
}
-/**
- * Get the transit repeat count.
- *
- * @see elm_transit_repeat_times_set()
- *
- * @param transit The Transit object.
- * @return The repeat count. If @p transit is NULL
- * 0 is returned
- *
- * @ingroup Transit
- */
EAPI int
elm_transit_repeat_times_get(const Elm_Transit *transit)
{
return transit->repeat.count;
}
-/**
- * Set the transit animation acceleration type.
- *
- * This function sets the tween mode of the transit that can be:
- * ELM_TRANSIT_TWEEN_MODE_LINEAR - The default mode.
- * ELM_TRANSIT_TWEEN_MODE_SINUSOIDAL - Starts in accelerate mode and ends decelerating.
- * ELM_TRANSIT_TWEEN_MODE_DECELERATE - The animation will be slowed over time.
- * ELM_TRANSIT_TWEEN_MODE_ACCELERATE - The animation will accelerate over time.
- *
- * @param transit The transit object.
- * @param tween_mode The tween type.
- *
- * @ingroup Transit
- */
EAPI void
elm_transit_tween_mode_set(Elm_Transit *transit, Elm_Transit_Tween_Mode tween_mode)
{
transit->tween_mode = tween_mode;
}
-/**
- * Get the transit animation acceleration type.
- *
- * @note @p transit can not be NULL
- *
- * @param transit The transit object.
- * @return The tween type. If @p transit is NULL
- * ELM_TRANSIT_TWEEN_MODE_LINEAR is returned.
- *
- * @ingroup Transit
- */
EAPI Elm_Transit_Tween_Mode
elm_transit_tween_mode_get(const Elm_Transit *transit)
{
return transit->tween_mode;
}
-/**
- * Set the transit animation time
- *
- * @note @p transit can not be NULL
- *
- * @param transit The transit object.
- * @param duration The animation time.
- *
- * @ingroup Transit
- */
EAPI void
elm_transit_duration_set(Elm_Transit *transit, double duration)
{
ELM_TRANSIT_CHECK_OR_RETURN(transit);
- if (transit->animator) return;
+ if (transit->animator)
+ {
+ WRN("elm_transit does not allow to set the duration time in operating! : transit=%p", transit);
+ return;
+ }
transit->time.duration = duration;
}
-/**
- * Get the transit animation time
- *
- * @note @p transit can not be NULL
- *
- * @param transit The transit object.
- *
- * @return The transit animation time.
- *
- * @ingroup Transit
- */
EAPI double
elm_transit_duration_get(const Elm_Transit *transit)
{
return transit->time.duration;
}
-/**
- * Starts the transition.
- * Once this API is called, the transit begins to measure the time.
- *
- * @note @p transit can not be NULL
- *
- * @param transit The transit object.
- *
- * @ingroup Transit
- */
EAPI void
elm_transit_go(Elm_Transit *transit)
{
ELM_TRANSIT_CHECK_OR_RETURN(transit);
+ Eina_List *elist;
+ Evas_Object *obj;
+
if (transit->animator)
ecore_animator_del(transit->animator);
+ EINA_LIST_FOREACH(transit->objs, elist, obj)
+ _transit_obj_data_update(transit, obj);
+
+ if (!transit->event_enabled)
+ {
+ EINA_LIST_FOREACH(transit->objs, elist, obj)
+ evas_object_freeze_events_set(obj, EINA_TRUE);
+ }
+
transit->time.paused = 0;
transit->time.delayed = 0;
transit->time.begin = ecore_loop_time_get();
- transit->animator = ecore_animator_add(_animator_animate_cb, transit);
-}
-
-/**
- * Pause/Resume the transition.
- * If you call elm_transit_go again, paused states will affect no anymore.
- *
- * @note @p transit can not be NULL
- *
- * @param transit The transit object.
- *
- * @ingroup Transit
- */
+ transit->animator = ecore_animator_add(_transit_animate_cb, transit);
+}
+
EAPI void
elm_transit_paused_set(Elm_Transit *transit, Eina_Bool paused)
{
}
}
-/**
- * Get the value of paused status.
- *
- * @see elm_transit_paused_set()
- *
- * @note @p transit can not be NULL
- *
- * @param transit The transit object.
- * @return EINA_TRUE means transition is paused. If @p transit is NULL
- * EINA_FALSE is returned
- *
- * @ingroup Transit
- */
EAPI Eina_Bool
elm_transit_paused_get(const Elm_Transit *transit)
{
return EINA_TRUE;
}
-/**
- * Get the time progression of the animation (a double value between 0.0 and 1.0).
- *
- * @note @p transit can not be NULL
- *
- * @param transit The transit object.
- *
- * @return The time progression value. If @p transit is NULL
- * 0 is returned
- *
- * @ingroup Transit
- */
EAPI double
elm_transit_progress_value_get(const Elm_Transit *transit)
{
ELM_TRANSIT_CHECK_OR_RETURN(transit, 0);
+
return transit->progress;
}
-
-
-/**
- * Enable/disable keeping up the objects states.
- * If it is not kept, the objects states will be reset when transition ends.
- *
- * @note @p transit can not be NULL.
- * @note One state includes geometry, color, map data.
- *
- * @param transit The transit object.
- * @param state_keep Keeping or Non Keeping.
- *
- * @ingroup Transit
- */
EAPI void
elm_transit_objects_final_state_keep_set(Elm_Transit *transit, Eina_Bool state_keep)
{
ELM_TRANSIT_CHECK_OR_RETURN(transit);
+
if (transit->state_keep == state_keep) return;
- if (transit->animator) return;
+ if (transit->animator)
+ {
+ WRN("elm_transit does not allow to change final state keep mode in operating! : transit=%p", transit);
+ return;
+ }
transit->state_keep = !!state_keep;
- if (state_keep) return;
- eina_hash_foreach(transit->objs_data_hash, _hash_foreach_obj_states_save, NULL);
-}
-
-/**
- * Get a value whether the objects states will be reset or not.
- *
- * @note @p transit can not be NULL
- *
- * @see elm_transit_objects_final_state_keep_set()
- *
- * @param transit The transit object.
- * @return EINA_TRUE means the states of the objects will be reset.
- * If @p transit is NULL, EINA_FALSE is returned
- *
- * @ingroup Transit
- */
+}
+
EAPI Eina_Bool
elm_transit_objects_final_state_keep_get(const Elm_Transit *transit)
{
return transit->state_keep;
}
-/**
- * Makes the chain relationship between two transits.
- *
- * @note @p transit can not be NULL. Transit would have multiple chain transits.
- * @note @p chain_transit can not be NULL. Chain transits could be chained to the only one transit.
- *
- * @param transit The transit object.
- * @param chain_transit The chain transit object. This transit will be operated
- * after transit is done.
- *
- * @ingroup Transit
- */
EAPI void
elm_transit_chain_transit_add(Elm_Transit *transit, Elm_Transit *chain_transit)
{
ELM_TRANSIT_CHECK_OR_RETURN(transit);
ELM_TRANSIT_CHECK_OR_RETURN(chain_transit);
- if (transit == chain_transit) return;
- if (transit == chain_transit->prev_chain_transit) return;
+ if (transit == chain_transit)
+ {
+ WRN("You add a same transit as a chain transit! : transit=%p, chain_transit=%p", transit, chain_transit);
+ return;
+ }
+ if (transit == chain_transit->prev_chain_transit)
+ return;
if (chain_transit->prev_chain_transit)
chain_transit->prev_chain_transit->next_chain_transits = eina_list_remove(chain_transit->prev_chain_transit->next_chain_transits, chain_transit);
transit->next_chain_transits = eina_list_append(transit->next_chain_transits, chain_transit);
}
-/**
- * Get the current chain transit list.
- *
- * @note @p transit can not be NULL.
- *
- * @param transit The transit object.
- * @return chain transit list.
- *
- * @ingroup Transit
- */
+EAPI void
+elm_transit_chain_transit_del(Elm_Transit *transit, Elm_Transit *chain_transit)
+{
+ ELM_TRANSIT_CHECK_OR_RETURN(transit);
+ ELM_TRANSIT_CHECK_OR_RETURN(chain_transit);
+
+ if (chain_transit->prev_chain_transit != transit)
+ {
+ WRN("A pair of transits does not have the chain relationship! : transit=%p, chain_transit=%p", transit, chain_transit);
+ return;
+ }
+
+ chain_transit->prev_chain_transit = NULL;
+ transit->next_chain_transits = eina_list_remove(transit->next_chain_transits, chain_transit);
+}
+
EAPI Eina_List *
elm_transit_chain_transits_get(const Elm_Transit * transit)
{
return transit->next_chain_transits;
}
-///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////
//Resizing Effect
-///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////
typedef struct _Elm_Transit_Effect_Resizing Elm_Transit_Effect_Resizing;
struct _Elm_Transit_Effect_Resizing
return resizing;
}
-/**
- * Add the Resizing Effect to Elm_Transit.
- *
- * @note This API is one of the facades. It creates resizing effect context
- * and add it's required APIs to elm_transit_effect_add.
- *
- * @see elm_transit_effect_add()
- *
- * @param transit Transit object.
- * @param from_w Object width size when effect begins.
- * @param from_h Object height size when effect begins.
- * @param to_w Object width size when effect ends.
- * @param to_h Object height size when effect ends.
- * @return Resizing effect context data.
- *
- * @ingroup Transit
- */
EAPI Elm_Transit_Effect *
elm_transit_effect_resizing_add(Elm_Transit *transit, Evas_Coord from_w, Evas_Coord from_h, Evas_Coord to_w, Evas_Coord to_h)
{
ELM_TRANSIT_CHECK_OR_RETURN(transit, NULL);
Elm_Transit_Effect *effect = _transit_effect_resizing_context_new(from_w, from_h, to_w, to_h);
- if (!effect) return NULL;
+ if (!effect)
+ {
+ ERR("Failed to allocate resizing effect! : transit=%p", transit);
+ return NULL;
+ }
elm_transit_effect_add(transit,
_transit_effect_resizing_op, effect,
_transit_effect_resizing_context_free);
return effect;
}
-///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////
//Translation Effect
-///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////
typedef struct _Elm_Transit_Effect_Translation Elm_Transit_Effect_Translation;
typedef struct _Elm_Transit_Effect_Translation_Node Elm_Transit_Effect_Translation_Node;
return translation;
}
-/**
- * Add the Translation Effect to Elm_Transit.
- *
- * @note This API is one of the facades. It creates translation effect context
- * and add it's required APIs to elm_transit_effect_add.
- *
- * @see elm_transit_effect_add()
- *
- * @param transit Transit object.
- * @param from_dx X Position variation when effect begins.
- * @param from_dy Y Position variation when effect begins.
- * @param to_dx X Position variation when effect ends.
- * @param to_dy Y Position variation when effect ends.
- * @return Translation effect context data.
- *
- * @ingroup Transit
- * @warning Is higher recommended just create a transit with this effect when
- * the window that the objects of the transit belongs has already been created.
- * This is because this effect needs the geometry information about the objects,
- * and if the window was not created yet, it can get a wrong information.
- */
EAPI Elm_Transit_Effect *
elm_transit_effect_translation_add(Elm_Transit *transit, Evas_Coord from_dx, Evas_Coord from_dy, Evas_Coord to_dx, Evas_Coord to_dy)
{
ELM_TRANSIT_CHECK_OR_RETURN(transit, NULL);
- Elm_Transit_Effect *effect_context = _transit_effect_translation_context_new(from_dx, from_dy, to_dx, to_dy);
+ Elm_Transit_Effect *effect = _transit_effect_translation_context_new(from_dx, from_dy, to_dx, to_dy);
- if (!effect_context) return NULL;
+ if (!effect)
+ {
+ ERR("Failed to allocate translation effect! : transit=%p", transit);
+ return NULL;
+ }
elm_transit_effect_add(transit,
- _transit_effect_translation_op, effect_context,
+ _transit_effect_translation_op, effect,
_transit_effect_translation_context_free);
- return effect_context;
+ return effect;
}
-
-///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////
//Zoom Effect
-///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////
typedef struct _Elm_Transit_Effect_Zoom Elm_Transit_Effect_Zoom;
struct _Elm_Transit_Effect_Zoom
return zoom;
}
-/**
- * Add the Zoom Effect to Elm_Transit.
- *
- * @note This API is one of the facades. It creates zoom effect context
- * and add it's required APIs to elm_transit_effect_add.
- *
- * @see elm_transit_effect_add()
- *
- * @param transit Transit object.
- * @param from_rate Scale rate when effect begins (1 is current rate).
- * @param to_rate Scale rate when effect ends.
- * @return Zoom effect context data.
- *
- * @ingroup Transit
- * @warning Is higher recommended just create a transit with this effect when
- * the window that the objects of the transit belongs has already been created.
- * This is because this effect needs the geometry information about the objects,
- * and if the window was not created yet, it can get a wrong information.
- */
EAPI Elm_Transit_Effect *
elm_transit_effect_zoom_add(Elm_Transit *transit, float from_rate, float to_rate)
{
ELM_TRANSIT_CHECK_OR_RETURN(transit, NULL);
- Elm_Transit_Effect *effect_context = _transit_effect_zoom_context_new(from_rate, to_rate);
+ Elm_Transit_Effect *effect = _transit_effect_zoom_context_new(from_rate, to_rate);
- if (!effect_context) return NULL;
+ if (!effect)
+ {
+ ERR("Failed to allocate zoom effect! : transit=%p", transit);
+ return NULL;
+ }
elm_transit_effect_add(transit,
- _transit_effect_zoom_op, effect_context,
+ _transit_effect_zoom_op, effect,
_transit_effect_zoom_context_free);
- return effect_context;
+ return effect;
}
-
-///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////
//Flip Effect
-///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////
typedef struct _Elm_Transit_Effect_Flip Elm_Transit_Effect_Flip;
struct _Elm_Transit_Effect_Flip
return flip;
}
-/**
- * Add the Flip Effect to Elm_Transit.
- *
- * @note This API is one of the facades. It creates flip effect context
- * and add it's required APIs to elm_transit_effect_add.
- * @note This effect is applied to each pair of objects in the order they are listed
- * in the transit list of objects. The first object in the pair will be the
- * "front" object and the second will be the "back" object.
- *
- * @see elm_transit_effect_add()
- *
- * @param transit Transit object.
- * @param axis Flipping Axis(X or Y).
- * @param cw Flipping Direction. EINA_TRUE is clock-wise.
- * @return Flip effect context data.
- *
- * @ingroup Transit
- * @warning Is higher recommended just create a transit with this effect when
- * the window that the objects of the transit belongs has already been created.
- * This is because this effect needs the geometry information about the objects,
- * and if the window was not created yet, it can get a wrong information.
- */
EAPI Elm_Transit_Effect *
elm_transit_effect_flip_add(Elm_Transit *transit, Elm_Transit_Effect_Flip_Axis axis, Eina_Bool cw)
{
ELM_TRANSIT_CHECK_OR_RETURN(transit, NULL);
- Elm_Transit_Effect *effect_context = _transit_effect_flip_context_new(axis, cw);
+ Elm_Transit_Effect *effect = _transit_effect_flip_context_new(axis, cw);
- if (!effect_context) return NULL;
+ if (!effect)
+ {
+ ERR("Failed to allocate flip effect! : transit=%p", transit);
+ return NULL;
+ }
elm_transit_effect_add(transit,
- _transit_effect_flip_op, effect_context,
+ _transit_effect_flip_op, effect,
_transit_effect_flip_context_free);
- return effect_context;
+ return effect;
}
-///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////
//ResizableFlip Effect
-///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////
typedef struct _Elm_Transit_Effect_Resizable_Flip Elm_Transit_Effect_ResizableFlip;
typedef struct _Elm_Transit_Effect_Resizable_Flip_Node Elm_Transit_Effect_ResizableFlip_Node;
return resizable_flip;
}
-/**
- * Add the Resizable Flip Effect to Elm_Transit.
- *
- * @note This API is one of the facades. It creates resizable flip effect context
- * and add it's required APIs to elm_transit_effect_add.
- * @note This effect is applied to each pair of objects in the order they are listed
- * in the transit list of objects. The first object in the pair will be the
- * "front" object and the second will be the "back" object.
- *
- * @see elm_transit_effect_add()
- *
- * @param transit Transit object.
- * @param axis Flipping Axis(X or Y).
- * @param cw Flipping Direction. EINA_TRUE is clock-wise.
- * @return Resizable flip effect context data.
- *
- * @ingroup Transit
- * @warning Is higher recommended just create a transit with this effect when
- * the window that the objects of the transit belongs has already been created.
- * This is because this effect needs the geometry information about the objects,
- * and if the window was not created yet, it can get a wrong information.
- */
EAPI Elm_Transit_Effect *
elm_transit_effect_resizable_flip_add(Elm_Transit *transit, Elm_Transit_Effect_Flip_Axis axis, Eina_Bool cw)
{
ELM_TRANSIT_CHECK_OR_RETURN(transit, NULL);
- Elm_Transit_Effect *effect_context = _transit_effect_resizable_flip_context_new(axis, cw);
+ Elm_Transit_Effect *effect = _transit_effect_resizable_flip_context_new(axis, cw);
- if (!effect_context) return NULL;
+ if (!effect)
+ {
+ ERR("Failed to allocate resizable_flip effect! : transit=%p", transit);
+ return NULL;
+ }
elm_transit_effect_add(transit,
- _transit_effect_resizable_flip_op, effect_context,
+ _transit_effect_resizable_flip_op, effect,
_transit_effect_resizable_flip_context_free);
- return effect_context;
+ return effect;
}
-
-///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////
//Wipe Effect
-///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////
typedef struct _Elm_Transit_Effect_Wipe Elm_Transit_Effect_Wipe;
struct _Elm_Transit_Effect_Wipe
return wipe;
}
-/**
- * Add the Wipe Effect to Elm_Transit.
- *
- * @note This API is one of the facades. It creates wipe effect context
- * and add it's required APIs to elm_transit_effect_add.
- *
- * @see elm_transit_effect_add()
- *
- * @param transit Transit object.
- * @param type Wipe type. Hide or show.
- * @param dir Wipe Direction.
- * @return Wipe effect context data.
- *
- * @ingroup Transit
- * @warning Is higher recommended just create a transit with this effect when
- * the window that the objects of the transit belongs has already been created.
- * This is because this effect needs the geometry information about the objects,
- * and if the window was not created yet, it can get a wrong information.
- */
EAPI void *
elm_transit_effect_wipe_add(Elm_Transit *transit, Elm_Transit_Effect_Wipe_Type type, Elm_Transit_Effect_Wipe_Dir dir)
{
ELM_TRANSIT_CHECK_OR_RETURN(transit, NULL);
- void *effect_context = _transit_effect_wipe_context_new(type, dir);
+ void *effect = _transit_effect_wipe_context_new(type, dir);
- if (!effect_context) return NULL;
+ if (!effect)
+ {
+ ERR("Failed to allocate wipe effect! : transit=%p", transit);
+ return NULL;
+ }
elm_transit_effect_add(transit,
- _transit_effect_wipe_op, effect_context,
+ _transit_effect_wipe_op, effect,
_transit_effect_wipe_context_free);
- return effect_context;
+ return effect;
}
-
-///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////
//Color Effect
-///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////
typedef struct _Elm_Transit_Effect_Color Elm_Transit_Effect_Color;
struct _Elm_Transit_Effect_Color
return color;
}
-/**
- * Add the Color Effect to Elm_Transit.
- *
- * @note This API is one of the facades. It creates color effect context
- * and add it's required APIs to elm_transit_effect_add.
- *
- * @see elm_transit_effect_add()
- *
- * @param transit Transit object.
- * @param from_r RGB R when effect begins.
- * @param from_g RGB G when effect begins.
- * @param from_b RGB B when effect begins.
- * @param from_a RGB A when effect begins.
- * @param to_r RGB R when effect ends.
- * @param to_g RGB G when effect ends.
- * @param to_b RGB B when effect ends.
- * @param to_a RGB A when effect ends.
- * @return Color effect context data.
- *
- * @ingroup Transit
- */
EAPI Elm_Transit_Effect *
elm_transit_effect_color_add(Elm_Transit *transit, unsigned int from_r, unsigned int from_g, unsigned int from_b, unsigned int from_a, unsigned int to_r, unsigned int to_g, unsigned int to_b, unsigned int to_a)
{
ELM_TRANSIT_CHECK_OR_RETURN(transit, NULL);
- Elm_Transit_Effect *effect_context = _transit_effect_color_context_new(from_r, from_g, from_b, from_a, to_r, to_g, to_b, to_a);
+ Elm_Transit_Effect *effect = _transit_effect_color_context_new(from_r, from_g, from_b, from_a, to_r, to_g, to_b, to_a);
- if (!effect_context) return NULL;
+ if (!effect)
+ {
+ ERR("Failed to allocate color effect! : transit=%p", transit);
+ return NULL;
+ }
elm_transit_effect_add(transit,
- _transit_effect_color_op, effect_context,
+ _transit_effect_color_op, effect,
_transit_effect_color_context_free);
- return effect_context;
+ return effect;
}
-///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////
//Fade Effect
-///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////
typedef struct _Elm_Transit_Effect_Fade Elm_Transit_Effect_Fade;
typedef struct _Elm_Transit_Effect_Fade_Node Elm_Transit_Effect_Fade_Node;
return fade;
}
-/**
- * Add the Fade Effect to Elm_Transit.
- *
- * @note This API is one of the facades. It creates fade effect context
- * and add it's required APIs to elm_transit_effect_add.
- * @note This effect is applied to each pair of objects in the order they are listed
- * in the transit list of objects. The first object in the pair will be the
- * "before" object and the second will be the "after" object.
- *
- * @see elm_transit_effect_add()
- *
- * @param transit Transit object.
- * @return Fade effect context data.
- *
- * @ingroup Transit
- * @warning Is higher recommended just create a transit with this effect when
- * the window that the objects of the transit belongs has already been created.
- * This is because this effect needs the color information about the objects,
- * and if the window was not created yet, it can get a wrong information.
- */
EAPI Elm_Transit_Effect *
elm_transit_effect_fade_add(Elm_Transit *transit)
{
ELM_TRANSIT_CHECK_OR_RETURN(transit, NULL);
- Elm_Transit_Effect *effect_context = _transit_effect_fade_context_new();
- if (!effect_context) return NULL;
+ Elm_Transit_Effect *effect = _transit_effect_fade_context_new();
+
+ if (!effect)
+ {
+ ERR("Failed to allocate fade effect! : transit=%p", transit);
+ return NULL;
+ }
elm_transit_effect_add(transit,
- _transit_effect_fade_op, effect_context,
+ _transit_effect_fade_op, effect,
_transit_effect_fade_context_free);
- return effect_context;
+ return effect;
}
-
-///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////
//Blend Effect
-///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////
typedef struct _Elm_Transit_Effect_Blend Elm_Transit_Effect_Blend;
typedef struct _Elm_Transit_Effect_Blend_Node Elm_Transit_Effect_Blend_Node;
return blend;
}
-/**
- * Add the Blend Effect to Elm_Transit.
- *
- * @note This API is one of the facades. It creates blend effect context
- * and add it's required APIs to elm_transit_effect_add.
- * @note This effect is applied to each pair of objects in the order they are listed
- * in the transit list of objects. The first object in the pair will be the
- * "before" object and the second will be the "after" object.
- *
- * @see elm_transit_effect_add()
- *
- * @param transit Transit object.
- * @return Blend effect context data.
- *
- * @ingroup Transit
- * @warning Is higher recommended just create a transit with this effect when
- * the window that the objects of the transit belongs has already been created.
- * This is because this effect needs the color information about the objects,
- * and if the window was not created yet, it can get a wrong information.
- */
EAPI Elm_Transit_Effect *
elm_transit_effect_blend_add(Elm_Transit *transit)
{
ELM_TRANSIT_CHECK_OR_RETURN(transit, NULL);
- Elm_Transit_Effect *effect_context = _transit_effect_blend_context_new();
+ Elm_Transit_Effect *effect = _transit_effect_blend_context_new();
- if (!effect_context) return NULL;
+ if (!effect)
+ {
+ ERR("Failed to allocate blend effect! : transit=%p", transit);
+ return NULL;
+ }
elm_transit_effect_add(transit,
- _transit_effect_blend_op, effect_context,
+ _transit_effect_blend_op, effect,
_transit_effect_blend_context_free);
- return effect_context;
+ return effect;
}
-
-///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////
//Rotation Effect
-///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////
typedef struct _Elm_Transit_Effect_Rotation Elm_Transit_Effect_Rotation;
struct _Elm_Transit_Effect_Rotation
return rotation;
}
-/**
- * Add the Rotation Effect to Elm_Transit.
- *
- * @note This API is one of the facades. It creates rotation effect context
- * and add it's required APIs to elm_transit_effect_add.
- *
- * @see elm_transit_effect_add()
- *
- * @param transit Transit object.
- * @param from_degree Degree when effect begins.
- * @param to_degree Degree when effect is ends.
- * @return Rotation effect context data.
- *
- * @ingroup Transit
- * @warning Is higher recommended just create a transit with this effect when
- * the window that the objects of the transit belongs has already been created.
- * This is because this effect needs the geometry information about the objects,
- * and if the window was not created yet, it can get a wrong information.
- */
EAPI Elm_Transit_Effect *
elm_transit_effect_rotation_add(Elm_Transit *transit, float from_degree, float to_degree)
{
ELM_TRANSIT_CHECK_OR_RETURN(transit, NULL);
- Elm_Transit_Effect *effect_context = _transit_effect_rotation_context_new(from_degree, to_degree);
+ Elm_Transit_Effect *effect = _transit_effect_rotation_context_new(from_degree, to_degree);
- if (!effect_context) return NULL;
+ if (!effect)
+ {
+ ERR("Failed to allocate rotation effect! : transit=%p", transit);
+ return NULL;
+ }
elm_transit_effect_add(transit,
- _transit_effect_rotation_op, effect_context,
+ _transit_effect_rotation_op, effect,
_transit_effect_rotation_context_free);
- return effect_context;
+ return effect;
}
-
-///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////
//ImageAnimation Effect
-///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////
typedef struct _Elm_Transit_Effect_Image_Animation Elm_Transit_Effect_Image_Animation;
struct _Elm_Transit_Effect_Image_Animation
EINA_LIST_FOREACH(transit->objs, elist, obj)
{
- if (elm_widget_type_check(obj, type))
+ if (elm_widget_type_check(obj, type, __func__))
elm_icon_file_set(obj,
eina_list_nth(image_animation->images, count), NULL);
}
return image_animation;
}
-/**
- * Add the ImageAnimation Effect to Elm_Transit.
- *
- * @note This API is one of the facades. It creates image animation effect context
- * and add it's required APIs to elm_transit_effect_add.
- * The @p images parameter is a list images paths. This list and
- * its contents will be deleted at the end of the effect by
- * elm_transit_effect_image_animation_context_free() function.
- *
- * Example:
- * @code
- * char buf[PATH_MAX];
- * Eina_List *images = NULL;
- * Elm_Transit *transi = elm_transit_add();
- *
- * snprintf(buf, sizeof(buf), "%s/images/icon_11.png", PACKAGE_DATA_DIR);
- * images = eina_list_append(images, eina_stringshare_add(buf));
- *
- * snprintf(buf, sizeof(buf), "%s/images/logo_small.png", PACKAGE_DATA_DIR);
- * images = eina_list_append(images, eina_stringshare_add(buf));
- * elm_transit_effect_image_animation_add(transi, images);
- *
- * @endcode
- *
- * @see elm_transit_effect_add()
- *
- * @param transit Transit object.
- * @param images Eina_List of images file paths. This list and
- * its contents will be deleted at the end of the effect by
- * elm_transit_effect_image_animation_context_free() function.
- * @return Image Animation effect context data.
- *
- * @ingroup Transit
- */
EAPI Elm_Transit_Effect *
elm_transit_effect_image_animation_add(Elm_Transit *transit, Eina_List *images)
{
ELM_TRANSIT_CHECK_OR_RETURN(transit, NULL);
Elm_Transit_Effect *effect = _transit_effect_image_animation_context_new(images);
- if (!effect) return NULL;
+ if (!effect)
+ {
+ ERR("Failed to allocate image_animation effect! : transit=%p", transit);
+ return NULL;
+ }
elm_transit_effect_add(transit,
_transit_effect_image_animation_op, effect,
_transit_effect_image_animation_context_free);
projects / framework / uifw / elementary.git / blobdiff