<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Implicit Animations: Clutter Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="Clutter Reference Manual">
<link rel="up" href="deprecated.html" title="Part X. Deprecated Classes">
<link rel="prev" href="ClutterAlpha.html" title="ClutterAlpha">
<link rel="next" href="ClutterAnimator.html" title="ClutterAnimator">
<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts">
<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span>
<a href="#clutter-Implicit-Animations.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
<a href="#clutter-Implicit-Animations.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces"> <span class="dim">|</span>
<a href="#clutter-Implicit-Animations.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_properties"> <span class="dim">|</span>
<a href="#clutter-Implicit-Animations.properties" class="shortcut">Properties</a></span><span id="nav_signals"> <span class="dim">|</span>
<a href="#clutter-Implicit-Animations.signals" class="shortcut">Signals</a></span>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="deprecated.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="ClutterAlpha.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="ClutterAnimator.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="clutter-Implicit-Animations"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="clutter-Implicit-Animations.top_of_page"></a>Implicit Animations</span></h2>
<p>Implicit Animations — Simple implicit animations</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="clutter-Implicit-Animations.functions"></a><h2>Functions</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_return">
<col class="functions_name">
</colgroup>
<tbody>
<tr>
<td class="function_type">
<a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *
</td>
<td class="function_name">
<a class="link" href="clutter-Implicit-Animations.html#clutter-animation-new" title="clutter_animation_new ()">clutter_animation_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="clutter-Implicit-Animations.html#clutter-animation-set-object" title="clutter_animation_set_object ()">clutter_animation_set_object</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GObject</span> *
</td>
<td class="function_name">
<a class="link" href="clutter-Implicit-Animations.html#clutter-animation-get-object" title="clutter_animation_get_object ()">clutter_animation_get_object</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="clutter-Implicit-Animations.html#clutter-animation-set-mode" title="clutter_animation_set_mode ()">clutter_animation_set_mode</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gulong</span>
</td>
<td class="function_name">
<a class="link" href="clutter-Implicit-Animations.html#clutter-animation-get-mode" title="clutter_animation_get_mode ()">clutter_animation_get_mode</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="clutter-Implicit-Animations.html#clutter-animation-set-duration" title="clutter_animation_set_duration ()">clutter_animation_set_duration</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">guint</span>
</td>
<td class="function_name">
<a class="link" href="clutter-Implicit-Animations.html#clutter-animation-get-duration" title="clutter_animation_get_duration ()">clutter_animation_get_duration</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="clutter-Implicit-Animations.html#clutter-animation-set-loop" title="clutter_animation_set_loop ()">clutter_animation_set_loop</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="clutter-Implicit-Animations.html#clutter-animation-get-loop" title="clutter_animation_get_loop ()">clutter_animation_get_loop</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="clutter-Implicit-Animations.html#clutter-animation-set-timeline" title="clutter_animation_set_timeline ()">clutter_animation_set_timeline</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="returnvalue">ClutterTimeline</span></a> *
</td>
<td class="function_name">
<a class="link" href="clutter-Implicit-Animations.html#clutter-animation-get-timeline" title="clutter_animation_get_timeline ()">clutter_animation_get_timeline</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="clutter-Implicit-Animations.html#clutter-animation-set-alpha" title="clutter_animation_set_alpha ()">clutter_animation_set_alpha</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="returnvalue">ClutterAlpha</span></a> *
</td>
<td class="function_name">
<a class="link" href="clutter-Implicit-Animations.html#clutter-animation-get-alpha" title="clutter_animation_get_alpha ()">clutter_animation_get_alpha</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="clutter-Implicit-Animations.html#clutter-animation-completed" title="clutter_animation_completed ()">clutter_animation_completed</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *
</td>
<td class="function_name">
<a class="link" href="clutter-Implicit-Animations.html#clutter-animation-bind" title="clutter_animation_bind ()">clutter_animation_bind</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *
</td>
<td class="function_name">
<a class="link" href="clutter-Implicit-Animations.html#clutter-animation-bind-interval" title="clutter_animation_bind_interval ()">clutter_animation_bind_interval</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *
</td>
<td class="function_name">
<a class="link" href="clutter-Implicit-Animations.html#clutter-animation-update" title="clutter_animation_update ()">clutter_animation_update</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="clutter-Implicit-Animations.html#clutter-animation-update-interval" title="clutter_animation_update_interval ()">clutter_animation_update_interval</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="clutter-Implicit-Animations.html#clutter-animation-has-property" title="clutter_animation_has_property ()">clutter_animation_has_property</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="clutter-Implicit-Animations.html#clutter-animation-unbind-property" title="clutter_animation_unbind_property ()">clutter_animation_unbind_property</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="clutter-Value-intervals.html#ClutterInterval"><span class="returnvalue">ClutterInterval</span></a> *
</td>
<td class="function_name">
<a class="link" href="clutter-Implicit-Animations.html#clutter-animation-get-interval" title="clutter_animation_get_interval ()">clutter_animation_get_interval</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *
</td>
<td class="function_name">
<a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animate" title="clutter_actor_animate ()">clutter_actor_animate</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *
</td>
<td class="function_name">
<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> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *
</td>
<td class="function_name">
<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> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *
</td>
<td class="function_name">
<a class="link" href="clutter-Implicit-Animations.html#clutter-actor-animatev" title="clutter_actor_animatev ()">clutter_actor_animatev</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *
</td>
<td class="function_name">
<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> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *
</td>
<td class="function_name">
<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> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *
</td>
<td class="function_name">
<a class="link" href="clutter-Implicit-Animations.html#clutter-actor-get-animation" title="clutter_actor_get_animation ()">clutter_actor_get_animation</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="clutter-Implicit-Animations.html#clutter-actor-detach-animation" title="clutter_actor_detach_animation ()">clutter_actor_detach_animation</a> <span class="c_punctuation">()</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="clutter-Implicit-Animations.properties"></a><h2>Properties</h2>
<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="properties_type">
<col width="300px" class="properties_name">
<col width="200px" class="properties_flags">
</colgroup>
<tbody>
<tr>
<td class="property_type">
<a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a> *</td>
<td class="property_name"><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation--alpha" title="The “alpha” property">alpha</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">guint</span></td>
<td class="property_name"><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation--duration" title="The “duration” property">duration</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation--loop" title="The “loop” property">loop</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">gulong</span></td>
<td class="property_name"><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation--mode" title="The “mode” property">mode</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">GObject</span> *</td>
<td class="property_name"><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation--object" title="The “object” property">object</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a> *</td>
<td class="property_name"><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation--timeline" title="The “timeline” property">timeline</a></td>
<td class="property_flags">Read / Write</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="clutter-Implicit-Animations.signals"></a><h2>Signals</h2>
<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="signals_return">
<col width="300px" class="signals_name">
<col width="200px" class="signals_flags">
</colgroup>
<tbody>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation-completed" title="The “completed” signal">completed</a></td>
<td class="signal_flags">Run Last</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation-started" title="The “started” signal">started</a></td>
<td class="signal_flags">Run Last</td>
</tr>
</tbody>
</table></div>
</div>
<a name="ClutterAnimation"></a><div class="refsect1">
<a name="clutter-Implicit-Animations.other"></a><h2>Types and Values</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="name">
<col class="description">
</colgroup>
<tbody>
<tr>
<td class="datatype_keyword"> </td>
<td class="function_name"><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation-struct" title="ClutterAnimation">ClutterAnimation</a></td>
</tr>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimationClass" title="struct ClutterAnimationClass">ClutterAnimationClass</a></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="clutter-Implicit-Animations.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen"> GObject
<span class="lineart">╰──</span> ClutterAnimation
</pre>
</div>
<div class="refsect1">
<a name="clutter-Implicit-Animations.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
<p>
ClutterAnimation implements
<a class="link" href="ClutterScriptable.html" title="ClutterScriptable">ClutterScriptable</a>.</p>
</div>
<div class="refsect1">
<a name="clutter-Implicit-Animations.description"></a><h2>Description</h2>
<p><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> is an object providing simple, implicit animations
for <span class="type">GObjects</span>.</p>
<p><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> instances will bind one or more <span class="type">GObject</span> properties
belonging to a <span class="type">GObject</span> to a <a class="link" href="clutter-Value-intervals.html#ClutterInterval"><span class="type">ClutterInterval</span></a>, and will then use a
<a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a> to interpolate the property between the initial and final
values of the interval.</p>
<p>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>.
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>.</p>
<p>If you want to control the animation you should retrieve the
<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
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>,
<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>.</p>
<p>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
when the <a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a> used by the animation is completed; unlike
<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
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 <code class="literal">TRUE</code> - that is, a looping
animation never completes.</p>
<p>If your animation depends on user control you can force its completion
using <a class="link" href="clutter-Implicit-Animations.html#clutter-animation-completed" title="clutter_animation_completed ()"><code class="function">clutter_animation_completed()</code></a>.</p>
<p>If the <span class="type">GObject</span> instance bound to a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> implements the
<a class="link" href="ClutterAnimatable.html" title="ClutterAnimatable"><span class="type">ClutterAnimatable</span></a> interface it is possible for that instance to
control the way the initial and final states are interpolated.</p>
<p><a href="clutter-Implicit-Animations.html#ClutterAnimation-struct"><span class="type">ClutterAnimations</span></a> are distinguished from <a href="ClutterBehaviour.html#ClutterBehaviour-struct"><span class="type">ClutterBehaviours</span></a>
because the former can only control <span class="type">GObject</span> properties of a single
<span class="type">GObject</span> instance, while the latter can control multiple properties
using accessor functions inside the <a class="link" href="ClutterBehaviour.html" title="ClutterBehaviour"><span class="type">ClutterBehaviour</span></a>
<code class="literal">alpha_notify</code> virtual function, and can control multiple <a href="ClutterActor.html#ClutterActor-struct"><span class="type">ClutterActors</span></a>
as well.</p>
<p>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>
function call which will take care of setting up and tearing down
a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> instance and animate an actor between its current
state and the specified final state.</p>
<p><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> is available since Clutter 1.0.</p>
<p><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> has been deprecated in Clutter 1.12. You should use
the <a class="link" href="ClutterActor.html#clutter-actor-animation" title="Animation">implicit animation API</a> available inside
<a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> instead. If you require to define explicit transitions for
one or more properties in order to reuse them, see <a class="link" href="ClutterTransition.html" title="ClutterTransition"><span class="type">ClutterTransition</span></a>
instead.</p>
<div class="refsect3">
<a name="id-1.11.3.10.13"></a><h4>Defining ClutterAnimationMode inside ClutterScript</h4>
<p>When defining a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> inside a ClutterScript
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
using the <a class="link" href="ClutterTimeline.html#ClutterAnimationMode" title="enum ClutterAnimationMode"><span class="type">ClutterAnimationMode</span></a> enumeration values through their
"nick" (the short string used inside <span class="type">GEnumValue</span>), their numeric
id, or using the following strings:</p>
<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
<li class="listitem"><p>easeInQuad, easeOutQuad, easeInOutQuad</p></li>
<li class="listitem"><p>easeInCubic, easeOutCubic, easeInOutCubic</p></li>
<li class="listitem"><p>easeInQuart, easeOutQuart, easeInOutQuart</p></li>
<li class="listitem"><p>easeInQuint, easeOutQuint, easeInOutQuint</p></li>
<li class="listitem"><p>easeInSine, easeOutSine, easeInOutSine</p></li>
<li class="listitem"><p>easeInExpo, easeOutExpo, easeInOutExpo</p></li>
<li class="listitem"><p>easeInCirc, easeOutCirc, easeInOutCirc</p></li>
<li class="listitem"><p>easeInElastic, easeOutElastic, easeInOutElastic</p></li>
<li class="listitem"><p>easeInBack, easeOutBack, easeInOutBack</p></li>
<li class="listitem"><p>easeInBounce, easeOutBounce, easeInOutBounce</p></li>
</ul></div>
</div>
</div>
<div class="refsect1">
<a name="clutter-Implicit-Animations.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="clutter-animation-new"></a><h3>clutter_animation_new ()</h3>
<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>
<div class="warning">
<p><code class="literal">clutter_animation_new</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterPropertyTransition.html" title="ClutterPropertyTransition"><span class="type">ClutterPropertyTransition</span></a> instead</p>
</div>
<p>Creates a new <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> instance. You should set the
<span class="type">GObject</span> 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>,
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
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>.</p>
<p>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>
to define the properties to be animated. The interval and the
animated properties can be updated at runtime.</p>
<p>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
an easy way to animate a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> and automatically manage the
lifetime of a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> instance, so you should consider using
those functions instead of manually creating an animation.</p>
<div class="refsect3">
<a name="clutter-animation-new.returns"></a><h4>Returns</h4>
<p> the newly created <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a>. Use <code class="function">g_object_unref()</code>
to release the associated resources</p>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-animation-set-object"></a><h3>clutter_animation_set_object ()</h3>
<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>,
<em class="parameter"><code><span class="type">GObject</span> *object</code></em>);</pre>
<div class="warning">
<p><code class="literal">clutter_animation_set_object</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterPropertyTransition.html" title="ClutterPropertyTransition"><span class="type">ClutterPropertyTransition</span></a> instead</p>
</div>
<p>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
reference on <em class="parameter"><code>object</code></em>
.</p>
<div class="refsect3">
<a name="clutter-animation-set-object.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>animation</p></td>
<td class="parameter_description"><p>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>object</p></td>
<td class="parameter_description"><p>a <span class="type">GObject</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-animation-get-object"></a><h3>clutter_animation_get_object ()</h3>
<pre class="programlisting"><span class="returnvalue">GObject</span> *
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>
<div class="warning">
<p><code class="literal">clutter_animation_get_object</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterPropertyTransition.html" title="ClutterPropertyTransition"><span class="type">ClutterPropertyTransition</span></a> instead</p>
</div>
<p>Retrieves the <span class="type">GObject</span> attached to <em class="parameter"><code>animation</code></em>
.</p>
<div class="refsect3">
<a name="clutter-animation-get-object.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>animation</p></td>
<td class="parameter_description"><p>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="clutter-animation-get-object.returns"></a><h4>Returns</h4>
<p> a <span class="type">GObject</span>. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-animation-set-mode"></a><h3>clutter_animation_set_mode ()</h3>
<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>,
<em class="parameter"><code><span class="type">gulong</span> mode</code></em>);</pre>
<div class="warning">
<p><code class="literal">clutter_animation_set_mode</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterPropertyTransition.html" title="ClutterPropertyTransition"><span class="type">ClutterPropertyTransition</span></a> instead</p>
</div>
<p>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
a logical id, either coming from the <a class="link" href="ClutterTimeline.html#ClutterAnimationMode" title="enum ClutterAnimationMode"><span class="type">ClutterAnimationMode</span></a> enumeration
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>.</p>
<p>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.</p>
<div class="refsect3">
<a name="clutter-animation-set-mode.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>animation</p></td>
<td class="parameter_description"><p>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>mode</p></td>
<td class="parameter_description"><p>an animation mode logical id</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-animation-get-mode"></a><h3>clutter_animation_get_mode ()</h3>
<pre class="programlisting"><span class="returnvalue">gulong</span>
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>
<div class="warning">
<p><code class="literal">clutter_animation_get_mode</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterPropertyTransition.html" title="ClutterPropertyTransition"><span class="type">ClutterPropertyTransition</span></a> instead</p>
</div>
<p>Retrieves the animation mode of <em class="parameter"><code>animation</code></em>
, as set by
<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>.</p>
<div class="refsect3">
<a name="clutter-animation-get-mode.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>animation</p></td>
<td class="parameter_description"><p>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="clutter-animation-get-mode.returns"></a><h4>Returns</h4>
<p> the mode for the animation</p>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-animation-set-duration"></a><h3>clutter_animation_set_duration ()</h3>
<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>,
<em class="parameter"><code><span class="type">guint</span> msecs</code></em>);</pre>
<div class="warning">
<p><code class="literal">clutter_animation_set_duration</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterPropertyTransition.html" title="ClutterPropertyTransition"><span class="type">ClutterPropertyTransition</span></a> instead</p>
</div>
<p>Sets the duration of <em class="parameter"><code>animation</code></em>
in milliseconds.</p>
<p>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
<a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation--timeline" title="The “timeline” property"><span class="type">“timeline”</span></a> if needed.</p>
<div class="refsect3">
<a name="clutter-animation-set-duration.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>animation</p></td>
<td class="parameter_description"><p>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>msecs</p></td>
<td class="parameter_description"><p>the duration in milliseconds</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-animation-get-duration"></a><h3>clutter_animation_get_duration ()</h3>
<pre class="programlisting"><span class="returnvalue">guint</span>
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>
<div class="warning">
<p><code class="literal">clutter_animation_get_duration</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterPropertyTransition.html" title="ClutterPropertyTransition"><span class="type">ClutterPropertyTransition</span></a> instead</p>
</div>
<p>Retrieves the duration of <em class="parameter"><code>animation</code></em>
, in milliseconds.</p>
<div class="refsect3">
<a name="clutter-animation-get-duration.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>animation</p></td>
<td class="parameter_description"><p>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="clutter-animation-get-duration.returns"></a><h4>Returns</h4>
<p> the duration of the animation</p>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-animation-set-loop"></a><h3>clutter_animation_set_loop ()</h3>
<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>,
<em class="parameter"><code><span class="type">gboolean</span> loop</code></em>);</pre>
<div class="warning">
<p><code class="literal">clutter_animation_set_loop</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterPropertyTransition.html" title="ClutterPropertyTransition"><span class="type">ClutterPropertyTransition</span></a> instead</p>
</div>
<p>Sets whether <em class="parameter"><code>animation</code></em>
should loop over itself once finished.</p>
<p>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>
signal when finished.</p>
<p>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
<a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation--timeline" title="The “timeline” property"><span class="type">“timeline”</span></a> if needed.</p>
<div class="refsect3">
<a name="clutter-animation-set-loop.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>animation</p></td>
<td class="parameter_description"><p>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>loop</p></td>
<td class="parameter_description"><p><code class="literal">TRUE</code> if the animation should loop</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-animation-get-loop"></a><h3>clutter_animation_get_loop ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
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>
<div class="warning">
<p><code class="literal">clutter_animation_get_loop</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterPropertyTransition.html" title="ClutterPropertyTransition"><span class="type">ClutterPropertyTransition</span></a> instead</p>
</div>
<p>Retrieves whether <em class="parameter"><code>animation</code></em>
is looping.</p>
<div class="refsect3">
<a name="clutter-animation-get-loop.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>animation</p></td>
<td class="parameter_description"><p>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="clutter-animation-get-loop.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the animation is looping</p>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-animation-set-timeline"></a><h3>clutter_animation_set_timeline ()</h3>
<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>,
<em class="parameter"><code><a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a> *timeline</code></em>);</pre>
<div class="warning">
<p><code class="literal">clutter_animation_set_timeline</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterPropertyTransition.html" title="ClutterPropertyTransition"><span class="type">ClutterPropertyTransition</span></a> instead</p>
</div>
<p>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>
.</p>
<p>This function will take a reference on the passed <em class="parameter"><code>timeline</code></em>
.</p>
<div class="refsect3">
<a name="clutter-animation-set-timeline.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>animation</p></td>
<td class="parameter_description"><p>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>timeline</p></td>
<td class="parameter_description"><p> a <a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a>, or <code class="literal">NULL</code> to unset the
current <a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-animation-get-timeline"></a><h3>clutter_animation_get_timeline ()</h3>
<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>
<div class="warning">
<p><code class="literal">clutter_animation_get_timeline</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterPropertyTransition.html" title="ClutterPropertyTransition"><span class="type">ClutterPropertyTransition</span></a> instead</p>
</div>
<p>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>
</p>
<div class="refsect3">
<a name="clutter-animation-get-timeline.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>animation</p></td>
<td class="parameter_description"><p>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="clutter-animation-get-timeline.returns"></a><h4>Returns</h4>
<p> the timeline used by the animation. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-animation-set-alpha"></a><h3>clutter_animation_set_alpha ()</h3>
<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>,
<em class="parameter"><code><a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a> *alpha</code></em>);</pre>
<div class="warning">
<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.</p>
<p>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
<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>
</div>
<p>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>
.</p>
<p>If <em class="parameter"><code>alpha</code></em>
is not <code class="literal">NULL</code>, the <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> will take ownership
of the <a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a> instance.</p>
<div class="refsect3">
<a name="clutter-animation-set-alpha.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>animation</p></td>
<td class="parameter_description"><p>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>alpha</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a>, or <code class="literal">NULL</code> to unset the current <a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-animation-get-alpha"></a><h3>clutter_animation_get_alpha ()</h3>
<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>
<div class="warning">
<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.</p>
<p>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
<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>
</div>
<p>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>
.</p>
<div class="refsect3">
<a name="clutter-animation-get-alpha.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>animation</p></td>
<td class="parameter_description"><p>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="clutter-animation-get-alpha.returns"></a><h4>Returns</h4>
<p> the alpha object used by the animation. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-animation-completed"></a><h3>clutter_animation_completed ()</h3>
<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>
<div class="warning">
<p><code class="literal">clutter_animation_completed</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterPropertyTransition.html" title="ClutterPropertyTransition"><span class="type">ClutterPropertyTransition</span></a> instead</p>
</div>
<p>Emits the ::completed signal on <em class="parameter"><code>animation</code></em>
</p>
<p>When using this function with a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> created
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>
will be unreferenced and it will not be valid anymore,
unless <code class="function">g_object_ref()</code> was called before calling this function
or unless a reference was taken inside a handler for the
<a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation-completed" title="The “completed” signal"><span class="type">“completed”</span></a> signal</p>
<div class="refsect3">
<a name="clutter-animation-completed.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>animation</p></td>
<td class="parameter_description"><p>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-animation-bind"></a><h3>clutter_animation_bind ()</h3>
<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>,
<em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
<em class="parameter"><code>const <span class="type">GValue</span> *final</code></em>);</pre>
<div class="warning">
<p><code class="literal">clutter_animation_bind</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterPropertyTransition.html" title="ClutterPropertyTransition"><span class="type">ClutterPropertyTransition</span></a> instead</p>
</div>
<p>Adds a single property with name <em class="parameter"><code>property_name</code></em>
to the
animation <em class="parameter"><code>animation</code></em>
. For more information 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>.</p>
<p>This method returns the animation primarily to make chained
calls convenient in language bindings.</p>
<div class="refsect3">
<a name="clutter-animation-bind.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>animation</p></td>
<td class="parameter_description"><p>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>the property to control</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>final</p></td>
<td class="parameter_description"><p>The final value of the property</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="clutter-animation-bind.returns"></a><h4>Returns</h4>
<p> The animation itself. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-animation-bind-interval"></a><h3>clutter_animation_bind_interval ()</h3>
<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>,
<em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
<em class="parameter"><code><a class="link" href="clutter-Value-intervals.html#ClutterInterval"><span class="type">ClutterInterval</span></a> *interval</code></em>);</pre>
<div class="warning">
<p><code class="literal">clutter_animation_bind_interval</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterPropertyTransition.html" title="ClutterPropertyTransition"><span class="type">ClutterPropertyTransition</span></a> instead</p>
</div>
<p>Binds <em class="parameter"><code>interval</code></em>
to the <em class="parameter"><code>property_name</code></em>
of the <span class="type">GObject</span>
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
ownership of the passed <a class="link" href="clutter-Value-intervals.html#ClutterInterval"><span class="type">ClutterInterval</span></a>. For more information
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>.</p>
<p>If you need to update the interval instance use
<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.</p>
<div class="refsect3">
<a name="clutter-animation-bind-interval.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>animation</p></td>
<td class="parameter_description"><p>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>the property to control</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>interval</p></td>
<td class="parameter_description"><p> a <a class="link" href="clutter-Value-intervals.html#ClutterInterval"><span class="type">ClutterInterval</span></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="clutter-animation-bind-interval.returns"></a><h4>Returns</h4>
<p> The animation itself. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-animation-update"></a><h3>clutter_animation_update ()</h3>
<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>,
<em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
<em class="parameter"><code>const <span class="type">GValue</span> *final</code></em>);</pre>
<div class="warning">
<p><code class="literal">clutter_animation_update</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterPropertyTransition.html" title="ClutterPropertyTransition"><span class="type">ClutterPropertyTransition</span></a> instead</p>
</div>
<p>Updates the <em class="parameter"><code>final</code></em>
value of the interval for <em class="parameter"><code>property_name</code></em>
</p>
<div class="refsect3">
<a name="clutter-animation-update.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>animation</p></td>
<td class="parameter_description"><p>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>name of the property</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>final</p></td>
<td class="parameter_description"><p>The final value of the property</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="clutter-animation-update.returns"></a><h4>Returns</h4>
<p> The animation itself. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-animation-update-interval"></a><h3>clutter_animation_update_interval ()</h3>
<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>,
<em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
<em class="parameter"><code><a class="link" href="clutter-Value-intervals.html#ClutterInterval"><span class="type">ClutterInterval</span></a> *interval</code></em>);</pre>
<div class="warning">
<p><code class="literal">clutter_animation_update_interval</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterPropertyTransition.html" title="ClutterPropertyTransition"><span class="type">ClutterPropertyTransition</span></a> instead</p>
</div>
<p>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>
will take ownership of the passed <a class="link" href="clutter-Value-intervals.html#ClutterInterval"><span class="type">ClutterInterval</span></a>.</p>
<div class="refsect3">
<a name="clutter-animation-update-interval.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>animation</p></td>
<td class="parameter_description"><p>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>name of the property</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>interval</p></td>
<td class="parameter_description"><p>a <a class="link" href="clutter-Value-intervals.html#ClutterInterval"><span class="type">ClutterInterval</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-animation-has-property"></a><h3>clutter_animation_has_property ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
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>,
<em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>);</pre>
<div class="warning">
<p><code class="literal">clutter_animation_has_property</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterPropertyTransition.html" title="ClutterPropertyTransition"><span class="type">ClutterPropertyTransition</span></a> instead</p>
</div>
<p>Checks whether <em class="parameter"><code>animation</code></em>
is controlling <em class="parameter"><code>property_name</code></em>
.</p>
<div class="refsect3">
<a name="clutter-animation-has-property.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>animation</p></td>
<td class="parameter_description"><p>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>name of the property</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="clutter-animation-has-property.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the property is animated by the
<a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a>, <code class="literal">FALSE</code> otherwise</p>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-animation-unbind-property"></a><h3>clutter_animation_unbind_property ()</h3>
<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>,
<em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>);</pre>
<div class="warning">
<p><code class="literal">clutter_animation_unbind_property</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterPropertyTransition.html" title="ClutterPropertyTransition"><span class="type">ClutterPropertyTransition</span></a> instead</p>
</div>
<p>Removes <em class="parameter"><code>property_name</code></em>
from the list of animated properties.</p>
<div class="refsect3">
<a name="clutter-animation-unbind-property.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>animation</p></td>
<td class="parameter_description"><p>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>name of the property</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-animation-get-interval"></a><h3>clutter_animation_get_interval ()</h3>
<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>,
<em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>);</pre>
<div class="warning">
<p><code class="literal">clutter_animation_get_interval</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterPropertyTransition.html" title="ClutterPropertyTransition"><span class="type">ClutterPropertyTransition</span></a> instead</p>
</div>
<p>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>
inside <em class="parameter"><code>animation</code></em>
.</p>
<div class="refsect3">
<a name="clutter-animation-get-interval.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>animation</p></td>
<td class="parameter_description"><p>a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>name of the property</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="clutter-animation-get-interval.returns"></a><h4>Returns</h4>
<p> a <a class="link" href="clutter-Value-intervals.html#ClutterInterval"><span class="type">ClutterInterval</span></a> or <code class="literal">NULL</code> if no
property with the same name was found. The returned interval is
owned by the <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> and should not be unreferenced. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-actor-animate"></a><h3>clutter_actor_animate ()</h3>
<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>,
<em class="parameter"><code><span class="type">gulong</span> mode</code></em>,
<em class="parameter"><code><span class="type">guint</span> duration</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *first_property_name</code></em>,
<em class="parameter"><code>...</code></em>);</pre>
<div class="warning">
<p><code class="literal">clutter_actor_animate</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use the implicit transition for animatable properties
in <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> instead. See <a class="link" href="ClutterActor.html#clutter-actor-save-easing-state" title="clutter_actor_save_easing_state ()"><code class="function">clutter_actor_save_easing_state()</code></a>,
<a class="link" href="ClutterActor.html#clutter-actor-set-easing-mode" title="clutter_actor_set_easing_mode ()"><code class="function">clutter_actor_set_easing_mode()</code></a>, <a class="link" href="ClutterActor.html#clutter-actor-set-easing-duration" title="clutter_actor_set_easing_duration ()"><code class="function">clutter_actor_set_easing_duration()</code></a>,
<a class="link" href="ClutterActor.html#clutter-actor-set-easing-delay" title="clutter_actor_set_easing_delay ()"><code class="function">clutter_actor_set_easing_delay()</code></a>, and <a class="link" href="ClutterActor.html#clutter-actor-restore-easing-state" title="clutter_actor_restore_easing_state ()"><code class="function">clutter_actor_restore_easing_state()</code></a>.</p>
</div>
<p>Animates the given list of properties of <em class="parameter"><code>actor</code></em>
between the current
value for each property and a new final value. The animation has a
definite duration and a speed given by the <em class="parameter"><code>mode</code></em>
.</p>
<p>For example, this:</p>
<div class="informalexample">
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
<tbody>
<tr>
<td class="listing_lines" align="right"><pre>1
2
3
4</pre></td>
<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="ClutterTimeline.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>
<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>
<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>
<span class="normal"> NULL</span><span class="symbol">);</span></pre></td>
</tr>
</tbody>
</table>
</div>
<p></p>
<p>will make width and height properties of the <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> "rectangle"
grow linearly between the current value and 100 pixels, in 250 milliseconds.</p>
<p>The animation <em class="parameter"><code>mode</code></em>
is a logical id, either from the <a class="link" href="ClutterTimeline.html#ClutterAnimationMode" title="enum ClutterAnimationMode"><span class="type">ClutterAnimationMode</span></a>
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>.</p>
<p>All the properties specified will be animated between the current value
and the final value. If a property should be set at the beginning of
the animation but not updated during the animation, it should be prefixed
by the "fixed::" string, for instance:</p>
<div class="informalexample">
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
<tbody>
<tr>
<td class="listing_lines" align="right"><pre>1
2
3
4</pre></td>
<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="ClutterTimeline.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>
<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>
<span class="normal"> </span><span class="string">"fixed::rotation-center-z"</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">center</span><span class="symbol">,</span>
<span class="normal"> NULL</span><span class="symbol">);</span></pre></td>
</tr>
</tbody>
</table>
</div>
<p></p>
<p>Will animate the "rotation-angle-z" property between the current value
and 360 degrees, and set the "rotation-center-z" property to the fixed
value of the <a class="link" href="clutter-Base-geometric-types.html#ClutterVertex"><span class="type">ClutterVertex</span></a> "center".</p>
<p>This function will implicitly create a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> object which
will be assigned to the <em class="parameter"><code>actor</code></em>
and will be returned to the developer
to control the animation or to know when the animation has been
completed.</p>
<p>If a name argument starts with "signal::", "signal-after::",
"signal-swapped::" or "signal-swapped-after::" the two following arguments
are used as callback function and data for a signal handler installed on
the <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> object for the specified signal name, for instance:</p>
<div class="informalexample">
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
<tbody>
<tr>
<td class="listing_lines" align="right"><pre>1
2
3
4
5
6
7
8
9
10
11</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
<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>
<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>
<span class="cbracket">{</span>
<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>
<span class="cbracket">}</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="ClutterTimeline.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>
<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>
<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>
<span class="normal"> NULL</span><span class="symbol">);</span></pre></td>
</tr>
</tbody>
</table>
</div>
<p></p>
<p>or, to automatically destroy an actor at the end of the animation:</p>
<div class="informalexample">
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
<tbody>
<tr>
<td class="listing_lines" align="right"><pre>1
2
3
4
5
6</pre></td>
<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="ClutterTimeline.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>
<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>
<span class="normal"> </span><span class="string">"signal-swapped-after::completed"</span><span class="symbol">,</span>
<span class="normal"> <a href="ClutterActor.html#clutter-actor-destroy">clutter_actor_destroy</a></span><span class="symbol">,</span>
<span class="normal"> actor</span><span class="symbol">,</span>
<span class="normal"> NULL</span><span class="symbol">);</span></pre></td>
</tr>
</tbody>
</table>
</div>
<p></p>
<p>The "signal::" modifier is the equivalent of using <code class="function">g_signal_connect()</code>;
the "signal-after::" modifier is the equivalent of using
<code class="function">g_signal_connect_after()</code> or <code class="function">g_signal_connect_data()</code> with the
<code class="literal">G_CONNECT_AFTER</code>; the "signal-swapped::" modifier is the equivalent
of using <code class="function">g_signal_connect_swapped()</code> or <code class="function">g_signal_connect_data()</code> with the
<code class="literal">G_CONNECT_SWAPPED</code> flah; finally, the "signal-swapped-after::" modifier
is the equivalent of using <code class="function">g_signal_connect_data()</code> with both the
<code class="literal">G_CONNECT_AFTER</code> and <code class="literal">G_CONNECT_SWAPPED</code> 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>
function will not keep track of multiple connections to the same signal,
so it is your responsability to avoid them when calling
<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.</p>
<p>Calling this function on an actor that is already being animated
will cause the current animation to change with the new final values,
the new easing mode and the new duration - that is, this code:</p>
<div class="informalexample">
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
<tbody>
<tr>
<td class="listing_lines" align="right"><pre>1
2
3
4
5
6
7
8
9</pre></td>
<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="ClutterTimeline.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>
<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>
<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>
<span class="normal"> NULL</span><span class="symbol">);</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="ClutterTimeline.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>
<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>
<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>
<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>
<span class="normal"> NULL</span><span class="symbol">);</span></pre></td>
</tr>
</tbody>
</table>
</div>
<p></p>
<p>is the equivalent of:</p>
<div class="informalexample">
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
<tbody>
<tr>
<td class="listing_lines" align="right"><pre>1
2
3
4
5
6</pre></td>
<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="ClutterTimeline.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>
<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>
<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>
<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>
<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>
<span class="normal"> NULL</span><span class="symbol">);</span></pre></td>
</tr>
</tbody>
</table>
</div>
<p></p>
<p>Unless the animation is looping, the <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> created by
<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
complete.</p>
<p>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>
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>
signal emission chain, you will not be able to create a new animation
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
<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
<code class="function">g_signal_connect_after()</code> to connect the callback function, for instance:</p>
<div class="informalexample">
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
<tbody>
<tr>
<td class="listing_lines" align="right"><pre>1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
<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>
<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>
<span class="cbracket">{</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="ClutterTimeline.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>
<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>
<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>
<span class="normal"> NULL</span><span class="symbol">);</span>
<span class="cbracket">}</span>
<span class="normal"> </span><span class="symbol">...</span>
<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="ClutterTimeline.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>
<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>
<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>
<span class="normal"> NULL</span><span class="symbol">);</span>
<span class="normal"> </span><span class="function">g_signal_connect</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>
<span class="normal"> </span><span class="function">G_CALLBACK</span><span class="normal"> </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>
<span class="normal"> </span><span class="symbol">...</span></pre></td>
</tr>
</tbody>
</table>
</div>
<p></p>
<div class="refsect3">
<a name="clutter-actor-animate.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>actor</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>mode</p></td>
<td class="parameter_description"><p>an animation mode logical id</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>duration</p></td>
<td class="parameter_description"><p>duration of the animation, in milliseconds</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>first_property_name</p></td>
<td class="parameter_description"><p>the name of a property</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>...</p></td>
<td class="parameter_description"><p>a <code class="literal">NULL</code> terminated list of property names and
property values</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="clutter-actor-animate.returns"></a><h4>Returns</h4>
<p> a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> object. The object is
owned by the <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> and should not be unreferenced with
<code class="function">g_object_unref()</code>. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-actor-animate-with-timeline"></a><h3>clutter_actor_animate_with_timeline ()</h3>
<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>,
<em class="parameter"><code><span class="type">gulong</span> mode</code></em>,
<em class="parameter"><code><a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a> *timeline</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *first_property_name</code></em>,
<em class="parameter"><code>...</code></em>);</pre>
<div class="warning">
<p><code class="literal">clutter_actor_animate_with_timeline</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use the implicit transition for animatable properties
in <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> instead. See <a class="link" href="ClutterActor.html#clutter-actor-save-easing-state" title="clutter_actor_save_easing_state ()"><code class="function">clutter_actor_save_easing_state()</code></a>,
<a class="link" href="ClutterActor.html#clutter-actor-set-easing-mode" title="clutter_actor_set_easing_mode ()"><code class="function">clutter_actor_set_easing_mode()</code></a>, <a class="link" href="ClutterActor.html#clutter-actor-set-easing-duration" title="clutter_actor_set_easing_duration ()"><code class="function">clutter_actor_set_easing_duration()</code></a>,
<a class="link" href="ClutterActor.html#clutter-actor-set-easing-delay" title="clutter_actor_set_easing_delay ()"><code class="function">clutter_actor_set_easing_delay()</code></a>, and <a class="link" href="ClutterActor.html#clutter-actor-restore-easing-state" title="clutter_actor_restore_easing_state ()"><code class="function">clutter_actor_restore_easing_state()</code></a>.</p>
</div>
<p>Animates the given list of properties of <em class="parameter"><code>actor</code></em>
between the current
value for each property and a new final value. The animation has a
definite duration given by <em class="parameter"><code>timeline</code></em>
and a speed given by the <em class="parameter"><code>mode</code></em>
.</p>
<p>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.</p>
<p>This function is useful if you want to use an existing timeline
to animate <em class="parameter"><code>actor</code></em>
.</p>
<div class="refsect3">
<a name="clutter-actor-animate-with-timeline.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>actor</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>mode</p></td>
<td class="parameter_description"><p>an animation mode logical id</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>timeline</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>first_property_name</p></td>
<td class="parameter_description"><p>the name of a property</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>...</p></td>
<td class="parameter_description"><p>a <code class="literal">NULL</code> terminated list of property names and
property values</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="clutter-actor-animate-with-timeline.returns"></a><h4>Returns</h4>
<p> a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> object. The object is
owned by the <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> and should not be unreferenced with
<code class="function">g_object_unref()</code>. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-actor-animate-with-alpha"></a><h3>clutter_actor_animate_with_alpha ()</h3>
<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>,
<em class="parameter"><code><a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a> *alpha</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *first_property_name</code></em>,
<em class="parameter"><code>...</code></em>);</pre>
<div class="warning">
<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.</p>
<p>Use the implicit transition for animatable properties
in <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> instead. See <a class="link" href="ClutterActor.html#clutter-actor-save-easing-state" title="clutter_actor_save_easing_state ()"><code class="function">clutter_actor_save_easing_state()</code></a>,
<a class="link" href="ClutterActor.html#clutter-actor-set-easing-mode" title="clutter_actor_set_easing_mode ()"><code class="function">clutter_actor_set_easing_mode()</code></a>, <a class="link" href="ClutterActor.html#clutter-actor-set-easing-duration" title="clutter_actor_set_easing_duration ()"><code class="function">clutter_actor_set_easing_duration()</code></a>,
<a class="link" href="ClutterActor.html#clutter-actor-set-easing-delay" title="clutter_actor_set_easing_delay ()"><code class="function">clutter_actor_set_easing_delay()</code></a>, and <a class="link" href="ClutterActor.html#clutter-actor-restore-easing-state" title="clutter_actor_restore_easing_state ()"><code class="function">clutter_actor_restore_easing_state()</code></a>.</p>
</div>
<p>Animates the given list of properties of <em class="parameter"><code>actor</code></em>
between the current
value for each property and a new final value. The animation has a
definite behaviour given by the passed <em class="parameter"><code>alpha</code></em>
.</p>
<p>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.</p>
<p>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>
to animate <em class="parameter"><code>actor</code></em>
.</p>
<div class="refsect3">
<a name="clutter-actor-animate-with-alpha.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>actor</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>alpha</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>first_property_name</p></td>
<td class="parameter_description"><p>the name of a property</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>...</p></td>
<td class="parameter_description"><p>a <code class="literal">NULL</code> terminated list of property names and
property values</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="clutter-actor-animate-with-alpha.returns"></a><h4>Returns</h4>
<p> a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> object. The object is owned by the
<a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> and should not be unreferenced with <code class="function">g_object_unref()</code>. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-actor-animatev"></a><h3>clutter_actor_animatev ()</h3>
<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>,
<em class="parameter"><code><span class="type">gulong</span> mode</code></em>,
<em class="parameter"><code><span class="type">guint</span> duration</code></em>,
<em class="parameter"><code><span class="type">gint</span> n_properties</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> * const properties[]</code></em>,
<em class="parameter"><code>const <span class="type">GValue</span> *values</code></em>);</pre>
<div class="warning">
<p><code class="literal">clutter_actor_animatev</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use the implicit transition for animatable properties
in <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> instead. See <a class="link" href="ClutterActor.html#clutter-actor-save-easing-state" title="clutter_actor_save_easing_state ()"><code class="function">clutter_actor_save_easing_state()</code></a>,
<a class="link" href="ClutterActor.html#clutter-actor-set-easing-mode" title="clutter_actor_set_easing_mode ()"><code class="function">clutter_actor_set_easing_mode()</code></a>, <a class="link" href="ClutterActor.html#clutter-actor-set-easing-duration" title="clutter_actor_set_easing_duration ()"><code class="function">clutter_actor_set_easing_duration()</code></a>,
<a class="link" href="ClutterActor.html#clutter-actor-set-easing-delay" title="clutter_actor_set_easing_delay ()"><code class="function">clutter_actor_set_easing_delay()</code></a>, and <a class="link" href="ClutterActor.html#clutter-actor-restore-easing-state" title="clutter_actor_restore_easing_state ()"><code class="function">clutter_actor_restore_easing_state()</code></a>.</p>
</div>
<p>Animates the given list of properties of <em class="parameter"><code>actor</code></em>
between the current
value for each property and a new final value. The animation has a
definite duration and a speed given by the <em class="parameter"><code>mode</code></em>
.</p>
<p>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
for language bindings.</p>
<p>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
allow you to specify "signal::" names and callbacks.</p>
<div class="refsect3">
<a name="clutter-actor-animatev.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>actor</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>mode</p></td>
<td class="parameter_description"><p>an animation mode logical id</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>duration</p></td>
<td class="parameter_description"><p>duration of the animation, in milliseconds</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>n_properties</p></td>
<td class="parameter_description"><p>number of property names and values</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>properties</p></td>
<td class="parameter_description"><p> a vector
containing the property names to set. </p></td>
<td class="parameter_annotations"><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></td>
</tr>
<tr>
<td class="parameter_name"><p>values</p></td>
<td class="parameter_description"><p> a vector containing the
property values to set. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_properties]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="clutter-actor-animatev.returns"></a><h4>Returns</h4>
<p> a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> object. The object is
owned by the <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> and should not be unreferenced with
<code class="function">g_object_unref()</code>. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-actor-animate-with-timelinev"></a><h3>clutter_actor_animate_with_timelinev ()</h3>
<pre class="programlisting"><a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="returnvalue">ClutterAnimation</span></a> *
clutter_actor_animate_with_timelinev (<em class="parameter"><code><a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> *actor</code></em>,
<em class="parameter"><code><span class="type">gulong</span> mode</code></em>,
<em class="parameter"><code><a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a> *timeline</code></em>,
<em class="parameter"><code><span class="type">gint</span> n_properties</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> * const properties[]</code></em>,
<em class="parameter"><code>const <span class="type">GValue</span> *values</code></em>);</pre>
<div class="warning">
<p><code class="literal">clutter_actor_animate_with_timelinev</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use the implicit transition for animatable properties
in <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> instead. See <a class="link" href="ClutterActor.html#clutter-actor-save-easing-state" title="clutter_actor_save_easing_state ()"><code class="function">clutter_actor_save_easing_state()</code></a>,
<a class="link" href="ClutterActor.html#clutter-actor-set-easing-mode" title="clutter_actor_set_easing_mode ()"><code class="function">clutter_actor_set_easing_mode()</code></a>, <a class="link" href="ClutterActor.html#clutter-actor-set-easing-duration" title="clutter_actor_set_easing_duration ()"><code class="function">clutter_actor_set_easing_duration()</code></a>,
<a class="link" href="ClutterActor.html#clutter-actor-set-easing-delay" title="clutter_actor_set_easing_delay ()"><code class="function">clutter_actor_set_easing_delay()</code></a>, and <a class="link" href="ClutterActor.html#clutter-actor-restore-easing-state" title="clutter_actor_restore_easing_state ()"><code class="function">clutter_actor_restore_easing_state()</code></a>.</p>
</div>
<p>Animates the given list of properties of <em class="parameter"><code>actor</code></em>
between the current
value for each property and a new final value. The animation has a
definite duration given by <em class="parameter"><code>timeline</code></em>
and a speed given by the <em class="parameter"><code>mode</code></em>
.</p>
<p>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.</p>
<p>This function is useful if you want to use an existing timeline
to animate <em class="parameter"><code>actor</code></em>
.</p>
<p>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>,
useful for language bindings.</p>
<p>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
will not allow you to specify "signal::" names and callbacks.</p>
<div class="refsect3">
<a name="clutter-actor-animate-with-timelinev.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>actor</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>mode</p></td>
<td class="parameter_description"><p>an animation mode logical id</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>timeline</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>n_properties</p></td>
<td class="parameter_description"><p>number of property names and values</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>properties</p></td>
<td class="parameter_description"><p> a vector
containing the property names to set. </p></td>
<td class="parameter_annotations"><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></td>
</tr>
<tr>
<td class="parameter_name"><p>values</p></td>
<td class="parameter_description"><p> a vector containing the
property values to set. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_properties]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="clutter-actor-animate-with-timelinev.returns"></a><h4>Returns</h4>
<p> a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> object. The object is
owned by the <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> and should not be unreferenced with
<code class="function">g_object_unref()</code>. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-actor-animate-with-alphav"></a><h3>clutter_actor_animate_with_alphav ()</h3>
<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>,
<em class="parameter"><code><a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a> *alpha</code></em>,
<em class="parameter"><code><span class="type">gint</span> n_properties</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> * const properties[]</code></em>,
<em class="parameter"><code>const <span class="type">GValue</span> *values</code></em>);</pre>
<div class="warning">
<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.</p>
<p>Use the implicit transition for animatable properties
in <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> instead. See <a class="link" href="ClutterActor.html#clutter-actor-save-easing-state" title="clutter_actor_save_easing_state ()"><code class="function">clutter_actor_save_easing_state()</code></a>,
<a class="link" href="ClutterActor.html#clutter-actor-set-easing-mode" title="clutter_actor_set_easing_mode ()"><code class="function">clutter_actor_set_easing_mode()</code></a>, <a class="link" href="ClutterActor.html#clutter-actor-set-easing-duration" title="clutter_actor_set_easing_duration ()"><code class="function">clutter_actor_set_easing_duration()</code></a>,
<a class="link" href="ClutterActor.html#clutter-actor-set-easing-delay" title="clutter_actor_set_easing_delay ()"><code class="function">clutter_actor_set_easing_delay()</code></a>, and <a class="link" href="ClutterActor.html#clutter-actor-restore-easing-state" title="clutter_actor_restore_easing_state ()"><code class="function">clutter_actor_restore_easing_state()</code></a>.</p>
</div>
<p>Animates the given list of properties of <em class="parameter"><code>actor</code></em>
between the current
value for each property and a new final value. The animation has a
definite behaviour given by the passed <em class="parameter"><code>alpha</code></em>
.</p>
<p>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.</p>
<p>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>
to animate <em class="parameter"><code>actor</code></em>
.</p>
<p>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>,
useful for language bindings.</p>
<p>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
not allow you to specify "signal::" names and callbacks.</p>
<div class="refsect3">
<a name="clutter-actor-animate-with-alphav.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>actor</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>alpha</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>n_properties</p></td>
<td class="parameter_description"><p>number of property names and values</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>properties</p></td>
<td class="parameter_description"><p> a vector
containing the property names to set. </p></td>
<td class="parameter_annotations"><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></td>
</tr>
<tr>
<td class="parameter_name"><p>values</p></td>
<td class="parameter_description"><p> a vector containing the
property values to set. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_properties]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="clutter-actor-animate-with-alphav.returns"></a><h4>Returns</h4>
<p> a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> object. The object is owned by the
<a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> and should not be unreferenced with <code class="function">g_object_unref()</code>. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-actor-get-animation"></a><h3>clutter_actor_get_animation ()</h3>
<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>
<div class="warning">
<p><code class="literal">clutter_actor_get_animation</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use the implicit transition for animatable properties
in <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> instead, and <a class="link" href="ClutterActor.html#clutter-actor-get-transition" title="clutter_actor_get_transition ()"><code class="function">clutter_actor_get_transition()</code></a> to retrieve
the transition.</p>
</div>
<p>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>
has been called on <em class="parameter"><code>actor</code></em>
.</p>
<div class="refsect3">
<a name="clutter-actor-get-animation.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>actor</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="clutter-actor-get-animation.returns"></a><h4>Returns</h4>
<p> a <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a>, or <code class="literal">NULL</code>. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="clutter-actor-detach-animation"></a><h3>clutter_actor_detach_animation ()</h3>
<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>
<div class="warning">
<p><code class="literal">clutter_actor_detach_animation</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use the implicit transition for animatable properties
in <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> instead, and <a class="link" href="ClutterActor.html#clutter-actor-remove-transition" title="clutter_actor_remove_transition ()"><code class="function">clutter_actor_remove_transition()</code></a> to
remove the transition.</p>
</div>
<p>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>
has been called on <em class="parameter"><code>actor</code></em>
.</p>
<p>Once the animation has been detached, it loses a reference. If it was
the only reference then the <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> becomes invalid.</p>
<p>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.</p>
<div class="refsect3">
<a name="clutter-actor-detach-animation.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>actor</p></td>
<td class="parameter_description"><p>a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-1.4">1.4</a></p>
</div>
</div>
<div class="refsect1">
<a name="clutter-Implicit-Animations.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="ClutterAnimation-struct"></a><h3>ClutterAnimation</h3>
<pre class="programlisting">typedef struct _ClutterAnimation ClutterAnimation;</pre>
<div class="warning">
<p><code class="literal">ClutterAnimation</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use the implicit animation on <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a></p>
</div>
<p>The <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation"><span class="type">ClutterAnimation</span></a> structure contains only private data and should
be accessed using the provided functions.</p>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="ClutterAnimationClass"></a><h3>struct ClutterAnimationClass</h3>
<pre class="programlisting">struct ClutterAnimationClass {
void (* started) (ClutterAnimation *animation);
void (* completed) (ClutterAnimation *animation);
};
</pre>
<div class="warning">
<p><code class="literal">ClutterAnimationClass</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use the implicit animation on <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a></p>
</div>
<p>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
should be accessed using the provided functions.</p>
<div class="refsect3">
<a name="ClutterAnimationClass.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="struct_members_name">
<col class="struct_members_description">
<col width="200px" class="struct_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="ClutterAnimationClass.started"></a>started</code></em> ()</p></td>
<td class="struct_member_description"><p>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</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="ClutterAnimationClass.completed"></a>completed</code></em> ()</p></td>
<td class="struct_member_description"><p>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</p></td>
<td class="struct_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
</div>
<div class="refsect1">
<a name="clutter-Implicit-Animations.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="ClutterAnimation--alpha"></a><h3>The <code class="literal">“alpha”</code> property</h3>
<pre class="programlisting"> “alpha” <a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a> *</pre>
<p>The <a class="link" href="ClutterAlpha.html" title="ClutterAlpha"><span class="type">ClutterAlpha</span></a> used by the animation.</p>
<div class="warning">
<p><code class="literal">ClutterAnimation:alpha</code> has been deprecated since version 1.10 and should not be used in newly-written code.</p>
<p>Use the <a class="link" href="clutter-Implicit-Animations.html#ClutterAnimation--timeline" title="The “timeline” property"><span class="type">“timeline”</span></a> property and
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>
</div>
<p>Flags: Read / Write</p>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="ClutterAnimation--duration"></a><h3>The <code class="literal">“duration”</code> property</h3>
<pre class="programlisting"> “duration” <span class="type">guint</span></pre>
<p>The duration of the animation, expressed in milliseconds.</p>
<div class="warning">
<p><code class="literal">ClutterAnimation:duration</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterPropertyTransition.html" title="ClutterPropertyTransition"><span class="type">ClutterPropertyTransition</span></a> instead</p>
</div>
<p>Flags: Read / Write</p>
<p>Default value: 0</p>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="ClutterAnimation--loop"></a><h3>The <code class="literal">“loop”</code> property</h3>
<pre class="programlisting"> “loop” <span class="type">gboolean</span></pre>
<p>Whether the animation should loop.</p>
<div class="warning">
<p><code class="literal">ClutterAnimation:loop</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterPropertyTransition.html" title="ClutterPropertyTransition"><span class="type">ClutterPropertyTransition</span></a> instead</p>
</div>
<p>Flags: Read / Write</p>
<p>Default value: FALSE</p>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="ClutterAnimation--mode"></a><h3>The <code class="literal">“mode”</code> property</h3>
<pre class="programlisting"> “mode” <span class="type">gulong</span></pre>
<p>The animation mode, either a value from <a class="link" href="ClutterTimeline.html#ClutterAnimationMode" title="enum ClutterAnimationMode"><span class="type">ClutterAnimationMode</span></a>
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
default value is <a class="link" href="ClutterTimeline.html#CLUTTER-LINEAR:CAPS"><code class="literal">CLUTTER_LINEAR</code></a>.</p>
<div class="warning">
<p><code class="literal">ClutterAnimation:mode</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterPropertyTransition.html" title="ClutterPropertyTransition"><span class="type">ClutterPropertyTransition</span></a> instead</p>
</div>
<p>Flags: Read / Write</p>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="ClutterAnimation--object"></a><h3>The <code class="literal">“object”</code> property</h3>
<pre class="programlisting"> “object” <span class="type">GObject</span> *</pre>
<p>The <span class="type">GObject</span> to which the animation applies.</p>
<div class="warning">
<p><code class="literal">ClutterAnimation:object</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterPropertyTransition.html" title="ClutterPropertyTransition"><span class="type">ClutterPropertyTransition</span></a> instead</p>
</div>
<p>Flags: Read / Write</p>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="ClutterAnimation--timeline"></a><h3>The <code class="literal">“timeline”</code> property</h3>
<pre class="programlisting"> “timeline” <a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a> *</pre>
<p>The <a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a> used by the animation.</p>
<div class="warning">
<p><code class="literal">ClutterAnimation:timeline</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterPropertyTransition.html" title="ClutterPropertyTransition"><span class="type">ClutterPropertyTransition</span></a> instead</p>
</div>
<p>Flags: Read / Write</p>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
</div>
<div class="refsect1">
<a name="clutter-Implicit-Animations.signal-details"></a><h2>Signal Details</h2>
<div class="refsect2">
<a name="ClutterAnimation-completed"></a><h3>The <code class="literal">“completed”</code> signal</h3>
<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,
<span class="type">gpointer</span> user_data)</pre>
<p>The ::completed signal is emitted once the animation has
been completed.</p>
<p>The <em class="parameter"><code>animation</code></em>
instance is guaranteed to be valid for the entire
duration of the signal emission chain.</p>
<div class="warning">
<p><code class="literal">ClutterAnimation::completed</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterPropertyTransition.html" title="ClutterPropertyTransition"><span class="type">ClutterPropertyTransition</span></a> instead</p>
</div>
<div class="refsect3">
<a name="ClutterAnimation-completed.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>animation</p></td>
<td class="parameter_description"><p>the animation that emitted the signal</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: Run Last</p>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="ClutterAnimation-started"></a><h3>The <code class="literal">“started”</code> signal</h3>
<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,
<span class="type">gpointer</span> user_data)</pre>
<p>The ::started signal is emitted once the animation has been
started</p>
<div class="warning">
<p><code class="literal">ClutterAnimation::started</code> has been deprecated since version 1.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="ClutterPropertyTransition.html" title="ClutterPropertyTransition"><span class="type">ClutterPropertyTransition</span></a> instead</p>
</div>
<div class="refsect3">
<a name="ClutterAnimation-started.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>animation</p></td>
<td class="parameter_description"><p>the animation that emitted the signal</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: Run Last</p>
<p class="since">Since: <a class="link" href="ix07.html#api-index-1.0">1.0</a></p>
</div>
</div>
<div class="refsect1">
<a name="clutter-Implicit-Animations.see-also"></a><h2>See Also</h2>
<p><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>,
<a class="link" href="ClutterTimeline.html" title="ClutterTimeline"><span class="type">ClutterTimeline</span></a></p>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.25.1</div>
</body>
</html>