docs: Document the AnimationMode definition

Both ClutterAlpha:mode and ClutterAnimation:mode can be defined using:

  • an integer id
  • the "nick" field of the AnimationMode GEnumValue
  • a custom, tweener-like string

All these methods should be documented.
This commit is contained in:
Emmanuele Bassi 2009-11-13 14:43:57 +00:00
parent c8d5703788
commit 49cd887aab
2 changed files with 67 additions and 2 deletions

View File

@ -75,10 +75,10 @@
* <example id="ClutterAlpha-script-example">
* <title>Defining a ClutterAlpha in ClutterScript</title>
* <para>The following JSON fragment defines a #ClutterAlpha
* using a #ClutterTimeline with id "timeline-01" and an alpha
* using a #ClutterTimeline with id "sine-timeline" and an alpha
* function called my_sine_alpha(). The defined #ClutterAlpha
* instance can be reused in multiple #ClutterBehaviour
* definitions.</para>
* definitions or for #ClutterAnimation definitions.</para>
* <programlisting>
* {
* "id" : "sine-alpha",
@ -91,6 +91,10 @@
* }
* </programlisting>
* </example>
* <para>For the way to define the #ClutterAlpha:mode property
* inside a ClutterScript fragment, see <link
* linkend="clutter-AnimationMode-Script">the corresponding section</link>
* in #ClutterAnimation.</para>
* </refsect2>
*
* Since: 0.2

View File

@ -68,6 +68,67 @@
* a #ClutterAnimation instance and animate an actor between its current
* state and the specified final state.
*
* <refsect2 id="clutter-AnimationMode-Script">
* <title>Defining ClutterAnimationMode inside ClutterScript</title>
* <para>When defining a #ClutterAnimation inside a ClutterScript
* file or string the #ClutterAnimation:mode can be defined either
* using the #ClutterAnimationMode enumeration values through their
* "nick" (the short string used inside #GEnumValue), their numeric
* id, or using the following strings:</para>
* <variablelist>
* <varlistentry>
* <term>easeInQuad, easeOutQuad, easeInOutQuad</term>
* <listitem><para>Corresponding to the quadratic easing
* modes</para></listitem>
* </varlistentry>
* <varlistentry>
* <term>easeInCubic, easeOutCubic, easeInOutCubic</term>
* <listitem><para>Corresponding to the cubic easing
* modes</para></listitem>
* </varlistentry>
* <varlistentry>
* <term>easeInQuart, easeOutQuart, easeInOutQuart</term>
* <listitem><para>Corresponding to the quartic easing
* modes</para></listitem>
* </varlistentry>
* <varlistentry>
* <term>easeInQuint, easeOutQuint, easeInOutQuint</term>
* <listitem><para>Corresponding to the quintic easing
* modes</para></listitem>
* </varlistentry>
* <varlistentry>
* <term>easeInSine, easeOutSine, easeInOutSine</term>
* <listitem><para>Corresponding to the sine easing
* modes</para></listitem>
* </varlistentry>
* <varlistentry>
* <term>easeInExpo, easeOutExpo, easeInOutExpo</term>
* <listitem><para>Corresponding to the exponential easing
* modes</para></listitem>
* </varlistentry>
* <varlistentry>
* <term>easeInCirc, easeOutCirc, easeInOutCirc</term>
* <listitem><para>Corresponding to the circular easing
* modes</para></listitem>
* </varlistentry>
* <varlistentry>
* <term>easeInElastic, easeOutElastic, easeInOutElastic</term>
* <listitem><para>Corresponding to the overshooting elastic
* easing modes</para></listitem>
* </varlistentry>
* <varlistentry>
* <term>easeInBack, easeOutBack, easeInOutBack</term>
* <listitem><para>Corresponding to the overshooting cubic
* easing modes</para></listitem>
* </varlistentry>
* <varlistentry>
* <term>easeInBounce, easeOutBounce, easeInOutBounce</term>
* <listitem><para>Corresponding to the bouncing easing
* modes</para></listitem>
* </varlistentry>
* </variablelist>
* </refsect2>
*
* #ClutterAnimation is available since Clutter 1.0
*/