]> Emmanuele Bassi
&author_mail;
2008 Intel Corporation This document is distributed under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. A copy of this license can be found in the file COPYING included with the source code of this program. The Clutter Cookbook &version;
Preface The Perl Cookbook Let me show you that easy way, so others may easily follow. There is a wonderful simile in the preface of the Perl Cookbook: approaching a programming problem is oftentimes similar to balancing Columbus's egg. The initial difficulties of dealing with, and more importantly solving, problems in the computer programming field sometimes can sometimes only be overcome if somebody shows you how to use a new tool. This is true for programming languages but also for programming libraries. This book has been written to try and give you a reference on how to solve common issues that you might have to face when using the Clutter toolkit. This book is not meant to be a replacement for the API reference, even though there will be descriptions of how Clutter works and how its API looks like. We will require knowledge of the Clutter API, but we will also point out where to find more information on the API that examples have used. Indeed, this book should be used as a companion to the API reference, expanding the examples and showing how to achieve a specific result. This is not a book for learning Clutter. This is also not a book for learning C, or GObject or even GUI development. Above all, this is a book for learning more about Clutter, and about how to use it in the most efficient and easiest way. It is meant to help you move past the basic usage of Clutter This book is divided into chapters. Each chapter is dedicated to a specific class, or a specific area. Each chapter starts with a short introduction, followed by different recipes. Each recipe has a problem, as a short statement describing what we want to achieve; a solution, containing the source code; and a discussion section, where the code is explained, where alternative approaches might be usefule, caveats and references to the Clutter API for furher studying. This book, in the cookbook spirit, can be accessed mostly at random.
About Clutter Clutter is an free and open source software library for creating fast, visually rich and animated graphical user interfaces. Clutter uses OpenGL (and, optionally, OpenGL ES on mobile and embedded platforms) for rendering the user interface elements, but at the same time it exposes an application program interface that hides the underlying complexity of the OpenGL state machine from the developer. The program interface of Clutter is intended to be easy to use, efficient, flexible and as self-documenting as possible.
About this document This document is available in various formats like HTML, text and PDF. The latest version is always available at &docurl;.
Where to get Clutter You can obtain Clutter from &appurl; or perhaps from your distributor.
License Clutter is distributed under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. A copy of this license can be found in the file COPYING included with the source code of this program.
Actors the author of the epigraph a short epigraph
Introduction introduction
A problem involving actors
Problem Description of the problem
Solution The solution of the problem, with the source code
Discussion Discussion of the solution, with eventual mentions of possible alternatives
Textures the author of the epigraph a short epigraph
Introduction introduction
Maintaining the aspect ratio when loading a texture
Problem
Solution
Discussion
Animations the author of the epigraph a short epigraph
Introduction introduction
Inverting Animations
Problem
Solution
Discussion
Contributing to this document This document is written in Docbook XML. The source file for this document is located in the subdirectory "doc/cookbook" of the source directory of Clutter.