doc/reference/clutter/html/go01.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <title>Glossary</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
   7 <link rel="home" href="index.html" title="Clutter Reference Manual">
   8 <link rel="up" href="clutterglossary.html" title="Part XII. Glossaries">
   9 <link rel="prev" href="clutterglossary.html" title="Part XII. Glossaries">
  10 <link rel="next" href="annotation-glossary.html" title="Annotation Glossary">
  11 <meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 </head>
  14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
  16 <td><a accesskey="p" href="clutterglossary.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  17 <td><a accesskey="u" href="clutterglossary.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  18 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  19 <th width="100%" align="center">Clutter Reference Manual</th>
  20 <td><a accesskey="n" href="annotation-glossary.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  21 </tr></table>
  22 <div class="glossary">
  23 <div class="titlepage"><div><div><h2 class="title">
  24 <a name="id930120"></a>Glossary</h2></div></div></div>
  25 <dl>
  26 <dt>
  27 <a name="actor"></a>actor</dt>
  28 <dd><p>An item on the <a class="glossterm" href="go01.html#scenegraph"><em class="glossterm">scenegraph</em></a>. Every
  29       actor has a <a class="glossterm" href="go01.html#parent"><em class="glossterm">parent</em></a>, except the <a class="glossterm" href="go01.html#stage"><em class="glossterm">stage</em></a>, and some actors can be <a class="glossterm" href="go01.html#container"><em class="glossterm">containers</em></a>. Every actor has a <a class="glossterm" href="go01.html#geometry"><em class="glossterm">geometry</em></a> and, when visible, it should paint its
  30       contents. The base class for actors is <a class="link" href="ClutterActor.html" title="ClutterActor"><span class="type">ClutterActor</span></a>.</p></dd>
  31 <dt>
  32 <a name="allocation"></a>allocation</dt>
  33 <dd>
  34 <p>The final size of an <a class="glossterm" href="go01.html#actor"><em class="glossterm">actor</em></a> within its
  35       <a class="glossterm" href="go01.html#parent"><em class="glossterm">parent</em></a>. For example, an actor might have
  36       a preferred <a class="glossterm" href="go01.html#minimum-size"><em class="glossterm">minimum size</em></a> of
  37       20×20 pixels and a <a class="glossterm" href="go01.html#natural-size"><em class="glossterm">natural
  38       size</em></a> of
  39       40×40 pixels, but its parent may decide to allocate 50×20 pixels for
  40       it instead.</p>
  41 <p>See Also
  42         <a class="glossterm" href="go01.html#minimum-size"><em class="glossterm">minimum size</em></a>
  43         <a class="glossterm" href="go01.html#natural-size"><em class="glossterm">natural size</em></a>
  44       .</p>
  45 </dd>
  46 <dt>
  47 <a name="child"></a>child</dt>
  48 <dd><p>A <a class="glossterm" href="go01.html#container"><em class="glossterm">container's</em></a> child is an
  49       <a class="glossterm" href="go01.html#actor"><em class="glossterm">actor</em></a> contained inside it.</p></dd>
  50 <dt>
  51 <a name="container"></a>container</dt>
  52 <dd><p>An <a class="glossterm" href="go01.html#actor"><em class="glossterm">actor</em></a> which can contain other
  53       actors. If a container is meant to be extended using public API it should implement
  54       the <a class="link" href="ClutterContainer.html" title="ClutterContainer"><span class="type">ClutterContainer</span></a> interface; otherwise it is a composite actor. A container
  55       can let its <a class="glossterm" href="go01.html#child"><em class="glossterm">children</em></a> manage their <a class="glossterm" href="go01.html#geometry"><em class="glossterm">geometry</em></a>, like <a class="link" href="ClutterGroup.html" title="ClutterGroup"><span class="type">ClutterGroup</span></a>, or they can take care of
  56       assigning one.</p></dd>
  57 <dt>
  58 <a name="event"></a>event</dt>
  59 <dd><p>Events are the way in which the Clutter backend informs Clutter about external
  60       events like pointer motion, button clicks, key presses, etc.</p></dd>
  61 <dt>
  62 <a name="geometry"></a>geometry</dt>
  63 <dd><p>An <a class="glossterm" href="go01.html#actor"><em class="glossterm">actor's</em></a> position and size. A
  64       geometry can be expressed in <a class="glossterm" href="go01.html#actor"><em class="glossterm">actor-relative</em></a>
  65       <a class="glossterm" href="go01.html#transformation"><em class="glossterm">untransformed</em></a> coordinates; or in
  66       <a class="glossterm" href="go01.html#stage"><em class="glossterm">stage-relative</em></a>, <a class="glossterm" href="go01.html#transformation"><em class="glossterm">transformed</em></a> coordinates.</p></dd>
  67 <dt>
  68 <a name="minimum-size"></a>minimum size</dt>
  69 <dd>
  70 <p>The minimum, useful size of an <a class="glossterm" href="go01.html#actor"><em class="glossterm">actor</em></a>.
  71       For instance, a button might have a minimum size of 20×20 millimeters on a
  72       touch screen, to retain the ability for the user to press it. A <a class="glossterm" href="go01.html#container"><em class="glossterm">container</em></a> that manages the size of its <a class="glossterm" href="go01.html#child"><em class="glossterm">children</em></a> should always try to <a class="glossterm" href="go01.html#allocation"><em class="glossterm">allocate</em></a> at least their minimum size.</p>
  73 <p>See Also
  74         <a class="glossterm" href="go01.html#natural-size"><em class="glossterm">natural size</em></a>
  75         <a class="glossterm" href="go01.html#allocation"><em class="glossterm">allocation</em></a>
  76       .</p>
  77 </dd>
  78 <dt>
  79 <a name="natural-size"></a>natural size</dt>
  80 <dd>
  81 <p>The default size requested by an <a class="glossterm" href="go01.html#actor"><em class="glossterm">actor</em></a>.</p>
  82 <p>See Also
  83         <a class="glossterm" href="go01.html#minimum-size"><em class="glossterm">minimum size</em></a>
  84         <a class="glossterm" href="go01.html#allocation"><em class="glossterm">allocation</em></a>
  85       .</p>
  86 </dd>
  87 <dt>
  88 <a name="parent"></a>parent</dt>
  89 <dd><p>An <a class="glossterm" href="go01.html#actor"><em class="glossterm">actor's</em></a> parent is the
  90       <a class="glossterm" href="go01.html#container"><em class="glossterm">container</em></a> inside which the actor
  91       resides.</p></dd>
  92 <dt>
  93 <a name="scenegraph"></a>scenegraph</dt>
  94 <dd><p>The tree of all <a class="glossterm" href="go01.html#actor"><em class="glossterm">actors</em></a>, starting
  95       from the <a class="glossterm" href="go01.html#stage"><em class="glossterm">stage</em></a> at the root and following
  96       the <a class="glossterm" href="go01.html#container"><em class="glossterm">containers</em></a>.</p></dd>
  97 <dt>
  98 <a name="stage"></a>stage</dt>
  99 <dd><p>The top-level <a class="glossterm" href="go01.html#container"><em class="glossterm">container</em></a> for
 100       <a class="glossterm" href="go01.html#actor"><em class="glossterm">actors</em></a>. Depending on the Clutter back end a
 101       stage can be associated to a window or to a frame buffer; also depending on the back
 102       end is the number of instantiatable stages. Stages in Clutter can be manipulated using
 103       the <a class="link" href="ClutterStage.html" title="ClutterStage"><span class="type">ClutterStage</span></a> API.</p></dd>
 104 <dt>
 105 <a name="transformation"></a>transformation</dt>
 106 <dd><p>A rotation, scaling or traslation of an <a class="glossterm" href="go01.html#actor"><em class="glossterm">actor</em></a>. Transformations are independent
 107       of the actor's <a class="glossterm" href="go01.html#geometry"><em class="glossterm">geometry</em></a>.</p></dd>
 108 </dl>
 109 </div>
 110 <div class="footer">
 111 <hr>
 112           Generated by GTK-Doc V1.18.1</div>
 113 </body>
 114 </html>