From 824dfcc67e6d66f38afa8d1fa175a8512e674a26 Mon Sep 17 00:00:00 2001 From: Emmanuele Bassi Date: Wed, 28 Mar 2012 13:21:58 +0100 Subject: [PATCH] docs: Mention in-flight value changes --- clutter/clutter-actor.c | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/clutter/clutter-actor.c b/clutter/clutter-actor.c index 865110945..7787cfbdf 100644 --- a/clutter/clutter-actor.c +++ b/clutter/clutter-actor.c @@ -258,6 +258,27 @@ * and a default easing mode of %CLUTTER_EASE_OUT_CUBIC, unless you call * clutter_actor_set_easing_mode() and clutter_actor_set_easing_duration() * after changing the easing state of the actor. + * It is important to note that if you modify the state on an + * animatable property while a transition is in flight, the transition's + * final value will be updated, as well as its duration and progress + * mode by using the current easing state; for instance, in the following + * example: + * + * clutter_actor_save_easing_state (actor); + * clutter_actor_set_x (actor, 200); + * clutter_actor_restore_easing_state (actor); + * + * clutter_actor_save_easing_state (actor); + * clutter_actor_set_x (actor, 100); + * clutter_actor_restore_easing_state (actor); + * + * the first call to clutter_actor_set_x() will begin a transition + * of the #ClutterActor:x property to the value of 200; the second call + * to clutter_actor_set_x() will change the transition's final value to + * 100. + * It is possible to retrieve the #ClutterTransition used by the + * animatable properties by using clutter_actor_get_transition() and using + * the property name as the transition name. * * * Explicit animations