libclutter-1.0-doc 1.24.2-1 / usr / share / gtk-doc / html / clutter-cookbook / clutter-cookbook.devhelp

<?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#idp57622768"/>
      <sub name="About this document" link="ch01s02.html">
        <sub name="Compiling the examples" link="ch01s02.html#idp50568768"/>
      </sub>
      <sub name="Acknowledgments" link="ch01s03.html">
        <sub name="Acknowledgments from Emmanuele" link="ch01s03.html#idp50580416"/>
        <sub name="Acknowledgements from Elliot" link="ch01s03.html#idp50582160"/>
      </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#idp57410624"/>
        <sub name="Solution" link="actors-allocation-notify.html#idp57412112"/>
        <sub name="Discussion" link="actors-allocation-notify.html#idp57421360"/>
      </sub>
      <sub name="Overriding the paint sequence" link="actors-paint-wrappers.html">
        <sub name="Problem" link="actors-paint-wrappers.html#idp57434000"/>
        <sub name="Solution" link="actors-paint-wrappers.html#idp57435312"/>
        <sub name="Discussion" link="actors-paint-wrappers.html#idp57442976"/>
      </sub>
      <sub name="Making an actor transparent by changing its opacity" link="actors-opacity.html">
        <sub name="Problem" link="actors-opacity.html#idp57451216"/>
        <sub name="Solution" link="actors-opacity.html#idp57452528"/>
        <sub name="Discussion" link="actors-opacity.html#idp57456384">
          <sub name="Container and color opacity" link="actors-opacity.html#idp57470128"/>
          <sub name="Depth and depth order" link="actors-opacity.html#idp57488160"/>
        </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#idp57503520"/>
        <sub name="Solution" link="actors-non-rectangular.html#idp57505392"/>
        <sub name="Discussion" link="actors-non-rectangular.html#idp57514208">
          <sub name="Cogl path coordinates" link="actors-non-rectangular.html#idp57517552"/>
          <sub name="Other Cogl primitives" link="actors-non-rectangular.html#idp57530496"/>
          <sub name="Using ClutterPath to store the path" link="actors-non-rectangular.html#idp57543936"/>
        </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#idp60459344"/>
        <sub name="Solutions" link="events-handling-key-events.html#idp60460656">
          <sub name="Solution 1" link="events-handling-key-events.html#idp56801600"/>
          <sub name="Solution 2" link="events-handling-key-events.html#idp58164976"/>
        </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#idp57586592"/>
          <sub name="Other useful things to know about key press events" link="events-handling-key-events.html#idp60492816"/>
        </sub>
      </sub>
      <sub name="Detecting mouse scrolling on an actor" link="events-mouse-scroll.html">
        <sub name="Problem" link="events-mouse-scroll.html#idp60502640"/>
        <sub name="Solution" link="events-mouse-scroll.html#idp60504112"/>
        <sub name="Discussion" link="events-mouse-scroll.html#idp60511984">
          <sub name="Creating a scrolling viewport for an actor" link="events-mouse-scroll.html#idp60513376"/>
        </sub>
        <sub name="Full example" link="events-mouse-scroll.html#idp60552192"/>
      </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#idp60567440"/>
          <sub name="Responding to motion events" link="events-pointer-motion.html#idp60578800"/>
        </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#idp60597920"/>
        </sub>
        <sub name="Full examples" link="events-pointer-motion.html#idp60612544"/>
      </sub>
      <sub name="Making an actor respond to button events" link="events-buttons.html">
        <sub name="Problem" link="events-buttons.html#idp60640816"/>
        <sub name="Solution" link="events-buttons.html#idp60646096"/>
        <sub name="Discussion" link="events-buttons.html#idp60663184">
          <sub name="Click count" link="events-buttons.html#idp60668848"/>
          <sub name="Button numbering" link="events-buttons.html#idp60680080"/>
          <sub name="ClutterClickAction" link="events-buttons.html#events-buttons-clutterclickaction"/>
        </sub>
        <sub name="Full examples" link="events-buttons.html#idp61178592"/>
      </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#idp56884560"/>
        <sub name="Solution" link="textures-drawing-with-cairo.html#idp59552720"/>
        <sub name="Discussion" link="textures-drawing-with-cairo.html#idp58139472">
          <sub name="Drawing pages from a PDF onto a ClutterCairoContext" link="textures-drawing-with-cairo.html#idp59919904"/>
        </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#idp60921344"/>
        <sub name="Solution" link="textures-aspect-ratio.html#idp60922784"/>
        <sub name="Discussion" link="textures-aspect-ratio.html#idp60927104"/>
      </sub>
      <sub name="Loading image data into a texture" link="textures-image-loading.html">
        <sub name="Problem" link="textures-image-loading.html#idp58869680"/>
        <sub name="Solution" link="textures-image-loading.html#idp58870992"/>
        <sub name="Discussion" link="textures-image-loading.html#idp61224352">
          <sub name="Synchronous vs. asynchronous image loading" link="textures-image-loading.html#idp61230320"/>
          <sub name="Other ways to load image data into a texture" link="textures-image-loading.html#idp61240272"/>
        </sub>
      </sub>
      <sub name="Creating sub-textures from an existing texture" link="textures-sub-textures.html">
        <sub name="Problem" link="textures-sub-textures.html#idp61248992"/>
        <sub name="Solution" link="textures-sub-textures.html#idp61250768"/>
        <sub name="Discussion" link="textures-sub-textures.html#idp61259616"/>
        <sub name="Full example" link="textures-sub-textures.html#idp61265792"/>
        <sub name="Going further" link="textures-sub-textures.html#idp61271744"/>
      </sub>
      <sub name="Creating a reflection of a texture" link="textures-reflection.html">
        <sub name="Problem" link="textures-reflection.html#idp61286784"/>
        <sub name="Solution" link="textures-reflection.html#idp61288688"/>
        <sub name="Discussion" link="textures-reflection.html#idp61296656"/>
        <sub name="Full example" link="textures-reflection.html#idp61311888"/>
      </sub>
      <sub name="Cross-fading between two images" link="textures-crossfade.html">
        <sub name="Problem" link="textures-crossfade.html#idp61320688"/>
        <sub name="Solutions" link="textures-crossfade.html#idp61322704">
          <sub name="Solution 1: two textures" link="textures-crossfade.html#idp61327600"/>
          <sub name="Solution 2: one texture with two layers" link="textures-crossfade.html#idp61360624">
            <sub name="Cross-fading using a texture combiner with interpolation" link="textures-crossfade.html#idp61365968"/>
          </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#idp61379472"/>
          <sub name="Slideshows" link="textures-crossfade.html#textures-crossfade-discussion-slideshows"/>
        </sub>
        <sub name="Full examples" link="textures-crossfade.html#idp61414992"/>
      </sub>
    </sub>
    <sub name="Animations" link="animations.html">
      <sub name="Introduction" link="animations.html#animations-introduction">
        <sub name="High level overview" link="animations.html#idp59712864"/>
        <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#idp59273040"/>
        <sub name="Solution" link="animations-inversion.html#idp59274352"/>
        <sub name="Discussion" link="animations-inversion.html#idp61531344"/>
      </sub>
      <sub name="Fading an actor out of or into view" link="animations-fading.html">
        <sub name="Problem" link="animations-fading.html#idp61540000"/>
        <sub name="Solution" link="animations-fading.html#idp61541312"/>
        <sub name="Discussion" link="animations-fading.html#idp61558496"/>
      </sub>
      <sub name="Rotating an actor" link="animations-rotating.html">
        <sub name="Problem" link="animations-rotating.html#idp61561952"/>
        <sub name="Solution" link="animations-rotating.html#idp61566528"/>
        <sub name="Discussion" link="animations-rotating.html#idp61593712">
          <sub name="Setting the rotation center for an animation" link="animations-rotating.html#idp61595232">
            <sub name="Setting a rotation center inside an actor" link="animations-rotating.html#idp61597616"/>
            <sub name="Setting the rotation center outside an actor" link="animations-rotating.html#idp61613328"/>
          </sub>
          <sub name="Direction of rotation" link="animations-rotating.html#animations-rotating-discussion-direction"/>
          <sub name="Apparent vs. actual rotation" link="animations-rotating.html#idp61647744"/>
          <sub name="Orientation of rotation axes" link="animations-rotating.html#idp61651552"/>
        </sub>
        <sub name="Full example" link="animations-rotating.html#idp61654816"/>
      </sub>
      <sub name="Creating complex animations with&#10;    ClutterAnimator" link="animations-complex.html">
        <sub name="Problem" link="animations-complex.html#idp61665568"/>
        <sub name="Solution" link="animations-complex.html#idp61667696"/>
        <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#idp62205104"/>
      </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#idp62289104"/>
        <sub name="Solutions" link="animations-moving.html#idp62293472">
          <sub name="Solution 1: Implicit animations" link="animations-moving.html#idp62296528"/>
          <sub name="Solution 2: ClutterState" link="animations-moving.html#idp62301664"/>
          <sub name="Solution 3: ClutterAnimator" link="animations-moving.html#idp62307536"/>
        </sub>
        <sub name="Discussion" link="animations-moving.html#idp62315136">
          <sub name="Movement can take an actor &quot;outside&quot; its container" link="animations-moving.html#idp62315776"/>
          <sub name="Anchor points can affect movement" link="animations-moving.html#idp62318720"/>
          <sub name="Actors can move in the z axis" link="animations-moving.html#idp62340240"/>
          <sub name="Movement is affected by constraints" link="animations-moving.html#idp62351040"/>
        </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#idp62395360"/>
        <sub name="Solutions" link="animations-looping.html#idp62396592">
          <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#idp62411728"/>
          <sub name="Solution 3: looping with ClutterState" link="animations-looping.html#idp62423680"/>
        </sub>
        <sub name="Discussion" link="animations-looping.html#idp62442064">
          <sub name="Looping a fixed number of times" link="animations-looping.html#idp62448128"/>
          <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#idp62483952"/>
        <sub name="Solution" link="animations-scaling.html#idp62487360"/>
        <sub name="Discussion" link="animations-scaling.html#idp62494144">
          <sub name="Scaling vs. resizing" link="animations-scaling.html#idp62504592"/>
          <sub name="Scaling, layouts and containers" link="animations-scaling.html#idp62514336"/>
          <sub name="Setting the scale center" link="animations-scaling.html#idp62517696"/>
        </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#idp62554784"/>
        <sub name="Solution" link="animations-path.html#idp62556064"/>
        <sub name="Discussion" link="animations-path.html#idp62571232">
          <sub name="Other ways to animate along a path" link="animations-path.html#idp62585504"/>
        </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#idp50610032"/>
        <sub name="Solution" link="text-shadow.html#idp56702624"/>
        <sub name="Discussion" link="text-shadow.html#idp56360304"/>
        <sub name="Full example" link="text-shadow.html#idp57120736"/>
      </sub>
    </sub>
    <sub name="Layout management" link="layouts.html">
      <sub name="Introduction" link="layouts.html#layouts-introduction">
        <sub name="Using layouts" link="layouts.html#idp60366816"/>
        <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#idp61870864"/>
        </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#idp61884672"/>
          <sub name="Using ClutterConstraint" link="layouts.html#idp61887792"/>
        </sub>
      </sub>
      <sub name="Stacking actors on top of each other" link="layouts-stacking.html">
        <sub name="Problem" link="layouts-stacking.html#idp61896640"/>
        <sub name="Solution" link="layouts-stacking.html#layouts-stacking-solution"/>
        <sub name="Discussion" link="layouts-stacking.html#idp58875840">
          <sub name="Setting and changing alignment" link="layouts-stacking.html#idp61904720"/>
          <sub name="Size requisitioning" link="layouts-stacking.html#layouts-stacking-size-requisitioning"/>
          <sub name="Depth ordering" link="layouts-stacking.html#idp61922496"/>
          <sub name="Other ways to stack actors" link="layouts-stacking.html#idp61926448"/>
        </sub>
        <sub name="Full examples" link="layouts-stacking.html#idp61932800"/>
      </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#idp61946624"/>
        <sub name="Solution" link="layouts-bind-constraint.html#idp61950960"/>
        <sub name="Discussion" link="layouts-bind-constraint.html#idp61968464">
          <sub name="Another way to bind actors' sizes together" link="layouts-bind-constraint.html#idp61980864"/>
        </sub>
        <sub name="Full examples" link="layouts-bind-constraint.html#idp61987632"/>
      </sub>
      <sub name="Arranging actors in a single row or column" link="layouts-box.html">
        <sub name="Problem" link="layouts-box.html#idp62003296"/>
        <sub name="Solution" link="layouts-box.html#idp62007312"/>
        <sub name="Discussion" link="layouts-box.html#idp62020128">
          <sub name="Layout properties" link="layouts-box.html#idp62023648">
            <sub name="ClutterBoxLayout properties" link="layouts-box.html#idp62030160"/>
            <sub name="Child properties" link="layouts-box.html#idp62050784"/>
          </sub>
          <sub name="Animating layout changes" link="layouts-box.html#layouts-box-animating-layout-changes"/>
        </sub>
        <sub name="Full examples" link="layouts-box.html#idp62079936"/>
      </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#idp56994048"/>
        <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#idp61056752"/>
        <sub name="Solution" link="script-ui.html#idp60313456"/>
        <sub name="Discussion" link="script-ui.html#idp60332512"/>
      </sub>
      <sub name="Connecting to signals in ClutterScript" link="script-signals.html">
        <sub name="Problem" link="script-signals.html#idp60336352"/>
        <sub name="Solution" link="script-signals.html#idp60337776"/>
        <sub name="Discussion" link="script-signals.html#script-signals-discussion">
          <sub name="Options for connecting signals to handlers" link="script-signals.html#idp61774848"/>
          <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#idp60967024"/>
        </sub>
        <sub name="Full examples" link="script-signals.html#idp60976400"/>
      </sub>
      <sub name="Connecting ClutterState states in ClutterScript" link="script-state.html">
        <sub name="Problem" link="script-state.html#idp60989392"/>
        <sub name="Solution" link="script-state.html#idp60991152"/>
        <sub name="Discussion" link="script-state.html#idp60999600"/>
        <sub name="Full examples" link="script-state.html#idp61079008"/>
      </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#idp59985088"/>
        <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#idp58019968"/>
        <sub name="Solution" link="effects-basic.html#idp58026480"/>
        <sub name="Discussion" link="effects-basic.html#idp59640832">
          <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#idp62690000"/>
        <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#idp62737376"/>
          <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#idp62775520"/>
      </sub>
    </sub>
    <sub name="Contributing to this document" link="contributing.html"/>
  </chapters>
  <functions/>
</book>