isa/mutter
1
0
Fork 0
mirror of https://github.com/brl/mutter.git synced 2025-01-11 20:22:23 +00:00
Code Issues Packages Projects Releases Wiki Activity

[docs] Clarify Animation memory management

Browse Source 
The memory management of the ClutterAnimation instances should be
heavily documented, given its "automagical" nature, so that other
people might understand it and avoid breaking it in the future.
This commit is contained in:
Emmanuele Bassi 2009-03-16 11:28:29 +00:00
parent 0674fded7f
commit a5c88e62f2
1 changed files with 7 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
clutter/clutter-animation.c
View File

@ -243,6 +243,10 @@ clutter_animation_real_completed (ClutterAnimation *animation)
CLUTTER_NOTE (ANIMATION, "Animation [%p] complete: unreffing", CLUTTER_NOTE (ANIMATION, "Animation [%p] complete: unreffing",
animation); animation);
/* the signal emission takes a reference on the animation, which
* means that even if we unref it here, it'll be valid for the
* whole duration of the emission chain
*/
g_object_unref (animation); g_object_unref (animation);
} }
@ -1539,7 +1543,9 @@ clutter_actor_animate_with_timeline (ClutterActor *actor,
* *
* <note>Unless the animation is looping, it will become invalid as soon * <note>Unless the animation is looping, it will become invalid as soon
* as it is complete. To avoid this, you should keep a reference on the * as it is complete. To avoid this, you should keep a reference on the
* returned value using g_object_ref().</note> * returned value using g_object_ref(). If you want to keep the animation
* alive across multiple cycles, you also have to add a reference each
* time the #ClutterAnimation::completed signal is emitted.</note>
* *
* Return value: (transfer none): a #ClutterAnimation object. The object is * Return value: (transfer none): a #ClutterAnimation object. The object is
* owned by the #ClutterActor and should not be unreferenced with * owned by the #ClutterActor and should not be unreferenced with