<?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#idm232896609984"/>
      <sub name="About this document" link="ch01s02.html">
        <sub name="Compiling the examples" link="ch01s02.html#idm232898774464"/>
      </sub>
      <sub name="Acknowledgments" link="ch01s03.html">
        <sub name="Acknowledgments from Emmanuele" link="ch01s03.html#idm232898766880"/>
        <sub name="Acknowledgements from Elliot" link="ch01s03.html#idm232898765088"/>
      </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#idm232896815936"/>
        <sub name="Solution" link="actors-allocation-notify.html#idm232896814448"/>
        <sub name="Discussion" link="actors-allocation-notify.html#idm232896805200"/>
      </sub>
      <sub name="Overriding the paint sequence" link="actors-paint-wrappers.html">
        <sub name="Problem" link="actors-paint-wrappers.html#idm232896792560"/>
        <sub name="Solution" link="actors-paint-wrappers.html#idm232896791248"/>
        <sub name="Discussion" link="actors-paint-wrappers.html#idm232896783584"/>
      </sub>
      <sub name="Making an actor transparent by changing its opacity" link="actors-opacity.html">
        <sub name="Problem" link="actors-opacity.html#idm232896775344"/>
        <sub name="Solution" link="actors-opacity.html#idm232896774032"/>
        <sub name="Discussion" link="actors-opacity.html#idm232896770176">
          <sub name="Container and color opacity" link="actors-opacity.html#idm232896756432"/>
          <sub name="Depth and depth order" link="actors-opacity.html#idm232896738304"/>
        </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#idm232896722848"/>
        <sub name="Solution" link="actors-non-rectangular.html#idm232896720976"/>
        <sub name="Discussion" link="actors-non-rectangular.html#idm232896712160">
          <sub name="Cogl path coordinates" link="actors-non-rectangular.html#idm232896708816"/>
          <sub name="Other Cogl primitives" link="actors-non-rectangular.html#idm232896695872"/>
          <sub name="Using ClutterPath to store the path" link="actors-non-rectangular.html#idm232896682432"/>
        </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#idm232896365328"/>
        <sub name="Solutions" link="events-handling-key-events.html#idm232896364016">
          <sub name="Solution 1" link="events-handling-key-events.html#idm232898481472"/>
          <sub name="Solution 2" link="events-handling-key-events.html#idm232897056032"/>
        </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#idm232898115920"/>
          <sub name="Other useful things to know about key press events" link="events-handling-key-events.html#idm232896332880"/>
        </sub>
      </sub>
      <sub name="Detecting mouse scrolling on an actor" link="events-mouse-scroll.html">
        <sub name="Problem" link="events-mouse-scroll.html#idm232896323056"/>
        <sub name="Solution" link="events-mouse-scroll.html#idm232896321584"/>
        <sub name="Discussion" link="events-mouse-scroll.html#idm232896313712">
          <sub name="Creating a scrolling viewport for an actor" link="events-mouse-scroll.html#idm232896312320"/>
        </sub>
        <sub name="Full example" link="events-mouse-scroll.html#idm232896272928"/>
      </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#idm232896257680"/>
          <sub name="Responding to motion events" link="events-pointer-motion.html#idm232893876320"/>
        </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#idm232893857280"/>
        </sub>
        <sub name="Full examples" link="events-pointer-motion.html#idm232893842896"/>
      </sub>
      <sub name="Making an actor respond to button events" link="events-buttons.html">
        <sub name="Problem" link="events-buttons.html#idm232893814624"/>
        <sub name="Solution" link="events-buttons.html#idm232893809248"/>
        <sub name="Discussion" link="events-buttons.html#idm232893792160">
          <sub name="Click count" link="events-buttons.html#idm232893786576"/>
          <sub name="Button numbering" link="events-buttons.html#idm232893775424"/>
          <sub name="ClutterClickAction" link="events-buttons.html#events-buttons-clutterclickaction"/>
        </sub>
        <sub name="Full examples" link="events-buttons.html#idm232893751616"/>
      </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#idm232898646416"/>
        <sub name="Solution" link="textures-drawing-with-cairo.html#idm232896348256"/>
        <sub name="Discussion" link="textures-drawing-with-cairo.html#idm232897440608">
          <sub name="Drawing pages from a PDF onto a ClutterCairoContext" link="textures-drawing-with-cairo.html#idm232894672480"/>
        </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#idm232897410256"/>
        <sub name="Solution" link="textures-aspect-ratio.html#idm232897408816"/>
        <sub name="Discussion" link="textures-aspect-ratio.html#idm232897404496"/>
      </sub>
      <sub name="Loading image data into a texture" link="textures-image-loading.html">
        <sub name="Problem" link="textures-image-loading.html#idm232896047648"/>
        <sub name="Solution" link="textures-image-loading.html#idm232896046336"/>
        <sub name="Discussion" link="textures-image-loading.html#idm232896041120">
          <sub name="Synchronous vs. asynchronous image loading" link="textures-image-loading.html#idm232898721536"/>
          <sub name="Other ways to load image data into a texture" link="textures-image-loading.html#idm232898711744"/>
        </sub>
      </sub>
      <sub name="Creating sub-textures from an existing texture" link="textures-sub-textures.html">
        <sub name="Problem" link="textures-sub-textures.html#idm232898703024"/>
        <sub name="Solution" link="textures-sub-textures.html#idm232898701248"/>
        <sub name="Discussion" link="textures-sub-textures.html#idm232898692400"/>
        <sub name="Full example" link="textures-sub-textures.html#idm232898686304"/>
        <sub name="Going further" link="textures-sub-textures.html#idm232898680352"/>
      </sub>
      <sub name="Creating a reflection of a texture" link="textures-reflection.html">
        <sub name="Problem" link="textures-reflection.html#idm232898665312"/>
        <sub name="Solution" link="textures-reflection.html#idm232898663408"/>
        <sub name="Discussion" link="textures-reflection.html#idm232893519920"/>
        <sub name="Full example" link="textures-reflection.html#idm232893504768"/>
      </sub>
      <sub name="Cross-fading between two images" link="textures-crossfade.html">
        <sub name="Problem" link="textures-crossfade.html#idm232893495952"/>
        <sub name="Solutions" link="textures-crossfade.html#idm232893493936">
          <sub name="Solution 1: two textures" link="textures-crossfade.html#idm232893489040"/>
          <sub name="Solution 2: one texture with two layers" link="textures-crossfade.html#idm232893456016">
            <sub name="Cross-fading using a texture combiner with interpolation" link="textures-crossfade.html#idm232893450672"/>
          </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#idm232893437168"/>
          <sub name="Slideshows" link="textures-crossfade.html#textures-crossfade-discussion-slideshows"/>
        </sub>
        <sub name="Full examples" link="textures-crossfade.html#idm232893401648"/>
      </sub>
    </sub>
    <sub name="Animations" link="animations.html">
      <sub name="Introduction" link="animations.html#animations-introduction">
        <sub name="High level overview" link="animations.html#idm232895507168"/>
        <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#idm232897125456"/>
        <sub name="Solution" link="animations-inversion.html#idm232897124144"/>
        <sub name="Discussion" link="animations-inversion.html#idm232893319984"/>
      </sub>
      <sub name="Fading an actor out of or into view" link="animations-fading.html">
        <sub name="Problem" link="animations-fading.html#idm232893311328"/>
        <sub name="Solution" link="animations-fading.html#idm232893310016"/>
        <sub name="Discussion" link="animations-fading.html#idm232893292832"/>
      </sub>
      <sub name="Rotating an actor" link="animations-rotating.html">
        <sub name="Problem" link="animations-rotating.html#idm232893289376"/>
        <sub name="Solution" link="animations-rotating.html#idm232893284800"/>
        <sub name="Discussion" link="animations-rotating.html#idm232893257616">
          <sub name="Setting the rotation center for an animation" link="animations-rotating.html#idm232893256096">
            <sub name="Setting a rotation center inside an actor" link="animations-rotating.html#idm232893253712"/>
            <sub name="Setting the rotation center outside an actor" link="animations-rotating.html#idm232893238000"/>
          </sub>
          <sub name="Direction of rotation" link="animations-rotating.html#animations-rotating-discussion-direction"/>
          <sub name="Apparent vs. actual rotation" link="animations-rotating.html#idm232893203584"/>
          <sub name="Orientation of rotation axes" link="animations-rotating.html#idm232893199776"/>
        </sub>
        <sub name="Full example" link="animations-rotating.html#idm232893196512"/>
      </sub>
      <sub name="Creating complex animations with&#10;    ClutterAnimator" link="animations-complex.html">
        <sub name="Problem" link="animations-complex.html#idm232893185744"/>
        <sub name="Solution" link="animations-complex.html#idm232893183616"/>
        <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#idm232891847408"/>
      </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#idm232891763568"/>
        <sub name="Solutions" link="animations-moving.html#idm232891759200">
          <sub name="Solution 1: Implicit animations" link="animations-moving.html#idm232891756144"/>
          <sub name="Solution 2: ClutterState" link="animations-moving.html#idm232891751008"/>
          <sub name="Solution 3: ClutterAnimator" link="animations-moving.html#idm232891745136"/>
        </sub>
        <sub name="Discussion" link="animations-moving.html#idm232891737536">
          <sub name="Movement can take an actor &quot;outside&quot; its container" link="animations-moving.html#idm232891736896"/>
          <sub name="Anchor points can affect movement" link="animations-moving.html#idm232891733952"/>
          <sub name="Actors can move in the z axis" link="animations-moving.html#idm232891712432"/>
          <sub name="Movement is affected by constraints" link="animations-moving.html#idm232891701632"/>
        </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#idm232891657312"/>
        <sub name="Solutions" link="animations-looping.html#idm232891656080">
          <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#idm232891640944"/>
          <sub name="Solution 3: looping with ClutterState" link="animations-looping.html#idm232891628992"/>
        </sub>
        <sub name="Discussion" link="animations-looping.html#idm232891610608">
          <sub name="Looping a fixed number of times" link="animations-looping.html#idm232891604544"/>
          <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#idm232891568720"/>
        <sub name="Solution" link="animations-scaling.html#idm232891565312"/>
        <sub name="Discussion" link="animations-scaling.html#idm232891558528">
          <sub name="Scaling vs. resizing" link="animations-scaling.html#idm232891548080"/>
          <sub name="Scaling, layouts and containers" link="animations-scaling.html#idm232891538336"/>
          <sub name="Setting the scale center" link="animations-scaling.html#idm232891534976"/>
        </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#idm232891497888"/>
        <sub name="Solution" link="animations-path.html#idm232891496608"/>
        <sub name="Discussion" link="animations-path.html#idm232891481440">
          <sub name="Other ways to animate along a path" link="animations-path.html#idm232891467168"/>
        </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#idm232894412592"/>
        <sub name="Solution" link="text-shadow.html#idm232894428448"/>
        <sub name="Discussion" link="text-shadow.html#idm232898518336"/>
        <sub name="Full example" link="text-shadow.html#idm232894223264"/>
      </sub>
    </sub>
    <sub name="Layout management" link="layouts.html">
      <sub name="Introduction" link="layouts.html#layouts-introduction">
        <sub name="Using layouts" link="layouts.html#idm232898267520"/>
        <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#idm232893089712"/>
        </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#idm232893075792"/>
          <sub name="Using ClutterConstraint" link="layouts.html#idm232893072672"/>
        </sub>
      </sub>
      <sub name="Stacking actors on top of each other" link="layouts-stacking.html">
        <sub name="Problem" link="layouts-stacking.html#idm232893063824"/>
        <sub name="Solution" link="layouts-stacking.html#layouts-stacking-solution"/>
        <sub name="Discussion" link="layouts-stacking.html#idm232893057216">
          <sub name="Setting and changing alignment" link="layouts-stacking.html#idm232893055616"/>
          <sub name="Size requisitioning" link="layouts-stacking.html#layouts-stacking-size-requisitioning"/>
          <sub name="Depth ordering" link="layouts-stacking.html#idm232893037840"/>
          <sub name="Other ways to stack actors" link="layouts-stacking.html#idm232893033888"/>
        </sub>
        <sub name="Full examples" link="layouts-stacking.html#idm232893027536"/>
      </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#idm232893013696"/>
        <sub name="Solution" link="layouts-bind-constraint.html#idm232893009456"/>
        <sub name="Discussion" link="layouts-bind-constraint.html#idm232892991952">
          <sub name="Another way to bind actors' sizes together" link="layouts-bind-constraint.html#idm232892979552"/>
        </sub>
        <sub name="Full examples" link="layouts-bind-constraint.html#idm232892972784"/>
      </sub>
      <sub name="Arranging actors in a single row or column" link="layouts-box.html">
        <sub name="Problem" link="layouts-box.html#idm232892957024"/>
        <sub name="Solution" link="layouts-box.html#idm232892952928"/>
        <sub name="Discussion" link="layouts-box.html#idm232892940112">
          <sub name="Layout properties" link="layouts-box.html#idm232892936592">
            <sub name="ClutterBoxLayout properties" link="layouts-box.html#idm232892930080"/>
            <sub name="Child properties" link="layouts-box.html#idm232892909456"/>
          </sub>
          <sub name="Animating layout changes" link="layouts-box.html#layouts-box-animating-layout-changes"/>
        </sub>
        <sub name="Full examples" link="layouts-box.html#idm232892764512"/>
      </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#idm232896891408"/>
        <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#idm232896100768"/>
        <sub name="Solution" link="script-ui.html#idm232896096544"/>
        <sub name="Discussion" link="script-ui.html#idm232896077488"/>
      </sub>
      <sub name="Connecting to signals in ClutterScript" link="script-signals.html">
        <sub name="Problem" link="script-signals.html#idm232895004352"/>
        <sub name="Solution" link="script-signals.html#idm232895002928"/>
        <sub name="Discussion" link="script-signals.html#script-signals-discussion">
          <sub name="Options for connecting signals to handlers" link="script-signals.html#idm232894985552"/>
          <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#idm232893127440"/>
        </sub>
        <sub name="Full examples" link="script-signals.html#idm232893118064"/>
      </sub>
      <sub name="Connecting ClutterState states in ClutterScript" link="script-state.html">
        <sub name="Problem" link="script-state.html#idm232893105072"/>
        <sub name="Solution" link="script-state.html#idm232893103312"/>
        <sub name="Discussion" link="script-state.html#idm232893094864"/>
        <sub name="Full examples" link="script-state.html#idm232891992480"/>
      </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#idm232897152816"/>
        <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#idm232891924064"/>
        <sub name="Solution" link="effects-basic.html#idm232892590032"/>
        <sub name="Discussion" link="effects-basic.html#idm232892553296">
          <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#idm232892472816"/>
        <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#idm232892425824"/>
          <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#idm232892387360"/>
      </sub>
    </sub>
    <sub name="Contributing to this document" link="contributing.html"/>
  </chapters>
  <functions/>
</book>
