#include <Elementary.h>
#include "elm_priv.h"
-/**
- * @addtogroup Animator Animator
- * @ingroup Elementary
- *
- * Support normalized frame value for animation.
-*/
-#define MAGIC_OBJ_ANIMATOR 0x40777770
+#define ELM_ANIMATOR_CHECK_OR_RETURN(animator, ...) \
+ do { \
+ if (!animator) { \
+ CRITICAL("Elm_Animator " # animator " is NULL!"); \
+ return __VA_ARGS__; \
+ } \
+ if (!EINA_MAGIC_CHECK(animator, ELM_ANIMATOR_MAGIC)) { \
+ EINA_MAGIC_FAIL(animator, ELM_ANIMATOR_MAGIC); \
+ return __VA_ARGS__; \
+ } \
+ } while (0)
+
struct _Elm_Animator
{
- int magic;
+#define ELM_ANIMATOR_MAGIC 0x40777770
+ EINA_MAGIC;
+
Evas_Object *parent;
Ecore_Animator *animator;
double begin_time;
double duration;
unsigned int repeat_cnt;
unsigned int cur_repeat_cnt;
- double (*curve_op) (double frame);
void (*animator_op) (void *data, Elm_Animator *animator, double frame);
void *animator_arg;
void (*completion_op) (void *data);
void *completion_arg;
+ Elm_Animator_Curve_Style curve_style;
Eina_Bool auto_reverse:1;
Eina_Bool on_animating:1;
};
animator->cur_time = ecore_loop_time_get();
elapsed_time = animator->cur_time - animator->begin_time;
if (elapsed_time > animator->duration) elapsed_time = animator->duration;
- frame = animator->curve_op(elapsed_time / animator->duration);
+
+ //Compute current frame
+ switch (animator->curve_style)
+ {
+ case ELM_ANIMATOR_CURVE_IN_OUT:
+ frame = _animator_curve_in_out(elapsed_time / animator->duration);
+ break;
+ case ELM_ANIMATOR_CURVE_IN:
+ frame = _animator_curve_in(elapsed_time / animator->duration);
+ break;
+ case ELM_ANIMATOR_CURVE_OUT:
+ frame = _animator_curve_out(elapsed_time / animator->duration);
+ break;
+ default:
+ frame = _animator_curve_linear(elapsed_time / animator->duration);
+ break;
+ }
+
//Reverse?
if (animator->auto_reverse)
{
- if (!(animator->cur_repeat_cnt % 2)) frame = 1 - frame;
+ if (!(animator->cur_repeat_cnt % 2)) frame = 1 - frame;
}
if (animator->duration > 0)
//Not end. Keep going.
if (elapsed_time < animator->duration) return ECORE_CALLBACK_RENEW;
- //Repeat and reverse and time done!
+ //Repeat and reverse and time done!
if (!animator->cur_repeat_cnt)
{
- animator->on_animating = EINA_FALSE;
- _delete_animator(animator);
- if (animator->completion_op)
- animator->completion_op(animator->completion_arg);
- return ECORE_CALLBACK_CANCEL;
+ animator->on_animating = EINA_FALSE;
+ _delete_animator(animator);
+ if (animator->completion_op)
+ animator->completion_op(animator->completion_arg);
+ return ECORE_CALLBACK_CANCEL;
}
//Repeat Case
static void
_animator_parent_del(void *data, Evas *evas __UNUSED__,
- Evas_Object *obj __UNUSED__, void *event __UNUSED__)
+ Evas_Object *obj __UNUSED__, void *event __UNUSED__)
{
elm_animator_del(data);
}
-/**
- * Get the value of reverse mode.
- *
- * @param[in] animator Animator object
- * @return EINA_TRUE is reverse mode
- *
- * @ingroup Animator
- */
EAPI Eina_Bool
elm_animator_auto_reverse_get(const Elm_Animator *animator)
{
- if ((!animator) || (animator->magic != MAGIC_OBJ_ANIMATOR)) return EINA_FALSE;
+ ELM_ANIMATOR_CHECK_OR_RETURN(animator, EINA_FALSE);
return animator->auto_reverse;
}
-/**
- * Get the value of repeat count.
- *
- * @param[in] animator Animator object
- * @return Repeat count
- *
- * @ingroup Animator
- */
EAPI unsigned int
elm_animator_repeat_get(const Elm_Animator *animator)
{
- if ((!animator) || (animator->magic != MAGIC_OBJ_ANIMATOR)) return 0;
+ ELM_ANIMATOR_CHECK_OR_RETURN(animator, 0);
return animator->repeat_cnt;
}
-/**
- * Set auto reverse function.
- *
- * @param[in] animator Animator object
- * @param[in] reverse Reverse or not
- *
- * @ingroup Animator
- */
+EAPI Elm_Animator_Curve_Style
+elm_animator_curve_style_get(const Elm_Animator *animator)
+{
+ ELM_ANIMATOR_CHECK_OR_RETURN(animator, ELM_ANIMATOR_CURVE_LINEAR);
+ return animator->curve_style;
+}
+
EAPI void
elm_animator_auto_reverse_set(Elm_Animator *animator, Eina_Bool reverse)
{
- if ((!animator) || (animator->magic != MAGIC_OBJ_ANIMATOR)) return;
+ ELM_ANIMATOR_CHECK_OR_RETURN(animator);
if (animator->auto_reverse == reverse) return;
animator->auto_reverse = reverse;
if (reverse)
animator->repeat_cnt =
- _animator_compute_reverse_repeat_count(animator->repeat_cnt);
+ _animator_compute_reverse_repeat_count(animator->repeat_cnt);
else
animator->repeat_cnt =
- _animator_compute_no_reverse_repeat_count(animator->repeat_cnt);
+ _animator_compute_no_reverse_repeat_count(animator->repeat_cnt);
}
-/**
- * Set the animation acceleration style.
- *
- * @param[in] animator Animator object
- * @param[in] cs Curve style. Default is ELM_ANIMATOR_CURVE_LINEAR
- *
- * @ingroup Animator
- */
EAPI void
elm_animator_curve_style_set(Elm_Animator *animator,
- Elm_Animator_Curve_Style cs)
+ Elm_Animator_Curve_Style cs)
{
- if ((!animator) || (animator->magic != MAGIC_OBJ_ANIMATOR)) return;
- switch (cs)
- {
- case ELM_ANIMATOR_CURVE_LINEAR:
- animator->curve_op = _animator_curve_linear;
- break;
- case ELM_ANIMATOR_CURVE_IN_OUT:
- animator->curve_op = _animator_curve_in_out;
- break;
- case ELM_ANIMATOR_CURVE_IN:
- animator->curve_op = _animator_curve_in;
- break;
- case ELM_ANIMATOR_CURVE_OUT:
- animator->curve_op = _animator_curve_out;
- break;
- default:
- animator->curve_op = _animator_curve_linear;
- break;
- }
+ ELM_ANIMATOR_CHECK_OR_RETURN(animator);
+ animator->curve_style = cs;
}
-
-/**
- * Set the operation duration.
- *
- * @param[in] animator Animator object
- * @param[in] duration Duration in second
- *
- * @ingroup Animator
- */
EAPI void
elm_animator_duration_set(Elm_Animator *animator, double duration)
{
- if ((!animator) || (animator->magic != MAGIC_OBJ_ANIMATOR)) return;
+ ELM_ANIMATOR_CHECK_OR_RETURN(animator);
if (animator->on_animating) return;
animator->duration = duration;
}
-/**
- * Set the callback function for animator operation.
- * The range of callback function frame data is to 0 ~ 1
- * User can refer this frame value for one's animation frame data.
- * @param[in] animator Animator object
- * @param[in] func Callback function pointer
- * @param[in] data Callback function user argument
- *
- * @ingroup Animator
- */
EAPI void
elm_animator_operation_callback_set(Elm_Animator *animator,
Elm_Animator_Operation_Cb func,
void *data)
{
- if ((!animator) || (animator->magic != MAGIC_OBJ_ANIMATOR)) return;
+ ELM_ANIMATOR_CHECK_OR_RETURN(animator);
if (animator->on_animating) return;
animator->animator_op = func;
animator->animator_arg = data;
}
-/**
- * Add new animator.
- *
- * @param[in] parent Parent object
- * @return animator object
- *
- * @ingroup Animator
- */
EAPI Elm_Animator *
elm_animator_add(Evas_Object *parent)
{
Elm_Animator *animator = ELM_NEW(Elm_Animator);
if (!animator) return NULL;
+ EINA_MAGIC_SET(animator, ELM_ANIMATOR_MAGIC);
animator->parent = parent;
- animator->magic = MAGIC_OBJ_ANIMATOR;
elm_animator_auto_reverse_set(animator, EINA_FALSE);
elm_animator_curve_style_set(animator, ELM_ANIMATOR_CURVE_LINEAR);
if (parent)
evas_object_event_callback_add(parent, EVAS_CALLBACK_DEL,
- _animator_parent_del, animator);
-
+ _animator_parent_del, animator);
return animator;
}
-/**
- * Get the status for the animator operation.
- *
- * @param[in] animator Animator object
- * @return EINA_TRUE is animator is operating.
- *
- * @ingroup Animator
- */
EAPI Eina_Bool
elm_animator_operating_get(const Elm_Animator *animator)
{
- if ((!animator) || (animator->magic != MAGIC_OBJ_ANIMATOR)) return EINA_FALSE;
+ ELM_ANIMATOR_CHECK_OR_RETURN(animator, EINA_FALSE);
return animator->on_animating;
}
-/**
- * Delete animator.
- *
- * @param[in] animator Animator object
- *
- * @ingroup Animator
- */
EAPI void
elm_animator_del(Elm_Animator *animator)
{
- if ((!animator) || (animator->magic != MAGIC_OBJ_ANIMATOR)) return;
+ ELM_ANIMATOR_CHECK_OR_RETURN(animator);
_delete_animator(animator);
if (animator->parent)
evas_object_event_callback_del(animator->parent, EVAS_CALLBACK_DEL,
- _animator_parent_del);
+ _animator_parent_del);
- memset(animator, 0x0, sizeof(Elm_Animator));
+ EINA_MAGIC_SET(animator, EINA_MAGIC_NONE);
free(animator);
}
-/**
- * Set the callback function for the animator end.
- *
- * @param[in] animator Animator object
- * @param[in] func Callback function pointer
- * @param[in] data Callback function user argument
- *
- * @ingroup Animator
- */
EAPI void
elm_animator_completion_callback_set(Elm_Animator *animator,
- Elm_Animator_Completion_Cb func,
+ Elm_Animator_Completion_Cb func,
void *data)
{
- if (!animator || (animator->magic != MAGIC_OBJ_ANIMATOR)) return;
+ ELM_ANIMATOR_CHECK_OR_RETURN(animator);
if (animator->on_animating) return;
animator->completion_op = func;
animator->completion_arg = data;
}
-/**
- * Pause the animator.
- *
- * @param[in] animator Animator object
- *
- * @ingroup Animator
- */
EAPI void
elm_animator_pause(Elm_Animator *animator)
{
- if ((!animator) || (animator->magic != MAGIC_OBJ_ANIMATOR)) return;
+ ELM_ANIMATOR_CHECK_OR_RETURN(animator);
if (!animator->on_animating) return;
ecore_animator_freeze(animator->animator);
}
-/**
- * Resume the animator.
- *
- * @param[in] animator Animator object
- *
- * @ingroup Animator
- */
EAPI void
elm_animator_resume(Elm_Animator *animator)
{
- if ((!animator) || (animator->magic != MAGIC_OBJ_ANIMATOR)) return;
+ ELM_ANIMATOR_CHECK_OR_RETURN(animator);
if (!animator->on_animating) return;
ecore_animator_thaw(animator->animator);
}
-/**
- * Stop animator.
- *
- * @param[in] animator Animator object
- *
- * @ingroup Animator
- */
EAPI void
elm_animator_stop(Elm_Animator *animator)
{
- if ((!animator) || (animator->magic != MAGIC_OBJ_ANIMATOR)) return;
+ ELM_ANIMATOR_CHECK_OR_RETURN(animator);
animator->on_animating = EINA_FALSE;
_delete_animator(animator);
}
-/**
- * Set the animator repeat count.
- *
- * @param[in] animator Animator object
- * @param[in] repeat_cnt Repeat count
- *
- * @ingroup Animator
- */
EAPI void
elm_animator_repeat_set(Elm_Animator *animator, unsigned int repeat_cnt)
{
- if ((!animator) || (animator->magic != MAGIC_OBJ_ANIMATOR)) return;
+ ELM_ANIMATOR_CHECK_OR_RETURN(animator);
if (!animator->auto_reverse) animator->repeat_cnt = repeat_cnt;
else
animator->repeat_cnt = _animator_compute_reverse_repeat_count(repeat_cnt);
}
-/**
- * Animate now.
- *
- * @param[in] animator Animator object
- *
- * @ingroup Animator
- */
EAPI void
elm_animator_animate(Elm_Animator *animator)
{
- if ((!animator) || (animator->magic != MAGIC_OBJ_ANIMATOR)) return;
+ ELM_ANIMATOR_CHECK_OR_RETURN(animator);
if (!animator->animator_op) return;
animator->begin_time = ecore_loop_time_get();
animator->cur_repeat_cnt = animator->repeat_cnt;