doc/reference/clutter/html/clutter-Implicit-Animations.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <title>Implicit Animations</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
   7 <link rel="home" href="index.html" title="Clutter Reference Manual">
   8 <link rel="up" href="ch10.html" title="High Level API">
   9 <link rel="prev" href="ch10.html" title="High Level API">
  10 <link rel="next" href="ClutterAnimator.html" title="ClutterAnimator">
  11 <meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 </head>
  14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
  16 <tr valign="middle">
  17 <td><a accesskey="p" href="ch10.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  18 <td><a accesskey="u" href="ch10.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  20 <th width="100%" align="center">Clutter Reference Manual</th>
  21 <td><a accesskey="n" href="ClutterAnimator.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  22 </tr>
  23 <tr><td colspan="5" class="shortcuts">
  24 <a href="#clutter-Implicit-Animations.synopsis" class="shortcut">Top</a>
  25                    |
  26                   <a href="#clutter-Implicit-Animations.description" class="shortcut">Description</a>
  27                    |
  28                   <a href="#clutter-Implicit-Animations.object-hierarchy" class="shortcut">Object Hierarchy</a>
  29                    |
  30                   <a href="#clutter-Implicit-Animations.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
  31                    |
  32                   <a href="#clutter-Implicit-Animations.properties" class="shortcut">Properties</a>
  33                    |
  34                   <a href="#clutter-Implicit-Animations.signals" class="shortcut">Signals</a>
  35 </td></tr>
  36 </table>
  37 <div class="refentry">
  38 <a name="clutter-Implicit-Animations"></a><div class="titlepage"></div>
  39 <div class="refnamediv"><table width="100%"><tr>
  40 <td valign="top">
  41 <h2><span class="refentrytitle"><a name="clutter-Implicit-Animations.top_of_page"></a>Implicit Animations</span></h2>
  42 <p>Implicit Animations — Simple implicit animations</p>
  43 </td>
  44 <td valign="top" align="right"></td>
  45 </tr></table></div>
  46 <div class="refsynopsisdiv">
  47 <a name="clutter-Implicit-Animations.synopsis"></a><h2>Synopsis</h2>
  48 <a name="ClutterAnimation"></a><pre class="synopsis">struct              <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation-struct" title="struct ClutterAnimation">ClutterAnimation</a>;
  49 struct              <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimationClass" title="struct ClutterAnimationClass">ClutterAnimationClass</a>;
  50 enum                <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimationMode" title="enum ClutterAnimationMode">ClutterAnimationMode</a>;
  51 <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *  <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-new" title="clutter_animation_new ()">clutter_animation_new</a>               (<em class="parameter"><code><span class="type">void</span></code></em>);
  52 <span class="returnvalue">void</span>                <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-set-object" title="clutter_animation_set_object ()">clutter_animation_set_object</a>        (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>,
  53                                                          <em class="parameter"><code><a href="../gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *object</code></em>);
  54 <a href="../gobject/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *           <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-get-object" title="clutter_animation_get_object ()">clutter_animation_get_object</a>        (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>);
  55 <span class="returnvalue">void</span>                <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-set-mode" title="clutter_animation_set_mode ()">clutter_animation_set_mode</a>          (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>,
  56                                                          <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> mode</code></em>);
  57 <a href="../glib/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a>              <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-get-mode" title="clutter_animation_get_mode ()">clutter_animation_get_mode</a>          (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>);
  58 <span class="returnvalue">void</span>                <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-set-duration" title="clutter_animation_set_duration ()">clutter_animation_set_duration</a>      (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>,
  59                                                          <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> msecs</code></em>);
  60 <a href="../glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-get-duration" title="clutter_animation_get_duration ()">clutter_animation_get_duration</a>      (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>);
  61 <span class="returnvalue">void</span>                <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-set-loop" title="clutter_animation_set_loop ()">clutter_animation_set_loop</a>          (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>,
  62                                                          <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> loop</code></em>);
  63 <a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-get-loop" title="clutter_animation_get_loop ()">clutter_animation_get_loop</a>          (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>);
  64 <span class="returnvalue">void</span>                <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-set-timeline" title="clutter_animation_set_timeline ()">clutter_animation_set_timeline</a>      (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>,
  65                                                          <em class="parameter"><code><a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a> *timeline</code></em>);
  66 <a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="returnvalue">ClutterTimeline</span></a> *   <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-get-timeline" title="clutter_animation_get_timeline ()">clutter_animation_get_timeline</a>      (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>);
  67 <span class="returnvalue">void</span>                <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-set-alpha" title="clutter_animation_set_alpha ()">clutter_animation_set_alpha</a>         (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>,
  68                                                          <em class="parameter"><code><a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a> *alpha</code></em>);
  69 <a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="returnvalue">ClutterAlpha</span></a> *      <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-get-alpha" title="clutter_animation_get_alpha ()">clutter_animation_get_alpha</a>         (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>);
  70 <span class="returnvalue">void</span>                <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-completed" title="clutter_animation_completed ()">clutter_animation_completed</a>         (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>);
  71
  72 <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *  <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-bind" title="clutter_animation_bind ()">clutter_animation_bind</a>              (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>,
  73                                                          <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>,
  74                                                          <em class="parameter"><code>const <a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *final</code></em>);
  75 <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *  <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-bind-interval" title="clutter_animation_bind_interval ()">clutter_animation_bind_interval</a>     (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>,
  76                                                          <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>,
  77                                                          <em class="parameter"><code><a class="link" href="clutter-Value-intervals.html#ClutterInterval"><span class="type">ClutterInterval</span></a> *interval</code></em>);
  78 <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *  <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-update" title="clutter_animation_update ()">clutter_animation_update</a>            (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>,
  79                                                          <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>,
  80                                                          <em class="parameter"><code>const <a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *final</code></em>);
  81 <span class="returnvalue">void</span>                <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-update-interval" title="clutter_animation_update_interval ()">clutter_animation_update_interval</a>   (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>,
  82                                                          <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>,
  83                                                          <em class="parameter"><code><a class="link" href="clutter-Value-intervals.html#ClutterInterval"><span class="type">ClutterInterval</span></a> *interval</code></em>);
  84 <a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-has-property" title="clutter_animation_has_property ()">clutter_animation_has_property</a>      (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>,
  85                                                          <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>);
  86 <span class="returnvalue">void</span>                <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-unbind-property" title="clutter_animation_unbind_property ()">clutter_animation_unbind_property</a>   (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>,
  87                                                          <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>);
  88 <a class="link" href="clutter-Value-intervals.html#ClutterInterval"><span class="returnvalue">ClutterInterval</span></a> *   <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-get-interval" title="clutter_animation_get_interval ()">clutter_animation_get_interval</a>      (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>,
  89                                                          <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>);
  90
  91 <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *  <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animate" title="clutter_actor_animate ()">clutter_actor_animate</a>               (<em class="parameter"><code><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> *actor</code></em>,
  92                                                          <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> mode</code></em>,
  93                                                          <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> duration</code></em>,
  94                                                          <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
  95                                                          <em class="parameter"><code>...</code></em>);
  96 <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *  <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animate-with-timeline" title="clutter_actor_animate_with_timeline ()">clutter_actor_animate_with_timeline</a> (<em class="parameter"><code><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> *actor</code></em>,
  97                                                          <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> mode</code></em>,
  98                                                          <em class="parameter"><code><a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a> *timeline</code></em>,
  99                                                          <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
 100                                                          <em class="parameter"><code>...</code></em>);
 101 <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *  <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animate-with-alpha" title="clutter_actor_animate_with_alpha ()">clutter_actor_animate_with_alpha</a>    (<em class="parameter"><code><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> *actor</code></em>,
 102                                                          <em class="parameter"><code><a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a> *alpha</code></em>,
 103                                                          <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
 104                                                          <em class="parameter"><code>...</code></em>);
 105 <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *  <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animatev" title="clutter_actor_animatev ()">clutter_actor_animatev</a>              (<em class="parameter"><code><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> *actor</code></em>,
 106                                                          <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> mode</code></em>,
 107                                                          <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> duration</code></em>,
 108                                                          <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_properties</code></em>,
 109                                                          <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> * const properties[]</code></em>,
 110                                                          <em class="parameter"><code>const <a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *values</code></em>);
 111 <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *  <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animate-with-timelinev" title="clutter_actor_animate_with_timelinev ()">clutter_actor_animate_with_timelinev</a>
 112                                                         (<em class="parameter"><code><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> *actor</code></em>,
 113                                                          <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> mode</code></em>,
 114                                                          <em class="parameter"><code><a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a> *timeline</code></em>,
 115                                                          <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_properties</code></em>,
 116                                                          <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> * const properties[]</code></em>,
 117                                                          <em class="parameter"><code>const <a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *values</code></em>);
 118 <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *  <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animate-with-alphav" title="clutter_actor_animate_with_alphav ()">clutter_actor_animate_with_alphav</a>   (<em class="parameter"><code><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> *actor</code></em>,
 119                                                          <em class="parameter"><code><a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a> *alpha</code></em>,
 120                                                          <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_properties</code></em>,
 121                                                          <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> * const properties[]</code></em>,
 122                                                          <em class="parameter"><code>const <a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *values</code></em>);
 123 <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *  <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-get-animation" title="clutter_actor_get_animation ()">clutter_actor_get_animation</a>         (<em class="parameter"><code><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> *actor</code></em>);
 124 <span class="returnvalue">void</span>                <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-detach-animation" title="clutter_actor_detach_animation ()">clutter_actor_detach_animation</a>      (<em class="parameter"><code><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> *actor</code></em>);
 125 </pre>
 126 </div>
 127 <div class="refsect1">
 128 <a name="clutter-Implicit-Animations.object-hierarchy"></a><h2>Object Hierarchy</h2>
 129 <pre class="synopsis">
 130   <a href="../gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 131    +----ClutterAnimation
 132 </pre>
 133 </div>
 134 <div class="refsect1">
 135 <a name="clutter-Implicit-Animations.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
 136 <p>
 137 ClutterAnimation implements
 138  <a class="link" href="ClutterScriptable.html" title="ClutterScriptable">ClutterScriptable</a>.</p>
 139 </div>
 140 <div class="refsect1">
 141 <a name="clutter-Implicit-Animations.properties"></a><h2>Properties</h2>
 142 <pre class="synopsis">
 143   "<a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation--alpha" title='The "alpha" property'>alpha</a>"                    <a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a>*         : Read / Write
 144   "<a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation--duration" title='The "duration" property'>duration</a>"                 <a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write
 145   "<a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation--loop" title='The "loop" property'>loop</a>"                     <a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 146   "<a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation--mode" title='The "mode" property'>mode</a>"                     <a href="../glib/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a>                : Read / Write
 147   "<a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation--object" title='The "object" property'>object</a>"                   <a href="../gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>*              : Read / Write
 148   "<a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation--timeline" title='The "timeline" property'>timeline</a>"                 <a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a>*      : Read / Write
 149 </pre>
 150 </div>
 151 <div class="refsect1">
 152 <a name="clutter-Implicit-Animations.signals"></a><h2>Signals</h2>
 153 <pre class="synopsis">
 154   "<a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation-completed" title='The "completed" signal'>completed</a>"                                      : <a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
 155   "<a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation-started" title='The "started" signal'>started</a>"                                        : <a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
 156 </pre>
 157 </div>
 158 <div class="refsect1">
 159 <a name="clutter-Implicit-Animations.description"></a><h2>Description</h2>
 160 <p>
 161 <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> is an object providing simple, implicit animations
 162 for <a href="../gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>s.
 163 </p>
 164 <p>
 165 <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> instances will bind one or more <a href="../gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> properties
 166 belonging to a <a href="../gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> to a <a class="link" href="clutter-Value-intervals.html#ClutterInterval"><span class="type">ClutterInterval</span></a>, and will then use a
 167 <a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a> to interpolate the property between the initial and final
 168 values of the interval.
 169 </p>
 170 <p>
 171 The duration of the animation is set using <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-set-duration" title="clutter_animation_set_duration ()"><code class="function">clutter_animation_set_duration()</code></a>.
 172 The easing mode of the animation is set using <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-set-mode" title="clutter_animation_set_mode ()"><code class="function">clutter_animation_set_mode()</code></a>.
 173 </p>
 174 <p>
 175 If you want to control the animation you should retrieve the
 176 <a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a> using <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-get-timeline" title="clutter_animation_get_timeline ()"><code class="function">clutter_animation_get_timeline()</code></a> and then
 177 use <a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a> functions like <a class="link" href="ClutterTimeline.html#clutter-timeline-start" title="clutter_timeline_start ()"><code class="function">clutter_timeline_start()</code></a>,
 178 <a class="link" href="ClutterTimeline.html#clutter-timeline-pause" title="clutter_timeline_pause ()"><code class="function">clutter_timeline_pause()</code></a> or <a class="link" href="ClutterTimeline.html#clutter-timeline-stop" title="clutter_timeline_stop ()"><code class="function">clutter_timeline_stop()</code></a>.
 179 </p>
 180 <p>
 181 A <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> will emit the <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation-completed" title='The "completed" signal'><span class="type">"completed"</span></a> signal
 182 when the <a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a> used by the animation is completed; unlike
 183 <a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a>, though, the <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation-completed" title='The "completed" signal'><span class="type">"completed"</span></a> will not be
 184 emitted if <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation--loop" title='The "loop" property'><span class="type">"loop"</span></a> is set to <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> - that is, a looping
 185 animation never completes.
 186 </p>
 187 <p>
 188 If your animation depends on user control you can force its completion
 189 using <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-completed" title="clutter_animation_completed ()"><code class="function">clutter_animation_completed()</code></a>.
 190 </p>
 191 <p>
 192 If the <a href="../gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> instance bound to a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> implements the
 193 <a class="link" href="ClutterAnimatable.html" title="ClutterAnimatable"><span class="type">ClutterAnimatable</span></a> interface it is possible for that instance to
 194 control the way the initial and final states are interpolated.
 195 </p>
 196 <p>
 197 <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a>s are distinguished from <a class="link" href="ClutterBehaviour.html" title="ClutterBehaviour"><span class="type">ClutterBehaviour</span></a>s
 198 because the former can only control <a href="../gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> properties of a single
 199 <a href="../gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> instance, while the latter can control multiple properties
 200 using accessor functions inside the <a class="link" href="ClutterBehaviour.html" title="ClutterBehaviour"><span class="type">ClutterBehaviour</span></a>
 201 <code class="function">alpha_notify</code> virtual function, and can control
 202 multiple <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a>s as well.
 203 </p>
 204 <p>
 205 For convenience, it is possible to use the <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animate" title="clutter_actor_animate ()"><code class="function">clutter_actor_animate()</code></a>
 206 function call which will take care of setting up and tearing down
 207 a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> instance and animate an actor between its current
 208 state and the specified final state.
 209 </p>
 210 <p>
 211 </p>
 212 <div class="refsect2">
 213 <a name="clutter-AnimationMode-Script"></a><h3>Defining ClutterAnimationMode inside ClutterScript</h3>
 214 <p>When defining a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> inside a ClutterScript
 215   file or string the <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation--mode" title='The "mode" property'><span class="type">"mode"</span></a> can be defined either
 216   using the <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimationMode" title="enum ClutterAnimationMode"><span class="type">ClutterAnimationMode</span></a> enumeration values through their
 217   "nick" (the short string used inside <a href="../gobject/gobject-Enumeration-and-Flag-Types.html#GEnumValue"><span class="type">GEnumValue</span></a>), their numeric
 218   id, or using the following strings:</p>
 219 <div class="variablelist"><table border="0">
 220 <col align="left" valign="top">
 221 <tbody>
 222 <tr>
 223 <td><p><span class="term">easeInQuad, easeOutQuad, easeInOutQuad</span></p></td>
 224 <td><p>Corresponding to the quadratic easing
 225       modes</p></td>
 226 </tr>
 227 <tr>
 228 <td><p><span class="term">easeInCubic, easeOutCubic, easeInOutCubic</span></p></td>
 229 <td><p>Corresponding to the cubic easing
 230       modes</p></td>
 231 </tr>
 232 <tr>
 233 <td><p><span class="term">easeInQuart, easeOutQuart, easeInOutQuart</span></p></td>
 234 <td><p>Corresponding to the quartic easing
 235       modes</p></td>
 236 </tr>
 237 <tr>
 238 <td><p><span class="term">easeInQuint, easeOutQuint, easeInOutQuint</span></p></td>
 239 <td><p>Corresponding to the quintic easing
 240       modes</p></td>
 241 </tr>
 242 <tr>
 243 <td><p><span class="term">easeInSine, easeOutSine, easeInOutSine</span></p></td>
 244 <td><p>Corresponding to the sine easing
 245       modes</p></td>
 246 </tr>
 247 <tr>
 248 <td><p><span class="term">easeInExpo, easeOutExpo, easeInOutExpo</span></p></td>
 249 <td><p>Corresponding to the exponential easing
 250       modes</p></td>
 251 </tr>
 252 <tr>
 253 <td><p><span class="term">easeInCirc, easeOutCirc, easeInOutCirc</span></p></td>
 254 <td><p>Corresponding to the circular easing
 255       modes</p></td>
 256 </tr>
 257 <tr>
 258 <td><p><span class="term">easeInElastic, easeOutElastic, easeInOutElastic</span></p></td>
 259 <td><p>Corresponding to the overshooting elastic
 260       easing modes</p></td>
 261 </tr>
 262 <tr>
 263 <td><p><span class="term">easeInBack, easeOutBack, easeInOutBack</span></p></td>
 264 <td><p>Corresponding to the overshooting cubic
 265       easing modes</p></td>
 266 </tr>
 267 <tr>
 268 <td><p><span class="term">easeInBounce, easeOutBounce, easeInOutBounce</span></p></td>
 269 <td><p>Corresponding to the bouncing easing
 270       modes</p></td>
 271 </tr>
 272 </tbody>
 273 </table></div>
 274 </div>
 275 <p>
 276 </p>
 277 <p>
 278 </p>
 279 <div class="example">
 280 <a name="example-clutter-animation"></a><p class="title"><b>Example 11. Tweening using <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animate" title="clutter_actor_animate ()"><code class="function">clutter_actor_animate()</code></a></b></p>
 281 <div class="example-contents">
 282   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
 283     <tbody>
 284       <tr>
 285         <td class="listing_lines" align="right"><pre>1
 286 2
 287 3
 288 4
 289 5
 290 6
 291 7
 292 8
 293 9
 294 10
 295 11
 296 12
 297 13
 298 14
 299 15
 300 16
 301 17
 302 18
 303 19
 304 20
 305 21
 306 22
 307 23
 308 24
 309 25
 310 26
 311 27
 312 28
 313 29
 314 30
 315 31
 316 32
 317 33
 318 34
 319 35
 320 36
 321 37
 322 38
 323 39
 324 40
 325 41
 326 42
 327 43
 328 44
 329 45
 330 46
 331 47
 332 48
 333 49
 334 50
 335 51
 336 52
 337 53
 338 54
 339 55
 340 56
 341 57
 342 58
 343 59
 344 60
 345 61
 346 62
 347 63
 348 64
 349 65
 350 66
 351 67
 352 68
 353 69
 354 70
 355 71
 356 72
 357 73
 358 74
 359 75
 360 76
 361 77
 362 78
 363 79
 364 80
 365 81
 366 82
 367 83
 368 84
 369 85
 370 86
 371 87
 372 88
 373 89
 374 90
 375 91
 376 92
 377 93
 378 94
 379 95
 380 96
 381 97
 382 98
 383 99
 384 100
 385 101
 386 102
 387 103
 388 104
 389 105
 390 106
 391 107
 392 108
 393 109
 394 110
 395 111
 396 112
 397 113
 398 114
 399 115
 400 116
 401 117
 402 118
 403 119
 404 120
 405 121
 406 122
 407 123
 408 124
 409 125
 410 126
 411 127
 412 128
 413 129
 414 130
 415 131
 416 132
 417 133
 418 134
 419 135
 420 136
 421 137
 422 138
 423 139
 424 140
 425 141
 426 142
 427 143
 428 144
 429 145
 430 146
 431 147
 432 148
 433 149
 434 150
 435 151
 436 152
 437 153
 438 154
 439 155
 440 156
 441 157
 442 158
 443 159
 444 160
 445 161
 446 162
 447 163
 448 164
 449 165
 450 166
 451 167
 452 168
 453 169
 454 170
 455 171
 456 172
 457 173
 458 174
 459 175
 460 176
 461 177
 462 178
 463 179
 464 180
 465 181
 466 182
 467 183
 468 184
 469 185
 470 186
 471 187
 472 188
 473 189
 474 190
 475 191
 476 192
 477 193
 478 194
 479 195
 480 196
 481 197
 482 198
 483 199
 484 200
 485 201
 486 202
 487 203
 488 204
 489 205
 490 206
 491 207
 492 208
 493 209
 494 210
 495 211
 496 212
 497 213
 498 214
 499 215
 500 216
 501 217
 502 218
 503 219
 504 220
 505 221
 506 222
 507 223
 508 224
 509 225
 510 226
 511 227
 512 228
 513 229
 514 230
 515 231
 516 232
 517 233
 518 234
 519 235
 520 236
 521 237
 522 238
 523 239
 524 240
 525 241
 526 242
 527 243
 528 244
 529 245
 530 246
 531 247
 532 248
 533 249
 534 250
 535 251
 536 252
 537 253
 538 254
 539 255
 540 256
 541 257
 542 258
 543 259
 544 260
 545 261
 546 262
 547 263
 548 264
 549 265
 550 266
 551 267
 552 268
 553 269
 554 270</pre></td>
 555         <td class="listing_code"><pre class="programlisting"><span class="preproc">#include</span><span class="normal"> </span><span class="string">&lt;stdlib.h&gt;</span>
 556 <span class="preproc">#include</span><span class="normal"> </span><span class="string">&lt;gmodule.h&gt;</span>
 557 <span class="preproc">#include</span><span class="normal"> </span><span class="string">&lt;clutter/clutter.h&gt;</span>
 558
 559 <span class="comment">/* all the easing modes provided by Clutter */</span>
 560 <span class="keyword">static</span><span class="normal"> </span><span class="keyword">const</span><span class="normal"> </span><span class="keyword">struct</span><span class="normal"> </span><span class="cbracket">{</span>
 561 <span class="normal">  </span><span class="keyword">const</span><span class="normal"> </span><span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">name</span><span class="symbol">;</span>
 562 <span class="normal">  </span><span class="usertype">ClutterAnimationMode</span><span class="normal"> mode</span><span class="symbol">;</span>
 563 <span class="cbracket">}</span><span class="normal"> easing_modes</span><span class="symbol">[]</span><span class="normal"> </span><span class="symbol">=</span><span class="normal"> </span><span class="cbracket">{</span>
 564 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"linear"</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-LINEAR:CAPS">CLUTTER_LINEAR</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
 565 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"easeInQuad"</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-QUAD:CAPS">CLUTTER_EASE_IN_QUAD</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
 566 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"easeOutQuad"</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-OUT-QUAD:CAPS">CLUTTER_EASE_OUT_QUAD</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
 567 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"easeInOutQuad"</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-OUT-QUAD:CAPS">CLUTTER_EASE_IN_OUT_QUAD</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
 568 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"easeInCubic"</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-CUBIC:CAPS">CLUTTER_EASE_IN_CUBIC</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
 569 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"easeOutCubic"</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-OUT-CUBIC:CAPS">CLUTTER_EASE_OUT_CUBIC</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
 570 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"easeInOutCubic"</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-OUT-CUBIC:CAPS">CLUTTER_EASE_IN_OUT_CUBIC</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
 571 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"easeInQuart"</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-QUART:CAPS">CLUTTER_EASE_IN_QUART</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
 572 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"easeOutQuart"</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-OUT-QUART:CAPS">CLUTTER_EASE_OUT_QUART</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
 573 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"easeInOutQuart"</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-OUT-QUART:CAPS">CLUTTER_EASE_IN_OUT_QUART</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
 574 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"easeInQuint"</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-QUINT:CAPS">CLUTTER_EASE_IN_QUINT</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
 575 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"easeOutQuint"</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-OUT-QUINT:CAPS">CLUTTER_EASE_OUT_QUINT</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
 576 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"easeInOutQuint"</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-OUT-QUINT:CAPS">CLUTTER_EASE_IN_OUT_QUINT</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
 577 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"easeInSine"</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-SINE:CAPS">CLUTTER_EASE_IN_SINE</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
 578 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"easeOutSine"</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-OUT-SINE:CAPS">CLUTTER_EASE_OUT_SINE</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
 579 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"easeInOutSine"</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-OUT-SINE:CAPS">CLUTTER_EASE_IN_OUT_SINE</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
 580 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"easeInExpo"</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-EXPO:CAPS">CLUTTER_EASE_IN_EXPO</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
 581 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"easeOutExpo"</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-OUT-EXPO:CAPS">CLUTTER_EASE_OUT_EXPO</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
 582 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"easeInOutExpo"</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-OUT-EXPO:CAPS">CLUTTER_EASE_IN_OUT_EXPO</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
 583 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"easeInCirc"</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-CIRC:CAPS">CLUTTER_EASE_IN_CIRC</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
 584 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"easeOutCirc"</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-OUT-CIRC:CAPS">CLUTTER_EASE_OUT_CIRC</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
 585 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"easeInOutCirc"</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-OUT-CIRC:CAPS">CLUTTER_EASE_IN_OUT_CIRC</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
 586 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"easeInElastic"</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-ELASTIC:CAPS">CLUTTER_EASE_IN_ELASTIC</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
 587 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"easeOutElastic"</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-OUT-ELASTIC:CAPS">CLUTTER_EASE_OUT_ELASTIC</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
 588 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"easeInOutElastic"</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-OUT-ELASTIC:CAPS">CLUTTER_EASE_IN_OUT_ELASTIC</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
 589 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"easeInBack"</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-BACK:CAPS">CLUTTER_EASE_IN_BACK</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
 590 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"easeOutBack"</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-OUT-BACK:CAPS">CLUTTER_EASE_OUT_BACK</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
 591 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"easeInOutBack"</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-OUT-BACK:CAPS">CLUTTER_EASE_IN_OUT_BACK</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
 592 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"easeInBounce"</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-BOUNCE:CAPS">CLUTTER_EASE_IN_BOUNCE</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
 593 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"easeOutBounce"</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-OUT-BOUNCE:CAPS">CLUTTER_EASE_OUT_BOUNCE</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
 594 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"easeInOutBounce"</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-OUT-BOUNCE:CAPS">CLUTTER_EASE_IN_OUT_BOUNCE</a> </span><span class="cbracket">}</span><span class="symbol">,</span>
 595 <span class="cbracket">}</span><span class="symbol">;</span>
 596
 597 <span class="preproc">#define</span><span class="normal"> HELP_TEXT       </span><span class="string">"Easing mode: %s (%d of %d)</span><span class="specialchar">\n</span><span class="string">"</span><span class="normal"> </span><span class="symbol">\</span>
 598 <span class="normal">                        </span><span class="string">"Left click to tween</span><span class="specialchar">\n</span><span class="string">"</span><span class="normal"> </span><span class="symbol">\</span>
 599 <span class="normal">                        </span><span class="string">"Right click to change the easing mode"</span>
 600
 601 <span class="keyword">static</span><span class="normal"> </span><span class="keyword">const</span><span class="normal"> </span><span class="usertype">gint</span><span class="normal"> n_easing_modes </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="../glib/glib-Standard-Macros.html#G-N-ELEMENTS:CAPS">G_N_ELEMENTS</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">easing_modes</span><span class="symbol">);</span>
 602 <span class="keyword">static</span><span class="normal"> </span><span class="usertype">gint</span><span class="normal"> current_mode </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span>
 603
 604 <span class="keyword">static</span><span class="normal"> </span><span class="usertype">gint</span><span class="normal"> duration </span><span class="symbol">=</span><span class="normal"> </span><span class="number">1</span><span class="symbol">;</span>
 605 <span class="keyword">static</span><span class="normal"> </span><span class="usertype">gboolean</span><span class="normal"> recenter </span><span class="symbol">=</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">;</span>
 606
 607 <span class="keyword">static</span><span class="normal"> </span><span class="usertype">ClutterActor</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">main_stage </span><span class="symbol">=</span><span class="normal"> <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
 608 <span class="keyword">static</span><span class="normal"> </span><span class="usertype">ClutterActor</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">easing_mode_label </span><span class="symbol">=</span><span class="normal"> <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
 609
 610 <span class="keyword">static</span><span class="normal"> </span><span class="usertype">ClutterAnimation</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">last_animation </span><span class="symbol">=</span><span class="normal"> <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
 611
 612 <span class="comment">/* recenter_bouncer:</span>
 613 <span class="comment"> *</span>
 614 <span class="comment"> * repositions (through an animation) the bouncer at the center of the stage</span>
 615 <span class="comment"> */</span>
 616 <span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
 617 <span class="function">recenter_bouncer</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">ClutterAnimation</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">animation</span><span class="symbol">,</span>
 618 <span class="normal">                  </span><span class="usertype">ClutterActor</span><span class="normal">     </span><span class="symbol">*</span><span class="normal">rectangle</span><span class="symbol">)</span>
 619 <span class="cbracket">{</span>
 620 <span class="normal">  </span><span class="usertype">gfloat</span><span class="normal"> base_x</span><span class="symbol">,</span><span class="normal"> base_y</span><span class="symbol">;</span>
 621 <span class="normal">  </span><span class="usertype">gint</span><span class="normal"> cur_mode</span><span class="symbol">;</span>
 622
 623 <span class="normal">  base_x </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="ClutterActor.html#clutter-actor-get-width">clutter_actor_get_width</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">main_stage</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">/</span><span class="normal"> </span><span class="number">2</span><span class="symbol">;</span>
 624 <span class="normal">  base_y </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="ClutterActor.html#clutter-actor-get-height">clutter_actor_get_height</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">main_stage</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">/</span><span class="normal"> </span><span class="number">2</span><span class="symbol">;</span>
 625
 626 <span class="normal">  cur_mode </span><span class="symbol">=</span><span class="normal"> easing_modes</span><span class="symbol">[</span><span class="normal">current_mode</span><span class="symbol">].</span><span class="normal">mode</span><span class="symbol">;</span>
 627
 628 <span class="normal">  </span><span class="function"><a href="clutter-Implicit-Animations.html#clutter-actor-animate">clutter_actor_animate</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">rectangle</span><span class="symbol">,</span><span class="normal"> cur_mode</span><span class="symbol">,</span><span class="normal"> </span><span class="number">250</span><span class="symbol">,</span>
 629 <span class="normal">                         </span><span class="string">"x"</span><span class="symbol">,</span><span class="normal"> base_x</span><span class="symbol">,</span>
 630 <span class="normal">                         </span><span class="string">"y"</span><span class="symbol">,</span><span class="normal"> base_y</span><span class="symbol">,</span>
 631 <span class="normal">                         <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
 632 <span class="cbracket">}</span>
 633
 634 <span class="keyword">static</span><span class="normal"> <a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a></span>
 635 <span class="function">on_button_press</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">ClutterActor</span><span class="normal">       </span><span class="symbol">*</span><span class="normal">actor</span><span class="symbol">,</span>
 636 <span class="normal">                 </span><span class="usertype">ClutterButtonEvent</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">event</span><span class="symbol">,</span>
 637 <span class="normal">                 </span><span class="usertype">ClutterActor</span><span class="normal">       </span><span class="symbol">*</span><span class="normal">rectangle</span><span class="symbol">)</span>
 638 <span class="cbracket">{</span>
 639 <span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">event</span><span class="symbol">-&gt;</span><span class="normal">button </span><span class="symbol">==</span><span class="normal"> <a href="clutter-Events.html#CLUTTER-BUTTON-SECONDARY:CAPS">CLUTTER_BUTTON_SECONDARY</a></span><span class="symbol">)</span>
 640 <span class="normal">    </span><span class="cbracket">{</span>
 641 <span class="normal">      </span><span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">text</span><span class="symbol">;</span>
 642
 643 <span class="normal">      </span><span class="comment">/* cycle through the various easing modes */</span>
 644 <span class="normal">      current_mode </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">current_mode </span><span class="symbol">+</span><span class="normal"> </span><span class="number">1</span><span class="normal"> </span><span class="symbol">&lt;</span><span class="normal"> n_easing_modes</span><span class="symbol">)</span>
 645 <span class="normal">                   </span><span class="symbol">?</span><span class="normal"> current_mode </span><span class="symbol">+</span><span class="normal"> </span><span class="number">1</span>
 646 <span class="normal">                   </span><span class="symbol">:</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span>
 647
 648 <span class="normal">      </span><span class="comment">/* update the text of the label */</span>
 649 <span class="normal">      text </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="../glib/glib-String-Utility-Functions.html#g-strdup-printf">g_strdup_printf</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">HELP_TEXT</span><span class="symbol">,</span>
 650 <span class="normal">                              easing_modes</span><span class="symbol">[</span><span class="normal">current_mode</span><span class="symbol">].</span><span class="normal">name</span><span class="symbol">,</span>
 651 <span class="normal">                              current_mode </span><span class="symbol">+</span><span class="normal"> </span><span class="number">1</span><span class="symbol">,</span>
 652 <span class="normal">                              n_easing_modes</span><span class="symbol">);</span>
 653
 654 <span class="normal">      </span><span class="function"><a href="ClutterText.html#clutter-text-set-text">clutter_text_set_text</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">CLUTTER_TEXT</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">easing_mode_label</span><span class="symbol">),</span><span class="normal"> text</span><span class="symbol">);</span>
 655 <span class="normal">      </span><span class="function"><a href="../glib/glib-Memory-Allocation.html#g-free">g_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">text</span><span class="symbol">);</span>
 656 <span class="normal">    </span><span class="cbracket">}</span>
 657 <span class="normal">  </span><span class="keyword">else</span><span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">event</span><span class="symbol">-&gt;</span><span class="normal">button </span><span class="symbol">==</span><span class="normal"> <a href="clutter-Events.html#CLUTTER-BUTTON-PRIMARY:CAPS">CLUTTER_BUTTON_PRIMARY</a></span><span class="symbol">)</span>
 658 <span class="normal">    </span><span class="cbracket">{</span>
 659 <span class="normal">      </span><span class="usertype">ClutterAnimation</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">animation</span><span class="symbol">;</span>
 660 <span class="normal">      </span><span class="usertype">ClutterAnimationMode</span><span class="normal"> cur_mode</span><span class="symbol">;</span>
 661
 662 <span class="normal">      cur_mode </span><span class="symbol">=</span><span class="normal"> easing_modes</span><span class="symbol">[</span><span class="normal">current_mode</span><span class="symbol">].</span><span class="normal">mode</span><span class="symbol">;</span>
 663
 664 <span class="normal">      </span><span class="comment">/* tween the actor using the current easing mode */</span>
 665 <span class="normal">      animation </span><span class="symbol">=</span>
 666 <span class="normal">        </span><span class="function"><a href="clutter-Implicit-Animations.html#clutter-actor-animate">clutter_actor_animate</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">rectangle</span><span class="symbol">,</span><span class="normal"> cur_mode</span><span class="symbol">,</span><span class="normal"> duration </span><span class="symbol">*</span><span class="normal"> </span><span class="number">1000</span><span class="symbol">,</span>
 667 <span class="normal">                               </span><span class="string">"x"</span><span class="symbol">,</span><span class="normal"> event</span><span class="symbol">-&gt;</span><span class="normal">x</span><span class="symbol">,</span>
 668 <span class="normal">                               </span><span class="string">"y"</span><span class="symbol">,</span><span class="normal"> event</span><span class="symbol">-&gt;</span><span class="normal">y</span><span class="symbol">,</span>
 669 <span class="normal">                               <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
 670
 671 <span class="normal">      </span><span class="comment">/* if we were asked to, recenter the bouncer at the end of the</span>
 672 <span class="comment">       * animation. we keep track of the animation to avoid connecting</span>
 673 <span class="comment">       * the signal handler to the same Animation twice.</span>
 674 <span class="comment">       */</span>
 675 <span class="normal">      </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">recenter </span><span class="symbol">&amp;&amp;</span><span class="normal"> last_animation </span><span class="symbol">!=</span><span class="normal"> animation</span><span class="symbol">)</span>
 676 <span class="normal">        </span><span class="function"><a href="../gobject/gobject-Signals.html#g-signal-connect-after">g_signal_connect_after</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">animation</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"completed"</span><span class="symbol">,</span>
 677 <span class="normal">                                </span><span class="function"><a href="../gobject/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">recenter_bouncer</span><span class="symbol">),</span>
 678 <span class="normal">                                rectangle</span><span class="symbol">);</span>
 679
 680 <span class="normal">      last_animation </span><span class="symbol">=</span><span class="normal"> animation</span><span class="symbol">;</span>
 681 <span class="normal">    </span><span class="cbracket">}</span>
 682
 683 <span class="normal">  </span><span class="keyword">return</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS">TRUE</a></span><span class="symbol">;</span>
 684 <span class="cbracket">}</span>
 685
 686 <span class="keyword">static</span><span class="normal"> <a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a></span>
 687 <span class="function">draw_bouncer</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">ClutterCairoTexture</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">texture</span><span class="symbol">,</span>
 688 <span class="normal">              </span><span class="usertype">cairo_t</span><span class="normal">             </span><span class="symbol">*</span><span class="normal">cr</span><span class="symbol">)</span>
 689 <span class="cbracket">{</span>
 690 <span class="normal">  </span><span class="keyword">const</span><span class="normal"> </span><span class="usertype">ClutterColor</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">bouncer_color</span><span class="symbol">;</span>
 691 <span class="normal">  </span><span class="usertype">cairo_pattern_t</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">pattern</span><span class="symbol">;</span>
 692 <span class="normal">  </span><span class="usertype">guint</span><span class="normal"> width</span><span class="symbol">,</span><span class="normal"> height</span><span class="symbol">;</span>
 693 <span class="normal">  </span><span class="type">float</span><span class="normal"> radius</span><span class="symbol">;</span>
 694
 695 <span class="normal">  </span><span class="function"><a href="ClutterCairoTexture.html#clutter-cairo-texture-get-surface-size">clutter_cairo_texture_get_surface_size</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">texture</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">width</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">height</span><span class="symbol">);</span>
 696
 697 <span class="normal">  radius </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="../glib/glib-Standard-Macros.html#MAX:CAPS">MAX</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">width</span><span class="symbol">,</span><span class="normal"> height</span><span class="symbol">);</span>
 698
 699 <span class="normal">  </span><span class="function"><a href="ClutterCairoTexture.html#clutter-cairo-texture-clear">clutter_cairo_texture_clear</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">texture</span><span class="symbol">);</span>
 700
 701 <span class="normal">  </span><span class="function"><a href="/home/ebassi/gnome3/install/share/gtk-doc/html/cairo/cairo-Paths.html#cairo-arc">cairo_arc</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cr</span><span class="symbol">,</span><span class="normal"> radius </span><span class="symbol">/</span><span class="normal"> </span><span class="number">2</span><span class="symbol">,</span><span class="normal"> radius </span><span class="symbol">/</span><span class="normal"> </span><span class="number">2</span><span class="symbol">,</span><span class="normal"> radius </span><span class="symbol">/</span><span class="normal"> </span><span class="number">2</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0.0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">2.0</span><span class="normal"> </span><span class="symbol">*</span><span class="normal"> <a href="../glib/glib-Numerical-Definitions.html#G-PI:CAPS">G_PI</a></span><span class="symbol">);</span>
 702
 703 <span class="normal">  bouncer_color </span><span class="symbol">=</span><span class="normal"> CLUTTER_COLOR_DarkScarletRed</span><span class="symbol">;</span>
 704
 705 <span class="normal">  pattern </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="/home/ebassi/gnome3/install/share/gtk-doc/html/cairo/cairo-cairo-pattern-t.html#cairo-pattern-create-radial">cairo_pattern_create_radial</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">radius </span><span class="symbol">/</span><span class="normal"> </span><span class="number">2</span><span class="symbol">,</span><span class="normal"> radius </span><span class="symbol">/</span><span class="normal"> </span><span class="number">2</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span>
 706 <span class="normal">                                         radius</span><span class="symbol">,</span><span class="normal"> radius</span><span class="symbol">,</span><span class="normal"> radius</span><span class="symbol">);</span>
 707 <span class="normal">  </span><span class="function"><a href="/home/ebassi/gnome3/install/share/gtk-doc/html/cairo/cairo-cairo-pattern-t.html#cairo-pattern-add-color-stop-rgba">cairo_pattern_add_color_stop_rgba</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">pattern</span><span class="symbol">,</span>
 708 <span class="normal">                                     </span><span class="number">0</span><span class="symbol">,</span>
 709 <span class="normal">                                     bouncer_color</span><span class="symbol">-&gt;</span><span class="normal">red </span><span class="symbol">/</span><span class="normal"> </span><span class="number">255.0</span><span class="symbol">,</span>
 710 <span class="normal">                                     bouncer_color</span><span class="symbol">-&gt;</span><span class="normal">green </span><span class="symbol">/</span><span class="normal"> </span><span class="number">255.0</span><span class="symbol">,</span>
 711 <span class="normal">                                     bouncer_color</span><span class="symbol">-&gt;</span><span class="normal">blue </span><span class="symbol">/</span><span class="normal"> </span><span class="number">255.0</span><span class="symbol">,</span>
 712 <span class="normal">                                     bouncer_color</span><span class="symbol">-&gt;</span><span class="normal">alpha </span><span class="symbol">/</span><span class="normal"> </span><span class="number">255.0</span><span class="symbol">);</span>
 713 <span class="normal">  </span><span class="function"><a href="/home/ebassi/gnome3/install/share/gtk-doc/html/cairo/cairo-cairo-pattern-t.html#cairo-pattern-add-color-stop-rgba">cairo_pattern_add_color_stop_rgba</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">pattern</span><span class="symbol">,</span>
 714 <span class="normal">                                     </span><span class="number">0.85</span><span class="symbol">,</span>
 715 <span class="normal">                                     bouncer_color</span><span class="symbol">-&gt;</span><span class="normal">red </span><span class="symbol">/</span><span class="normal"> </span><span class="number">255.0</span><span class="symbol">,</span>
 716 <span class="normal">                                     bouncer_color</span><span class="symbol">-&gt;</span><span class="normal">green </span><span class="symbol">/</span><span class="normal"> </span><span class="number">255.0</span><span class="symbol">,</span>
 717 <span class="normal">                                     bouncer_color</span><span class="symbol">-&gt;</span><span class="normal">blue </span><span class="symbol">/</span><span class="normal"> </span><span class="number">255.0</span><span class="symbol">,</span>
 718 <span class="normal">                                     </span><span class="number">0.25</span><span class="symbol">);</span>
 719
 720 <span class="normal">  </span><span class="function"><a href="/home/ebassi/gnome3/install/share/gtk-doc/html/cairo/cairo-cairo-t.html#cairo-set-source">cairo_set_source</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cr</span><span class="symbol">,</span><span class="normal"> pattern</span><span class="symbol">);</span>
 721 <span class="normal">  </span><span class="function"><a href="/home/ebassi/gnome3/install/share/gtk-doc/html/cairo/cairo-cairo-t.html#cairo-fill-preserve">cairo_fill_preserve</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cr</span><span class="symbol">);</span>
 722
 723 <span class="normal">  </span><span class="function"><a href="/home/ebassi/gnome3/install/share/gtk-doc/html/cairo/cairo-cairo-pattern-t.html#cairo-pattern-destroy">cairo_pattern_destroy</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">pattern</span><span class="symbol">);</span>
 724
 725 <span class="normal">  </span><span class="keyword">return</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS">TRUE</a></span><span class="symbol">;</span>
 726 <span class="cbracket">}</span>
 727
 728 <span class="keyword">static</span><span class="normal"> <a href="ClutterActor.html">ClutterActor</a> </span><span class="symbol">*</span>
 729 <span class="function">make_bouncer</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">gfloat</span><span class="normal"> width</span><span class="symbol">,</span>
 730 <span class="normal">              </span><span class="usertype">gfloat</span><span class="normal"> height</span><span class="symbol">)</span>
 731 <span class="cbracket">{</span>
 732 <span class="normal">  </span><span class="usertype">ClutterActor</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">retval</span><span class="symbol">;</span>
 733
 734 <span class="normal">  retval </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="ClutterCairoTexture.html#clutter-cairo-texture-new">clutter_cairo_texture_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">width</span><span class="symbol">,</span><span class="normal"> height</span><span class="symbol">);</span>
 735 <span class="normal">  </span><span class="function"><a href="../gobject/gobject-Signals.html#g-signal-connect">g_signal_connect</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">retval</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"draw"</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="../gobject/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">draw_bouncer</span><span class="symbol">),</span><span class="normal"> <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
 736
 737 <span class="normal">  </span><span class="function"><a href="ClutterActor.html#clutter-actor-set-name">clutter_actor_set_name</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">retval</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"bouncer"</span><span class="symbol">);</span>
 738 <span class="normal">  </span><span class="function"><a href="ClutterActor.html#clutter-actor-set-size">clutter_actor_set_size</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">retval</span><span class="symbol">,</span><span class="normal"> width</span><span class="symbol">,</span><span class="normal"> height</span><span class="symbol">);</span>
 739 <span class="normal">  </span><span class="function"><a href="ClutterActor.html#clutter-actor-set-anchor-point">clutter_actor_set_anchor_point</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">retval</span><span class="symbol">,</span><span class="normal"> width </span><span class="symbol">/</span><span class="normal"> </span><span class="number">2</span><span class="symbol">,</span><span class="normal"> height </span><span class="symbol">/</span><span class="normal"> </span><span class="number">2</span><span class="symbol">);</span>
 740 <span class="normal">  </span><span class="function"><a href="ClutterActor.html#clutter-actor-set-reactive">clutter_actor_set_reactive</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">retval</span><span class="symbol">,</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS">TRUE</a></span><span class="symbol">);</span>
 741
 742 <span class="normal">  </span><span class="comment">/* make sure we draw the bouncer immediately */</span>
 743 <span class="normal">  </span><span class="function"><a href="ClutterCairoTexture.html#clutter-cairo-texture-invalidate">clutter_cairo_texture_invalidate</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">CLUTTER_CAIRO_TEXTURE</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">retval</span><span class="symbol">));</span>
 744
 745 <span class="normal">  </span><span class="keyword">return</span><span class="normal"> retval</span><span class="symbol">;</span>
 746 <span class="cbracket">}</span>
 747
 748 <span class="keyword">static</span><span class="normal"> </span><span class="usertype">GOptionEntry</span><span class="normal"> test_easing_entries</span><span class="symbol">[]</span><span class="normal"> </span><span class="symbol">=</span><span class="normal"> </span><span class="cbracket">{</span>
 749 <span class="normal">  </span><span class="cbracket">{</span>
 750 <span class="normal">    </span><span class="string">"re-center"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">'r'</span><span class="symbol">,</span>
 751 <span class="normal">    </span><span class="number">0</span><span class="symbol">,</span>
 752 <span class="normal">    <a href="../glib/glib-Commandline-option-parser.html#G-OPTION-ARG-NONE:CAPS">G_OPTION_ARG_NONE</a></span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">recenter</span><span class="symbol">,</span>
 753 <span class="normal">    </span><span class="string">"Re-center the actor when the animation ends"</span><span class="symbol">,</span>
 754 <span class="normal">    <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS">NULL</a></span>
 755 <span class="normal">  </span><span class="cbracket">}</span><span class="symbol">,</span>
 756 <span class="normal">  </span><span class="cbracket">{</span>
 757 <span class="normal">    </span><span class="string">"duration"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">'d'</span><span class="symbol">,</span>
 758 <span class="normal">    </span><span class="number">0</span><span class="symbol">,</span>
 759 <span class="normal">    <a href="../glib/glib-Commandline-option-parser.html#G-OPTION-ARG-INT:CAPS">G_OPTION_ARG_INT</a></span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">duration</span><span class="symbol">,</span>
 760 <span class="normal">    </span><span class="string">"Duration of the animation"</span><span class="symbol">,</span>
 761 <span class="normal">    </span><span class="string">"SECONDS"</span>
 762 <span class="normal">  </span><span class="cbracket">}</span><span class="symbol">,</span>
 763
 764 <span class="normal">  </span><span class="cbracket">{</span><span class="normal"> <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS">NULL</a> </span><span class="cbracket">}</span>
 765 <span class="cbracket">}</span><span class="symbol">;</span>
 766
 767 <span class="normal"><a href="../glib/glib-Dynamic-Loading-of-Modules.html#G-MODULE-EXPORT:CAPS">G_MODULE_EXPORT</a> </span><span class="type">int</span>
 768 <span class="function">test_easing_main</span><span class="normal"> </span><span class="symbol">(</span><span class="type">int</span><span class="normal"> argc</span><span class="symbol">,</span><span class="normal"> </span><span class="type">char</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">argv</span><span class="symbol">[])</span>
 769 <span class="cbracket">{</span>
 770 <span class="normal">  </span><span class="usertype">ClutterActor</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">stage</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">rect</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">label</span><span class="symbol">;</span>
 771 <span class="normal">  </span><span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">text</span><span class="symbol">;</span>
 772 <span class="normal">  </span><span class="usertype">gfloat</span><span class="normal"> stage_width</span><span class="symbol">,</span><span class="normal"> stage_height</span><span class="symbol">;</span>
 773 <span class="normal">  </span><span class="usertype">GError</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">error </span><span class="symbol">=</span><span class="normal"> <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
 774
 775 <span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="clutter-General.html#clutter-init-with-args">clutter_init_with_args</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">argc</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">argv</span><span class="symbol">,</span>
 776 <span class="normal">                              <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span>
 777 <span class="normal">                              test_easing_entries</span><span class="symbol">,</span>
 778 <span class="normal">                              <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span>
 779 <span class="normal">                              </span><span class="symbol">&amp;</span><span class="normal">error</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">!=</span><span class="normal"> <a href="clutter-General.html#CLUTTER-INIT-SUCCESS:CAPS">CLUTTER_INIT_SUCCESS</a></span><span class="symbol">)</span>
 780 <span class="normal">    </span><span class="keyword">return</span><span class="normal"> </span><span class="number">1</span><span class="symbol">;</span>
 781
 782 <span class="normal">  stage </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="ClutterStage.html#clutter-stage-new">clutter_stage_new</a></span><span class="normal"> </span><span class="symbol">();</span>
 783 <span class="normal">  </span><span class="function"><a href="ClutterStage.html#clutter-stage-set-title">clutter_stage_set_title</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">CLUTTER_STAGE</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">stage</span><span class="symbol">),</span><span class="normal"> </span><span class="string">"Easing Modes"</span><span class="symbol">);</span>
 784 <span class="normal">  </span><span class="function"><a href="ClutterActor.html#clutter-actor-set-background-color">clutter_actor_set_background_color</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">stage</span><span class="symbol">,</span><span class="normal"> CLUTTER_COLOR_LightSkyBlue</span><span class="symbol">);</span>
 785 <span class="normal">  </span><span class="function"><a href="../gobject/gobject-Signals.html#g-signal-connect">g_signal_connect</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">stage</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"destroy"</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="../gobject/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="clutter-General.html#clutter-main-quit">clutter_main_quit</a></span><span class="symbol">),</span><span class="normal"> <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
 786 <span class="normal">  main_stage </span><span class="symbol">=</span><span class="normal"> stage</span><span class="symbol">;</span>
 787
 788 <span class="normal">  </span><span class="function"><a href="ClutterActor.html#clutter-actor-get-size">clutter_actor_get_size</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">stage</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">stage_width</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">stage_height</span><span class="symbol">);</span>
 789
 790 <span class="normal">  </span><span class="comment">/* create the actor that we want to tween */</span>
 791 <span class="normal">  rect </span><span class="symbol">=</span><span class="normal"> </span><span class="function">make_bouncer</span><span class="normal"> </span><span class="symbol">(</span><span class="number">50</span><span class="symbol">,</span><span class="normal"> </span><span class="number">50</span><span class="symbol">);</span>
 792 <span class="normal">  </span><span class="function"><a href="ClutterContainer.html#clutter-container-add-actor">clutter_container_add_actor</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">CLUTTER_CONTAINER</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">stage</span><span class="symbol">),</span><span class="normal"> rect</span><span class="symbol">);</span>
 793 <span class="normal">  </span><span class="function"><a href="ClutterActor.html#clutter-actor-set-position">clutter_actor_set_position</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">rect</span><span class="symbol">,</span><span class="normal"> stage_width </span><span class="symbol">/</span><span class="normal"> </span><span class="number">2</span><span class="symbol">,</span><span class="normal"> stage_height </span><span class="symbol">/</span><span class="normal"> </span><span class="number">2</span><span class="symbol">);</span>
 794
 795 <span class="normal">  text </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="../glib/glib-String-Utility-Functions.html#g-strdup-printf">g_strdup_printf</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">HELP_TEXT</span><span class="symbol">,</span>
 796 <span class="normal">                          easing_modes</span><span class="symbol">[</span><span class="normal">current_mode</span><span class="symbol">].</span><span class="normal">name</span><span class="symbol">,</span>
 797 <span class="normal">                          current_mode </span><span class="symbol">+</span><span class="normal"> </span><span class="number">1</span><span class="symbol">,</span>
 798 <span class="normal">                          n_easing_modes</span><span class="symbol">);</span>
 799
 800 <span class="normal">  label </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="ClutterText.html#clutter-text-new">clutter_text_new</a></span><span class="normal"> </span><span class="symbol">();</span>
 801 <span class="normal">  </span><span class="function"><a href="ClutterContainer.html#clutter-container-add-actor">clutter_container_add_actor</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">CLUTTER_CONTAINER</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">stage</span><span class="symbol">),</span><span class="normal"> label</span><span class="symbol">);</span>
 802 <span class="normal">  </span><span class="function"><a href="ClutterText.html#clutter-text-set-text">clutter_text_set_text</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">CLUTTER_TEXT</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">label</span><span class="symbol">),</span><span class="normal"> text</span><span class="symbol">);</span>
 803 <span class="normal">  </span><span class="function"><a href="ClutterActor.html#clutter-actor-add-constraint">clutter_actor_add_constraint</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">label</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="ClutterAlignConstraint.html#clutter-align-constraint-new">clutter_align_constraint_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">stage</span><span class="symbol">,</span><span class="normal"> <a href="ClutterAlignConstraint.html#CLUTTER-ALIGN-X-AXIS:CAPS">CLUTTER_ALIGN_X_AXIS</a></span><span class="symbol">,</span><span class="normal"> </span><span class="number">0.95</span><span class="symbol">));</span>
 804 <span class="normal">  </span><span class="function"><a href="ClutterActor.html#clutter-actor-add-constraint">clutter_actor_add_constraint</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">label</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="ClutterAlignConstraint.html#clutter-align-constraint-new">clutter_align_constraint_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">stage</span><span class="symbol">,</span><span class="normal"> <a href="ClutterAlignConstraint.html#CLUTTER-ALIGN-Y-AXIS:CAPS">CLUTTER_ALIGN_Y_AXIS</a></span><span class="symbol">,</span><span class="normal"> </span><span class="number">0.95</span><span class="symbol">));</span>
 805 <span class="normal">  easing_mode_label </span><span class="symbol">=</span><span class="normal"> label</span><span class="symbol">;</span>
 806
 807 <span class="normal">  </span><span class="function"><a href="../glib/glib-Memory-Allocation.html#g-free">g_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">text</span><span class="symbol">);</span>
 808
 809 <span class="normal">  </span><span class="function"><a href="../gobject/gobject-Signals.html#g-signal-connect">g_signal_connect</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">stage</span><span class="symbol">,</span>
 810 <span class="normal">                    </span><span class="string">"button-press-event"</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="../gobject/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">on_button_press</span><span class="symbol">),</span>
 811 <span class="normal">                    rect</span><span class="symbol">);</span>
 812
 813 <span class="normal">  </span><span class="function"><a href="ClutterActor.html#clutter-actor-show">clutter_actor_show</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">stage</span><span class="symbol">);</span>
 814
 815 <span class="normal">  </span><span class="function"><a href="clutter-General.html#clutter-main">clutter_main</a></span><span class="normal"> </span><span class="symbol">();</span>
 816
 817 <span class="normal">  </span><span class="keyword">return</span><span class="normal"> EXIT_SUCCESS</span><span class="symbol">;</span>
 818 <span class="cbracket">}</span>
 819
 820 <span class="normal"><a href="../glib/glib-Dynamic-Loading-of-Modules.html#G-MODULE-EXPORT:CAPS">G_MODULE_EXPORT</a> </span><span class="usertype">const</span><span class="normal"> </span><span class="type">char</span><span class="normal"> </span><span class="symbol">*</span>
 821 <span class="function">test_easing_describe</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
 822 <span class="cbracket">{</span>
 823 <span class="normal">  </span><span class="keyword">return</span><span class="normal"> </span><span class="string">"Visualize all easing modes provided by Clutter"</span><span class="symbol">;</span>
 824 <span class="cbracket">}</span></pre></td>
 825       </tr>
 826     </tbody>
 827   </table>
 828 </div>
 829
 830 </div>
 831 <p><br class="example-break">
 832 </p>
 833 <p>
 834 <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> is available since Clutter 1.0
 835 </p>
 836 </div>
 837 <div class="refsect1">
 838 <a name="clutter-Implicit-Animations.details"></a><h2>Details</h2>
 839 <div class="refsect2">
 840 <a name="ClutterAnimation-struct"></a><h3>struct ClutterAnimation</h3>
 841 <pre class="programlisting">struct ClutterAnimation;</pre>
 842 <p>
 843 The <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> structure contains only private data and should
 844 be accessed using the provided functions.
 845 </p>
 846 <p class="since">Since 1.0</p>
 847 </div>
 848 <hr>
 849 <div class="refsect2">
 850 <a name="ClutterAnimationClass"></a><h3>struct ClutterAnimationClass</h3>
 851 <pre class="programlisting">struct ClutterAnimationClass {
 852   void (* started)   (ClutterAnimation *animation);
 853   void (* completed) (ClutterAnimation *animation);
 854 };
 855 </pre>
 856 <p>
 857 The <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimationClass" title="struct ClutterAnimationClass"><span class="type">ClutterAnimationClass</span></a> structure contains only private data and
 858 should be accessed using the provided functions.
 859 </p>
 860 <div class="variablelist"><table border="0">
 861 <col align="left" valign="top">
 862 <tbody>
 863 <tr>
 864 <td><p><span class="term"><em class="structfield"><code><a name="ClutterAnimationClass.started"></a>started</code></em> ()</span></p></td>
 865 <td>class handler for the <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation-started" title='The "started" signal'><span class="type">"started"</span></a> signal</td>
 866 </tr>
 867 <tr>
 868 <td><p><span class="term"><em class="structfield"><code><a name="ClutterAnimationClass.completed"></a>completed</code></em> ()</span></p></td>
 869 <td>class handler for the <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation-completed" title='The "completed" signal'><span class="type">"completed"</span></a> signal</td>
 870 </tr>
 871 </tbody>
 872 </table></div>
 873 <p class="since">Since 1.0</p>
 874 </div>
 875 <hr>
 876 <div class="refsect2">
 877 <a name="ClutterAnimationMode"></a><h3>enum ClutterAnimationMode</h3>
 878 <pre class="programlisting">typedef enum {
 879   CLUTTER_CUSTOM_MODE = 0,
 880
 881   /* linear */
 882   CLUTTER_LINEAR,
 883
 884   /* quadratic */
 885   CLUTTER_EASE_IN_QUAD,
 886   CLUTTER_EASE_OUT_QUAD,
 887   CLUTTER_EASE_IN_OUT_QUAD,
 888
 889   /* cubic */
 890   CLUTTER_EASE_IN_CUBIC,
 891   CLUTTER_EASE_OUT_CUBIC,
 892   CLUTTER_EASE_IN_OUT_CUBIC,
 893
 894   /* quartic */
 895   CLUTTER_EASE_IN_QUART,
 896   CLUTTER_EASE_OUT_QUART,
 897   CLUTTER_EASE_IN_OUT_QUART,
 898
 899   /* quintic */
 900   CLUTTER_EASE_IN_QUINT,
 901   CLUTTER_EASE_OUT_QUINT,
 902   CLUTTER_EASE_IN_OUT_QUINT,
 903
 904   /* sinusoidal */
 905   CLUTTER_EASE_IN_SINE,
 906   CLUTTER_EASE_OUT_SINE,
 907   CLUTTER_EASE_IN_OUT_SINE,
 908
 909   /* exponential */
 910   CLUTTER_EASE_IN_EXPO,
 911   CLUTTER_EASE_OUT_EXPO,
 912   CLUTTER_EASE_IN_OUT_EXPO,
 913
 914   /* circular */
 915   CLUTTER_EASE_IN_CIRC,
 916   CLUTTER_EASE_OUT_CIRC,
 917   CLUTTER_EASE_IN_OUT_CIRC,
 918
 919   /* elastic */
 920   CLUTTER_EASE_IN_ELASTIC,
 921   CLUTTER_EASE_OUT_ELASTIC,
 922   CLUTTER_EASE_IN_OUT_ELASTIC,
 923
 924   /* overshooting cubic */
 925   CLUTTER_EASE_IN_BACK,
 926   CLUTTER_EASE_OUT_BACK,
 927   CLUTTER_EASE_IN_OUT_BACK,
 928
 929   /* exponentially decaying parabolic */
 930   CLUTTER_EASE_IN_BOUNCE,
 931   CLUTTER_EASE_OUT_BOUNCE,
 932   CLUTTER_EASE_IN_OUT_BOUNCE,
 933
 934   /* guard, before registered alpha functions */
 935   CLUTTER_ANIMATION_LAST
 936 } ClutterAnimationMode;
 937 </pre>
 938 <p>
 939 The animation modes used by <a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a> and <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a>. This
 940 enumeration can be expanded in later versions of Clutter. See the
 941 <a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a> documentation for a graph of all the animation modes.
 942 </p>
 943 <p>
 944 Every global alpha function registered using <a class="link" href="ClutterAlpha.html#clutter-alpha-register-func" title="clutter_alpha_register_func ()"><code class="function">clutter_alpha_register_func()</code></a>
 945 or <a class="link" href="ClutterAlpha.html#clutter-alpha-register-closure" title="clutter_alpha_register_closure ()"><code class="function">clutter_alpha_register_closure()</code></a> will have a logical id greater than
 946 <a class="link" href="clutter-Implicit-Animations.html#CLUTTER-ANIMATION-LAST:CAPS"><code class="literal">CLUTTER_ANIMATION_LAST</code></a>.
 947 </p>
 948 <div class="variablelist"><table border="0">
 949 <col align="left" valign="top">
 950 <tbody>
 951 <tr>
 952 <td><p><a name="CLUTTER-CUSTOM-MODE:CAPS"></a><span class="term"><code class="literal">CLUTTER_CUSTOM_MODE</code></span></p></td>
 953 <td>custom progress function
 954 </td>
 955 </tr>
 956 <tr>
 957 <td><p><a name="CLUTTER-LINEAR:CAPS"></a><span class="term"><code class="literal">CLUTTER_LINEAR</code></span></p></td>
 958 <td>linear tweening
 959 </td>
 960 </tr>
 961 <tr>
 962 <td><p><a name="CLUTTER-EASE-IN-QUAD:CAPS"></a><span class="term"><code class="literal">CLUTTER_EASE_IN_QUAD</code></span></p></td>
 963 <td>quadratic tweening
 964 </td>
 965 </tr>
 966 <tr>
 967 <td><p><a name="CLUTTER-EASE-OUT-QUAD:CAPS"></a><span class="term"><code class="literal">CLUTTER_EASE_OUT_QUAD</code></span></p></td>
 968 <td>quadratic tweening, inverse of
 969    <a class="link" href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-QUAD:CAPS"><code class="literal">CLUTTER_EASE_IN_QUAD</code></a>
 970 </td>
 971 </tr>
 972 <tr>
 973 <td><p><a name="CLUTTER-EASE-IN-OUT-QUAD:CAPS"></a><span class="term"><code class="literal">CLUTTER_EASE_IN_OUT_QUAD</code></span></p></td>
 974 <td>quadratic tweening, combininig
 975    <a class="link" href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-QUAD:CAPS"><code class="literal">CLUTTER_EASE_IN_QUAD</code></a> and <a class="link" href="clutter-Implicit-Animations.html#CLUTTER-EASE-OUT-QUAD:CAPS"><code class="literal">CLUTTER_EASE_OUT_QUAD</code></a>
 976 </td>
 977 </tr>
 978 <tr>
 979 <td><p><a name="CLUTTER-EASE-IN-CUBIC:CAPS"></a><span class="term"><code class="literal">CLUTTER_EASE_IN_CUBIC</code></span></p></td>
 980 <td>cubic tweening
 981 </td>
 982 </tr>
 983 <tr>
 984 <td><p><a name="CLUTTER-EASE-OUT-CUBIC:CAPS"></a><span class="term"><code class="literal">CLUTTER_EASE_OUT_CUBIC</code></span></p></td>
 985 <td>cubic tweening, invers of
 986    <a class="link" href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-CUBIC:CAPS"><code class="literal">CLUTTER_EASE_IN_CUBIC</code></a>
 987 </td>
 988 </tr>
 989 <tr>
 990 <td><p><a name="CLUTTER-EASE-IN-OUT-CUBIC:CAPS"></a><span class="term"><code class="literal">CLUTTER_EASE_IN_OUT_CUBIC</code></span></p></td>
 991 <td>cubic tweening, combining
 992    <a class="link" href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-CUBIC:CAPS"><code class="literal">CLUTTER_EASE_IN_CUBIC</code></a> and <a class="link" href="clutter-Implicit-Animations.html#CLUTTER-EASE-OUT-CUBIC:CAPS"><code class="literal">CLUTTER_EASE_OUT_CUBIC</code></a>
 993 </td>
 994 </tr>
 995 <tr>
 996 <td><p><a name="CLUTTER-EASE-IN-QUART:CAPS"></a><span class="term"><code class="literal">CLUTTER_EASE_IN_QUART</code></span></p></td>
 997 <td>quartic tweening
 998 </td>
 999 </tr>
1000 <tr>
1001 <td><p><a name="CLUTTER-EASE-OUT-QUART:CAPS"></a><span class="term"><code class="literal">CLUTTER_EASE_OUT_QUART</code></span></p></td>
1002 <td>quartic tweening, inverse of
1003    <a class="link" href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-QUART:CAPS"><code class="literal">CLUTTER_EASE_IN_QUART</code></a>
1004 </td>
1005 </tr>
1006 <tr>
1007 <td><p><a name="CLUTTER-EASE-IN-OUT-QUART:CAPS"></a><span class="term"><code class="literal">CLUTTER_EASE_IN_OUT_QUART</code></span></p></td>
1008 <td>quartic tweening, combining
1009    <a class="link" href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-QUART:CAPS"><code class="literal">CLUTTER_EASE_IN_QUART</code></a> and <a class="link" href="clutter-Implicit-Animations.html#CLUTTER-EASE-OUT-QUART:CAPS"><code class="literal">CLUTTER_EASE_OUT_QUART</code></a>
1010 </td>
1011 </tr>
1012 <tr>
1013 <td><p><a name="CLUTTER-EASE-IN-QUINT:CAPS"></a><span class="term"><code class="literal">CLUTTER_EASE_IN_QUINT</code></span></p></td>
1014 <td>quintic tweening
1015 </td>
1016 </tr>
1017 <tr>
1018 <td><p><a name="CLUTTER-EASE-OUT-QUINT:CAPS"></a><span class="term"><code class="literal">CLUTTER_EASE_OUT_QUINT</code></span></p></td>
1019 <td>quintic tweening, inverse of
1020    <a class="link" href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-QUINT:CAPS"><code class="literal">CLUTTER_EASE_IN_QUINT</code></a>
1021 </td>
1022 </tr>
1023 <tr>
1024 <td><p><a name="CLUTTER-EASE-IN-OUT-QUINT:CAPS"></a><span class="term"><code class="literal">CLUTTER_EASE_IN_OUT_QUINT</code></span></p></td>
1025 <td>fifth power tweening, combining
1026    <a class="link" href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-QUINT:CAPS"><code class="literal">CLUTTER_EASE_IN_QUINT</code></a> and <a class="link" href="clutter-Implicit-Animations.html#CLUTTER-EASE-OUT-QUINT:CAPS"><code class="literal">CLUTTER_EASE_OUT_QUINT</code></a>
1027 </td>
1028 </tr>
1029 <tr>
1030 <td><p><a name="CLUTTER-EASE-IN-SINE:CAPS"></a><span class="term"><code class="literal">CLUTTER_EASE_IN_SINE</code></span></p></td>
1031 <td>sinusoidal tweening
1032 </td>
1033 </tr>
1034 <tr>
1035 <td><p><a name="CLUTTER-EASE-OUT-SINE:CAPS"></a><span class="term"><code class="literal">CLUTTER_EASE_OUT_SINE</code></span></p></td>
1036 <td>sinusoidal tweening, inverse of
1037    <a class="link" href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-SINE:CAPS"><code class="literal">CLUTTER_EASE_IN_SINE</code></a>
1038 </td>
1039 </tr>
1040 <tr>
1041 <td><p><a name="CLUTTER-EASE-IN-OUT-SINE:CAPS"></a><span class="term"><code class="literal">CLUTTER_EASE_IN_OUT_SINE</code></span></p></td>
1042 <td>sine wave tweening, combining
1043    <a class="link" href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-SINE:CAPS"><code class="literal">CLUTTER_EASE_IN_SINE</code></a> and <a class="link" href="clutter-Implicit-Animations.html#CLUTTER-EASE-OUT-SINE:CAPS"><code class="literal">CLUTTER_EASE_OUT_SINE</code></a>
1044 </td>
1045 </tr>
1046 <tr>
1047 <td><p><a name="CLUTTER-EASE-IN-EXPO:CAPS"></a><span class="term"><code class="literal">CLUTTER_EASE_IN_EXPO</code></span></p></td>
1048 <td>exponential tweening
1049 </td>
1050 </tr>
1051 <tr>
1052 <td><p><a name="CLUTTER-EASE-OUT-EXPO:CAPS"></a><span class="term"><code class="literal">CLUTTER_EASE_OUT_EXPO</code></span></p></td>
1053 <td>exponential tweening, inverse of
1054    <a class="link" href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-EXPO:CAPS"><code class="literal">CLUTTER_EASE_IN_EXPO</code></a>
1055 </td>
1056 </tr>
1057 <tr>
1058 <td><p><a name="CLUTTER-EASE-IN-OUT-EXPO:CAPS"></a><span class="term"><code class="literal">CLUTTER_EASE_IN_OUT_EXPO</code></span></p></td>
1059 <td>exponential tweening, combining
1060    <a class="link" href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-EXPO:CAPS"><code class="literal">CLUTTER_EASE_IN_EXPO</code></a> and <a class="link" href="clutter-Implicit-Animations.html#CLUTTER-EASE-OUT-EXPO:CAPS"><code class="literal">CLUTTER_EASE_OUT_EXPO</code></a>
1061 </td>
1062 </tr>
1063 <tr>
1064 <td><p><a name="CLUTTER-EASE-IN-CIRC:CAPS"></a><span class="term"><code class="literal">CLUTTER_EASE_IN_CIRC</code></span></p></td>
1065 <td>circular tweening
1066 </td>
1067 </tr>
1068 <tr>
1069 <td><p><a name="CLUTTER-EASE-OUT-CIRC:CAPS"></a><span class="term"><code class="literal">CLUTTER_EASE_OUT_CIRC</code></span></p></td>
1070 <td>circular tweening, inverse of
1071    <a class="link" href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-CIRC:CAPS"><code class="literal">CLUTTER_EASE_IN_CIRC</code></a>
1072 </td>
1073 </tr>
1074 <tr>
1075 <td><p><a name="CLUTTER-EASE-IN-OUT-CIRC:CAPS"></a><span class="term"><code class="literal">CLUTTER_EASE_IN_OUT_CIRC</code></span></p></td>
1076 <td>circular tweening, combining
1077    <a class="link" href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-CIRC:CAPS"><code class="literal">CLUTTER_EASE_IN_CIRC</code></a> and <a class="link" href="clutter-Implicit-Animations.html#CLUTTER-EASE-OUT-CIRC:CAPS"><code class="literal">CLUTTER_EASE_OUT_CIRC</code></a>
1078 </td>
1079 </tr>
1080 <tr>
1081 <td><p><a name="CLUTTER-EASE-IN-ELASTIC:CAPS"></a><span class="term"><code class="literal">CLUTTER_EASE_IN_ELASTIC</code></span></p></td>
1082 <td>elastic tweening, with offshoot on start
1083 </td>
1084 </tr>
1085 <tr>
1086 <td><p><a name="CLUTTER-EASE-OUT-ELASTIC:CAPS"></a><span class="term"><code class="literal">CLUTTER_EASE_OUT_ELASTIC</code></span></p></td>
1087 <td>elastic tweening, with offshoot on end
1088 </td>
1089 </tr>
1090 <tr>
1091 <td><p><a name="CLUTTER-EASE-IN-OUT-ELASTIC:CAPS"></a><span class="term"><code class="literal">CLUTTER_EASE_IN_OUT_ELASTIC</code></span></p></td>
1092 <td>elastic tweening with offshoot on both ends
1093 </td>
1094 </tr>
1095 <tr>
1096 <td><p><a name="CLUTTER-EASE-IN-BACK:CAPS"></a><span class="term"><code class="literal">CLUTTER_EASE_IN_BACK</code></span></p></td>
1097 <td>overshooting cubic tweening, with
1098   backtracking on start
1099 </td>
1100 </tr>
1101 <tr>
1102 <td><p><a name="CLUTTER-EASE-OUT-BACK:CAPS"></a><span class="term"><code class="literal">CLUTTER_EASE_OUT_BACK</code></span></p></td>
1103 <td>overshooting cubic tweening, with
1104   backtracking on end
1105 </td>
1106 </tr>
1107 <tr>
1108 <td><p><a name="CLUTTER-EASE-IN-OUT-BACK:CAPS"></a><span class="term"><code class="literal">CLUTTER_EASE_IN_OUT_BACK</code></span></p></td>
1109 <td>overshooting cubic tweening, with
1110   backtracking on both ends
1111 </td>
1112 </tr>
1113 <tr>
1114 <td><p><a name="CLUTTER-EASE-IN-BOUNCE:CAPS"></a><span class="term"><code class="literal">CLUTTER_EASE_IN_BOUNCE</code></span></p></td>
1115 <td>exponentially decaying parabolic (bounce)
1116   tweening, with bounce on start
1117 </td>
1118 </tr>
1119 <tr>
1120 <td><p><a name="CLUTTER-EASE-OUT-BOUNCE:CAPS"></a><span class="term"><code class="literal">CLUTTER_EASE_OUT_BOUNCE</code></span></p></td>
1121 <td>exponentially decaying parabolic (bounce)
1122   tweening, with bounce on end
1123 </td>
1124 </tr>
1125 <tr>
1126 <td><p><a name="CLUTTER-EASE-IN-OUT-BOUNCE:CAPS"></a><span class="term"><code class="literal">CLUTTER_EASE_IN_OUT_BOUNCE</code></span></p></td>
1127 <td>exponentially decaying parabolic (bounce)
1128   tweening, with bounce on both ends
1129 </td>
1130 </tr>
1131 <tr>
1132 <td><p><a name="CLUTTER-ANIMATION-LAST:CAPS"></a><span class="term"><code class="literal">CLUTTER_ANIMATION_LAST</code></span></p></td>
1133 <td>last animation mode, used as a guard for
1134   registered global alpha functions
1135 </td>
1136 </tr>
1137 </tbody>
1138 </table></div>
1139 <p class="since">Since 1.0</p>
1140 </div>
1141 <hr>
1142 <div class="refsect2">
1143 <a name="clutter-animation-new"></a><h3>clutter_animation_new ()</h3>
1144 <pre class="programlisting"><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *  clutter_animation_new               (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1145 <p>
1146 Creates a new <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> instance. You should set the
1147 <a href="../gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> to be animated using <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-set-object" title="clutter_animation_set_object ()"><code class="function">clutter_animation_set_object()</code></a>,
1148 set the duration with <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-set-duration" title="clutter_animation_set_duration ()"><code class="function">clutter_animation_set_duration()</code></a> and the
1149 easing mode using <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-set-mode" title="clutter_animation_set_mode ()"><code class="function">clutter_animation_set_mode()</code></a>.
1150 </p>
1151 <p>
1152 Use <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-bind" title="clutter_animation_bind ()"><code class="function">clutter_animation_bind()</code></a> or <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-bind-interval" title="clutter_animation_bind_interval ()"><code class="function">clutter_animation_bind_interval()</code></a>
1153 to define the properties to be animated. The interval and the
1154 animated properties can be updated at runtime.
1155 </p>
1156 <p>
1157 The <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animate" title="clutter_actor_animate ()"><code class="function">clutter_actor_animate()</code></a> and relative family of functions provide
1158 an easy way to animate a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> and automatically manage the
1159 lifetime of a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> instance, so you should consider using
1160 those functions instead of manually creating an animation.
1161 </p>
1162 <div class="variablelist"><table border="0">
1163 <col align="left" valign="top">
1164 <tbody><tr>
1165 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1166 <td>the newly created <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a>. Use <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>
1167 to release the associated resources</td>
1168 </tr></tbody>
1169 </table></div>
1170 <p class="since">Since 1.0</p>
1171 </div>
1172 <hr>
1173 <div class="refsect2">
1174 <a name="clutter-animation-set-object"></a><h3>clutter_animation_set_object ()</h3>
1175 <pre class="programlisting"><span class="returnvalue">void</span>                clutter_animation_set_object        (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>,
1176                                                          <em class="parameter"><code><a href="../gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *object</code></em>);</pre>
1177 <p>
1178 Attaches <em class="parameter"><code>animation</code></em> to <em class="parameter"><code>object</code></em>. The <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> will take a
1179 reference on <em class="parameter"><code>object</code></em>.
1180 </p>
1181 <div class="variablelist"><table border="0">
1182 <col align="left" valign="top">
1183 <tbody>
1184 <tr>
1185 <td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td>
1186 <td>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a>
1187 </td>
1188 </tr>
1189 <tr>
1190 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
1191 <td>a <a href="../gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>
1192 </td>
1193 </tr>
1194 </tbody>
1195 </table></div>
1196 <p class="since">Since 1.0</p>
1197 </div>
1198 <hr>
1199 <div class="refsect2">
1200 <a name="clutter-animation-get-object"></a><h3>clutter_animation_get_object ()</h3>
1201 <pre class="programlisting"><a href="../gobject/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *           clutter_animation_get_object        (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>);</pre>
1202 <p>
1203 Retrieves the <a href="../gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> attached to <em class="parameter"><code>animation</code></em>.
1204 </p>
1205 <div class="variablelist"><table border="0">
1206 <col align="left" valign="top">
1207 <tbody>
1208 <tr>
1209 <td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td>
1210 <td>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a>
1211 </td>
1212 </tr>
1213 <tr>
1214 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1215 <td>a <a href="../gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1216 </td>
1217 </tr>
1218 </tbody>
1219 </table></div>
1220 <p class="since">Since 1.0</p>
1221 </div>
1222 <hr>
1223 <div class="refsect2">
1224 <a name="clutter-animation-set-mode"></a><h3>clutter_animation_set_mode ()</h3>
1225 <pre class="programlisting"><span class="returnvalue">void</span>                clutter_animation_set_mode          (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>,
1226                                                          <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> mode</code></em>);</pre>
1227 <p>
1228 Sets the animation <em class="parameter"><code>mode</code></em> of <em class="parameter"><code>animation</code></em>. The animation <em class="parameter"><code>mode</code></em> is
1229 a logical id, either coming from the <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimationMode" title="enum ClutterAnimationMode"><span class="type">ClutterAnimationMode</span></a> enumeration
1230 or the return value of <a class="link" href="ClutterAlpha.html#clutter-alpha-register-func" title="clutter_alpha_register_func ()"><code class="function">clutter_alpha_register_func()</code></a>.
1231 </p>
1232 <p>
1233 This function will also set <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation--alpha" title='The "alpha" property'><span class="type">"alpha"</span></a> if needed.
1234 </p>
1235 <div class="variablelist"><table border="0">
1236 <col align="left" valign="top">
1237 <tbody>
1238 <tr>
1239 <td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td>
1240 <td>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a>
1241 </td>
1242 </tr>
1243 <tr>
1244 <td><p><span class="term"><em class="parameter"><code>mode</code></em> :</span></p></td>
1245 <td>an animation mode logical id</td>
1246 </tr>
1247 </tbody>
1248 </table></div>
1249 <p class="since">Since 1.0</p>
1250 </div>
1251 <hr>
1252 <div class="refsect2">
1253 <a name="clutter-animation-get-mode"></a><h3>clutter_animation_get_mode ()</h3>
1254 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a>              clutter_animation_get_mode          (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>);</pre>
1255 <p>
1256 Retrieves the animation mode of <em class="parameter"><code>animation</code></em>, as set by
1257 <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-set-mode" title="clutter_animation_set_mode ()"><code class="function">clutter_animation_set_mode()</code></a>.
1258 </p>
1259 <div class="variablelist"><table border="0">
1260 <col align="left" valign="top">
1261 <tbody>
1262 <tr>
1263 <td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td>
1264 <td>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a>
1265 </td>
1266 </tr>
1267 <tr>
1268 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1269 <td>the mode for the animation</td>
1270 </tr>
1271 </tbody>
1272 </table></div>
1273 <p class="since">Since 1.0</p>
1274 </div>
1275 <hr>
1276 <div class="refsect2">
1277 <a name="clutter-animation-set-duration"></a><h3>clutter_animation_set_duration ()</h3>
1278 <pre class="programlisting"><span class="returnvalue">void</span>                clutter_animation_set_duration      (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>,
1279                                                          <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> msecs</code></em>);</pre>
1280 <p>
1281 Sets the duration of <em class="parameter"><code>animation</code></em> in milliseconds.
1282 </p>
1283 <p>
1284 This function will set <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation--alpha" title='The "alpha" property'><span class="type">"alpha"</span></a> and
1285 <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation--timeline" title='The "timeline" property'><span class="type">"timeline"</span></a> if needed.
1286 </p>
1287 <div class="variablelist"><table border="0">
1288 <col align="left" valign="top">
1289 <tbody>
1290 <tr>
1291 <td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td>
1292 <td>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a>
1293 </td>
1294 </tr>
1295 <tr>
1296 <td><p><span class="term"><em class="parameter"><code>msecs</code></em> :</span></p></td>
1297 <td>the duration in milliseconds</td>
1298 </tr>
1299 </tbody>
1300 </table></div>
1301 <p class="since">Since 1.0</p>
1302 </div>
1303 <hr>
1304 <div class="refsect2">
1305 <a name="clutter-animation-get-duration"></a><h3>clutter_animation_get_duration ()</h3>
1306 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               clutter_animation_get_duration      (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>);</pre>
1307 <p>
1308 Retrieves the duration of <em class="parameter"><code>animation</code></em>, in milliseconds.
1309 </p>
1310 <div class="variablelist"><table border="0">
1311 <col align="left" valign="top">
1312 <tbody>
1313 <tr>
1314 <td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td>
1315 <td>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a>
1316 </td>
1317 </tr>
1318 <tr>
1319 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1320 <td>the duration of the animation</td>
1321 </tr>
1322 </tbody>
1323 </table></div>
1324 <p class="since">Since 1.0</p>
1325 </div>
1326 <hr>
1327 <div class="refsect2">
1328 <a name="clutter-animation-set-loop"></a><h3>clutter_animation_set_loop ()</h3>
1329 <pre class="programlisting"><span class="returnvalue">void</span>                clutter_animation_set_loop          (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>,
1330                                                          <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> loop</code></em>);</pre>
1331 <p>
1332 Sets whether <em class="parameter"><code>animation</code></em> should loop over itself once finished.
1333 </p>
1334 <p>
1335 A looping <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> will not emit the <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation-completed" title='The "completed" signal'><span class="type">"completed"</span></a>
1336 signal when finished.
1337 </p>
1338 <p>
1339 This function will set <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation--alpha" title='The "alpha" property'><span class="type">"alpha"</span></a> and
1340 <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation--timeline" title='The "timeline" property'><span class="type">"timeline"</span></a> if needed.
1341 </p>
1342 <div class="variablelist"><table border="0">
1343 <col align="left" valign="top">
1344 <tbody>
1345 <tr>
1346 <td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td>
1347 <td>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a>
1348 </td>
1349 </tr>
1350 <tr>
1351 <td><p><span class="term"><em class="parameter"><code>loop</code></em> :</span></p></td>
1352 <td>
1353 <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the animation should loop</td>
1354 </tr>
1355 </tbody>
1356 </table></div>
1357 <p class="since">Since 1.0</p>
1358 </div>
1359 <hr>
1360 <div class="refsect2">
1361 <a name="clutter-animation-get-loop"></a><h3>clutter_animation_get_loop ()</h3>
1362 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            clutter_animation_get_loop          (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>);</pre>
1363 <p>
1364 Retrieves whether <em class="parameter"><code>animation</code></em> is looping.
1365 </p>
1366 <div class="variablelist"><table border="0">
1367 <col align="left" valign="top">
1368 <tbody>
1369 <tr>
1370 <td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td>
1371 <td>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a>
1372 </td>
1373 </tr>
1374 <tr>
1375 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1376 <td>
1377 <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the animation is looping</td>
1378 </tr>
1379 </tbody>
1380 </table></div>
1381 <p class="since">Since 1.0</p>
1382 </div>
1383 <hr>
1384 <div class="refsect2">
1385 <a name="clutter-animation-set-timeline"></a><h3>clutter_animation_set_timeline ()</h3>
1386 <pre class="programlisting"><span class="returnvalue">void</span>                clutter_animation_set_timeline      (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>,
1387                                                          <em class="parameter"><code><a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a> *timeline</code></em>);</pre>
1388 <p>
1389 Sets the <a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a> used by <em class="parameter"><code>animation</code></em>.
1390 </p>
1391 <p>
1392 This function will take a reference on the passed <em class="parameter"><code>timeline</code></em>.
1393 </p>
1394 <div class="variablelist"><table border="0">
1395 <col align="left" valign="top">
1396 <tbody>
1397 <tr>
1398 <td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td>
1399 <td>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a>
1400 </td>
1401 </tr>
1402 <tr>
1403 <td><p><span class="term"><em class="parameter"><code>timeline</code></em> :</span></p></td>
1404 <td>a <a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a>, or <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset the
1405 current <a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1406 </td>
1407 </tr>
1408 </tbody>
1409 </table></div>
1410 <p class="since">Since 1.0</p>
1411 </div>
1412 <hr>
1413 <div class="refsect2">
1414 <a name="clutter-animation-get-timeline"></a><h3>clutter_animation_get_timeline ()</h3>
1415 <pre class="programlisting"><a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="returnvalue">ClutterTimeline</span></a> *   clutter_animation_get_timeline      (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>);</pre>
1416 <p>
1417 Retrieves the <a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a> used by <em class="parameter"><code>animation</code></em>
1418 </p>
1419 <div class="variablelist"><table border="0">
1420 <col align="left" valign="top">
1421 <tbody>
1422 <tr>
1423 <td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td>
1424 <td>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a>
1425 </td>
1426 </tr>
1427 <tr>
1428 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1429 <td>the timeline used by the animation. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1430 </td>
1431 </tr>
1432 </tbody>
1433 </table></div>
1434 <p class="since">Since 1.0</p>
1435 </div>
1436 <hr>
1437 <div class="refsect2">
1438 <a name="clutter-animation-set-alpha"></a><h3>clutter_animation_set_alpha ()</h3>
1439 <pre class="programlisting"><span class="returnvalue">void</span>                clutter_animation_set_alpha         (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>,
1440                                                          <em class="parameter"><code><a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a> *alpha</code></em>);</pre>
1441 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1442 <h3 class="title">Warning</h3>
1443 <p><code class="literal">clutter_animation_set_alpha</code> has been deprecated since version 1.10 and should not be used in newly-written code. Use <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-get-timeline" title="clutter_animation_get_timeline ()"><code class="function">clutter_animation_get_timeline()</code></a> and
1444   <a class="link" href="ClutterTimeline.html#clutter-timeline-set-progress-mode" title="clutter_timeline_set_progress_mode ()"><code class="function">clutter_timeline_set_progress_mode()</code></a> instead.</p>
1445 </div>
1446 <p>
1447 Sets <em class="parameter"><code>alpha</code></em> as the <a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a> used by <em class="parameter"><code>animation</code></em>.
1448 </p>
1449 <p>
1450 If <em class="parameter"><code>alpha</code></em> is not <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>, the <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> will take ownership
1451 of the <a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a> instance.
1452 </p>
1453 <div class="variablelist"><table border="0">
1454 <col align="left" valign="top">
1455 <tbody>
1456 <tr>
1457 <td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td>
1458 <td>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a>
1459 </td>
1460 </tr>
1461 <tr>
1462 <td><p><span class="term"><em class="parameter"><code>alpha</code></em> :</span></p></td>
1463 <td>a <a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a>, or <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset the current <a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a>
1464 </td>
1465 </tr>
1466 </tbody>
1467 </table></div>
1468 <p class="since">Since 1.0</p>
1469 </div>
1470 <hr>
1471 <div class="refsect2">
1472 <a name="clutter-animation-get-alpha"></a><h3>clutter_animation_get_alpha ()</h3>
1473 <pre class="programlisting"><a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="returnvalue">ClutterAlpha</span></a> *      clutter_animation_get_alpha         (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>);</pre>
1474 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1475 <h3 class="title">Warning</h3>
1476 <p><code class="literal">clutter_animation_get_alpha</code> has been deprecated since version 1.10 and should not be used in newly-written code. Use <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-get-timeline" title="clutter_animation_get_timeline ()"><code class="function">clutter_animation_get_timeline()</code></a> and
1477   <a class="link" href="ClutterTimeline.html#clutter-timeline-get-progress-mode" title="clutter_timeline_get_progress_mode ()"><code class="function">clutter_timeline_get_progress_mode()</code></a> instead.</p>
1478 </div>
1479 <p>
1480 Retrieves the <a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a> used by <em class="parameter"><code>animation</code></em>.
1481 </p>
1482 <div class="variablelist"><table border="0">
1483 <col align="left" valign="top">
1484 <tbody>
1485 <tr>
1486 <td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td>
1487 <td>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a>
1488 </td>
1489 </tr>
1490 <tr>
1491 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1492 <td>the alpha object used by the animation. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1493 </td>
1494 </tr>
1495 </tbody>
1496 </table></div>
1497 <p class="since">Since 1.0</p>
1498 </div>
1499 <hr>
1500 <div class="refsect2">
1501 <a name="clutter-animation-completed"></a><h3>clutter_animation_completed ()</h3>
1502 <pre class="programlisting"><span class="returnvalue">void</span>                clutter_animation_completed         (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>);</pre>
1503 <p>
1504 Emits the ::completed signal on <em class="parameter"><code>animation</code></em>
1505 </p>
1506 <p>
1507 When using this function with a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> created
1508 by the <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animate" title="clutter_actor_animate ()"><code class="function">clutter_actor_animate()</code></a> family of functions, <em class="parameter"><code>animation</code></em>
1509 will be unreferenced and it will not be valid anymore,
1510 unless <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> was called before calling this function
1511 or unless a reference was taken inside a handler for the
1512 <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation-completed" title='The "completed" signal'><span class="type">"completed"</span></a> signal
1513 </p>
1514 <div class="variablelist"><table border="0">
1515 <col align="left" valign="top">
1516 <tbody><tr>
1517 <td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td>
1518 <td>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a>
1519 </td>
1520 </tr></tbody>
1521 </table></div>
1522 <p class="since">Since 1.0</p>
1523 </div>
1524 <hr>
1525 <div class="refsect2">
1526 <a name="clutter-animation-bind"></a><h3>clutter_animation_bind ()</h3>
1527 <pre class="programlisting"><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *  clutter_animation_bind              (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>,
1528                                                          <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>,
1529                                                          <em class="parameter"><code>const <a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *final</code></em>);</pre>
1530 <p>
1531 Adds a single property with name <em class="parameter"><code>property_name</code></em> to the
1532 animation <em class="parameter"><code>animation</code></em>.  For more information about animations,
1533 see <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animate" title="clutter_actor_animate ()"><code class="function">clutter_actor_animate()</code></a>.
1534 </p>
1535 <p>
1536 This method returns the animation primarily to make chained
1537 calls convenient in language bindings.
1538 </p>
1539 <div class="variablelist"><table border="0">
1540 <col align="left" valign="top">
1541 <tbody>
1542 <tr>
1543 <td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td>
1544 <td>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a>
1545 </td>
1546 </tr>
1547 <tr>
1548 <td><p><span class="term"><em class="parameter"><code>property_name</code></em> :</span></p></td>
1549 <td>the property to control</td>
1550 </tr>
1551 <tr>
1552 <td><p><span class="term"><em class="parameter"><code>final</code></em> :</span></p></td>
1553 <td>The final value of the property</td>
1554 </tr>
1555 <tr>
1556 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1557 <td>The animation itself. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1558 </td>
1559 </tr>
1560 </tbody>
1561 </table></div>
1562 <p class="since">Since 1.0</p>
1563 </div>
1564 <hr>
1565 <div class="refsect2">
1566 <a name="clutter-animation-bind-interval"></a><h3>clutter_animation_bind_interval ()</h3>
1567 <pre class="programlisting"><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *  clutter_animation_bind_interval     (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>,
1568                                                          <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>,
1569                                                          <em class="parameter"><code><a class="link" href="clutter-Value-intervals.html#ClutterInterval"><span class="type">ClutterInterval</span></a> *interval</code></em>);</pre>
1570 <p>
1571 Binds <em class="parameter"><code>interval</code></em> to the <em class="parameter"><code>property_name</code></em> of the <a href="../gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>
1572 attached to <em class="parameter"><code>animation</code></em>. The <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> will take
1573 ownership of the passed <a class="link" href="clutter-Value-intervals.html#ClutterInterval"><span class="type">ClutterInterval</span></a>.  For more information
1574 about animations, see <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animate" title="clutter_actor_animate ()"><code class="function">clutter_actor_animate()</code></a>.
1575 </p>
1576 <p>
1577 If you need to update the interval instance use
1578 <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-update-interval" title="clutter_animation_update_interval ()"><code class="function">clutter_animation_update_interval()</code></a> instead.
1579 </p>
1580 <div class="variablelist"><table border="0">
1581 <col align="left" valign="top">
1582 <tbody>
1583 <tr>
1584 <td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td>
1585 <td>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a>
1586 </td>
1587 </tr>
1588 <tr>
1589 <td><p><span class="term"><em class="parameter"><code>property_name</code></em> :</span></p></td>
1590 <td>the property to control</td>
1591 </tr>
1592 <tr>
1593 <td><p><span class="term"><em class="parameter"><code>interval</code></em> :</span></p></td>
1594 <td>a <a class="link" href="clutter-Value-intervals.html#ClutterInterval"><span class="type">ClutterInterval</span></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1595 </td>
1596 </tr>
1597 <tr>
1598 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1599 <td>The animation itself. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1600 </td>
1601 </tr>
1602 </tbody>
1603 </table></div>
1604 <p class="since">Since 1.0</p>
1605 </div>
1606 <hr>
1607 <div class="refsect2">
1608 <a name="clutter-animation-update"></a><h3>clutter_animation_update ()</h3>
1609 <pre class="programlisting"><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *  clutter_animation_update            (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>,
1610                                                          <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>,
1611                                                          <em class="parameter"><code>const <a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *final</code></em>);</pre>
1612 <p>
1613 Updates the <em class="parameter"><code>final</code></em> value of the interval for <em class="parameter"><code>property_name</code></em>
1614 </p>
1615 <div class="variablelist"><table border="0">
1616 <col align="left" valign="top">
1617 <tbody>
1618 <tr>
1619 <td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td>
1620 <td>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a>
1621 </td>
1622 </tr>
1623 <tr>
1624 <td><p><span class="term"><em class="parameter"><code>property_name</code></em> :</span></p></td>
1625 <td>name of the property</td>
1626 </tr>
1627 <tr>
1628 <td><p><span class="term"><em class="parameter"><code>final</code></em> :</span></p></td>
1629 <td>The final value of the property</td>
1630 </tr>
1631 <tr>
1632 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1633 <td>The animation itself. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1634 </td>
1635 </tr>
1636 </tbody>
1637 </table></div>
1638 <p class="since">Since 1.0</p>
1639 </div>
1640 <hr>
1641 <div class="refsect2">
1642 <a name="clutter-animation-update-interval"></a><h3>clutter_animation_update_interval ()</h3>
1643 <pre class="programlisting"><span class="returnvalue">void</span>                clutter_animation_update_interval   (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>,
1644                                                          <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>,
1645                                                          <em class="parameter"><code><a class="link" href="clutter-Value-intervals.html#ClutterInterval"><span class="type">ClutterInterval</span></a> *interval</code></em>);</pre>
1646 <p>
1647 Changes the <em class="parameter"><code>interval</code></em> for <em class="parameter"><code>property_name</code></em>. The <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a>
1648 will take ownership of the passed <a class="link" href="clutter-Value-intervals.html#ClutterInterval"><span class="type">ClutterInterval</span></a>.
1649 </p>
1650 <div class="variablelist"><table border="0">
1651 <col align="left" valign="top">
1652 <tbody>
1653 <tr>
1654 <td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td>
1655 <td>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a>
1656 </td>
1657 </tr>
1658 <tr>
1659 <td><p><span class="term"><em class="parameter"><code>property_name</code></em> :</span></p></td>
1660 <td>name of the property</td>
1661 </tr>
1662 <tr>
1663 <td><p><span class="term"><em class="parameter"><code>interval</code></em> :</span></p></td>
1664 <td>a <a class="link" href="clutter-Value-intervals.html#ClutterInterval"><span class="type">ClutterInterval</span></a>
1665 </td>
1666 </tr>
1667 </tbody>
1668 </table></div>
1669 <p class="since">Since 1.0</p>
1670 </div>
1671 <hr>
1672 <div class="refsect2">
1673 <a name="clutter-animation-has-property"></a><h3>clutter_animation_has_property ()</h3>
1674 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            clutter_animation_has_property      (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>,
1675                                                          <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>);</pre>
1676 <p>
1677 Checks whether <em class="parameter"><code>animation</code></em> is controlling <em class="parameter"><code>property_name</code></em>.
1678 </p>
1679 <div class="variablelist"><table border="0">
1680 <col align="left" valign="top">
1681 <tbody>
1682 <tr>
1683 <td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td>
1684 <td>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a>
1685 </td>
1686 </tr>
1687 <tr>
1688 <td><p><span class="term"><em class="parameter"><code>property_name</code></em> :</span></p></td>
1689 <td>name of the property</td>
1690 </tr>
1691 <tr>
1692 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1693 <td>
1694 <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the property is animated by the
1695 <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a>, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise</td>
1696 </tr>
1697 </tbody>
1698 </table></div>
1699 <p class="since">Since 1.0</p>
1700 </div>
1701 <hr>
1702 <div class="refsect2">
1703 <a name="clutter-animation-unbind-property"></a><h3>clutter_animation_unbind_property ()</h3>
1704 <pre class="programlisting"><span class="returnvalue">void</span>                clutter_animation_unbind_property   (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>,
1705                                                          <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>);</pre>
1706 <p>
1707 Removes <em class="parameter"><code>property_name</code></em> from the list of animated properties.
1708 </p>
1709 <div class="variablelist"><table border="0">
1710 <col align="left" valign="top">
1711 <tbody>
1712 <tr>
1713 <td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td>
1714 <td>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a>
1715 </td>
1716 </tr>
1717 <tr>
1718 <td><p><span class="term"><em class="parameter"><code>property_name</code></em> :</span></p></td>
1719 <td>name of the property</td>
1720 </tr>
1721 </tbody>
1722 </table></div>
1723 <p class="since">Since 1.0</p>
1724 </div>
1725 <hr>
1726 <div class="refsect2">
1727 <a name="clutter-animation-get-interval"></a><h3>clutter_animation_get_interval ()</h3>
1728 <pre class="programlisting"><a class="link" href="clutter-Value-intervals.html#ClutterInterval"><span class="returnvalue">ClutterInterval</span></a> *   clutter_animation_get_interval      (<em class="parameter"><code><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation</code></em>,
1729                                                          <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *property_name</code></em>);</pre>
1730 <p>
1731 Retrieves the <a class="link" href="clutter-Value-intervals.html#ClutterInterval"><span class="type">ClutterInterval</span></a> associated to <em class="parameter"><code>property_name</code></em>
1732 inside <em class="parameter"><code>animation</code></em>.
1733 </p>
1734 <div class="variablelist"><table border="0">
1735 <col align="left" valign="top">
1736 <tbody>
1737 <tr>
1738 <td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td>
1739 <td>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a>
1740 </td>
1741 </tr>
1742 <tr>
1743 <td><p><span class="term"><em class="parameter"><code>property_name</code></em> :</span></p></td>
1744 <td>name of the property</td>
1745 </tr>
1746 <tr>
1747 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1748 <td>a <a class="link" href="clutter-Value-intervals.html#ClutterInterval"><span class="type">ClutterInterval</span></a> or <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> if no
1749 property with the same name was found. The returned interval is
1750 owned by the <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> and should not be unreferenced. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1751 </td>
1752 </tr>
1753 </tbody>
1754 </table></div>
1755 <p class="since">Since 1.0</p>
1756 </div>
1757 <hr>
1758 <div class="refsect2">
1759 <a name="clutter-actor-animate"></a><h3>clutter_actor_animate ()</h3>
1760 <pre class="programlisting"><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *  clutter_actor_animate               (<em class="parameter"><code><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> *actor</code></em>,
1761                                                          <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> mode</code></em>,
1762                                                          <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> duration</code></em>,
1763                                                          <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
1764                                                          <em class="parameter"><code>...</code></em>);</pre>
1765 <p>
1766 Animates the given list of properties of <em class="parameter"><code>actor</code></em> between the current
1767 value for each property and a new final value. The animation has a
1768 definite duration and a speed given by the <em class="parameter"><code>mode</code></em>.
1769 </p>
1770 <p>
1771 For example, this:
1772 </p>
1773 <p>
1774 </p>
1775 <div class="informalexample">
1776   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1777     <tbody>
1778       <tr>
1779         <td class="listing_lines" align="right"><pre>1
1780 2
1781 3
1782 4</pre></td>
1783         <td class="listing_code"><pre class="programlisting"><span class="function"><a href="clutter-Implicit-Animations.html#clutter-actor-animate">clutter_actor_animate</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">rectangle</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-LINEAR:CAPS">CLUTTER_LINEAR</a></span><span class="symbol">,</span><span class="normal"> </span><span class="number">250</span><span class="symbol">,</span>
1784 <span class="normal">                       </span><span class="string">"width"</span><span class="symbol">,</span><span class="normal"> </span><span class="number">100.0</span><span class="symbol">,</span>
1785 <span class="normal">                       </span><span class="string">"height"</span><span class="symbol">,</span><span class="normal"> </span><span class="number">100.0</span><span class="symbol">,</span>
1786 <span class="normal">                       <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span></pre></td>
1787       </tr>
1788     </tbody>
1789   </table>
1790 </div>
1791
1792 <p>
1793 </p>
1794 <p>
1795 will make width and height properties of the <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> "rectangle"
1796 grow linearly between the current value and 100 pixels, in 250 milliseconds.
1797 </p>
1798 <p>
1799 The animation <em class="parameter"><code>mode</code></em> is a logical id, either from the <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimationMode" title="enum ClutterAnimationMode"><span class="type">ClutterAnimationMode</span></a>
1800 enumeration of from <a class="link" href="ClutterAlpha.html#clutter-alpha-register-func" title="clutter_alpha_register_func ()"><code class="function">clutter_alpha_register_func()</code></a>.
1801 </p>
1802 <p>
1803 All the properties specified will be animated between the current value
1804 and the final value. If a property should be set at the beginning of
1805 the animation but not updated during the animation, it should be prefixed
1806 by the "fixed::" string, for instance:
1807 </p>
1808 <p>
1809 </p>
1810 <div class="informalexample">
1811   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1812     <tbody>
1813       <tr>
1814         <td class="listing_lines" align="right"><pre>1
1815 2
1816 3
1817 4</pre></td>
1818         <td class="listing_code"><pre class="programlisting"><span class="function"><a href="clutter-Implicit-Animations.html#clutter-actor-animate">clutter_actor_animate</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">actor</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-SINE:CAPS">CLUTTER_EASE_IN_SINE</a></span><span class="symbol">,</span><span class="normal"> </span><span class="number">100</span><span class="symbol">,</span>
1819 <span class="normal">                       </span><span class="string">"rotation-angle-z"</span><span class="symbol">,</span><span class="normal"> </span><span class="number">360.0</span><span class="symbol">,</span>
1820 <span class="normal">                       </span><span class="string">"fixed::rotation-center-z"</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">center</span><span class="symbol">,</span>
1821 <span class="normal">                       <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span></pre></td>
1822       </tr>
1823     </tbody>
1824   </table>
1825 </div>
1826
1827 <p>
1828 </p>
1829 <p>
1830 Will animate the "rotation-angle-z" property between the current value
1831 and 360 degrees, and set the "rotation-center-z" property to the fixed
1832 value of the <a class="link" href="ClutterActor.html#ClutterVertex" title="struct ClutterVertex"><span class="type">ClutterVertex</span></a> "center".
1833 </p>
1834 <p>
1835 This function will implicitly create a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> object which
1836 will be assigned to the <em class="parameter"><code>actor</code></em> and will be returned to the developer
1837 to control the animation or to know when the animation has been
1838 completed.
1839 </p>
1840 <p>
1841 If a name argument starts with "signal::", "signal-after::",
1842 "signal-swapped::" or "signal-swapped-after::" the two following arguments
1843 are used as callback function and data for a signal handler installed on
1844 the <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> object for the specified signal name, for instance:
1845 </p>
1846 <p>
1847 </p>
1848 <div class="informalexample">
1849   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1850     <tbody>
1851       <tr>
1852         <td class="listing_lines" align="right"><pre>1
1853 2
1854 3
1855 4
1856 5
1857 6
1858 7
1859 8
1860 9
1861 10
1862 11</pre></td>
1863         <td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
1864 <span class="function">on_animation_completed</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">ClutterAnimation</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">animation</span><span class="symbol">,</span>
1865 <span class="normal">                        </span><span class="usertype">ClutterActor</span><span class="normal">     </span><span class="symbol">*</span><span class="normal">actor</span><span class="symbol">)</span>
1866 <span class="cbracket">{</span>
1867 <span class="normal">  </span><span class="function"><a href="ClutterActor.html#clutter-actor-hide">clutter_actor_hide</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">actor</span><span class="symbol">);</span>
1868 <span class="cbracket">}</span>
1869
1870 <span class="function"><a href="clutter-Implicit-Animations.html#clutter-actor-animate">clutter_actor_animate</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">actor</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-CUBIC:CAPS">CLUTTER_EASE_IN_CUBIC</a></span><span class="symbol">,</span><span class="normal"> </span><span class="number">100</span><span class="symbol">,</span>
1871 <span class="normal">                       </span><span class="string">"opacity"</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span>
1872 <span class="normal">                       </span><span class="string">"signal::completed"</span><span class="symbol">,</span><span class="normal"> on_animation_completed</span><span class="symbol">,</span><span class="normal"> actor</span><span class="symbol">,</span>
1873 <span class="normal">                       <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span></pre></td>
1874       </tr>
1875     </tbody>
1876   </table>
1877 </div>
1878
1879 <p>
1880 </p>
1881 <p>
1882 or, to automatically destroy an actor at the end of the animation:
1883 </p>
1884 <p>
1885 </p>
1886 <div class="informalexample">
1887   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1888     <tbody>
1889       <tr>
1890         <td class="listing_lines" align="right"><pre>1
1891 2
1892 3
1893 4
1894 5
1895 6</pre></td>
1896         <td class="listing_code"><pre class="programlisting"><span class="function"><a href="clutter-Implicit-Animations.html#clutter-actor-animate">clutter_actor_animate</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">actor</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-CUBIC:CAPS">CLUTTER_EASE_IN_CUBIC</a></span><span class="symbol">,</span><span class="normal"> </span><span class="number">100</span><span class="symbol">,</span>
1897 <span class="normal">                       </span><span class="string">"opacity"</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span>
1898 <span class="normal">                       </span><span class="string">"signal-swapped-after::completed"</span><span class="symbol">,</span>
1899 <span class="normal">                         <a href="ClutterActor.html#clutter-actor-destroy">clutter_actor_destroy</a></span><span class="symbol">,</span>
1900 <span class="normal">                         actor</span><span class="symbol">,</span>
1901 <span class="normal">                       <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span></pre></td>
1902       </tr>
1903     </tbody>
1904   </table>
1905 </div>
1906
1907 <p>
1908 </p>
1909 <p>
1910 The "signal::" modifier is the equivalent of using <a href="../gobject/gobject-Signals.html#g-signal-connect"><code class="function">g_signal_connect()</code></a>;
1911 the "signal-after::" modifier is the equivalent of using
1912 <a href="../gobject/gobject-Signals.html#g-signal-connect-after"><code class="function">g_signal_connect_after()</code></a> or <a href="../gobject/gobject-Signals.html#g-signal-connect-data"><code class="function">g_signal_connect_data()</code></a> with the
1913 <a href="../gobject/gobject-Signals.html#G-CONNECT-AFTER:CAPS"><code class="literal">G_CONNECT_AFTER</code></a>; the "signal-swapped::" modifier is the equivalent
1914 of using <a href="../gobject/gobject-Signals.html#g-signal-connect-swapped"><code class="function">g_signal_connect_swapped()</code></a> or <a href="../gobject/gobject-Signals.html#g-signal-connect-data"><code class="function">g_signal_connect_data()</code></a> with the
1915 <a href="../gobject/gobject-Signals.html#G-CONNECT-SWAPPED:CAPS"><code class="literal">G_CONNECT_SWAPPED</code></a> flah; finally, the "signal-swapped-after::" modifier
1916 is the equivalent of using <a href="../gobject/gobject-Signals.html#g-signal-connect-data"><code class="function">g_signal_connect_data()</code></a> with both the
1917 <a href="../gobject/gobject-Signals.html#G-CONNECT-AFTER:CAPS"><code class="literal">G_CONNECT_AFTER</code></a> and <a href="../gobject/gobject-Signals.html#G-CONNECT-SWAPPED:CAPS"><code class="literal">G_CONNECT_SWAPPED</code></a> flags. The <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animate" title="clutter_actor_animate ()"><code class="function">clutter_actor_animate()</code></a>
1918 function will not keep track of multiple connections to the same signal,
1919 so it is your responsability to avoid them when calling
1920 <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animate" title="clutter_actor_animate ()"><code class="function">clutter_actor_animate()</code></a> multiple times on the same actor.
1921 </p>
1922 <p>
1923 Calling this function on an actor that is already being animated
1924 will cause the current animation to change with the new final values,
1925 the new easing mode and the new duration - that is, this code:
1926 </p>
1927 <p>
1928 </p>
1929 <div class="informalexample">
1930   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1931     <tbody>
1932       <tr>
1933         <td class="listing_lines" align="right"><pre>1
1934 2
1935 3
1936 4
1937 5
1938 6
1939 7
1940 8
1941 9</pre></td>
1942         <td class="listing_code"><pre class="programlisting"><span class="function"><a href="clutter-Implicit-Animations.html#clutter-actor-animate">clutter_actor_animate</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">actor</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-LINEAR:CAPS">CLUTTER_LINEAR</a></span><span class="symbol">,</span><span class="normal"> </span><span class="number">250</span><span class="symbol">,</span>
1943 <span class="normal">                       </span><span class="string">"width"</span><span class="symbol">,</span><span class="normal"> </span><span class="number">100.0</span><span class="symbol">,</span>
1944 <span class="normal">                       </span><span class="string">"height"</span><span class="symbol">,</span><span class="normal"> </span><span class="number">100.0</span><span class="symbol">,</span>
1945 <span class="normal">                       <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
1946 <span class="function"><a href="clutter-Implicit-Animations.html#clutter-actor-animate">clutter_actor_animate</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">actor</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-CUBIC:CAPS">CLUTTER_EASE_IN_CUBIC</a></span><span class="symbol">,</span><span class="normal"> </span><span class="number">500</span><span class="symbol">,</span>
1947 <span class="normal">                       </span><span class="string">"x"</span><span class="symbol">,</span><span class="normal"> </span><span class="number">100.0</span><span class="symbol">,</span>
1948 <span class="normal">                       </span><span class="string">"y"</span><span class="symbol">,</span><span class="normal"> </span><span class="number">100.0</span><span class="symbol">,</span>
1949 <span class="normal">                       </span><span class="string">"width"</span><span class="symbol">,</span><span class="normal"> </span><span class="number">200.0</span><span class="symbol">,</span>
1950 <span class="normal">                       <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span></pre></td>
1951       </tr>
1952     </tbody>
1953   </table>
1954 </div>
1955
1956 <p>
1957 </p>
1958 <p>
1959 is the equivalent of:
1960 </p>
1961 <p>
1962 </p>
1963 <div class="informalexample">
1964   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1965     <tbody>
1966       <tr>
1967         <td class="listing_lines" align="right"><pre>1
1968 2
1969 3
1970 4
1971 5
1972 6</pre></td>
1973         <td class="listing_code"><pre class="programlisting"><span class="function"><a href="clutter-Implicit-Animations.html#clutter-actor-animate">clutter_actor_animate</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">actor</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-CUBIC:CAPS">CLUTTER_EASE_IN_CUBIC</a></span><span class="symbol">,</span><span class="normal"> </span><span class="number">500</span><span class="symbol">,</span>
1974 <span class="normal">                       </span><span class="string">"x"</span><span class="symbol">,</span><span class="normal"> </span><span class="number">100.0</span><span class="symbol">,</span>
1975 <span class="normal">                       </span><span class="string">"y"</span><span class="symbol">,</span><span class="normal"> </span><span class="number">100.0</span><span class="symbol">,</span>
1976 <span class="normal">                       </span><span class="string">"width"</span><span class="symbol">,</span><span class="normal"> </span><span class="number">200.0</span><span class="symbol">,</span>
1977 <span class="normal">                       </span><span class="string">"height"</span><span class="symbol">,</span><span class="normal"> </span><span class="number">100.0</span><span class="symbol">,</span>
1978 <span class="normal">                       <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span></pre></td>
1979       </tr>
1980     </tbody>
1981   </table>
1982 </div>
1983
1984 <p>
1985 </p>
1986 <p>
1987 </p>
1988 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
1989 <h3 class="title">Note</h3>Unless the animation is looping, the <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> created by
1990 <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animate" title="clutter_actor_animate ()"><code class="function">clutter_actor_animate()</code></a> will become invalid as soon as it is
1991 complete.</div>
1992 <p>
1993 </p>
1994 <p>
1995 Since the created <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> instance attached to <em class="parameter"><code>actor</code></em>
1996 is guaranteed to be valid throughout the <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation-completed" title='The "completed" signal'><span class="type">"completed"</span></a>
1997 signal emission chain, you will not be able to create a new animation
1998 using <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animate" title="clutter_actor_animate ()"><code class="function">clutter_actor_animate()</code></a> on the same <em class="parameter"><code>actor</code></em> from within the
1999 <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation-completed" title='The "completed" signal'><span class="type">"completed"</span></a> signal handler unless you use
2000 <a href="../gobject/gobject-Signals.html#g-signal-connect-after"><code class="function">g_signal_connect_after()</code></a> to connect the callback function, for instance:
2001 </p>
2002 <p>
2003 </p>
2004 <div class="informalexample">
2005   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
2006     <tbody>
2007       <tr>
2008         <td class="listing_lines" align="right"><pre>1
2009 2
2010 3
2011 4
2012 5
2013 6
2014 7
2015 8
2016 9
2017 10
2018 11
2019 12
2020 13
2021 14
2022 15
2023 16
2024 17
2025 18
2026 19</pre></td>
2027         <td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
2028 <span class="function">on_animation_completed</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">ClutterAnimation</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">animation</span><span class="symbol">,</span>
2029 <span class="normal">                        </span><span class="usertype">ClutterActor</span><span class="normal">     </span><span class="symbol">*</span><span class="normal">actor</span><span class="symbol">)</span>
2030 <span class="cbracket">{</span>
2031 <span class="normal">  </span><span class="function"><a href="clutter-Implicit-Animations.html#clutter-actor-animate">clutter_actor_animate</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">actor</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-OUT-CUBIC:CAPS">CLUTTER_EASE_OUT_CUBIC</a></span><span class="symbol">,</span><span class="normal"> </span><span class="number">250</span><span class="symbol">,</span>
2032 <span class="normal">                         </span><span class="string">"x"</span><span class="symbol">,</span><span class="normal"> </span><span class="number">500.0</span><span class="symbol">,</span>
2033 <span class="normal">                         </span><span class="string">"y"</span><span class="symbol">,</span><span class="normal"> </span><span class="number">500.0</span><span class="symbol">,</span>
2034 <span class="normal">                         <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
2035 <span class="cbracket">}</span>
2036
2037 <span class="normal">  </span><span class="symbol">...</span>
2038 <span class="normal">  animation </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="clutter-Implicit-Animations.html#clutter-actor-animate">clutter_actor_animate</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">actor</span><span class="symbol">,</span><span class="normal"> <a href="clutter-Implicit-Animations.html#CLUTTER-EASE-IN-CUBIC:CAPS">CLUTTER_EASE_IN_CUBIC</a></span><span class="symbol">,</span><span class="normal"> </span><span class="number">250</span><span class="symbol">,</span>
2039 <span class="normal">                                     </span><span class="string">"x"</span><span class="symbol">,</span><span class="normal"> </span><span class="number">100.0</span><span class="symbol">,</span>
2040 <span class="normal">                                     </span><span class="string">"y"</span><span class="symbol">,</span><span class="normal"> </span><span class="number">100.0</span><span class="symbol">,</span>
2041 <span class="normal">                                     <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
2042 <span class="normal">  </span><span class="function"><a href="../gobject/gobject-Signals.html#g-signal-connect">g_signal_connect</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">animation</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"completed"</span><span class="symbol">,</span>
2043 <span class="normal">                    </span><span class="function"><a href="../gobject/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">on_animation_completed</span><span class="symbol">),</span>
2044 <span class="normal">                    actor</span><span class="symbol">);</span>
2045 <span class="normal">  </span><span class="symbol">...</span></pre></td>
2046       </tr>
2047     </tbody>
2048   </table>
2049 </div>
2050
2051 <p>
2052 </p>
2053 <div class="variablelist"><table border="0">
2054 <col align="left" valign="top">
2055 <tbody>
2056 <tr>
2057 <td><p><span class="term"><em class="parameter"><code>actor</code></em> :</span></p></td>
2058 <td>a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a>
2059 </td>
2060 </tr>
2061 <tr>
2062 <td><p><span class="term"><em class="parameter"><code>mode</code></em> :</span></p></td>
2063 <td>an animation mode logical id</td>
2064 </tr>
2065 <tr>
2066 <td><p><span class="term"><em class="parameter"><code>duration</code></em> :</span></p></td>
2067 <td>duration of the animation, in milliseconds</td>
2068 </tr>
2069 <tr>
2070 <td><p><span class="term"><em class="parameter"><code>first_property_name</code></em> :</span></p></td>
2071 <td>the name of a property</td>
2072 </tr>
2073 <tr>
2074 <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
2075 <td>a <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> terminated list of property names and
2076 property values</td>
2077 </tr>
2078 <tr>
2079 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2080 <td>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> object. The object is
2081 owned by the <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> and should not be unreferenced with
2082 <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
2083 </td>
2084 </tr>
2085 </tbody>
2086 </table></div>
2087 <p class="since">Since 1.0</p>
2088 </div>
2089 <hr>
2090 <div class="refsect2">
2091 <a name="clutter-actor-animate-with-timeline"></a><h3>clutter_actor_animate_with_timeline ()</h3>
2092 <pre class="programlisting"><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *  clutter_actor_animate_with_timeline (<em class="parameter"><code><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> *actor</code></em>,
2093                                                          <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> mode</code></em>,
2094                                                          <em class="parameter"><code><a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a> *timeline</code></em>,
2095                                                          <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
2096                                                          <em class="parameter"><code>...</code></em>);</pre>
2097 <p>
2098 Animates the given list of properties of <em class="parameter"><code>actor</code></em> between the current
2099 value for each property and a new final value. The animation has a
2100 definite duration given by <em class="parameter"><code>timeline</code></em> and a speed given by the <em class="parameter"><code>mode</code></em>.
2101 </p>
2102 <p>
2103 See <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animate" title="clutter_actor_animate ()"><code class="function">clutter_actor_animate()</code></a> for further details.
2104 </p>
2105 <p>
2106 This function is useful if you want to use an existing timeline
2107 to animate <em class="parameter"><code>actor</code></em>.
2108 </p>
2109 <div class="variablelist"><table border="0">
2110 <col align="left" valign="top">
2111 <tbody>
2112 <tr>
2113 <td><p><span class="term"><em class="parameter"><code>actor</code></em> :</span></p></td>
2114 <td>a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a>
2115 </td>
2116 </tr>
2117 <tr>
2118 <td><p><span class="term"><em class="parameter"><code>mode</code></em> :</span></p></td>
2119 <td>an animation mode logical id</td>
2120 </tr>
2121 <tr>
2122 <td><p><span class="term"><em class="parameter"><code>timeline</code></em> :</span></p></td>
2123 <td>a <a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a>
2124 </td>
2125 </tr>
2126 <tr>
2127 <td><p><span class="term"><em class="parameter"><code>first_property_name</code></em> :</span></p></td>
2128 <td>the name of a property</td>
2129 </tr>
2130 <tr>
2131 <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
2132 <td>a <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> terminated list of property names and
2133 property values</td>
2134 </tr>
2135 <tr>
2136 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2137 <td>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> object. The object is
2138 owned by the <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> and should not be unreferenced with
2139 <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
2140 </td>
2141 </tr>
2142 </tbody>
2143 </table></div>
2144 <p class="since">Since 1.0</p>
2145 </div>
2146 <hr>
2147 <div class="refsect2">
2148 <a name="clutter-actor-animate-with-alpha"></a><h3>clutter_actor_animate_with_alpha ()</h3>
2149 <pre class="programlisting"><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *  clutter_actor_animate_with_alpha    (<em class="parameter"><code><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> *actor</code></em>,
2150                                                          <em class="parameter"><code><a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a> *alpha</code></em>,
2151                                                          <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
2152                                                          <em class="parameter"><code>...</code></em>);</pre>
2153 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2154 <h3 class="title">Warning</h3>
2155 <p><code class="literal">clutter_actor_animate_with_alpha</code> has been deprecated since version 1.10 and should not be used in newly-written code. Use <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animate-with-timeline" title="clutter_actor_animate_with_timeline ()"><code class="function">clutter_actor_animate_with_timeline()</code></a> instead</p>
2156 </div>
2157 <p>
2158 Animates the given list of properties of <em class="parameter"><code>actor</code></em> between the current
2159 value for each property and a new final value. The animation has a
2160 definite behaviour given by the passed <em class="parameter"><code>alpha</code></em>.
2161 </p>
2162 <p>
2163 See <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animate" title="clutter_actor_animate ()"><code class="function">clutter_actor_animate()</code></a> for further details.
2164 </p>
2165 <p>
2166 This function is useful if you want to use an existing <a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a>
2167 to animate <em class="parameter"><code>actor</code></em>.
2168 </p>
2169 <div class="variablelist"><table border="0">
2170 <col align="left" valign="top">
2171 <tbody>
2172 <tr>
2173 <td><p><span class="term"><em class="parameter"><code>actor</code></em> :</span></p></td>
2174 <td>a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a>
2175 </td>
2176 </tr>
2177 <tr>
2178 <td><p><span class="term"><em class="parameter"><code>alpha</code></em> :</span></p></td>
2179 <td>a <a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a>
2180 </td>
2181 </tr>
2182 <tr>
2183 <td><p><span class="term"><em class="parameter"><code>first_property_name</code></em> :</span></p></td>
2184 <td>the name of a property</td>
2185 </tr>
2186 <tr>
2187 <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
2188 <td>a <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> terminated list of property names and
2189 property values</td>
2190 </tr>
2191 <tr>
2192 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2193 <td>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> object. The object is owned by the
2194 <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> and should not be unreferenced with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
2195 </td>
2196 </tr>
2197 </tbody>
2198 </table></div>
2199 <p class="since">Since 1.0</p>
2200 </div>
2201 <hr>
2202 <div class="refsect2">
2203 <a name="clutter-actor-animatev"></a><h3>clutter_actor_animatev ()</h3>
2204 <pre class="programlisting"><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *  clutter_actor_animatev              (<em class="parameter"><code><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> *actor</code></em>,
2205                                                          <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> mode</code></em>,
2206                                                          <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> duration</code></em>,
2207                                                          <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_properties</code></em>,
2208                                                          <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> * const properties[]</code></em>,
2209                                                          <em class="parameter"><code>const <a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *values</code></em>);</pre>
2210 <p>
2211 Animates the given list of properties of <em class="parameter"><code>actor</code></em> between the current
2212 value for each property and a new final value. The animation has a
2213 definite duration and a speed given by the <em class="parameter"><code>mode</code></em>.
2214 </p>
2215 <p>
2216 This is the vector-based variant of <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animate" title="clutter_actor_animate ()"><code class="function">clutter_actor_animate()</code></a>, useful
2217 for language bindings.
2218 </p>
2219 <p>
2220 </p>
2221 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2222 <h3 class="title">Warning</h3>Unlike <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animate" title="clutter_actor_animate ()"><code class="function">clutter_actor_animate()</code></a>, this function will not
2223 allow you to specify "signal::" names and callbacks.</div>
2224 <p>
2225 </p>
2226 <div class="variablelist"><table border="0">
2227 <col align="left" valign="top">
2228 <tbody>
2229 <tr>
2230 <td><p><span class="term"><em class="parameter"><code>actor</code></em> :</span></p></td>
2231 <td>a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a>
2232 </td>
2233 </tr>
2234 <tr>
2235 <td><p><span class="term"><em class="parameter"><code>mode</code></em> :</span></p></td>
2236 <td>an animation mode logical id</td>
2237 </tr>
2238 <tr>
2239 <td><p><span class="term"><em class="parameter"><code>duration</code></em> :</span></p></td>
2240 <td>duration of the animation, in milliseconds</td>
2241 </tr>
2242 <tr>
2243 <td><p><span class="term"><em class="parameter"><code>n_properties</code></em> :</span></p></td>
2244 <td>number of property names and values</td>
2245 </tr>
2246 <tr>
2247 <td><p><span class="term"><em class="parameter"><code>properties</code></em> :</span></p></td>
2248 <td>a vector
2249 containing the property names to set. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_properties][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8]</span>
2250 </td>
2251 </tr>
2252 <tr>
2253 <td><p><span class="term"><em class="parameter"><code>values</code></em> :</span></p></td>
2254 <td>a vector containing the
2255 property values to set. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_properties]</span>
2256 </td>
2257 </tr>
2258 <tr>
2259 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2260 <td>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> object. The object is
2261 owned by the <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> and should not be unreferenced with
2262 <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
2263 </td>
2264 </tr>
2265 </tbody>
2266 </table></div>
2267 <p class="since">Since 1.0</p>
2268 </div>
2269 <hr>
2270 <div class="refsect2">
2271 <a name="clutter-actor-animate-with-timelinev"></a><h3>clutter_actor_animate_with_timelinev ()</h3>
2272 <pre class="programlisting"><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *  clutter_actor_animate_with_timelinev
2273                                                         (<em class="parameter"><code><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> *actor</code></em>,
2274                                                          <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> mode</code></em>,
2275                                                          <em class="parameter"><code><a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a> *timeline</code></em>,
2276                                                          <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_properties</code></em>,
2277                                                          <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> * const properties[]</code></em>,
2278                                                          <em class="parameter"><code>const <a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *values</code></em>);</pre>
2279 <p>
2280 Animates the given list of properties of <em class="parameter"><code>actor</code></em> between the current
2281 value for each property and a new final value. The animation has a
2282 definite duration given by <em class="parameter"><code>timeline</code></em> and a speed given by the <em class="parameter"><code>mode</code></em>.
2283 </p>
2284 <p>
2285 See <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animate" title="clutter_actor_animate ()"><code class="function">clutter_actor_animate()</code></a> for further details.
2286 </p>
2287 <p>
2288 This function is useful if you want to use an existing timeline
2289 to animate <em class="parameter"><code>actor</code></em>.
2290 </p>
2291 <p>
2292 This is the vector-based variant of <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animate-with-timeline" title="clutter_actor_animate_with_timeline ()"><code class="function">clutter_actor_animate_with_timeline()</code></a>,
2293 useful for language bindings.
2294 </p>
2295 <p>
2296 </p>
2297 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2298 <h3 class="title">Warning</h3>Unlike <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animate-with-timeline" title="clutter_actor_animate_with_timeline ()"><code class="function">clutter_actor_animate_with_timeline()</code></a>, this function
2299 will not allow you to specify "signal::" names and callbacks.</div>
2300 <p>
2301 </p>
2302 <div class="variablelist"><table border="0">
2303 <col align="left" valign="top">
2304 <tbody>
2305 <tr>
2306 <td><p><span class="term"><em class="parameter"><code>actor</code></em> :</span></p></td>
2307 <td>a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a>
2308 </td>
2309 </tr>
2310 <tr>
2311 <td><p><span class="term"><em class="parameter"><code>mode</code></em> :</span></p></td>
2312 <td>an animation mode logical id</td>
2313 </tr>
2314 <tr>
2315 <td><p><span class="term"><em class="parameter"><code>timeline</code></em> :</span></p></td>
2316 <td>a <a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a>
2317 </td>
2318 </tr>
2319 <tr>
2320 <td><p><span class="term"><em class="parameter"><code>n_properties</code></em> :</span></p></td>
2321 <td>number of property names and values</td>
2322 </tr>
2323 <tr>
2324 <td><p><span class="term"><em class="parameter"><code>properties</code></em> :</span></p></td>
2325 <td>a vector
2326 containing the property names to set. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_properties][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8]</span>
2327 </td>
2328 </tr>
2329 <tr>
2330 <td><p><span class="term"><em class="parameter"><code>values</code></em> :</span></p></td>
2331 <td>a vector containing the
2332 property values to set. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_properties]</span>
2333 </td>
2334 </tr>
2335 <tr>
2336 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2337 <td>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> object. The object is
2338 owned by the <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> and should not be unreferenced with
2339 <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
2340 </td>
2341 </tr>
2342 </tbody>
2343 </table></div>
2344 <p class="since">Since 1.0</p>
2345 </div>
2346 <hr>
2347 <div class="refsect2">
2348 <a name="clutter-actor-animate-with-alphav"></a><h3>clutter_actor_animate_with_alphav ()</h3>
2349 <pre class="programlisting"><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *  clutter_actor_animate_with_alphav   (<em class="parameter"><code><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> *actor</code></em>,
2350                                                          <em class="parameter"><code><a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a> *alpha</code></em>,
2351                                                          <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_properties</code></em>,
2352                                                          <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> * const properties[]</code></em>,
2353                                                          <em class="parameter"><code>const <a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *values</code></em>);</pre>
2354 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2355 <h3 class="title">Warning</h3>
2356 <p><code class="literal">clutter_actor_animate_with_alphav</code> has been deprecated since version 1.10 and should not be used in newly-written code. Use <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animate-with-timelinev" title="clutter_actor_animate_with_timelinev ()"><code class="function">clutter_actor_animate_with_timelinev()</code></a> instead</p>
2357 </div>
2358 <p>
2359 Animates the given list of properties of <em class="parameter"><code>actor</code></em> between the current
2360 value for each property and a new final value. The animation has a
2361 definite behaviour given by the passed <em class="parameter"><code>alpha</code></em>.
2362 </p>
2363 <p>
2364 See <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animate" title="clutter_actor_animate ()"><code class="function">clutter_actor_animate()</code></a> for further details.
2365 </p>
2366 <p>
2367 This function is useful if you want to use an existing <a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a>
2368 to animate <em class="parameter"><code>actor</code></em>.
2369 </p>
2370 <p>
2371 This is the vector-based variant of <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animate-with-alpha" title="clutter_actor_animate_with_alpha ()"><code class="function">clutter_actor_animate_with_alpha()</code></a>,
2372 useful for language bindings.
2373 </p>
2374 <p>
2375 </p>
2376 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2377 <h3 class="title">Warning</h3>Unlike <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animate-with-alpha" title="clutter_actor_animate_with_alpha ()"><code class="function">clutter_actor_animate_with_alpha()</code></a>, this function will
2378 not allow you to specify "signal::" names and callbacks.</div>
2379 <p>
2380 </p>
2381 <div class="variablelist"><table border="0">
2382 <col align="left" valign="top">
2383 <tbody>
2384 <tr>
2385 <td><p><span class="term"><em class="parameter"><code>actor</code></em> :</span></p></td>
2386 <td>a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a>
2387 </td>
2388 </tr>
2389 <tr>
2390 <td><p><span class="term"><em class="parameter"><code>alpha</code></em> :</span></p></td>
2391 <td>a <a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a>
2392 </td>
2393 </tr>
2394 <tr>
2395 <td><p><span class="term"><em class="parameter"><code>n_properties</code></em> :</span></p></td>
2396 <td>number of property names and values</td>
2397 </tr>
2398 <tr>
2399 <td><p><span class="term"><em class="parameter"><code>properties</code></em> :</span></p></td>
2400 <td>a vector
2401 containing the property names to set. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_properties][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8]</span>
2402 </td>
2403 </tr>
2404 <tr>
2405 <td><p><span class="term"><em class="parameter"><code>values</code></em> :</span></p></td>
2406 <td>a vector containing the
2407 property values to set. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_properties]</span>
2408 </td>
2409 </tr>
2410 <tr>
2411 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2412 <td>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> object. The object is owned by the
2413 <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> and should not be unreferenced with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
2414 </td>
2415 </tr>
2416 </tbody>
2417 </table></div>
2418 <p class="since">Since 1.0</p>
2419 </div>
2420 <hr>
2421 <div class="refsect2">
2422 <a name="clutter-actor-get-animation"></a><h3>clutter_actor_get_animation ()</h3>
2423 <pre class="programlisting"><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *  clutter_actor_get_animation         (<em class="parameter"><code><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> *actor</code></em>);</pre>
2424 <p>
2425 Retrieves the <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> used by <em class="parameter"><code>actor</code></em>, if <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animate" title="clutter_actor_animate ()"><code class="function">clutter_actor_animate()</code></a>
2426 has been called on <em class="parameter"><code>actor</code></em>.
2427 </p>
2428 <div class="variablelist"><table border="0">
2429 <col align="left" valign="top">
2430 <tbody>
2431 <tr>
2432 <td><p><span class="term"><em class="parameter"><code>actor</code></em> :</span></p></td>
2433 <td>a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a>
2434 </td>
2435 </tr>
2436 <tr>
2437 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2438 <td>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a>, or <a href="/home/ebassi/gnome3/install/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
2439 </td>
2440 </tr>
2441 </tbody>
2442 </table></div>
2443 <p class="since">Since 1.0</p>
2444 </div>
2445 <hr>
2446 <div class="refsect2">
2447 <a name="clutter-actor-detach-animation"></a><h3>clutter_actor_detach_animation ()</h3>
2448 <pre class="programlisting"><span class="returnvalue">void</span>                clutter_actor_detach_animation      (<em class="parameter"><code><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> *actor</code></em>);</pre>
2449 <p>
2450 Detaches the <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> used by <em class="parameter"><code>actor</code></em>, if <a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animate" title="clutter_actor_animate ()"><code class="function">clutter_actor_animate()</code></a>
2451 has been called on <em class="parameter"><code>actor</code></em>.
2452 </p>
2453 <p>
2454 Once the animation has been detached, it loses a reference. If it was
2455 the only reference then the <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> becomes invalid.
2456 </p>
2457 <p>
2458 The <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation-completed" title='The "completed" signal'><span class="type">"completed"</span></a> signal will not be emitted.
2459 </p>
2460 <div class="variablelist"><table border="0">
2461 <col align="left" valign="top">
2462 <tbody><tr>
2463 <td><p><span class="term"><em class="parameter"><code>actor</code></em> :</span></p></td>
2464 <td>a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a>
2465 </td>
2466 </tr></tbody>
2467 </table></div>
2468 <p class="since">Since 1.4</p>
2469 </div>
2470 </div>
2471 <div class="refsect1">
2472 <a name="clutter-Implicit-Animations.property-details"></a><h2>Property Details</h2>
2473 <div class="refsect2">
2474 <a name="ClutterAnimation--alpha"></a><h3>The <code class="literal">"alpha"</code> property</h3>
2475 <pre class="programlisting">  "alpha"                    <a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a>*         : Read / Write</pre>
2476 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2477 <h3 class="title">Warning</h3>
2478 <p><code class="literal">ClutterAnimation:alpha</code> has been deprecated since version 1.10 and should not be used in newly-written code. Use the <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation--timeline" title='The "timeline" property'><span class="type">"timeline"</span></a> property and
2479   the <a class="link" href="ClutterTimeline.html#ClutterTimeline--progress-mode" title='The "progress-mode" property'><span class="type">"progress-mode"</span></a> property instead.</p>
2480 </div>
2481 <p>
2482 The <a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a> used by the animation.
2483 </p>
2484 <p class="since">Since 1.0</p>
2485 </div>
2486 <hr>
2487 <div class="refsect2">
2488 <a name="ClutterAnimation--duration"></a><h3>The <code class="literal">"duration"</code> property</h3>
2489 <pre class="programlisting">  "duration"                 <a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write</pre>
2490 <p>
2491 The duration of the animation, expressed in milliseconds.
2492 </p>
2493 <p>Default value: 0</p>
2494 <p class="since">Since 1.0</p>
2495 </div>
2496 <hr>
2497 <div class="refsect2">
2498 <a name="ClutterAnimation--loop"></a><h3>The <code class="literal">"loop"</code> property</h3>
2499 <pre class="programlisting">  "loop"                     <a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
2500 <p>
2501 Whether the animation should loop.
2502 </p>
2503 <p>Default value: FALSE</p>
2504 <p class="since">Since 1.0</p>
2505 </div>
2506 <hr>
2507 <div class="refsect2">
2508 <a name="ClutterAnimation--mode"></a><h3>The <code class="literal">"mode"</code> property</h3>
2509 <pre class="programlisting">  "mode"                     <a href="../glib/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a>                : Read / Write</pre>
2510 <p>
2511 The animation mode, either a value from <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimationMode" title="enum ClutterAnimationMode"><span class="type">ClutterAnimationMode</span></a>
2512 or a value returned by <a class="link" href="ClutterAlpha.html#clutter-alpha-register-func" title="clutter_alpha_register_func ()"><code class="function">clutter_alpha_register_func()</code></a>. The
2513 default value is <a class="link" href="clutter-Implicit-Animations.html#CLUTTER-LINEAR:CAPS"><code class="literal">CLUTTER_LINEAR</code></a>.
2514 </p>
2515 <p class="since">Since 1.0</p>
2516 </div>
2517 <hr>
2518 <div class="refsect2">
2519 <a name="ClutterAnimation--object"></a><h3>The <code class="literal">"object"</code> property</h3>
2520 <pre class="programlisting">  "object"                   <a href="../gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>*              : Read / Write</pre>
2521 <p>
2522 The <a href="../gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> to which the animation applies.
2523 </p>
2524 <p class="since">Since 1.0</p>
2525 </div>
2526 <hr>
2527 <div class="refsect2">
2528 <a name="ClutterAnimation--timeline"></a><h3>The <code class="literal">"timeline"</code> property</h3>
2529 <pre class="programlisting">  "timeline"                 <a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a>*      : Read / Write</pre>
2530 <p>
2531 The <a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a> used by the animation.
2532 </p>
2533 <p class="since">Since 1.0</p>
2534 </div>
2535 </div>
2536 <div class="refsect1">
2537 <a name="clutter-Implicit-Animations.signal-details"></a><h2>Signal Details</h2>
2538 <div class="refsect2">
2539 <a name="ClutterAnimation-completed"></a><h3>The <code class="literal">"completed"</code> signal</h3>
2540 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation,
2541                                                         <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>          user_data)      : <a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
2542 <p>
2543 The ::completed signal is emitted once the animation has
2544 been completed.
2545 </p>
2546 <p>
2547 The <em class="parameter"><code>animation</code></em> instance is guaranteed to be valid for the entire
2548 duration of the signal emission chain.
2549 </p>
2550 <div class="variablelist"><table border="0">
2551 <col align="left" valign="top">
2552 <tbody>
2553 <tr>
2554 <td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td>
2555 <td>the animation that emitted the signal</td>
2556 </tr>
2557 <tr>
2558 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2559 <td>user data set when the signal handler was connected.</td>
2560 </tr>
2561 </tbody>
2562 </table></div>
2563 <p class="since">Since 1.0</p>
2564 </div>
2565 <hr>
2566 <div class="refsect2">
2567 <a name="ClutterAnimation-started"></a><h3>The <code class="literal">"started"</code> signal</h3>
2568 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> *animation,
2569                                                         <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>          user_data)      : <a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
2570 <p>
2571 The ::started signal is emitted once the animation has been
2572 started
2573 </p>
2574 <div class="variablelist"><table border="0">
2575 <col align="left" valign="top">
2576 <tbody>
2577 <tr>
2578 <td><p><span class="term"><em class="parameter"><code>animation</code></em> :</span></p></td>
2579 <td>the animation that emitted the signal</td>
2580 </tr>
2581 <tr>
2582 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2583 <td>user data set when the signal handler was connected.</td>
2584 </tr>
2585 </tbody>
2586 </table></div>
2587 <p class="since">Since 1.0</p>
2588 </div>
2589 </div>
2590 <div class="refsect1">
2591 <a name="clutter-Implicit-Animations.see-also"></a><h2>See Also</h2>
2592 <a class="link" href="ClutterAnimatable.html" title="ClutterAnimatable"><span class="type">ClutterAnimatable</span></a>, <a class="link" href="clutter-Value-intervals.html#ClutterInterval"><span class="type">ClutterInterval</span></a>, <a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a>,
2593   <a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a>
2594 </div>
2595 </div>
2596 <div class="footer">
2597 <hr>
2598           Generated by GTK-Doc V1.18.1</div>
2599 </body>
2600 </html>