From 679ce128e4a789a123f34e4133bb0ed1af8c12bf Mon Sep 17 00:00:00 2001 From: Emmanuele Bassi Date: Sat, 4 Aug 2007 09:42:01 +0000 Subject: [PATCH] 2007-08-04 Emmanuele Bassi * clutter/clutter-behaviour-depth.c: Clarify the depth behaviour even more in the description used by the API reference. --- ChangeLog | 7 ++++++- clutter/clutter-behaviour-depth.c | 12 ++++++++++-- 2 files changed, 16 insertions(+), 3 deletions(-) diff --git a/ChangeLog b/ChangeLog index d0a112428..aec9ee1f1 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,6 +1,11 @@ 2007-08-04 Emmanuele Bassi - * clutter/clutter-behaviour-depth.c: Clarify that what drives + * clutter/clutter-behaviour-depth.c: Clarify the depth behaviour + even more in the description used by the API reference. + +2007-08-04 Emmanuele Bassi + + * clutter/clutter-behaviour-depth.[ch]: Clarify that what drives the movement along the Z axis is the ClutterAlpha object (we don't have the luxury of a rollover like the opacity does); so, if you want to go from 0 to -100 you have to use a diff --git a/clutter/clutter-behaviour-depth.c b/clutter/clutter-behaviour-depth.c index fe1ac72d6..67cf0d6e0 100644 --- a/clutter/clutter-behaviour-depth.c +++ b/clutter/clutter-behaviour-depth.c @@ -44,9 +44,17 @@ * The minimum and maximum depth are controlled by the * ClutterBehaviourDepth:min-depth and ClutterBehaviourDepth:max-depth * properties. The direction of the motion on the depth axis is controlled - * by the #ClutterAlpha object. + * by the #ClutterAlpha object. If you want to make a #ClutterActor + * controlled by the #ClutterBehaviourDepth behaviour from a depth of + * 0 to a depth of 100 you will have to use an increasing alpha function, + * like %CLUTTER_ALPHA_RAMP_INC. On the other hand, if you want to make + * the same actor move from a depth of 100 to a depth of 0 you will have + * to use a decreasing alpha function, like %CLUTTER_ALPHA_RAMP_DEC. Using + * a minimum depth greater than the maximum depth and a decreasing alpha + * function, or using a maximum depth greater than the minimum depth and + * an increasing alpha function will result in an undefined behaviour. * - * Since: 0.4 + * #ClutterBehaviourDepth is available since Clutter 0.4. */ G_DEFINE_TYPE (ClutterBehaviourDepth,