RubyGems - clutter - Versions diffs - 2.2.0-x86-mingw32 → 2.2.1-x86-mingw32 - Mend

clutter 2.2.0-x86-mingw32 → 2.2.1-x86-mingw32

Files changed (631) hide show

data/vendor/local/share/gtk-doc/html/clutter/ClutterConstraint.html CHANGED Viewed

@@ -8,17 +8,15 @@
 <link rel="up" href="ch01.html" title="Abstract classes and interfaces">
 <link rel="prev" href="ClutterAction.html" title="ClutterAction">
 <link rel="next" href="ClutterEffect.html" title="ClutterEffect">
-<meta name="generator" content="GTK-Doc V1.19.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.20.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="10"><tr valign="middle">
-<td width="100%" align="left">
-<a href="#" class="shortcut">Top</a>
-                   |
-                  <a href="#ClutterConstraint.description" class="shortcut">Description</a>
-                   |
-                  <a href="#ClutterConstraint.object-hierarchy" class="shortcut">Object Hierarchy</a>
+<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="#ClutterConstraint.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span>
+                  <a href="#ClutterConstraint.object-hierarchy" class="shortcut">Object Hierarchy</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="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
@@ -32,302 +30,179 @@
 <h2><span class="refentrytitle"><a name="ClutterConstraint.top_of_page"></a>ClutterConstraint</span></h2>
 <p>ClutterConstraint — Abstract class for constraints on position or size</p>
 </td>
-<td valign="top" align="right"></td>
+<td class="gallery_image" valign="top" align="right"></td>
 </tr></table></div>
-<div class="refsynopsisdiv">
-<a name="ClutterConstraint.synopsis"></a><h2>Synopsis</h2>
-<pre class="synopsis">                    <a class="link" href="ClutterConstraint.html#ClutterConstraint-struct" title="ClutterConstraint">ClutterConstraint</a>;
-struct              <a class="link" href="ClutterConstraint.html#ClutterConstraintClass" title="struct ClutterConstraintClass">ClutterConstraintClass</a>;
-</pre>
+<div class="refsect1">
+<a name="ClutterConstraint.other"></a><h2>Types and Values</h2>
+<div class="informaltable"><table 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="ClutterConstraint.html#ClutterConstraint-struct" title="ClutterConstraint">ClutterConstraint</a></td>
+</tr>
+<tr>
+<td class="datatype_keyword">struct</td>
+<td class="function_name"><a class="link" href="ClutterConstraint.html#ClutterConstraintClass" title="struct ClutterConstraintClass">ClutterConstraintClass</a></td>
+</tr>
+</tbody>
+</table></div>
 </div>
 <div class="refsect1">
 <a name="ClutterConstraint.object-hierarchy"></a><h2>Object Hierarchy</h2>
-<pre class="synopsis">
-  GObject
-   +----GInitiallyUnowned
-         +----<a class="link" href="ClutterActorMeta.html" title="ClutterActorMeta">ClutterActorMeta</a>
-               +----ClutterConstraint
-                     +----<a class="link" href="ClutterAlignConstraint.html" title="ClutterAlignConstraint">ClutterAlignConstraint</a>
-                     +----<a class="link" href="ClutterBindConstraint.html" title="ClutterBindConstraint">ClutterBindConstraint</a>
-                     +----<a class="link" href="ClutterPathConstraint.html" title="ClutterPathConstraint">ClutterPathConstraint</a>
-                     +----<a class="link" href="ClutterSnapConstraint.html" title="ClutterSnapConstraint">ClutterSnapConstraint</a>
+<pre class="screen">    GObject
+    <span class="lineart">╰──</span> GInitiallyUnowned
+        <span class="lineart">╰──</span> <a class="link" href="ClutterActorMeta.html" title="ClutterActorMeta">ClutterActorMeta</a>
+            <span class="lineart">╰──</span> ClutterConstraint
+                <span class="lineart">├──</span> <a class="link" href="ClutterAlignConstraint.html" title="ClutterAlignConstraint">ClutterAlignConstraint</a>
+                <span class="lineart">├──</span> <a class="link" href="ClutterBindConstraint.html" title="ClutterBindConstraint">ClutterBindConstraint</a>
+                <span class="lineart">├──</span> <a class="link" href="ClutterPathConstraint.html" title="ClutterPathConstraint">ClutterPathConstraint</a>
+                <span class="lineart">╰──</span> <a class="link" href="ClutterSnapConstraint.html" title="ClutterSnapConstraint">ClutterSnapConstraint</a>
 </pre>
 </div>
 <div class="refsect1">
 <a name="ClutterConstraint.description"></a><h2>Description</h2>
-<p>
-<a class="link" href="ClutterConstraint.html" title="ClutterConstraint"><span class="type">ClutterConstraint</span></a> is a base abstract class for modifiers of a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a>
-position or size.
-</p>
-<p>
-A <a class="link" href="ClutterConstraint.html" title="ClutterConstraint"><span class="type">ClutterConstraint</span></a> sub-class should contain the logic for modifying
+<p><a class="link" href="ClutterConstraint.html" title="ClutterConstraint"><span class="type">ClutterConstraint</span></a> is a base abstract class for modifiers of a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a>
+position or size.</p>
+<p>A <a class="link" href="ClutterConstraint.html" title="ClutterConstraint"><span class="type">ClutterConstraint</span></a> sub-class should contain the logic for modifying
 the position or size of the <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> to which it is applied, by
 updating the actor's allocation. Each <a class="link" href="ClutterConstraint.html" title="ClutterConstraint"><span class="type">ClutterConstraint</span></a> can change the
 allocation of the actor to which they are applied by overriding the
-<code class="function">ClutterConstraintClass.update_allocation()</code> virtual function.
-</p>
-<p>
-</p>
-<div class="refsect2">
-<a name="ClutterConstraint-usage"></a><h3>Using Constraints</h3>
+<a class="link" href="ClutterConstraint.html#ClutterConstraintClass.update-allocation"><code class="function">ClutterConstraintClass.update_allocation()</code></a> virtual function.</p>
+<p><a class="link" href="ClutterConstraint.html" title="ClutterConstraint"><span class="type">ClutterConstraint</span></a> is available since Clutter 1.4</p>
+<div class="refsect3">
+<a name="id-1.5.2.10.5.5"></a><h4>Using Constraints</h4>
 <p>Constraints can be used with fixed layout managers, like
-  <a class="link" href="ClutterFixedLayout.html" title="ClutterFixedLayout"><span class="type">ClutterFixedLayout</span></a>, or with actors implicitly using a fixed layout
-  manager, like <a class="link" href="ClutterGroup.html" title="ClutterGroup"><span class="type">ClutterGroup</span></a> and <a class="link" href="ClutterStage.html" title="ClutterStage"><span class="type">ClutterStage</span></a>.</p>
+<a class="link" href="ClutterFixedLayout.html" title="ClutterFixedLayout"><span class="type">ClutterFixedLayout</span></a>, or with actors implicitly using a fixed layout
+manager, like <a class="link" href="ClutterGroup.html" title="ClutterGroup"><span class="type">ClutterGroup</span></a> and <a class="link" href="ClutterStage.html" title="ClutterStage"><span class="type">ClutterStage</span></a>.</p>
 <p>Constraints provide a way to build user interfaces by using
-  relations between <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a>s, without explicit fixed
-  positioning and sizing, similarly to how fluid layout managers like
-  <a class="link" href="ClutterBoxLayout.html" title="ClutterBoxLayout"><span class="type">ClutterBoxLayout</span></a> and <a class="link" href="ClutterTableLayout.html" title="ClutterTableLayout"><span class="type">ClutterTableLayout</span></a> lay out their children.</p>
+relations between <a href="ClutterActor.html"><span class="type">ClutterActors</span></a>, without explicit fixed
+positioning and sizing, similarly to how fluid layout managers like
+<a class="link" href="ClutterBoxLayout.html" title="ClutterBoxLayout"><span class="type">ClutterBoxLayout</span></a> and <a class="link" href="ClutterTableLayout.html" title="ClutterTableLayout"><span class="type">ClutterTableLayout</span></a> lay out their children.</p>
 <p>Constraints are attached to a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a>, and are available
-  for inspection using <a class="link" href="ClutterActor.html#clutter-actor-get-constraints" title="clutter_actor_get_constraints ()"><code class="function">clutter_actor_get_constraints()</code></a>.</p>
+for inspection using <a class="link" href="ClutterActor.html#clutter-actor-get-constraints" title="clutter_actor_get_constraints ()"><code class="function">clutter_actor_get_constraints()</code></a>.</p>
 <p>Clutter provides different implementation of the <a class="link" href="ClutterConstraint.html" title="ClutterConstraint"><span class="type">ClutterConstraint</span></a>
-  abstract class, for instance:</p>
-<div class="variablelist"><table border="0" class="variablelist">
-<colgroup>
-<col align="left" valign="top">
-<col>
-</colgroup>
-<tbody>
-<tr>
-<td><p><span class="term"><a class="link" href="ClutterAlignConstraint.html" title="ClutterAlignConstraint"><span class="type">ClutterAlignConstraint</span></a></span></p></td>
-<td>this constraint can be used to align an actor
-      to another one, on either the horizontal or the vertical axis; the
-      <a class="link" href="ClutterAlignConstraint.html" title="ClutterAlignConstraint"><span class="type">ClutterAlignConstraint</span></a> uses a normalized offset between 0.0 (the
-      top or the left of the source actor, depending on the axis) and
-      1.0 (the bottom or the right of the source actor, depending on the
-      axis).</td>
-</tr>
-<tr>
-<td><p><span class="term"><a class="link" href="ClutterBindConstraint.html" title="ClutterBindConstraint"><span class="type">ClutterBindConstraint</span></a></span></p></td>
-<td>this constraint binds the X, Y, width or height
-      of an actor to the corresponding position or size of a source
-      actor; it can also apply an offset.</td>
-</tr>
-<tr>
-<td><p><span class="term"><a class="link" href="ClutterSnapConstraint.html" title="ClutterSnapConstraint"><span class="type">ClutterSnapConstraint</span></a></span></p></td>
-<td>this constraint "snaps" together the edges of
-      two <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a>s; if an actor uses two constraints on
-      both its horizontal or vertical edges then it can also expand to
-      fit the empty space.</td>
-</tr>
-</tbody>
-</table></div>
-<div class="example">
-<a name="ClutterConstraint-usage-example"></a><p class="title"><b>Example 2. Usage of constraints</b></p>
-<div class="example-contents">
-<p>The example below uses various <a class="link" href="ClutterConstraint.html" title="ClutterConstraint"><span class="type">ClutterConstraint</span></a>s to
-    lay out three actors on a resizable stage. Only the central actor has
-    an explicit size, and no actor has an explicit position.</p>
-<div class="orderedlist"><ol class="orderedlist" type="1">
-<li class="listitem">The <a class="link" href="ClutterRectangle.html" title="ClutterRectangle"><span class="type">ClutterRectangle</span></a> with <a class="link" href="ClutterActor.html#ClutterActor--name" title='The "name" property'><span class="type">"name"</span></a>
-      <span class="emphasis"><em>layerA</em></span> is explicitly sized to 100 pixels by 25
-      pixels, and it's added to the <a class="link" href="ClutterStage.html" title="ClutterStage"><span class="type">ClutterStage</span></a>;</li>
-<li class="listitem">two <a class="link" href="ClutterAlignConstraint.html" title="ClutterAlignConstraint"><span class="type">ClutterAlignConstraint</span></a>s are used
-      to anchor <span class="emphasis"><em>layerA</em></span> to the center of the stage,
-      by using 0.5 as the alignment <a class="link" href="ClutterAlignConstraint.html#ClutterAlignConstraint--factor" title='The "factor" property'><span class="type">"factor"</span></a> on
-      both the X and Y axis.</li>
-<li class="listitem">the <a class="link" href="ClutterRectangle.html" title="ClutterRectangle"><span class="type">ClutterRectangle</span></a> with <a class="link" href="ClutterActor.html#ClutterActor--name" title='The "name" property'><span class="type">"name"</span></a>
-      <span class="emphasis"><em>layerB</em></span> is added to the <a class="link" href="ClutterStage.html" title="ClutterStage"><span class="type">ClutterStage</span></a> with
-      no explicit size;</li>
-<li class="listitem">the <a class="link" href="ClutterActor.html#ClutterActor--x" title='The "x" property'><span class="type">"x"</span></a> and <a class="link" href="ClutterActor.html#ClutterActor--width" title='The "width" property'><span class="type">"width"</span></a>
-      of <span class="emphasis"><em>layerB</em></span> are bound to the same properties
-      of <span class="emphasis"><em>layerA</em></span> using two <a class="link" href="ClutterBindConstraint.html" title="ClutterBindConstraint"><span class="type">ClutterBindConstraint</span></a>
-      objects, thus keeping <span class="emphasis"><em>layerB</em></span> aligned to
-      <span class="emphasis"><em>layerA</em></span>;</li>
-<li class="listitem">the top edge of <span class="emphasis"><em>layerB</em></span> is
-      snapped together with the bottom edge of <span class="emphasis"><em>layerA</em></span>;
-      the bottom edge of <span class="emphasis"><em>layerB</em></span> is also snapped
-      together with the bottom edge of the <a class="link" href="ClutterStage.html" title="ClutterStage"><span class="type">ClutterStage</span></a>; an offset is
-      given to the two <a class="link" href="ClutterSnapConstraint.html" title="ClutterSnapConstraint"><span class="type">ClutterSnapConstraint</span></a>s to allow for some
-      padding; since <span class="emphasis"><em>layerB</em></span> is snapped between two
-      different <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a>s, its height is stretched to match
-      the gap;</li>
-<li class="listitem">the <a class="link" href="ClutterRectangle.html" title="ClutterRectangle"><span class="type">ClutterRectangle</span></a> with <a class="link" href="ClutterActor.html#ClutterActor--name" title='The "name" property'><span class="type">"name"</span></a>
-      <span class="emphasis"><em>layerC</em></span> mirrors <span class="emphasis"><em>layerB</em></span>,
-      snapping the top edge of the <a class="link" href="ClutterStage.html" title="ClutterStage"><span class="type">ClutterStage</span></a> to the top edge of
-      <span class="emphasis"><em>layerC</em></span> and the top edge of
-      <span class="emphasis"><em>layerA</em></span> to the bottom edge of
-      <span class="emphasis"><em>layerC</em></span>;</li>
-</ol></div>
-<div class="figure">
-<a name="constraints-example"></a><p class="title"><b>Figure 3. Constraints</b></p>
-<div class="figure-contents"><div><img src="constraints-example.png" alt="Constraints"></div></div>
-</div>
-<br class="figure-break"><pre class="programlisting">
-#include &lt;stdlib.h&gt;
-#include &lt;clutter/clutter.h&gt;
-int
-main (int argc, char *argv[])
-{
-  ClutterActor *stage, *layer_a, *layer_b, *layer_c;
-  if (clutter_init (&amp;argc, &amp;argv) != CLUTTER_INIT_SUCCESS)
-    return 1;
-  /* the main container */
-  stage = clutter_stage_new ();
-  clutter_actor_set_name (stage, "stage");
-  clutter_stage_set_title (CLUTTER_STAGE (stage), "Snap Constraint");
-  clutter_actor_set_background_color (stage, CLUTTER_COLOR_Aluminium1);
-  clutter_stage_set_user_resizable (CLUTTER_STAGE (stage), TRUE);
-  g_signal_connect (stage, "destroy", G_CALLBACK (clutter_main_quit), NULL);
-  /* first layer, with a fixed (100, 25) size */
-  layer_a = clutter_actor_new ();
-  clutter_actor_set_background_color (layer_a, CLUTTER_COLOR_ScarletRed);
-  clutter_actor_set_name (layer_a, "layerA");
-  clutter_actor_set_size (layer_a, 100.0, 25.0);
-  clutter_actor_add_child (stage, layer_a);
-  /* the first layer is anchored to the middle of the stage */
-  clutter_actor_add_constraint (layer_a, clutter_align_constraint_new (stage, CLUTTER_ALIGN_BOTH, 0.5));
-  /* second layer, with no implicit size */
-  layer_b = clutter_actor_new ();
-  clutter_actor_set_background_color (layer_b, CLUTTER_COLOR_DarkButter);
-  clutter_actor_set_name (layer_b, "layerB");
-  clutter_actor_add_child (stage, layer_b);
-  /* the second layer tracks the X coordinate and the width of
-   * the first layer
-   */
-  clutter_actor_add_constraint (layer_b, clutter_bind_constraint_new (layer_a, CLUTTER_BIND_X, 0.0));
-  clutter_actor_add_constraint (layer_b, clutter_bind_constraint_new (layer_a, CLUTTER_BIND_WIDTH, 0.0));
-  /* the second layer is snapped between the bottom edge of
-   * the first layer, and the bottom edge of the stage; a
-   * spacing of 10 pixels in each direction is added for padding
-   */
-  clutter_actor_add_constraint (layer_b,
-                                clutter_snap_constraint_new (layer_a,
-                                                             CLUTTER_SNAP_EDGE_TOP,
-                                                             CLUTTER_SNAP_EDGE_BOTTOM,
-                                                             10.0));
-  clutter_actor_add_constraint (layer_b,
-                                clutter_snap_constraint_new (stage,
-                                                             CLUTTER_SNAP_EDGE_BOTTOM,
-                                                             CLUTTER_SNAP_EDGE_BOTTOM,
-                                                             -10.0));
-  /* the third layer, with no implicit size */
-  layer_c = clutter_actor_new ();
-  clutter_actor_set_background_color (layer_c, CLUTTER_COLOR_LightChameleon);
-  clutter_actor_set_name (layer_c, "layerC");
-  clutter_actor_add_child (stage, layer_c);
-  /* as for the second layer, the third layer tracks the X
-   * coordinate and width of the first layer
-   */
-  clutter_actor_add_constraint (layer_c, clutter_bind_constraint_new (layer_a, CLUTTER_BIND_X, 0.0));
-  clutter_actor_add_constraint (layer_c, clutter_bind_constraint_new (layer_a, CLUTTER_BIND_WIDTH, 0.0));
-  /* the third layer is snapped between the top edge of the stage
-   * and the top edge of the first layer; again, a spacing of
-   * 10 pixels in each direction is added for padding
-   */
-  clutter_actor_add_constraint (layer_c,
-                                clutter_snap_constraint_new (layer_a,
-                                                             CLUTTER_SNAP_EDGE_BOTTOM,
-                                                             CLUTTER_SNAP_EDGE_TOP,
-                                                             -10.0));
-  clutter_actor_add_constraint (layer_c,
-                                clutter_snap_constraint_new (stage,
-                                                             CLUTTER_SNAP_EDGE_TOP,
-                                                             CLUTTER_SNAP_EDGE_TOP,
-                                                             10.0));
-  clutter_actor_show (stage);
-  clutter_main ();
-  return EXIT_SUCCESS;
-}
-    </pre>
+abstract class, for instance:</p>
+<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
+<li class="listitem"><p><a class="link" href="ClutterAlignConstraint.html" title="ClutterAlignConstraint"><span class="type">ClutterAlignConstraint</span></a>, a constraint that can be used to align
+an actor to another one on either the horizontal or the vertical
+axis, using a normalized value between 0 and 1.</p></li>
+<li class="listitem"><p><a class="link" href="ClutterBindConstraint.html" title="ClutterBindConstraint"><span class="type">ClutterBindConstraint</span></a>, a constraint binds the X, Y, width or height
+of an actor to the corresponding position or size of a source actor,
+with or without an offset.</p></li>
+<li class="listitem"><p><a class="link" href="ClutterSnapConstraint.html" title="ClutterSnapConstraint"><span class="type">ClutterSnapConstraint</span></a>, a constraint that "snaps" together the edges
+of two <a href="ClutterActor.html"><span class="type">ClutterActors</span></a>; if an actor uses two constraints on both its
+horizontal or vertical edges then it can also expand to fit the empty
+space.</p></li>
+</ul></div>
+<p>The <a class="ulink" href="https://git.gnome.org/browse/clutter/tree/examples/constraints.c?h=clutter-1.18" target="_top">constraints example</a>
+uses various types of <a href="ClutterConstraint.html"><span class="type">ClutterConstraints</span></a> to lay out three actors on a
+resizable stage. Only the central actor has an explicit size, and no
+actor has an explicit position.</p>
+<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
+<li class="listitem"><p>The <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> with <a class="link" href="ClutterActor.html#ClutterActor--name" title="The “name” property"><span class="type">“name”</span></a> <code class="literal">layerA</code> is explicitly
+sized to 100 pixels by 25 pixels, and it's added to the <a class="link" href="ClutterStage.html" title="ClutterStage"><span class="type">ClutterStage</span></a></p></li>
+<li class="listitem"><p>two <a href="ClutterAlignConstraint.html"><span class="type">ClutterAlignConstraints</span></a> are used to anchor <code class="literal">layerA</code> to the
+center of the stage, by using 0.5 as the alignment <a class="link" href="ClutterAlignConstraint.html#ClutterAlignConstraint--factor" title="The “factor” property"><span class="type">“factor”</span></a> on
+both the X and Y axis</p></li>
+<li class="listitem"><p>the <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> with <a class="link" href="ClutterActor.html#ClutterActor--name" title="The “name” property"><span class="type">“name”</span></a> <code class="literal">layerB</code> is added to the
+<a class="link" href="ClutterStage.html" title="ClutterStage"><span class="type">ClutterStage</span></a> with no explicit size</p></li>
+<li class="listitem"><p>the <a class="link" href="ClutterActor.html#ClutterActor--x" title="The “x” property"><span class="type">“x”</span></a> and <a class="link" href="ClutterActor.html#ClutterActor--width" title="The “width” property"><span class="type">“width”</span></a> of <code class="literal">layerB</code> are bound
+to the same properties of <code class="literal">layerA</code> using two <a class="link" href="ClutterBindConstraint.html" title="ClutterBindConstraint"><span class="type">ClutterBindConstraint</span></a>
+objects, thus keeping <code class="literal">layerB</code> aligned to <code class="literal">layerA</code></p></li>
+<li class="listitem"><p>the top edge of <code class="literal">layerB</code> is snapped together with the bottom edge
+of <code class="literal">layerA</code>; the bottom edge of <code class="literal">layerB</code> is also snapped together with
+the bottom edge of the <a class="link" href="ClutterStage.html" title="ClutterStage"><span class="type">ClutterStage</span></a>; an offset is  given to the two
+<span class="type">ClutterSnapConstraintss</span> to allow for some padding; since <code class="literal">layerB</code> is
+snapped between two different <a href="ClutterActor.html"><span class="type">ClutterActors</span></a>, its height is stretched
+to match the gap</p></li>
+<li class="listitem"><p>the <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> with <a class="link" href="ClutterActor.html#ClutterActor--name" title="The “name” property"><span class="type">“name”</span></a> <code class="literal">layerC</code> mirrors <code class="literal">layerB</code>,
+snapping the top edge of the <a class="link" href="ClutterStage.html" title="ClutterStage"><span class="type">ClutterStage</span></a> to the top edge of <code class="literal">layerC</code>
+and the top edge of <code class="literal">layerA</code> to the bottom edge of <code class="literal">layerC</code></p></li>
+</ul></div>
 <p>You can try resizing interactively the <a class="link" href="ClutterStage.html" title="ClutterStage"><span class="type">ClutterStage</span></a> and verify
-    that the three <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a>s maintain the same position and
-    size relative to each other, and to the <a class="link" href="ClutterStage.html" title="ClutterStage"><span class="type">ClutterStage</span></a>.</p>
-</div>
-</div>
-<br class="example-break"><div class="warning">
-<h3 class="title">Warning</h3>
-<p>It's important to note that Clutter does not avoid loops
-  or competing constraints; if two or more <a class="link" href="ClutterConstraint.html" title="ClutterConstraint"><span class="type">ClutterConstraint</span></a>s
-  are operating on the same positional or dimensional attributes of an
-  actor, or if the constraints on two different actors depend on each
-  other, then the behavior is undefined.</p>
-</div>
+that the three <a href="ClutterActor.html"><span class="type">ClutterActors</span></a> maintain the same position and
+size relative to each other, and to the <a class="link" href="ClutterStage.html" title="ClutterStage"><span class="type">ClutterStage</span></a>.</p>
+<p>It is important to note that Clutter does not avoid loops or
+competing constraints; if two or more <a href="ClutterConstraint.html"><span class="type">ClutterConstraints</span></a>
+are operating on the same positional or dimensional attributes of an
+actor, or if the constraints on two different actors depend on each
+other, then the behavior is undefined.</p>
 </div>
-<p>
-</p>
-<p>
-</p>
-<div class="refsect2">
-<a name="ClutterConstraint-implementation"></a><h3>Implementing a ClutterConstraint</h3>
+<div class="refsect3">
+<a name="id-1.5.2.10.5.6"></a><h4>Implementing a ClutterConstraint</h4>
 <p>Creating a sub-class of <a class="link" href="ClutterConstraint.html" title="ClutterConstraint"><span class="type">ClutterConstraint</span></a> requires the
-  implementation of the <code class="function"><code class="function">update_allocation()</code></code>
-  virtual function.</p>
-<p>The <code class="function"><code class="function">update_allocation()</code></code> virtual function
-  is called during the allocation sequence of a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a>, and
-  allows any <a class="link" href="ClutterConstraint.html" title="ClutterConstraint"><span class="type">ClutterConstraint</span></a> attached to that actor to modify the
-  allocation before it is passed to the <code class="function"><code class="function">allocate()</code></code>
-  implementation.</p>
-<p>The <a class="link" href="clutter-Base-geometric-types.html#ClutterActorBox" title="struct ClutterActorBox"><span class="type">ClutterActorBox</span></a> passed to the
-  <code class="function"><code class="function">update_allocation()</code></code> implementation contains the
-  original allocation of the <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a>, plus the eventual modifications
-  applied by the other <a class="link" href="ClutterConstraint.html" title="ClutterConstraint"><span class="type">ClutterConstraint</span></a>s.</p>
-<div class="note">
-<h3 class="title">Note</h3>
-<p>Constraints are queried in the same order as they were
-  applied using <a class="link" href="ClutterActor.html#clutter-actor-add-constraint" title="clutter_actor_add_constraint ()"><code class="function">clutter_actor_add_constraint()</code></a> or
-  <a class="link" href="ClutterActor.html#clutter-actor-add-constraint-with-name" title="clutter_actor_add_constraint_with_name ()"><code class="function">clutter_actor_add_constraint_with_name()</code></a>.</p>
-</div>
+implementation of the <a class="link" href="ClutterConstraint.html#ClutterConstraintClass.update-allocation"><code class="function">ClutterConstraintClass.update_allocation()</code></a>
+virtual function.</p>
+<p>The <code class="literal"><code class="function">update_allocation()</code></code> virtual function is called during the
+allocation sequence of a <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a>, and allows any <a class="link" href="ClutterConstraint.html" title="ClutterConstraint"><span class="type">ClutterConstraint</span></a>
+attached to that actor to modify the allocation before it is passed to
+the actor's <a class="link" href="ClutterActor.html#ClutterActorClass.allocate"><code class="function">ClutterActorClass.allocate()</code></a> implementation.</p>
+<p>The <a class="link" href="clutter-Base-geometric-types.html#ClutterActorBox" title="struct ClutterActorBox"><span class="type">ClutterActorBox</span></a> passed to the <code class="literal"><code class="function">update_allocation()</code></code> implementation
+contains the original allocation of the <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a>, plus the eventual
+modifications applied by the other <a href="ClutterConstraint.html"><span class="type">ClutterConstraints</span></a>, in the same order
+the constraints have been applied to the actor.</p>
 <p>It is not necessary for a <a class="link" href="ClutterConstraint.html" title="ClutterConstraint"><span class="type">ClutterConstraint</span></a> sub-class to chain
-  up to the parent's implementation.</p>
+up to the parent's implementation.</p>
 <p>If a <a class="link" href="ClutterConstraint.html" title="ClutterConstraint"><span class="type">ClutterConstraint</span></a> is parametrized - i.e. if it contains
-  properties that affect the way the constraint is implemented - it should
-  call <a class="link" href="ClutterActor.html#clutter-actor-queue-relayout" title="clutter_actor_queue_relayout ()"><code class="function">clutter_actor_queue_relayout()</code></a> on the actor to which it is attached
-  to whenever any parameter is changed. The actor to which it is attached
-  can be recovered at any point using <a class="link" href="ClutterActorMeta.html#clutter-actor-meta-get-actor" title="clutter_actor_meta_get_actor ()"><code class="function">clutter_actor_meta_get_actor()</code></a>.</p>
+properties that affect the way the constraint is implemented - it should
+call <a class="link" href="ClutterActor.html#clutter-actor-queue-relayout" title="clutter_actor_queue_relayout ()"><code class="function">clutter_actor_queue_relayout()</code></a> on the actor to which it is attached
+to whenever any parameter is changed. The actor to which it is attached
+can be recovered at any point using <a class="link" href="ClutterActorMeta.html#clutter-actor-meta-get-actor" title="clutter_actor_meta_get_actor ()"><code class="function">clutter_actor_meta_get_actor()</code></a>.</p>
 </div>
-<p>
-</p>
-<p>
-<a class="link" href="ClutterConstraint.html" title="ClutterConstraint"><span class="type">ClutterConstraint</span></a> is available since Clutter 1.4
-</p>
 </div>
 <div class="refsect1">
-<a name="ClutterConstraint.details"></a><h2>Details</h2>
+<a name="ClutterConstraint.functions_details"></a><h2>Functions</h2>
+</div>
+<div class="refsect1">
+<a name="ClutterConstraint.other_details"></a><h2>Types and Values</h2>
 <div class="refsect2">
 <a name="ClutterConstraint-struct"></a><h3>ClutterConstraint</h3>
 <pre class="programlisting">typedef struct _ClutterConstraint ClutterConstraint;</pre>
-<p>
-The <span class="structname">ClutterConstraint</span> structure contains only
-private data and should be accessed using the provided API
-</p>
+<p>The <a class="link" href="ClutterConstraint.html" title="ClutterConstraint"><span class="type">ClutterConstraint</span></a> structure contains only
+private data and should be accessed using the provided API</p>
 <p class="since">Since 1.4</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="ClutterConstraintClass"></a><h3>struct ClutterConstraintClass</h3>
 <pre class="programlisting">struct ClutterConstraintClass {
+  void (* update_allocation) (ClutterConstraint *constraint,
+                              ClutterActor      *actor,
+                              ClutterActorBox   *allocation);
 };
 </pre>
-<p>
-The <span class="structname">ClutterConstraintClass</span> structure contains
-only private data
-</p>
+<p>The <a class="link" href="ClutterConstraint.html#ClutterConstraintClass" title="struct ClutterConstraintClass"><span class="type">ClutterConstraintClass</span></a> structure contains
+only private data</p>
+<div class="refsect3">
+<a name="id-1.5.2.10.7.3.5"></a><h4>Members</h4>
+<div class="informaltable"><table 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="ClutterConstraintClass.update-allocation"></a>update_allocation</code></em> ()</p></td>
+<td class="struct_member_description"><p>virtual function used to update the allocation
+of the <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a> using the <a class="link" href="ClutterConstraint.html" title="ClutterConstraint"><span class="type">ClutterConstraint</span></a></p></td>
+<td class="struct_member_annotations"> </td>
+</tr></tbody>
+</table></div>
+</div>
 <p class="since">Since 1.4</p>
 </div>
 </div>
 <div class="refsect1">
 <a name="ClutterConstraint.see-also"></a><h2>See Also</h2>
-<a class="link" href="ClutterAction.html" title="ClutterAction"><span class="type">ClutterAction</span></a>
+<p><a class="link" href="ClutterAction.html" title="ClutterAction"><span class="type">ClutterAction</span></a></p>
 </div>
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.19.1</div>
+          Generated by GTK-Doc V1.20.1</div>
 </body>
 </html>