Programming with Cluttermm Murray Cumming Daniel Elstner Programming with Cluttermm by Murray Cumming and Daniel Elstner Copyright © 2007, 2008, 2009 Openismus GmbH We very much appreciate any reports of inaccuracies or other errors in this document. Contributions are also most welcome. Post your suggestions, critiques or addenda to the team (mailto:[email protected]). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. You may obtain a copy of the GNU Free Documentation License from the Free Software Foundation by visiting their Web site or by writing to: Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. Table of Contents 1. Introduction............................................................................................................................................1 1.1. This Book....................................................................................................................................1 1.2. Clutter..........................................................................................................................................1 1.3. Cluttermm...................................................................................................................................2 2. Installation..............................................................................................................................................3 2.1. Prebuilt Packages........................................................................................................................3 2.2. Installing from Source.................................................................................................................3 2.2.1. Dependencies..................................................................................................................3 3. Header Files And Linking.....................................................................................................................5 4. The Stage................................................................................................................................................6 4.1. Stage Basics................................................................................................................................6 4.1.1. Example..........................................................................................................................6 4.2. Stage Widget...............................................................................................................................8 4.2.1. Example..........................................................................................................................9 5. Actors....................................................................................................................................................12 5.1. Actor Basics..............................................................................................................................12 5.1.1. Example........................................................................................................................13 5.2. Transformations........................................................................................................................14 5.2.1. Scaling..........................................................................................................................14 5.2.2. Rotation........................................................................................................................14 5.2.3. Clipping........................................................................................................................15 5.2.4. Movement.....................................................................................................................15 5.2.5. Example........................................................................................................................15 5.3. Containers.................................................................................................................................17 5.3.1. Example........................................................................................................................18 5.4. Events........................................................................................................................................19 5.4.1. Example........................................................................................................................20 6. Timelines...............................................................................................................................................22 6.1. Using Timelines........................................................................................................................22 6.2. Example....................................................................................................................................22 6.3. Grouping TimeLines in a Score................................................................................................24 6.4. Example....................................................................................................................................25 7. Effects....................................................................................................................................................28 7.1. Using Effects.............................................................................................................................28 7.2. Example....................................................................................................................................29 8. Behaviours............................................................................................................................................32 8.1. Using Behaviours......................................................................................................................32 8.2. Example....................................................................................................................................34 9. Full Example........................................................................................................................................38 A. Implementing Actors..........................................................................................................................48 A.1. Implementing Simple Actors...................................................................................................48 A.2. Example....................................................................................................................................49 A.3. Implementing Container Actors...............................................................................................53 iii A.3.1. Clutter::Actor virtual functions to implement.............................................................53 A.3.2. Clutter::Container virtual methods to implement........................................................54 A.4. Example....................................................................................................................................54 B. Implementing Scrolling in a Window-like Actor.............................................................................62 B.1. The Technique..........................................................................................................................62 B.2. Example....................................................................................................................................62 10. Contributing.......................................................................................................................................70 iv List of Figures 4-1. Stage.....................................................................................................................................................6 4-2. Stage Widget........................................................................................................................................9 5-1. Actor...................................................................................................................................................13 5-2. Actor...................................................................................................................................................15 5-3. Group..................................................................................................................................................18 5-4. Actor Events.......................................................................................................................................20 6-1. Timeline..............................................................................................................................................22 6-2. Score...................................................................................................................................................25 7-1. Graphic representation of some alpha functions................................................................................28 7-2. Behaviour...........................................................................................................................................29