From acc28cf60c482bf56bb298630a9d1b75f350d31b Mon Sep 17 00:00:00 2001
From: Elliot Smith <elliot.smith@intel.com>
Date: Tue, 31 Aug 2010 17:42:37 +0100
Subject: [PATCH 1/6] cookbook: Added example for animation reuse recipe

Added an example showing how to reuse a ClutterAnimator
instance to animate multiple actors at different times
using an animatable rig, combined with reparenting.
---
 doc/cookbook/examples/Makefile.am           |   2 +
 doc/cookbook/examples/animations-reuse.c    | 117 ++++++++++++++++++
 doc/cookbook/examples/animations-reuse.json | 124 ++++++++++++++++++++
 3 files changed, 243 insertions(+)
 create mode 100644 doc/cookbook/examples/animations-reuse.c
 create mode 100644 doc/cookbook/examples/animations-reuse.json

diff --git a/doc/cookbook/examples/Makefile.am b/doc/cookbook/examples/Makefile.am
index 6039c690b..e1bcd81b9 100644
--- a/doc/cookbook/examples/Makefile.am
+++ b/doc/cookbook/examples/Makefile.am
@@ -4,6 +4,7 @@ NULL =
 
 noinst_PROGRAMS = \
 	animations-complex	\
+	animations-reuse	\
 	animations-rotating	\
 	text-shadow		\
 	textures-reflection	\
@@ -45,6 +46,7 @@ AM_CFLAGS = \
 AM_LDFLAGS = $(CLUTTER_LIBS) -export-dynamic
 
 animations_complex_SOURCES                 = animations-complex.c
+animations_reuse_SOURCES                   = animations-reuse.c
 animations_rotating_SOURCES                = animations-rotating.c
 text_shadow_SOURCES                        = text-shadow.c
 textures_reflection_SOURCES                = textures-reflection.c
diff --git a/doc/cookbook/examples/animations-reuse.c b/doc/cookbook/examples/animations-reuse.c
new file mode 100644
index 000000000..2a7ffbecd
--- /dev/null
+++ b/doc/cookbook/examples/animations-reuse.c
@@ -0,0 +1,117 @@
+#include <stdlib.h>
+#include <clutter/clutter.h>
+
+gboolean
+foo_button_pressed_cb (ClutterActor *actor,
+                       ClutterEvent *event,
+                       gpointer      user_data)
+{
+  ClutterScript *script = CLUTTER_SCRIPT (user_data);
+
+  ClutterAnimator *bounce;
+  ClutterActor *rig;
+  ClutterTimeline *bounce_timeline;
+
+  clutter_script_get_objects (script,
+                              "bounce_timeline", &bounce_timeline,
+                              "rig", &rig,
+                              "bounce", &bounce,
+                              NULL);
+
+  /* don't allow animation to be reused until it is complete */
+  if (clutter_timeline_is_playing (bounce_timeline))
+    return TRUE;
+
+  clutter_actor_set_position (rig, 0, 0);
+
+  clutter_actor_set_scale (rig, 1.0, 1.0);
+
+  clutter_actor_reparent (actor, rig);
+
+  clutter_animator_start (bounce);
+
+  return TRUE;
+}
+
+/* set the actor's position to the rig's position
+ * but parented to the background;
+ * remove the click handler so the rectangle can't be animated again
+ */
+static void
+_move_to_background_cb (ClutterActor *actor,
+                        gpointer      user_data)
+{
+  ClutterActor *background = CLUTTER_ACTOR (user_data);
+
+  gfloat x, y;
+  clutter_actor_get_position (clutter_actor_get_parent (actor), &x, &y);
+
+  gdouble scale_x, scale_y;
+  clutter_actor_get_scale (clutter_actor_get_parent (actor), &scale_x, &scale_y);
+
+  clutter_actor_reparent (actor, background);
+
+  clutter_actor_set_position (actor, x, y);
+  clutter_actor_set_scale (actor, scale_x, scale_y);
+
+  g_signal_handlers_disconnect_matched (actor,
+                                        G_SIGNAL_MATCH_FUNC,
+                                        0,
+                                        0,
+                                        NULL,
+                                        foo_button_pressed_cb,
+                                        NULL);
+}
+
+void
+foo_rig_animation_complete_cb (ClutterTimeline *timeline,
+                               gpointer         user_data)
+{
+  ClutterScript *script = CLUTTER_SCRIPT (user_data);
+
+  ClutterContainer *rig;
+  ClutterActor *background;
+
+  clutter_script_get_objects (script,
+                              "rig", &rig,
+                              "background", &background,
+                              NULL);
+
+  clutter_container_foreach (rig,
+                             CLUTTER_CALLBACK (_move_to_background_cb),
+                             background);
+}
+
+int
+main (int argc, char *argv[])
+{
+  clutter_init (&argc, &argv);
+
+  gchar *filename = "animations-reuse.json";
+  GError *error = NULL;
+
+  ClutterScript *script = clutter_script_new ();
+  clutter_script_load_from_file (script, filename, &error);
+
+  if (error != NULL)
+    {
+      g_critical ("Error loading ClutterScript file %s\n%s", filename, error->message);
+      g_error_free (error);
+      exit (EXIT_FAILURE);
+    }
+
+  clutter_script_connect_signals (script, script);
+
+  ClutterActor *stage;
+  clutter_script_get_objects (script,
+                              "stage", &stage,
+                              NULL);
+
+  clutter_actor_show (stage);
+
+  clutter_main ();
+
+  g_object_unref (script);
+
+  return EXIT_SUCCESS;
+}
diff --git a/doc/cookbook/examples/animations-reuse.json b/doc/cookbook/examples/animations-reuse.json
new file mode 100644
index 000000000..c300cd9e9
--- /dev/null
+++ b/doc/cookbook/examples/animations-reuse.json
@@ -0,0 +1,124 @@
+[
+  {
+    "type" : "ClutterStage",
+    "id" : "stage",
+    "width" : 550,
+    "height" : 400,
+    "color" : "#333355ff",
+
+    "signals" : [
+      { "name" : "destroy", "handler" : "clutter_main_quit" }
+    ],
+
+    "children" : [
+
+      {
+        "type" : "ClutterRectangle",
+        "id" : "rect1",
+        "color" : "red",
+        "width" : 50,
+        "height" : 50,
+        "reactive" : true,
+        "signals" : [
+          { "name" : "button-press-event", "handler" : "foo_button_pressed_cb" }
+        ]
+      },
+
+      {
+        "type" : "ClutterRectangle",
+        "id" : "rect2",
+        "color" : "blue",
+        "width" : 50,
+        "height" : 50,
+        "reactive" : true,
+        "signals" : [
+          { "name" : "button-press-event", "handler" : "foo_button_pressed_cb" }
+        ]
+      },
+
+      {
+        "type" : "ClutterRectangle",
+        "id" : "rect3",
+        "color" : "green",
+        "width" : 50,
+        "height" : 50,
+        "reactive" : true,
+        "signals" : [
+          { "name" : "button-press-event", "handler" : "foo_button_pressed_cb" }
+        ]
+      },
+
+      {
+        "type" : "ClutterGroup",
+        "id" : "background"
+      },
+
+      {
+        "type" : "ClutterGroup",
+        "id" : "rig"
+      }
+
+    ]
+  },
+
+  {
+    "type" : "ClutterAnimator",
+    "id" : "bounce",
+    "timeline" : {
+      "type" : "ClutterTimeline",
+      "id" : "bounce_timeline",
+      "duration" : 3000,
+
+      "signals" : [
+        { "name" : "completed", "handler" : "foo_rig_animation_complete_cb" }
+      ]
+    },
+
+    "properties" : [
+      {
+        "object" : "rig",
+        "name" : "x",
+        "ease-in" : true,
+        "keys" : [
+          [ 0.2, "easeOutCubic", 100.0 ],
+          [ 0.6, "easeOutCubic", 150.0 ],
+          [ 0.8, "linear", 350.0 ],
+          [ 1.0, "linear", 500.0 ]
+        ]
+      },
+      {
+        "object" : "rig",
+        "name" : "y",
+        "ease-in" : true,
+        "keys" : [
+          [ 0.2, "easeOutCubic", 200.0 ],
+          [ 0.6, "easeOutBounce",  200.0 ],
+          [ 0.8, "linear", 200.0 ],
+          [ 1.0, "linear", 0.0 ]
+        ]
+      },
+      {
+        "object" : "rig",
+        "name" : "scale-x",
+        "ease-in" : true,
+        "keys" : [
+          [ 0.2, "easeOutElastic", 2.0 ],
+          [ 0.6, "easeOutBounce",  4.0 ],
+          [ 0.8, "linear", 4.0 ],
+          [ 1.0, "linear", 1.0 ]
+        ]
+      },
+      {
+        "object" : "rig",
+        "name" : "scale-y",
+        "ease-in" : true,
+        "keys" : [
+          [ 0.2, "easeOutElastic", 2.0 ],
+          [ 0.6, "easeOutBounce",  4.0 ],
+          [ 0.8, "linear", 4.0 ],
+          [ 1.0, "linear", 1.0 ]
+        ]
+      }
+    ]
+  }
+]

From d4190cbf8ce8c667110744976c8cdd52ff3ede81 Mon Sep 17 00:00:00 2001
From: Elliot Smith <elliot.smith@intel.com>
Date: Wed, 1 Sep 2010 10:21:23 +0100
Subject: [PATCH 2/6] cookbook: Refactored reusable animation example

Extracted the animation into its own JSON definition,
then create a new script and get the animation each
time a rectangle is clicked.

Removes the need to reparent onto the background and
copy property values to the rectangle after the animation,
and generally much cleaner.
---
 .../examples/animations-reuse-animation.json  |  63 +++++++++
 .../examples/animations-reuse-ui.json         |  53 ++++++++
 doc/cookbook/examples/animations-reuse.c      | 108 ++++++---------
 doc/cookbook/examples/animations-reuse.json   | 124 ------------------
 4 files changed, 158 insertions(+), 190 deletions(-)
 create mode 100644 doc/cookbook/examples/animations-reuse-animation.json
 create mode 100644 doc/cookbook/examples/animations-reuse-ui.json
 delete mode 100644 doc/cookbook/examples/animations-reuse.json

diff --git a/doc/cookbook/examples/animations-reuse-animation.json b/doc/cookbook/examples/animations-reuse-animation.json
new file mode 100644
index 000000000..cad247500
--- /dev/null
+++ b/doc/cookbook/examples/animations-reuse-animation.json
@@ -0,0 +1,63 @@
+[
+  {
+    "type" : "ClutterGroup",
+    "id" : "rig"
+  },
+
+  {
+    "type" : "ClutterAnimator",
+    "id" : "bounce",
+    "timeline" : {
+      "type" : "ClutterTimeline",
+      "id" : "bounce_timeline",
+      "duration" : 2500
+    },
+
+    "properties" : [
+      {
+        "object" : "rig",
+        "name" : "x",
+        "ease-in" : true,
+        "keys" : [
+          [ 0.2, "easeOutCubic", 100.0 ],
+          [ 0.6, "easeOutCubic", 150.0 ],
+          [ 0.8, "linear", 350.0 ],
+          [ 1.0, "linear", 500.0 ]
+        ]
+      },
+      {
+        "object" : "rig",
+        "name" : "y",
+        "ease-in" : true,
+        "keys" : [
+          [ 0.2, "easeOutCubic", 200.0 ],
+          [ 0.6, "easeOutBounce",  200.0 ],
+          [ 0.8, "linear", 200.0 ],
+          [ 1.0, "linear", 0.0 ]
+        ]
+      },
+      {
+        "object" : "rig",
+        "name" : "scale-x",
+        "ease-in" : true,
+        "keys" : [
+          [ 0.2, "easeOutElastic", 2.0 ],
+          [ 0.6, "easeOutBounce",  4.0 ],
+          [ 0.8, "linear", 4.0 ],
+          [ 1.0, "linear", 1.0 ]
+        ]
+      },
+      {
+        "object" : "rig",
+        "name" : "scale-y",
+        "ease-in" : true,
+        "keys" : [
+          [ 0.2, "easeOutElastic", 2.0 ],
+          [ 0.6, "easeOutBounce",  4.0 ],
+          [ 0.8, "linear", 4.0 ],
+          [ 1.0, "linear", 1.0 ]
+        ]
+      }
+    ]
+  }
+]
diff --git a/doc/cookbook/examples/animations-reuse-ui.json b/doc/cookbook/examples/animations-reuse-ui.json
new file mode 100644
index 000000000..0b9e24087
--- /dev/null
+++ b/doc/cookbook/examples/animations-reuse-ui.json
@@ -0,0 +1,53 @@
+[
+  {
+    "type" : "ClutterStage",
+    "id" : "stage",
+    "width" : 550,
+    "height" : 400,
+    "color" : "#333355ff",
+
+    "signals" : [
+      { "name" : "destroy", "handler" : "clutter_main_quit" }
+    ],
+
+    "children" : [
+
+      {
+        "type" : "ClutterRectangle",
+        "id" : "rect1",
+        "color" : "red",
+        "width" : 50,
+        "height" : 50,
+        "reactive" : true,
+        "signals" : [
+          { "name" : "button-press-event", "handler" : "foo_button_pressed_cb" }
+        ]
+      },
+
+      {
+        "type" : "ClutterRectangle",
+        "id" : "rect2",
+        "color" : "blue",
+        "width" : 50,
+        "height" : 50,
+        "reactive" : true,
+        "signals" : [
+          { "name" : "button-press-event", "handler" : "foo_button_pressed_cb" }
+        ]
+      },
+
+      {
+        "type" : "ClutterRectangle",
+        "id" : "rect3",
+        "color" : "green",
+        "width" : 50,
+        "height" : 50,
+        "reactive" : true,
+        "signals" : [
+          { "name" : "button-press-event", "handler" : "foo_button_pressed_cb" }
+        ]
+      }
+
+    ]
+  }
+]
diff --git a/doc/cookbook/examples/animations-reuse.c b/doc/cookbook/examples/animations-reuse.c
index 2a7ffbecd..78d0082a9 100644
--- a/doc/cookbook/examples/animations-reuse.c
+++ b/doc/cookbook/examples/animations-reuse.c
@@ -1,12 +1,38 @@
 #include <stdlib.h>
 #include <clutter/clutter.h>
 
+#define UI_FILE "animations-reuse-ui.json"
+#define ANIMATION_FILE "animations-reuse-animation.json"
+
+static gboolean
+_load_script (ClutterScript *script,
+              gchar         *filename)
+{
+  GError *error = NULL;
+
+  clutter_script_load_from_file (script, filename, &error);
+
+  if (error != NULL)
+    {
+      g_critical ("Error loading ClutterScript file %s\n%s", filename, error->message);
+      g_error_free (error);
+      exit (EXIT_FAILURE);
+    }
+
+  return TRUE;
+}
+
 gboolean
 foo_button_pressed_cb (ClutterActor *actor,
                        ClutterEvent *event,
                        gpointer      user_data)
 {
-  ClutterScript *script = CLUTTER_SCRIPT (user_data);
+  ClutterScript *ui = CLUTTER_SCRIPT (user_data);
+  ClutterStage *stage = CLUTTER_STAGE (clutter_script_get_object (ui, "stage"));
+
+  ClutterScript *script = clutter_script_new ();
+
+  _load_script (script, ANIMATION_FILE);
 
   ClutterAnimator *bounce;
   ClutterActor *rig;
@@ -18,13 +44,22 @@ foo_button_pressed_cb (ClutterActor *actor,
                               "bounce", &bounce,
                               NULL);
 
-  /* don't allow animation to be reused until it is complete */
-  if (clutter_timeline_is_playing (bounce_timeline))
-    return TRUE;
+  /* remove the button press handler */
+  g_signal_handlers_disconnect_matched (actor,
+                                        G_SIGNAL_MATCH_FUNC,
+                                        0,
+                                        0,
+                                        NULL,
+                                        foo_button_pressed_cb,
+                                        NULL);
 
-  clutter_actor_set_position (rig, 0, 0);
+  /* add a handler to clean up when the animation completes */
+  g_signal_connect_swapped (bounce_timeline,
+                            "completed",
+                            G_CALLBACK (g_object_unref),
+                            script);
 
-  clutter_actor_set_scale (rig, 1.0, 1.0);
+  clutter_container_add_actor (CLUTTER_CONTAINER (stage), rig);
 
   clutter_actor_reparent (actor, rig);
 
@@ -33,72 +68,13 @@ foo_button_pressed_cb (ClutterActor *actor,
   return TRUE;
 }
 
-/* set the actor's position to the rig's position
- * but parented to the background;
- * remove the click handler so the rectangle can't be animated again
- */
-static void
-_move_to_background_cb (ClutterActor *actor,
-                        gpointer      user_data)
-{
-  ClutterActor *background = CLUTTER_ACTOR (user_data);
-
-  gfloat x, y;
-  clutter_actor_get_position (clutter_actor_get_parent (actor), &x, &y);
-
-  gdouble scale_x, scale_y;
-  clutter_actor_get_scale (clutter_actor_get_parent (actor), &scale_x, &scale_y);
-
-  clutter_actor_reparent (actor, background);
-
-  clutter_actor_set_position (actor, x, y);
-  clutter_actor_set_scale (actor, scale_x, scale_y);
-
-  g_signal_handlers_disconnect_matched (actor,
-                                        G_SIGNAL_MATCH_FUNC,
-                                        0,
-                                        0,
-                                        NULL,
-                                        foo_button_pressed_cb,
-                                        NULL);
-}
-
-void
-foo_rig_animation_complete_cb (ClutterTimeline *timeline,
-                               gpointer         user_data)
-{
-  ClutterScript *script = CLUTTER_SCRIPT (user_data);
-
-  ClutterContainer *rig;
-  ClutterActor *background;
-
-  clutter_script_get_objects (script,
-                              "rig", &rig,
-                              "background", &background,
-                              NULL);
-
-  clutter_container_foreach (rig,
-                             CLUTTER_CALLBACK (_move_to_background_cb),
-                             background);
-}
-
 int
 main (int argc, char *argv[])
 {
   clutter_init (&argc, &argv);
 
-  gchar *filename = "animations-reuse.json";
-  GError *error = NULL;
-
   ClutterScript *script = clutter_script_new ();
-  clutter_script_load_from_file (script, filename, &error);
-
-  if (error != NULL)
-    {
-      g_critical ("Error loading ClutterScript file %s\n%s", filename, error->message);
-      g_error_free (error);
-      exit (EXIT_FAILURE);
-    }
+  _load_script (script, UI_FILE);
 
   clutter_script_connect_signals (script, script);
 
diff --git a/doc/cookbook/examples/animations-reuse.json b/doc/cookbook/examples/animations-reuse.json
deleted file mode 100644
index c300cd9e9..000000000
--- a/doc/cookbook/examples/animations-reuse.json
+++ /dev/null
@@ -1,124 +0,0 @@
-[
-  {
-    "type" : "ClutterStage",
-    "id" : "stage",
-    "width" : 550,
-    "height" : 400,
-    "color" : "#333355ff",
-
-    "signals" : [
-      { "name" : "destroy", "handler" : "clutter_main_quit" }
-    ],
-
-    "children" : [
-
-      {
-        "type" : "ClutterRectangle",
-        "id" : "rect1",
-        "color" : "red",
-        "width" : 50,
-        "height" : 50,
-        "reactive" : true,
-        "signals" : [
-          { "name" : "button-press-event", "handler" : "foo_button_pressed_cb" }
-        ]
-      },
-
-      {
-        "type" : "ClutterRectangle",
-        "id" : "rect2",
-        "color" : "blue",
-        "width" : 50,
-        "height" : 50,
-        "reactive" : true,
-        "signals" : [
-          { "name" : "button-press-event", "handler" : "foo_button_pressed_cb" }
-        ]
-      },
-
-      {
-        "type" : "ClutterRectangle",
-        "id" : "rect3",
-        "color" : "green",
-        "width" : 50,
-        "height" : 50,
-        "reactive" : true,
-        "signals" : [
-          { "name" : "button-press-event", "handler" : "foo_button_pressed_cb" }
-        ]
-      },
-
-      {
-        "type" : "ClutterGroup",
-        "id" : "background"
-      },
-
-      {
-        "type" : "ClutterGroup",
-        "id" : "rig"
-      }
-
-    ]
-  },
-
-  {
-    "type" : "ClutterAnimator",
-    "id" : "bounce",
-    "timeline" : {
-      "type" : "ClutterTimeline",
-      "id" : "bounce_timeline",
-      "duration" : 3000,
-
-      "signals" : [
-        { "name" : "completed", "handler" : "foo_rig_animation_complete_cb" }
-      ]
-    },
-
-    "properties" : [
-      {
-        "object" : "rig",
-        "name" : "x",
-        "ease-in" : true,
-        "keys" : [
-          [ 0.2, "easeOutCubic", 100.0 ],
-          [ 0.6, "easeOutCubic", 150.0 ],
-          [ 0.8, "linear", 350.0 ],
-          [ 1.0, "linear", 500.0 ]
-        ]
-      },
-      {
-        "object" : "rig",
-        "name" : "y",
-        "ease-in" : true,
-        "keys" : [
-          [ 0.2, "easeOutCubic", 200.0 ],
-          [ 0.6, "easeOutBounce",  200.0 ],
-          [ 0.8, "linear", 200.0 ],
-          [ 1.0, "linear", 0.0 ]
-        ]
-      },
-      {
-        "object" : "rig",
-        "name" : "scale-x",
-        "ease-in" : true,
-        "keys" : [
-          [ 0.2, "easeOutElastic", 2.0 ],
-          [ 0.6, "easeOutBounce",  4.0 ],
-          [ 0.8, "linear", 4.0 ],
-          [ 1.0, "linear", 1.0 ]
-        ]
-      },
-      {
-        "object" : "rig",
-        "name" : "scale-y",
-        "ease-in" : true,
-        "keys" : [
-          [ 0.2, "easeOutElastic", 2.0 ],
-          [ 0.6, "easeOutBounce",  4.0 ],
-          [ 0.8, "linear", 4.0 ],
-          [ 1.0, "linear", 1.0 ]
-        ]
-      }
-    ]
-  }
-]

From d7a3e35f46593e04cf8cfe5eca18e3b2c06ff35b Mon Sep 17 00:00:00 2001
From: Elliot Smith <elliot.smith@intel.com>
Date: Wed, 1 Sep 2010 11:18:15 +0100
Subject: [PATCH 3/6] cookbook: Cleaned up the "animations reuse" example

With some help from pippin, moved variable declarations
into more sensible positions within their functions,
changed a function name, and found a better way
to unref a script once its associated actor has
been destroyed.
---
 .../examples/animations-reuse-animation.json  |  1 -
 doc/cookbook/examples/animations-reuse.c      | 32 +++++++++----------
 2 files changed, 15 insertions(+), 18 deletions(-)

diff --git a/doc/cookbook/examples/animations-reuse-animation.json b/doc/cookbook/examples/animations-reuse-animation.json
index cad247500..7561bd557 100644
--- a/doc/cookbook/examples/animations-reuse-animation.json
+++ b/doc/cookbook/examples/animations-reuse-animation.json
@@ -9,7 +9,6 @@
     "id" : "bounce",
     "timeline" : {
       "type" : "ClutterTimeline",
-      "id" : "bounce_timeline",
       "duration" : 2500
     },
 
diff --git a/doc/cookbook/examples/animations-reuse.c b/doc/cookbook/examples/animations-reuse.c
index 78d0082a9..ee58020bc 100644
--- a/doc/cookbook/examples/animations-reuse.c
+++ b/doc/cookbook/examples/animations-reuse.c
@@ -5,8 +5,8 @@
 #define ANIMATION_FILE "animations-reuse-animation.json"
 
 static gboolean
-_load_script (ClutterScript *script,
-              gchar         *filename)
+load_script_from_file (ClutterScript *script,
+                       gchar         *filename)
 {
   GError *error = NULL;
 
@@ -30,16 +30,15 @@ foo_button_pressed_cb (ClutterActor *actor,
   ClutterScript *ui = CLUTTER_SCRIPT (user_data);
   ClutterStage *stage = CLUTTER_STAGE (clutter_script_get_object (ui, "stage"));
 
-  ClutterScript *script = clutter_script_new ();
-
-  _load_script (script, ANIMATION_FILE);
-
-  ClutterAnimator *bounce;
+  ClutterScript *script;
   ClutterActor *rig;
-  ClutterTimeline *bounce_timeline;
+  ClutterAnimator *bounce;
+
+  script = clutter_script_new ();
+
+  load_script_from_file (script, ANIMATION_FILE);
 
   clutter_script_get_objects (script,
-                              "bounce_timeline", &bounce_timeline,
                               "rig", &rig,
                               "bounce", &bounce,
                               NULL);
@@ -53,11 +52,8 @@ foo_button_pressed_cb (ClutterActor *actor,
                                         foo_button_pressed_cb,
                                         NULL);
 
-  /* add a handler to clean up when the animation completes */
-  g_signal_connect_swapped (bounce_timeline,
-                            "completed",
-                            G_CALLBACK (g_object_unref),
-                            script);
+  /* add a callback to clean up the script when the rig is destroyed */
+  g_object_set_data_full (G_OBJECT (rig), "script", script, g_object_unref);
 
   clutter_container_add_actor (CLUTTER_CONTAINER (stage), rig);
 
@@ -71,14 +67,16 @@ foo_button_pressed_cb (ClutterActor *actor,
 int
 main (int argc, char *argv[])
 {
+  ClutterScript *script;
+  ClutterActor *stage;
+
   clutter_init (&argc, &argv);
 
-  ClutterScript *script = clutter_script_new ();
-  _load_script (script, UI_FILE);
+  script = clutter_script_new ();
+  load_script_from_file (script, UI_FILE);
 
   clutter_script_connect_signals (script, script);
 
-  ClutterActor *stage;
   clutter_script_get_objects (script,
                               "stage", &stage,
                               NULL);

From 82ab00930b63d3860f96ac99da9cdc8128de1aee Mon Sep 17 00:00:00 2001
From: Elliot Smith <elliot.smith@intel.com>
Date: Thu, 9 Sep 2010 12:02:02 +0100
Subject: [PATCH 4/6] cookbook: Simplified and clarified example code

Modified the "animation reuse" sample code to provide
a simpler example to explain in the recipe.

Also modified variable names to mirror the names used
for the previous "complex animation" example and added
some more comments, to further simplify and support the
recipe.
---
 .../examples/animations-reuse-animation.json  | 36 ++++--------------
 .../examples/animations-reuse-ui.json         | 37 ++++++++++++++++---
 doc/cookbook/examples/animations-reuse.c      | 20 ++++++++--
 3 files changed, 56 insertions(+), 37 deletions(-)

diff --git a/doc/cookbook/examples/animations-reuse-animation.json b/doc/cookbook/examples/animations-reuse-animation.json
index 7561bd557..5f16e1ee9 100644
--- a/doc/cookbook/examples/animations-reuse-animation.json
+++ b/doc/cookbook/examples/animations-reuse-animation.json
@@ -6,11 +6,8 @@
 
   {
     "type" : "ClutterAnimator",
-    "id" : "bounce",
-    "timeline" : {
-      "type" : "ClutterTimeline",
-      "duration" : 2500
-    },
+    "id" : "animator",
+    "duration" : 2000,
 
     "properties" : [
       {
@@ -18,21 +15,8 @@
         "name" : "x",
         "ease-in" : true,
         "keys" : [
-          [ 0.2, "easeOutCubic", 100.0 ],
-          [ 0.6, "easeOutCubic", 150.0 ],
-          [ 0.8, "linear", 350.0 ],
-          [ 1.0, "linear", 500.0 ]
-        ]
-      },
-      {
-        "object" : "rig",
-        "name" : "y",
-        "ease-in" : true,
-        "keys" : [
-          [ 0.2, "easeOutCubic", 200.0 ],
-          [ 0.6, "easeOutBounce",  200.0 ],
-          [ 0.8, "linear", 200.0 ],
-          [ 1.0, "linear", 0.0 ]
+          [ 0.0, "linear", 0.0 ],
+          [ 1.0, "easeOutCubic", 150.0 ]
         ]
       },
       {
@@ -40,10 +24,8 @@
         "name" : "scale-x",
         "ease-in" : true,
         "keys" : [
-          [ 0.2, "easeOutElastic", 2.0 ],
-          [ 0.6, "easeOutBounce",  4.0 ],
-          [ 0.8, "linear", 4.0 ],
-          [ 1.0, "linear", 1.0 ]
+          [ 0.5, "linear", 1.0 ],
+          [ 1.0, "easeOutBack", 2.0 ]
         ]
       },
       {
@@ -51,10 +33,8 @@
         "name" : "scale-y",
         "ease-in" : true,
         "keys" : [
-          [ 0.2, "easeOutElastic", 2.0 ],
-          [ 0.6, "easeOutBounce",  4.0 ],
-          [ 0.8, "linear", 4.0 ],
-          [ 1.0, "linear", 1.0 ]
+          [ 0.5, "linear", 1.0 ],
+          [ 1.0, "easeOutBack", 2.0 ]
         ]
       }
     ]
diff --git a/doc/cookbook/examples/animations-reuse-ui.json b/doc/cookbook/examples/animations-reuse-ui.json
index 0b9e24087..99f50c616 100644
--- a/doc/cookbook/examples/animations-reuse-ui.json
+++ b/doc/cookbook/examples/animations-reuse-ui.json
@@ -2,8 +2,8 @@
   {
     "type" : "ClutterStage",
     "id" : "stage",
-    "width" : 550,
-    "height" : 400,
+    "width" : 300,
+    "height" : 200,
     "color" : "#333355ff",
 
     "signals" : [
@@ -11,13 +11,13 @@
     ],
 
     "children" : [
-
       {
         "type" : "ClutterRectangle",
         "id" : "rect1",
-        "color" : "red",
+        "color" : "white",
         "width" : 50,
         "height" : 50,
+        "y" : 50,
         "reactive" : true,
         "signals" : [
           { "name" : "button-press-event", "handler" : "foo_button_pressed_cb" }
@@ -30,6 +30,7 @@
         "color" : "blue",
         "width" : 50,
         "height" : 50,
+        "y" : 50,
         "reactive" : true,
         "signals" : [
           { "name" : "button-press-event", "handler" : "foo_button_pressed_cb" }
@@ -42,12 +43,38 @@
         "color" : "green",
         "width" : 50,
         "height" : 50,
+        "y" : 50,
+        "reactive" : true,
+        "signals" : [
+          { "name" : "button-press-event", "handler" : "foo_button_pressed_cb" }
+        ]
+      },
+
+      {
+        "type" : "ClutterRectangle",
+        "id" : "rect4",
+        "color" : "red",
+        "width" : 50,
+        "height" : 50,
+        "y" : 50,
+        "reactive" : true,
+        "signals" : [
+          { "name" : "button-press-event", "handler" : "foo_button_pressed_cb" }
+        ]
+      },
+
+      {
+        "type" : "ClutterRectangle",
+        "id" : "rect5",
+        "color" : "grey",
+        "width" : 50,
+        "height" : 50,
+        "y" : 50,
         "reactive" : true,
         "signals" : [
           { "name" : "button-press-event", "handler" : "foo_button_pressed_cb" }
         ]
       }
-
     ]
   }
 ]
diff --git a/doc/cookbook/examples/animations-reuse.c b/doc/cookbook/examples/animations-reuse.c
index ee58020bc..506435a21 100644
--- a/doc/cookbook/examples/animations-reuse.c
+++ b/doc/cookbook/examples/animations-reuse.c
@@ -32,18 +32,20 @@ foo_button_pressed_cb (ClutterActor *actor,
 
   ClutterScript *script;
   ClutterActor *rig;
-  ClutterAnimator *bounce;
+  ClutterAnimator *animator;
 
+  /* load the rig and its animator from a JSON file */
   script = clutter_script_new ();
 
+  /* use a function defined statically in this source file to load the JSON */
   load_script_from_file (script, ANIMATION_FILE);
 
   clutter_script_get_objects (script,
                               "rig", &rig,
-                              "bounce", &bounce,
+                              "animator", &animator,
                               NULL);
 
-  /* remove the button press handler */
+  /* remove the button press handler from the rectangle */
   g_signal_handlers_disconnect_matched (actor,
                                         G_SIGNAL_MATCH_FUNC,
                                         0,
@@ -55,11 +57,21 @@ foo_button_pressed_cb (ClutterActor *actor,
   /* add a callback to clean up the script when the rig is destroyed */
   g_object_set_data_full (G_OBJECT (rig), "script", script, g_object_unref);
 
+  /* add the rig to the stage */
   clutter_container_add_actor (CLUTTER_CONTAINER (stage), rig);
 
+  /* place the rig at the same coordinates on the stage as the rectangle */
+  clutter_actor_set_position (rig,
+                              clutter_actor_get_x (actor),
+                              clutter_actor_get_y (actor));
+
+  /* put the rectangle into the top-left corner of the rig */
   clutter_actor_reparent (actor, rig);
 
-  clutter_animator_start (bounce);
+  clutter_actor_set_position (actor, 0, 0);
+
+  /* animate the rig */
+  clutter_animator_start (animator);
 
   return TRUE;
 }

From 6548bee56ca8401d2e9d31e33bf4fcd5a65b92f5 Mon Sep 17 00:00:00 2001
From: Elliot Smith <elliot.smith@intel.com>
Date: Mon, 13 Sep 2010 10:28:16 +0100
Subject: [PATCH 5/6] cookbook: Added id for section in "rotating an actor"
 recipe

Added an id to a section in the "rotating an actor" recipe,
so that it can be referred to from the "reusing an animation"
recipe.
---
 doc/cookbook/animations.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/cookbook/animations.xml b/doc/cookbook/animations.xml
index 49c9a0832..661b64eaf 100644
--- a/doc/cookbook/animations.xml
+++ b/doc/cookbook/animations.xml
@@ -844,7 +844,7 @@ clutter_actor_set_z_rotation_from_gravity (actor,
 
       </section>
 
-      <section>
+      <section id="animations-rotating-discussion-direction">
         <title>Direction of rotation</title>
 
         <para>The apparent direction of an animated rotation depends on

From e8e360eaa7207a677738ce15496499ac7196a5b5 Mon Sep 17 00:00:00 2001
From: Elliot Smith <elliot.smith@intel.com>
Date: Mon, 13 Sep 2010 14:29:37 +0100
Subject: [PATCH 6/6] cookbook: Added a recipe for reusing a complex animation

This recipe explains how to "reuse" the same animation
definition for different actors, by creating a new
instance of a "rig" (empty container) and animation
for the rig each time the animation is required.

An actor is then re-parented to the rig and animated
using it, rather than being animated directly.

JSON is used to define the rig + animator, to make
creating new instances of them simpler. The recipe
also discusses various caveats around using this
approach, rather than directly animating an actor.
---
 doc/cookbook/Makefile.am                 |   1 +
 doc/cookbook/animations.xml              | 378 +++++++++++++++++++++++
 doc/cookbook/videos/animations-reuse.ogv | Bin 0 -> 60837 bytes
 3 files changed, 379 insertions(+)
 create mode 100644 doc/cookbook/videos/animations-reuse.ogv

diff --git a/doc/cookbook/Makefile.am b/doc/cookbook/Makefile.am
index 9ce15c241..15ce15a23 100644
--- a/doc/cookbook/Makefile.am
+++ b/doc/cookbook/Makefile.am
@@ -58,6 +58,7 @@ VIDEO_FILES = \
 	videos/events-mouse-scroll.ogv \
 	videos/textures-crossfade-two-textures.ogv \
 	videos/animations-complex.ogv \
+	videos/animations-reuse.ogv \
 	$(NULL)
 
 EXTRA_DIST = \
diff --git a/doc/cookbook/animations.xml b/doc/cookbook/animations.xml
index 661b64eaf..ba22a3350 100644
--- a/doc/cookbook/animations.xml
+++ b/doc/cookbook/animations.xml
@@ -1438,4 +1438,382 @@ clutter_actor_set_z_rotation_from_gravity (actor,
 
   </section>
 
+  <section id="animations-reuse">
+    <title>Reusing a complex animation on different actors</title>
+
+    <section id="animations-reuse-problem">
+      <title>Problem</title>
+
+      <para>You want to apply the same complex animation to several
+      different actors.</para>
+
+    </section>
+
+    <section id="animations-reuse-solution">
+      <title>Solution</title>
+
+      <para>Instead of animating each actor separately, create a
+      <emphasis>rig</emphasis>: an empty container with an associated
+      animation, which will be animated in lieu of
+      animating the actor directly. Do this as follows:</para>
+
+      <orderedlist>
+        <listitem>
+          <para>Initialise the stage and actors, including those
+          to be animated.</para>
+        </listitem>
+        <listitem>
+          <para>Define a <type>ClutterContainer</type> and a
+          <type>ClutterAnimator</type> animation to animate it.</para>
+        </listitem>
+        <listitem>
+          <para>When you need to animate an actor:</para>
+
+          <orderedlist>
+            <listitem>
+              <para>Create an instance of the rig and its animator.</para>
+            </listitem>
+            <listitem>
+              <para>Reparent the actor to the rig.</para>
+            </listitem>
+            <listitem>
+              <para>Run the rig's animation.</para>
+            </listitem>
+          </orderedlist>
+        </listitem>
+      </orderedlist>
+
+      <para>For this solution, we're using
+      <ulink url="http://json.org/">JSON</ulink> to define the
+      animation and the user interface elements. For more
+      details about this approach, see
+      <link linkend="script-introduction">the chapter
+      on <type>ClutterScript</type></link>.</para>
+
+      <para>Here's an extract of the JSON definition for the stage and
+      one of five rectangles placed at its left edge (the full definition
+      is in <link linkend="animations-reuse-example-1">the
+      appendix</link>):</para>
+
+      <informalexample>
+        <programlisting>
+<![CDATA[
+[
+  {
+    "type" : "ClutterStage",
+    "id" : "stage",
+
+    ... stage properties, signal handlers etc. ...
+
+    "children" : [
+      {
+        "type" : "ClutterRectangle",
+        "id" : "rect1",
+        "color" : "white",
+        "width" : 50,
+        "height" : 50,
+        "y" : 50,
+        "reactive" : true,
+        "signals" : [
+          { "name" : "button-press-event", "handler" : "foo_button_pressed_cb" }
+        ]
+      },
+
+      ... more children defined here ...
+    ]
+  }
+]
+]]>
+        </programlisting>
+      </informalexample>
+
+      <para>The key point to note is how a signal handler is defined
+      for the <code>button-press-event</code>, so that the
+      <function>foo_button_pressed_cb()</function> function will trigger
+      the animation when a (mouse) button is pressed on each rectangle.</para>
+
+      <para>The second JSON definition includes the rig
+      (an empty <type>ClutterGroup</type>) and a
+      <type>ClutterAnimator</type> to animate it. The animation moves the
+      container across the stage and scales it to twice its original
+      size. (This is the <link linkend="animations-reuse-example-2">same
+      code as in the appendix</link>):</para>
+
+      <informalexample>
+        <programlisting>
+<xi:include href="examples/animations-reuse-animation.json" parse="text">
+  <xi:fallback>a code sample should be here... but isn't</xi:fallback>
+</xi:include>
+        </programlisting>
+      </informalexample>
+
+      <para>The remaining parts of the application code load
+      the user interface definition, setting up the stage and rectangles;
+      and define the callback. The full code is
+      <link linkend="animations-reuse-example-3">in the appendix</link>,
+      but below is the most important part, the callback function:</para>
+
+      <informalexample>
+        <programlisting>
+<![CDATA[
+gboolean
+foo_button_pressed_cb (ClutterActor *actor,
+                       ClutterEvent *event,
+                       gpointer      user_data)
+{
+  ClutterScript *ui = CLUTTER_SCRIPT (user_data);
+  ClutterStage *stage = CLUTTER_STAGE (clutter_script_get_object (ui, "stage"));
+
+  ClutterScript *script;
+  ClutterActor *rig;
+  ClutterAnimator *animator;
+
+  /* load the rig and its animator from a JSON file */
+  script = clutter_script_new ();
+
+  /* use a function defined statically in this source file to load the JSON */
+  load_script_from_file (script, ANIMATION_FILE);
+
+  clutter_script_get_objects (script,
+                              "rig", &rig,
+                              "animator", &animator,
+                              NULL);
+
+  /* remove the button press handler from the rectangle */
+  g_signal_handlers_disconnect_matched (actor,
+                                        G_SIGNAL_MATCH_FUNC,
+                                        0,
+                                        0,
+                                        NULL,
+                                        foo_button_pressed_cb,
+                                        NULL);
+
+  /* add a callback to clean up the script when the rig is destroyed */
+  g_object_set_data_full (G_OBJECT (rig), "script", script, g_object_unref);
+
+  /* add the rig to the stage */
+  clutter_container_add_actor (CLUTTER_CONTAINER (stage), rig);
+
+  /* place the rig at the same coordinates on the stage as the rectangle */
+  clutter_actor_set_position (rig,
+                              clutter_actor_get_x (actor),
+                              clutter_actor_get_y (actor));
+
+  /* put the rectangle into the top-left corner of the rig */
+  clutter_actor_reparent (actor, rig);
+
+  clutter_actor_set_position (actor, 0, 0);
+
+  /* animate the rig */
+  clutter_animator_start (animator);
+
+  return TRUE;
+}
+]]>
+        </programlisting>
+      </informalexample>
+
+      <para>The code creates a new rig and associated animation
+      at the point when the rectangle is clicked. It then positions the
+      rig at the same coordinates as the rectangle, reparents
+      the rectangle to the rig, and starts the rig's animation.</para>
+
+      <note>
+        <para>The signal handler has to be declared non-static and
+        you must use <code>-export-dynamic</code> as an option to the
+        compiler, otherwise the function isn't visible to
+        <type>ClutterScript</type> (as outlined
+        <link linkend="script-signals">in this recipe</link>).</para>
+      </note>
+
+      <para>This is what the animation looks like:</para>
+
+      <inlinemediaobject>
+          <videoobject>
+            <videodata fileref="videos/animations-reuse.ogv"/>
+          </videoobject>
+          <alt>
+            <para>Video of a simple reusable animation</para>
+          </alt>
+        </inlinemediaobject>
+
+    </section>
+
+    <section id="animations-reuse-discussion">
+      <title>Discussion</title>
+
+      <para>The above solution reparents an actor to be animated
+      into a rig (an empty placeholder). The rig is a container
+      which acts as a temporary parent for the actor we
+      <emphasis>really</emphasis> want to animate. By animating the rig,
+      it appears as though the actor inside it is being animated (but
+      <link linkend="animations-reuse-discussion-rig-not-actor">see
+      these caveats</link>). This means the same animation can be
+      easily applied to different actors: create an
+      instance of the rig, reparent an actor to it, then
+      run the rig's animation. This is simpler than creating
+      a separate animation for each actor individually, or
+      reusing a single <type>ClutterAnimator</type> on different
+      actors (see
+      <link linkend="animations-reuse-discussion-one-or-many">this
+      section</link>).</para>
+
+      <para>Using JSON enhances the animation's reusability (it's even
+      potentially reusable in another application), makes the code
+      simpler (an animation can be loaded directly from the script),
+      and makes refactoring easier (the animation can be modified
+      without recompiling the application code). However, it also puts
+      some minor limitations on the animation's reusability; namely, you
+      can only set absolute property values in a JSON animation
+      definition. This makes JSON less useful in cases where
+      you need to animate properties relative to their starting
+      values: for example, "move 50 pixels along the x axis" or
+      "rotate by 10 degrees more on the z axis". (This type of animation
+      is probably less portable anyway.) In such cases, the programmable
+      API may be a better option: see the <type>ClutterAnimator</type>
+      documentation for examples.</para>
+
+      <section id="animations-reuse-discussion-one-or-many">
+        <title>One animation vs. many</title>
+
+        <para>In the sample code, a new instance of the rig and its
+        animation are created for each actor. One side effect of this
+        is that all of the actors can animate simultaneously with the
+        "same" animation. If you don't want this behaviour, but still
+        want to use a rig approach, you could create a single instance
+        of the rig and its animation. Then, you could reparent each actor
+        to it in turn.</para>
+
+        <para>To ensure that the rig only animates one actor (or group
+        of actors) at a time, you could track whether the rig is
+        currently animating (e.g. by examining the animation's
+        timeline with <function>clutter_animator_get_timeline()</function>).
+        Then, if the animation is running, prevent any other actor
+        from being reparented to the rig.</para>
+
+        <para>Note that you would also need to "reset" the rig each time the
+        animation completed (move it back to the right start values for
+        its properties), ready to animate the next actor.</para>
+      </section>
+
+      <section id="animations-reuse-discussion-rig-not-actor">
+        <title>Caveats about animating a rig instead of an actor</title>
+
+        <para>There are a few issues to be aware of in cases
+        where you animate a rig with contained actors, rather than
+        animating the actor directly:</para>
+
+        <itemizedlist>
+          <listitem>
+            <para>Animating a rig doesn't <emphasis>always</emphasis>
+            produce the same visual effect as animating an actor directly.
+            For example, compare the following cases:</para>
+
+            <itemizedlist>
+              <listitem>
+                <para>You rotate an actor by 180 degrees in the
+                <code>y</code> axis, then by 90 degrees in the
+                <code>z</code> axis. The actor appears to rotate in
+                a <emphasis>clockwise</emphasis> direction.</para>
+              </listitem>
+              <listitem>
+                <para>You rotate the parent container of an actor
+                by 180 degrees in the <code>y</code> axis; then rotate
+                the actor by 90 degrees in the <code>z</code> axis.
+                The actor appears to rotate in an
+                <emphasis>anti-clockwise</emphasis> direction. By
+                rotating the container, the "back" of the
+                actor faces the view point, so the actor's movement
+                appears reversed. See
+                <link linkend="animations-rotating-discussion-direction">this
+                recipe</link> for more details.</para>
+              </listitem>
+            </itemizedlist>
+
+            <para>There may be other situations where you get similar
+            discrepancies.</para>
+          </listitem>
+
+          <listitem>
+            <para>Animating a rig doesn't change an actor's properties,
+            but animating the actor does.</para>
+
+            <para>When you animate a container rather than the actor
+            directly, the reported properties of the actor may not
+            reflect its visual appearance. For example, if you apply
+            a scale animation to a container, the final scale of
+            actors inside it (as returned by
+            <function>clutter_actor_get_scale()</function>) will not
+            reflect the scaling applied to their container; whereas
+            directly animating the actors would cause their scale
+            properties to change.</para>
+          </listitem>
+
+          <listitem>
+            <para>Reparenting an actor to a rig can cause the actor
+            to "jump" to the rig's position, unless you align the
+            actor to the rig first.</para>
+
+            <para>Note that in the sample code, the position of the actor
+            (<code>x</code>, <code>y</code> coordinates) is copied to
+            the rig before the reparenting happens. The actor is then
+            reparented to the rig, and positioned in the rig's
+            top-left corner. So the actor appears to be in the same
+            position, but is now actually inside a rig at the actor's old
+            position.</para>
+
+            <para>Why bother to do this? Because the rig has a default
+            position of <code>0,0</code> (top-left of <emphasis>its</emphasis>
+            container, the stage). If you reparent the actor to the rig,
+            without first copying the actor's position to the rig, the
+            actor appears to "jump" to the rig's position.</para>
+          </listitem>
+        </itemizedlist>
+      </section>
+
+    </section>
+
+    <section id="animations-reuse-examples">
+      <title>Full example</title>
+
+      <note>
+        <para>The three separate code examples in this section
+        constitute a single application which implements the above
+        solution.</para>
+      </note>
+
+      <example id="animations-reuse-example-1">
+        <title><type>ClutterScript</type> JSON defining several
+        rectangles with signal handlers</title>
+        <programlisting>
+<xi:include href="examples/animations-reuse-ui.json" parse="text">
+  <xi:fallback>a code sample should be here... but isn't</xi:fallback>
+</xi:include>
+        </programlisting>
+      </example>
+
+      <example id="animations-reuse-example-2">
+        <title><type>ClutterScript</type> JSON describing a "rig"
+        and a <type>ClutterAnimator</type> animation</title>
+        <programlisting>
+<xi:include href="examples/animations-reuse-animation.json" parse="text">
+  <xi:fallback>a code sample should be here... but isn't</xi:fallback>
+</xi:include>
+        </programlisting>
+      </example>
+
+      <example id="animations-reuse-example-3">
+        <title>Loading <type>ClutterScript</type> from JSON files
+        in response to events in a user interface</title>
+        <programlisting>
+<xi:include href="examples/animations-reuse.c" parse="text">
+  <xi:fallback>a code sample should be here... but isn't</xi:fallback>
+</xi:include>
+        </programlisting>
+      </example>
+
+    </section>
+
+  </section>
+
 </chapter>
diff --git a/doc/cookbook/videos/animations-reuse.ogv b/doc/cookbook/videos/animations-reuse.ogv
new file mode 100644
index 0000000000000000000000000000000000000000..07b0c4e40a0480f3f076878f956b2aad8176d52d
GIT binary patch
literal 60837
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

literal 0
HcmV?d00001