<?xml version="1.0" encoding="utf-8" standalone="no"?>
<book xmlns="http://www.devhelp.net/book" title="The Clutter Cookbook" link="index.html" author="Emmanuele BassiElliot Smith" name="clutter-cookbook">
  <chapters>
    <sub name="Preface" link="introduction.html">
      <sub name="About Clutter" link="introduction.html#idm46603824868448"/>
      <sub name="About this document" link="ch01s02.html">
        <sub name="Compiling the examples" link="ch01s02.html#idm46603828253312"/>
      </sub>
      <sub name="Acknowledgments" link="ch01s03.html">
        <sub name="Acknowledgments from Emmanuele" link="ch01s03.html#idm46603828246096"/>
        <sub name="Acknowledgements from Elliot" link="ch01s03.html#idm46603828244400"/>
      </sub>
      <sub name="Where to get Clutter" link="ch01s04.html"/>
    </sub>
    <sub name="Actors" link="actors.html">
      <sub name="Introduction" link="actors.html#actors-introduction"/>
      <sub name="Implementing a simple custom actor" link="actors-composite.html">
        <sub name="Problem" link="actors-composite.html#actors-composite-problem"/>
        <sub name="Solution" link="actors-composite.html#actors-composite-solution"/>
        <sub name="Discussion" link="actors-composite.html#actors-composite-discussion">
          <sub name="Implementing ClutterActor virtual functions" link="actors-composite.html#actors-composite-discussion-clutter-virtual-functions"/>
        </sub>
      </sub>
      <sub name="Knowing when an actor's position or size changes" link="actors-allocation-notify.html">
        <sub name="Problem" link="actors-allocation-notify.html#idm46603823759456"/>
        <sub name="Solution" link="actors-allocation-notify.html#idm46603823758144"/>
        <sub name="Discussion" link="actors-allocation-notify.html#idm46603823749168"/>
      </sub>
      <sub name="Overriding the paint sequence" link="actors-paint-wrappers.html">
        <sub name="Problem" link="actors-paint-wrappers.html#idm46603823737136"/>
        <sub name="Solution" link="actors-paint-wrappers.html#idm46603823735728"/>
        <sub name="Discussion" link="actors-paint-wrappers.html#idm46603823727776"/>
      </sub>
      <sub name="Making an actor transparent by changing its opacity" link="actors-opacity.html">
        <sub name="Problem" link="actors-opacity.html#idm46603823719712"/>
        <sub name="Solution" link="actors-opacity.html#idm46603823718304"/>
        <sub name="Discussion" link="actors-opacity.html#idm46603823714688">
          <sub name="Container and color opacity" link="actors-opacity.html#idm46603823701024"/>
          <sub name="Depth and depth order" link="actors-opacity.html#idm46603823683216"/>
        </sub>
      </sub>
      <sub name="Creating an actor with a non-rectangular shape" link="actors-non-rectangular.html">
        <sub name="Problem" link="actors-non-rectangular.html#idm46603823667760"/>
        <sub name="Solution" link="actors-non-rectangular.html#idm46603823665888"/>
        <sub name="Discussion" link="actors-non-rectangular.html#idm46603823657072">
          <sub name="Cogl path coordinates" link="actors-non-rectangular.html#idm46603823654032"/>
          <sub name="Other Cogl primitives" link="actors-non-rectangular.html#idm46603823641088"/>
          <sub name="Using ClutterPath to store the path" link="actors-non-rectangular.html#idm46603823627984"/>
        </sub>
      </sub>
    </sub>
    <sub name="Events" link="events.html">
      <sub name="Introduction" link="events.html#events-introduction"/>
      <sub name="Handling key events" link="events-handling-key-events.html">
        <sub name="Problem" link="events-handling-key-events.html#idm46603824298592"/>
        <sub name="Solutions" link="events-handling-key-events.html#idm46603824297280">
          <sub name="Solution 1" link="events-handling-key-events.html#idm46603824840656"/>
          <sub name="Solution 2" link="events-handling-key-events.html#idm46603827161344"/>
        </sub>
        <sub name="Discussion" link="events-handling-key-events.html#events-handling-key-events-discussion">
          <sub name="Pros and cons of Solution 1 and Solution 2" link="events-handling-key-events.html#idm46603823343392"/>
          <sub name="Other useful things to know about key press events" link="events-handling-key-events.html#idm46603823339888"/>
        </sub>
      </sub>
      <sub name="Detecting mouse scrolling on an actor" link="events-mouse-scroll.html">
        <sub name="Problem" link="events-mouse-scroll.html#idm46603823330432"/>
        <sub name="Solution" link="events-mouse-scroll.html#idm46603823328960"/>
        <sub name="Discussion" link="events-mouse-scroll.html#idm46603823321872">
          <sub name="Creating a scrolling viewport for an actor" link="events-mouse-scroll.html#idm46603823320720"/>
        </sub>
        <sub name="Full example" link="events-mouse-scroll.html#idm46603823283648"/>
      </sub>
      <sub name="Detecting pointer movements on an actor" link="events-pointer-motion.html">
        <sub name="Problem" link="events-pointer-motion.html#events-pointer-motion-problem"/>
        <sub name="Solution" link="events-pointer-motion.html#events-pointer-motion-solution">
          <sub name="Responding to crossing events" link="events-pointer-motion.html#idm46603823268240"/>
          <sub name="Responding to motion events" link="events-pointer-motion.html#idm46603823257024"/>
        </sub>
        <sub name="Discussion" link="events-pointer-motion.html#events-pointer-motion-discussion">
          <sub name="Pointer events on actors at different depths" link="events-pointer-motion.html#idm46603823238048"/>
        </sub>
        <sub name="Full examples" link="events-pointer-motion.html#idm46603823223776"/>
      </sub>
      <sub name="Making an actor respond to button events" link="events-buttons.html">
        <sub name="Problem" link="events-buttons.html#idm46603823195504"/>
        <sub name="Solution" link="events-buttons.html#idm46603823190320"/>
        <sub name="Discussion" link="events-buttons.html#idm46603823175664">
          <sub name="Click count" link="events-buttons.html#idm46603823170144"/>
          <sub name="Button numbering" link="events-buttons.html#idm46603823159088"/>
          <sub name="ClutterClickAction" link="events-buttons.html#events-buttons-clutterclickaction"/>
        </sub>
        <sub name="Full examples" link="events-buttons.html#idm46603822817280"/>
      </sub>
    </sub>
    <sub name="Textures" link="textures.html">
      <sub name="Introduction" link="textures.html#textures-introduction"/>
      <sub name="Drawing 2D graphics onto a texture" link="textures-drawing-with-cairo.html">
        <sub name="Problem" link="textures-drawing-with-cairo.html#idm46603824671312"/>
        <sub name="Solution" link="textures-drawing-with-cairo.html#idm46603823423504"/>
        <sub name="Discussion" link="textures-drawing-with-cairo.html#idm46603823418928">
          <sub name="Drawing pages from a PDF onto a ClutterCairoContext" link="textures-drawing-with-cairo.html#idm46603827924096"/>
        </sub>
      </sub>
      <sub name="Maintaining the aspect ratio when loading an&#10;    image into a texture" link="textures-aspect-ratio.html">
        <sub name="Problem" link="textures-aspect-ratio.html#idm46603827918528"/>
        <sub name="Solution" link="textures-aspect-ratio.html#idm46603825782832"/>
        <sub name="Discussion" link="textures-aspect-ratio.html#idm46603825779168"/>
      </sub>
      <sub name="Loading image data into a texture" link="textures-image-loading.html">
        <sub name="Problem" link="textures-image-loading.html#idm46603823457376"/>
        <sub name="Solution" link="textures-image-loading.html#idm46603823456064"/>
        <sub name="Discussion" link="textures-image-loading.html#idm46603823451568">
          <sub name="Synchronous vs. asynchronous image loading" link="textures-image-loading.html#idm46603823445968"/>
          <sub name="Other ways to load image data into a texture" link="textures-image-loading.html#idm46603823436448"/>
        </sub>
      </sub>
      <sub name="Creating sub-textures from an existing texture" link="textures-sub-textures.html">
        <sub name="Problem" link="textures-sub-textures.html#idm46603823427728"/>
        <sub name="Solution" link="textures-sub-textures.html#idm46603823425952"/>
        <sub name="Discussion" link="textures-sub-textures.html#idm46603823897728"/>
        <sub name="Full example" link="textures-sub-textures.html#idm46603823892144"/>
        <sub name="Going further" link="textures-sub-textures.html#idm46603823886192"/>
      </sub>
      <sub name="Creating a reflection of a texture" link="textures-reflection.html">
        <sub name="Problem" link="textures-reflection.html#idm46603823871456"/>
        <sub name="Solution" link="textures-reflection.html#idm46603823869728"/>
        <sub name="Discussion" link="textures-reflection.html#idm46603823861760"/>
        <sub name="Full example" link="textures-reflection.html#idm46603823847168"/>
      </sub>
      <sub name="Cross-fading between two images" link="textures-crossfade.html">
        <sub name="Problem" link="textures-crossfade.html#idm46603823838368"/>
        <sub name="Solutions" link="textures-crossfade.html#idm46603823836528">
          <sub name="Solution 1: two textures" link="textures-crossfade.html#idm46603825718864"/>
          <sub name="Solution 2: one texture with two layers" link="textures-crossfade.html#idm46603825688896">
            <sub name="Cross-fading using a texture combiner with interpolation" link="textures-crossfade.html#idm46603825684192"/>
          </sub>
        </sub>
        <sub name="Discussion" link="textures-crossfade.html#textures-crossfade-discussion">
          <sub name="Cross-fades between images of different sizes" link="textures-crossfade.html#idm46603825670688"/>
          <sub name="Slideshows" link="textures-crossfade.html#textures-crossfade-discussion-slideshows"/>
        </sub>
        <sub name="Full examples" link="textures-crossfade.html#idm46603825635600"/>
      </sub>
    </sub>
    <sub name="Animations" link="animations.html">
      <sub name="Introduction" link="animations.html#animations-introduction">
        <sub name="High level overview" link="animations.html#idm46603822758896"/>
        <sub name="Alphas" link="animations.html#animations-introduction-alphas"/>
        <sub name="Clutter's animation API" link="animations.html#animations-introduction-api"/>
      </sub>
      <sub name="Inverting Animations" link="animations-inversion.html">
        <sub name="Problem" link="animations-inversion.html#idm46603822726848"/>
        <sub name="Solution" link="animations-inversion.html#idm46603822725536"/>
        <sub name="Discussion" link="animations-inversion.html#idm46603822713408"/>
      </sub>
      <sub name="Fading an actor out of or into view" link="animations-fading.html">
        <sub name="Problem" link="animations-fading.html#idm46603822705072"/>
        <sub name="Solution" link="animations-fading.html#idm46603822703760"/>
        <sub name="Discussion" link="animations-fading.html#idm46603822687792"/>
      </sub>
      <sub name="Rotating an actor" link="animations-rotating.html">
        <sub name="Problem" link="animations-rotating.html#idm46603822684336"/>
        <sub name="Solution" link="animations-rotating.html#idm46603822679760"/>
        <sub name="Discussion" link="animations-rotating.html#idm46603822653600">
          <sub name="Setting the rotation center for an animation" link="animations-rotating.html#idm46603822652080">
            <sub name="Setting a rotation center inside an actor" link="animations-rotating.html#idm46603822649856"/>
            <sub name="Setting the rotation center outside an actor" link="animations-rotating.html#idm46603822635008"/>
          </sub>
          <sub name="Direction of rotation" link="animations-rotating.html#animations-rotating-discussion-direction"/>
          <sub name="Apparent vs. actual rotation" link="animations-rotating.html#idm46603822602432"/>
          <sub name="Orientation of rotation axes" link="animations-rotating.html#idm46603822598624"/>
        </sub>
        <sub name="Full example" link="animations-rotating.html#idm46603822595360"/>
      </sub>
      <sub name="Creating complex animations with&#10;    ClutterAnimator" link="animations-complex.html">
        <sub name="Problem" link="animations-complex.html#idm46603822584480"/>
        <sub name="Solution" link="animations-complex.html#idm46603822582560"/>
        <sub name="Discussion" link="animations-complex.html#animations-complex-discussion">
          <sub name="Understanding keys and key frames" link="animations-complex.html#animations-complex-discussion-keys"/>
          <sub name="Why ClutterAnimator?" link="animations-complex.html#animations-complex-why-clutteranimator"/>
        </sub>
        <sub name="Full example" link="animations-complex.html#idm46603821824640"/>
      </sub>
      <sub name="Reusing a complex animation on different actors" link="animations-reuse.html">
        <sub name="Problem" link="animations-reuse.html#animations-reuse-problem"/>
        <sub name="Solution" link="animations-reuse.html#animations-reuse-solution"/>
        <sub name="Discussion" link="animations-reuse.html#animations-reuse-discussion">
          <sub name="One animation vs. many" link="animations-reuse.html#animations-reuse-discussion-one-or-many"/>
          <sub name="Caveats about animating a rig instead of an actor" link="animations-reuse.html#animations-reuse-discussion-rig-not-actor"/>
        </sub>
        <sub name="Full example" link="animations-reuse.html#animations-reuse-examples"/>
      </sub>
      <sub name="Moving actors" link="animations-moving.html">
        <sub name="Problem" link="animations-moving.html#idm46603821744064"/>
        <sub name="Solutions" link="animations-moving.html#idm46603821739696">
          <sub name="Solution 1: Implicit animations" link="animations-moving.html#idm46603821736640"/>
          <sub name="Solution 2: ClutterState" link="animations-moving.html#idm46603821731680"/>
          <sub name="Solution 3: ClutterAnimator" link="animations-moving.html#idm46603821726800"/>
        </sub>
        <sub name="Discussion" link="animations-moving.html#idm46603821719376">
          <sub name="Movement can take an actor &quot;outside&quot; its container" link="animations-moving.html#idm46603821718736"/>
          <sub name="Anchor points can affect movement" link="animations-moving.html#idm46603821715792"/>
          <sub name="Actors can move in the z axis" link="animations-moving.html#idm46603821694272"/>
          <sub name="Movement is affected by constraints" link="animations-moving.html#idm46603821683472"/>
        </sub>
        <sub name="Full examples" link="animations-moving.html#animations-moving-examples"/>
      </sub>
      <sub name="Looping an animation" link="animations-looping.html">
        <sub name="Problem" link="animations-looping.html#idm46603821639152"/>
        <sub name="Solutions" link="animations-looping.html#idm46603821637920">
          <sub name="Solution 1: looping an implicit animation" link="animations-looping.html#animations-looping-solutions-implicit"/>
          <sub name="Solution 2: looping with ClutterAnimator" link="animations-looping.html#idm46603821623200"/>
          <sub name="Solution 3: looping with ClutterState" link="animations-looping.html#idm46603821612208"/>
        </sub>
        <sub name="Discussion" link="animations-looping.html#idm46603821593824">
          <sub name="Looping a fixed number of times" link="animations-looping.html#idm46603821587760"/>
          <sub name="Creating a &quot;closed loop&quot; with an implicit animation" link="animations-looping.html#animations-looping-discussion-closed-loop"/>
        </sub>
        <sub name="Full examples" link="animations-looping.html#animations-looping-examples"/>
      </sub>
      <sub name="Animated scaling" link="animations-scaling.html">
        <sub name="Problem" link="animations-scaling.html#idm46603821552208"/>
        <sub name="Solution" link="animations-scaling.html#idm46603821548800"/>
        <sub name="Discussion" link="animations-scaling.html#idm46603821542016">
          <sub name="Scaling vs. resizing" link="animations-scaling.html#idm46603821531568"/>
          <sub name="Scaling, layouts and containers" link="animations-scaling.html#idm46603821521824"/>
          <sub name="Setting the scale center" link="animations-scaling.html#idm46603821518464"/>
        </sub>
        <sub name="Full examples" link="animations-scaling.html#animations-scaling-examples"/>
      </sub>
      <sub name="Animating an actor along a curved path" link="animations-path.html">
        <sub name="Problem" link="animations-path.html#idm46603821482144"/>
        <sub name="Solution" link="animations-path.html#idm46603821480864"/>
        <sub name="Discussion" link="animations-path.html#idm46603821467168">
          <sub name="Other ways to animate along a path" link="animations-path.html#idm46603821453776"/>
        </sub>
        <sub name="Full examples" link="animations-path.html#animations-path-examples"/>
      </sub>
    </sub>
    <sub name="Text" link="text.html">
      <sub name="Introduction" link="text.html#text-introduction"/>
      <sub name="Drawing a shadow under the text" link="text-shadow.html">
        <sub name="Problem" link="text-shadow.html#idm46603823907856"/>
        <sub name="Solution" link="text-shadow.html#idm46603823913664"/>
        <sub name="Discussion" link="text-shadow.html#idm46603824252000"/>
        <sub name="Full example" link="text-shadow.html#idm46603823084224"/>
      </sub>
    </sub>
    <sub name="Layout management" link="layouts.html">
      <sub name="Introduction" link="layouts.html#layouts-introduction">
        <sub name="Using layouts" link="layouts.html#idm46603825288080"/>
        <sub name="Types of layout manager" link="layouts.html#layouts-introduction-manager-types"/>
        <sub name="Layout properties" link="layouts.html#layouts-introduction-layout-properties">
          <sub name="Setting layout properties" link="layouts.html#idm46603822025648"/>
        </sub>
        <sub name="Not using layout managers" link="layouts.html#layouts-introduction-not-using-layout-managers">
          <sub name="Manual positioning and alignment" link="layouts.html#idm46603822011728"/>
          <sub name="Using ClutterConstraint" link="layouts.html#idm46603822009104"/>
        </sub>
      </sub>
      <sub name="Stacking actors on top of each other" link="layouts-stacking.html">
        <sub name="Problem" link="layouts-stacking.html#idm46603822000896"/>
        <sub name="Solution" link="layouts-stacking.html#layouts-stacking-solution"/>
        <sub name="Discussion" link="layouts-stacking.html#idm46603821994320">
          <sub name="Setting and changing alignment" link="layouts-stacking.html#idm46603821992720"/>
          <sub name="Size requisitioning" link="layouts-stacking.html#layouts-stacking-size-requisitioning"/>
          <sub name="Depth ordering" link="layouts-stacking.html#idm46603822136224"/>
          <sub name="Other ways to stack actors" link="layouts-stacking.html#idm46603822132544"/>
        </sub>
        <sub name="Full examples" link="layouts-stacking.html#idm46603822126192"/>
      </sub>
      <sub name="Binding the size of one actor to the size of another" link="layouts-bind-constraint.html">
        <sub name="Problem" link="layouts-bind-constraint.html#idm46603822112368"/>
        <sub name="Solution" link="layouts-bind-constraint.html#idm46603822108304"/>
        <sub name="Discussion" link="layouts-bind-constraint.html#idm46603822091840">
          <sub name="Another way to bind actors' sizes together" link="layouts-bind-constraint.html#idm46603822081408"/>
        </sub>
        <sub name="Full examples" link="layouts-bind-constraint.html#idm46603822075184"/>
      </sub>
      <sub name="Arranging actors in a single row or column" link="layouts-box.html">
        <sub name="Problem" link="layouts-box.html#idm46603822059440"/>
        <sub name="Solution" link="layouts-box.html#idm46603822055344"/>
        <sub name="Discussion" link="layouts-box.html#idm46603822042528">
          <sub name="Layout properties" link="layouts-box.html#idm46603822039280">
            <sub name="ClutterBoxLayout properties" link="layouts-box.html#idm46603822033280"/>
            <sub name="Child properties" link="layouts-box.html#idm46603821411568"/>
          </sub>
          <sub name="Animating layout changes" link="layouts-box.html#layouts-box-animating-layout-changes"/>
        </sub>
        <sub name="Full examples" link="layouts-box.html#idm46603821387456"/>
      </sub>
    </sub>
    <sub name="Script" link="script.html">
      <sub name="Introduction" link="script.html#script-introduction">
        <sub name="Basic principles of ClutterScript" link="script.html#idm46603821885632"/>
        <sub name="Data types" link="script.html#script-introduction-data-types"/>
      </sub>
      <sub name="Defining a user interface with JSON" link="script-ui.html">
        <sub name="Problem" link="script-ui.html#idm46603822419040"/>
        <sub name="Solution" link="script-ui.html#idm46603822414960"/>
        <sub name="Discussion" link="script-ui.html#idm46603821335872"/>
      </sub>
      <sub name="Connecting to signals in ClutterScript" link="script-signals.html">
        <sub name="Problem" link="script-signals.html#idm46603821332640"/>
        <sub name="Solution" link="script-signals.html#idm46603821331216"/>
        <sub name="Discussion" link="script-signals.html#script-signals-discussion">
          <sub name="Options for connecting signals to handlers" link="script-signals.html#idm46603821314768"/>
          <sub name="Writing handler functions" link="script-signals.html#script-signals-discussion-writing-handlers"/>
          <sub name="Passing objects to handler functions" link="script-signals.html#idm46603821298848"/>
        </sub>
        <sub name="Full examples" link="script-signals.html#idm46603821290064"/>
      </sub>
      <sub name="Connecting ClutterState states in ClutterScript" link="script-state.html">
        <sub name="Problem" link="script-state.html#idm46603821277840"/>
        <sub name="Solution" link="script-state.html#idm46603821275984"/>
        <sub name="Discussion" link="script-state.html#idm46603821267664"/>
        <sub name="Full examples" link="script-state.html#idm46603821252256"/>
      </sub>
    </sub>
    <sub name="Effects" link="effects.html">
      <sub name="Introduction" link="effects.html#effects-introduction">
        <sub name="Creating effects using the abstract effect classes" link="effects.html#idm46603821043776"/>
        <sub name="Using the built-in effects" link="effects.html#effects-introduction-using-the-built-in-effects"/>
      </sub>
      <sub name="Changing an actor's paint sequence using&#10;    ClutterEffect" link="effects-basic.html">
        <sub name="Problem" link="effects-basic.html#idm46603821001920"/>
        <sub name="Solution" link="effects-basic.html#idm46603820995664"/>
        <sub name="Discussion" link="effects-basic.html#idm46603820962368">
          <sub name="Effect properties" link="effects-basic.html#effects-basic-discussion-properties"/>
        </sub>
        <sub name="Full example" link="effects-basic.html#effects-basic-example">
          <sub name="CbBackgroundEffect" link="effects-basic.html#effects-basic-example-cbbackgroundeffect"/>
          <sub name="CbBorderEffect" link="effects-basic.html#effects-basic-example-cbbordereffect"/>
          <sub name="Application" link="effects-basic.html#effects-basic-example-application"/>
        </sub>
      </sub>
      <sub name="Creating and animating a custom ClutterDeformEffect" link="effects-custom-deform.html">
        <sub name="Problem" link="effects-custom-deform.html#idm46603820885744"/>
        <sub name="Solution" link="effects-custom-deform.html#effects-custom-deform-solution"/>
        <sub name="Discussion" link="effects-custom-deform.html#effects-custom-deform-discussion">
          <sub name="Customising the back material" link="effects-custom-deform.html#idm46603820841136"/>
          <sub name="Animating a custom deform effect" link="effects-custom-deform.html#effects-custom-deform-discussion-animating"/>
          <sub name="Tiles" link="effects-custom-deform.html#effects-custom-deform-discussion-tiles"/>
        </sub>
        <sub name="Full example" link="effects-custom-deform.html#idm46603820806512"/>
      </sub>
    </sub>
    <sub name="Contributing to this document" link="contributing.html"/>
  </chapters>
  <functions/>
</book>
