From 143be77205a7e2f78ec43300ff5f7530be33ac36 Mon Sep 17 00:00:00 2001 From: Emmanuele Bassi Date: Fri, 8 Feb 2008 15:39:41 +0000 Subject: [PATCH] 2008-02-08 Emmanuele Bassi * clutter/clutter-behaviour-path.c: Move the nice graph and description from the Path behaviour... * clutter/clutter-behaviour.c: ... to the main Behaviour class. --- ChangeLog | 7 +++++++ clutter/clutter-behaviour-path.c | 12 ------------ clutter/clutter-behaviour.c | 20 +++++++++++++++++++- 3 files changed, 26 insertions(+), 13 deletions(-) diff --git a/ChangeLog b/ChangeLog index 1d9d5778a..6d4498499 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,10 @@ +2008-02-08 Emmanuele Bassi + + * clutter/clutter-behaviour-path.c: Move the nice graph and + description from the Path behaviour... + + * clutter/clutter-behaviour.c: ... to the main Behaviour class. + 2008-02-08 Emmanuele Bassi * clutter/clutter-behaviour-path.c: Add a paragraph describing diff --git a/clutter/clutter-behaviour-path.c b/clutter/clutter-behaviour-path.c index ff4aee8ca..afd077fff 100644 --- a/clutter/clutter-behaviour-path.c +++ b/clutter/clutter-behaviour-path.c @@ -40,18 +40,6 @@ * knot in the path is reached with the upper bound value provided by * the #ClutterAlpha object used by the behaviour. * - *
- * Effects of alpha functions on a path - * - *
- * - * The actors position between the path's end points directly correlates - * to the #ClutterAlpha's current alpha value driving the behaviour. With - * the #ClutterAlpha's function set to %CLUTTER_ALPHA_RAMP_INC the actor - * will follow the path at a constant velocity, but when changing to - * %CLUTTER_ALPHA_SINE_INC the actor initially accelerates quickly before - * quickly decelerating. - * * If the alpha function is a periodic function, i.e. it returns to * 0 after reaching %CLUTTER_ALPHA_MAX_ALPHA, then the actors will walk * the path back to the starting #ClutterKnot. diff --git a/clutter/clutter-behaviour.c b/clutter/clutter-behaviour.c index 3703774bf..664041b33 100644 --- a/clutter/clutter-behaviour.c +++ b/clutter/clutter-behaviour.c @@ -42,11 +42,29 @@ * of a set of actors; #ClutterBehaviourScale, which controls the width * and height of a set of actors. * + * To visualize the effects of different alpha functions on a + * #ClutterBehaviour implementation it is possible to take the + * #ClutterBehaviourPath as an example: + * + *
+ * Effects of alpha functions on a path + * + *
+ * + * The actors position between the path's end points directly correlates + * to the #ClutterAlpha's current alpha value driving the behaviour. With + * the #ClutterAlpha's function set to %CLUTTER_ALPHA_RAMP_INC the actor + * will follow the path at a constant velocity, but when changing to + * %CLUTTER_ALPHA_SINE_INC the actor initially accelerates before quickly + * decelerating. + * * In order to implement a new behaviour you should subclass #ClutterBehaviour * and override the "alpha_notify" virtual function; inside the overridden * function you should obtain the alpha value from the #ClutterAlpha * instance bound to the behaviour and apply it to the desiderd property - * (or properties) of every actor controlled by the behaviour. + * (or properties) of every actor controlled by the behaviour. + * + * #ClutterBehaviour is available since Clutter 0.2 */ #ifdef HAVE_CONFIG_H