diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/ABOUT-NLS clutter-0.7.6/ABOUT-NLS --- clutter-0.7.4/ABOUT-NLS 1970-01-01 01:00:00.000000000 +0100 +++ clutter-0.7.6/ABOUT-NLS 2008-06-10 15:11:42.000000000 +0100 @@ -0,0 +1,1068 @@ +1 Notes on the Free Translation Project +*************************************** + +Free software is going international! The Free Translation Project is +a way to get maintainers of free software, translators, and users all +together, so that free software will gradually become able to speak many +languages. A few packages already provide translations for their +messages. + + If you found this `ABOUT-NLS' file inside a distribution, you may +assume that the distributed package does use GNU `gettext' internally, +itself available at your nearest GNU archive site. But you do _not_ +need to install GNU `gettext' prior to configuring, installing or using +this package with messages translated. + + Installers will find here some useful hints. These notes also +explain how users should proceed for getting the programs to use the +available translations. They tell how people wanting to contribute and +work on translations can contact the appropriate team. + + When reporting bugs in the `intl/' directory or bugs which may be +related to internationalization, you should tell about the version of +`gettext' which is used. The information can be found in the +`intl/VERSION' file, in internationalized packages. + +1.1 Quick configuration advice +============================== + +If you want to exploit the full power of internationalization, you +should configure it using + + ./configure --with-included-gettext + +to force usage of internationalizing routines provided within this +package, despite the existence of internationalizing capabilities in the +operating system where this package is being installed. So far, only +the `gettext' implementation in the GNU C library version 2 provides as +many features (such as locale alias, message inheritance, automatic +charset conversion or plural form handling) as the implementation here. +It is also not possible to offer this additional functionality on top +of a `catgets' implementation. Future versions of GNU `gettext' will +very likely convey even more functionality. So it might be a good idea +to change to GNU `gettext' as soon as possible. + + So you need _not_ provide this option if you are using GNU libc 2 or +you have installed a recent copy of the GNU gettext package with the +included `libintl'. + +1.2 INSTALL Matters +=================== + +Some packages are "localizable" when properly installed; the programs +they contain can be made to speak your own native language. Most such +packages use GNU `gettext'. Other packages have their own ways to +internationalization, predating GNU `gettext'. + + By default, this package will be installed to allow translation of +messages. It will automatically detect whether the system already +provides the GNU `gettext' functions. If not, the included GNU +`gettext' library will be used. This library is wholly contained +within this package, usually in the `intl/' subdirectory, so prior +installation of the GNU `gettext' package is _not_ required. +Installers may use special options at configuration time for changing +the default behaviour. The commands: + + ./configure --with-included-gettext + ./configure --disable-nls + +will, respectively, bypass any pre-existing `gettext' to use the +internationalizing routines provided within this package, or else, +_totally_ disable translation of messages. + + When you already have GNU `gettext' installed on your system and run +configure without an option for your new package, `configure' will +probably detect the previously built and installed `libintl.a' file and +will decide to use this. This might not be desirable. You should use +the more recent version of the GNU `gettext' library. I.e. if the file +`intl/VERSION' shows that the library which comes with this package is +more recent, you should use + + ./configure --with-included-gettext + +to prevent auto-detection. + + The configuration process will not test for the `catgets' function +and therefore it will not be used. The reason is that even an +emulation of `gettext' on top of `catgets' could not provide all the +extensions of the GNU `gettext' library. + + Internationalized packages usually have many `po/LL.po' files, where +LL gives an ISO 639 two-letter code identifying the language. Unless +translations have been forbidden at `configure' time by using the +`--disable-nls' switch, all available translations are installed +together with the package. However, the environment variable `LINGUAS' +may be set, prior to configuration, to limit the installed set. +`LINGUAS' should then contain a space separated list of two-letter +codes, stating which languages are allowed. + +1.3 Using This Package +====================== + +As a user, if your language has been installed for this package, you +only have to set the `LANG' environment variable to the appropriate +`LL_CC' combination. If you happen to have the `LC_ALL' or some other +`LC_xxx' environment variables set, you should unset them before +setting `LANG', otherwise the setting of `LANG' will not have the +desired effect. Here `LL' is an ISO 639 two-letter language code, and +`CC' is an ISO 3166 two-letter country code. For example, let's +suppose that you speak German and live in Germany. At the shell +prompt, merely execute `setenv LANG de_DE' (in `csh'), +`export LANG; LANG=de_DE' (in `sh') or `export LANG=de_DE' (in `bash'). +This can be done from your `.login' or `.profile' file, once and for +all. + + You might think that the country code specification is redundant. +But in fact, some languages have dialects in different countries. For +example, `de_AT' is used for Austria, and `pt_BR' for Brazil. The +country code serves to distinguish the dialects. + + The locale naming convention of `LL_CC', with `LL' denoting the +language and `CC' denoting the country, is the one use on systems based +on GNU libc. On other systems, some variations of this scheme are +used, such as `LL' or `LL_CC.ENCODING'. You can get the list of +locales supported by your system for your language by running the +command `locale -a | grep '^LL''. + + Not all programs have translations for all languages. By default, an +English message is shown in place of a nonexistent translation. If you +understand other languages, you can set up a priority list of languages. +This is done through a different environment variable, called +`LANGUAGE'. GNU `gettext' gives preference to `LANGUAGE' over `LANG' +for the purpose of message handling, but you still need to have `LANG' +set to the primary language; this is required by other parts of the +system libraries. For example, some Swedish users who would rather +read translations in German than English for when Swedish is not +available, set `LANGUAGE' to `sv:de' while leaving `LANG' to `sv_SE'. + + Special advice for Norwegian users: The language code for Norwegian +bokma*l changed from `no' to `nb' recently (in 2003). During the +transition period, while some message catalogs for this language are +installed under `nb' and some older ones under `no', it's recommended +for Norwegian users to set `LANGUAGE' to `nb:no' so that both newer and +older translations are used. + + In the `LANGUAGE' environment variable, but not in the `LANG' +environment variable, `LL_CC' combinations can be abbreviated as `LL' +to denote the language's main dialect. For example, `de' is equivalent +to `de_DE' (German as spoken in Germany), and `pt' to `pt_PT' +(Portuguese as spoken in Portugal) in this context. + +1.4 Translating Teams +===================== + +For the Free Translation Project to be a success, we need interested +people who like their own language and write it well, and who are also +able to synergize with other translators speaking the same language. +Each translation team has its own mailing list. The up-to-date list of +teams can be found at the Free Translation Project's homepage, +`http://translationproject.org/', in the "Teams" area. + + If you'd like to volunteer to _work_ at translating messages, you +should become a member of the translating team for your own language. +The subscribing address is _not_ the same as the list itself, it has +`-request' appended. For example, speakers of Swedish can send a +message to `sv-request@li.org', having this message body: + + subscribe + + Keep in mind that team members are expected to participate +_actively_ in translations, or at solving translational difficulties, +rather than merely lurking around. If your team does not exist yet and +you want to start one, or if you are unsure about what to do or how to +get started, please write to `coordinator@translationproject.org' to +reach the coordinator for all translator teams. + + The English team is special. It works at improving and uniformizing +the terminology in use. Proven linguistic skills are praised more than +programming skills, here. + +1.5 Available Packages +====================== + +Languages are not equally supported in all packages. The following +matrix shows the current state of internationalization, as of November +2007. The matrix shows, in regard of each package, for which languages +PO files have been submitted to translation coordination, with a +translation percentage of at least 50%. + + Ready PO files af am ar az be bg bs ca cs cy da de el en en_GB eo + +----------------------------------------------------+ + Compendium | [] [] [] [] | + a2ps | [] [] [] [] [] | + aegis | () | + ant-phone | () | + anubis | [] | + ap-utils | | + aspell | [] [] [] [] [] | + bash | [] | + bfd | | + bibshelf | [] | + binutils | | + bison | [] [] | + bison-runtime | [] | + bluez-pin | [] [] [] [] [] | + cflow | [] | + clisp | [] [] [] | + console-tools | [] [] | + coreutils | [] [] [] [] | + cpio | | + cpplib | [] [] [] | + cryptonit | [] | + dialog | | + diffutils | [] [] [] [] [] [] | + doodle | [] | + e2fsprogs | [] [] | + enscript | [] [] [] [] | + fetchmail | [] [] () [] [] | + findutils | [] | + findutils_stable | [] [] [] | + flex | [] [] [] | + fslint | | + gas | | + gawk | [] [] [] | + gcal | [] | + gcc | [] | + gettext-examples | [] [] [] [] [] | + gettext-runtime | [] [] [] [] [] | + gettext-tools | [] [] | + gip | [] | + gliv | [] [] | + glunarclock | [] | + gmult | [] [] | + gnubiff | () | + gnucash | [] [] () () [] | + gnuedu | | + gnulib | [] | + gnunet | | + gnunet-gtk | | + gnutls | [] | + gpe-aerial | [] [] | + gpe-beam | [] [] | + gpe-calendar | | + gpe-clock | [] [] | + gpe-conf | [] [] | + gpe-contacts | | + gpe-edit | [] | + gpe-filemanager | | + gpe-go | [] | + gpe-login | [] [] | + gpe-ownerinfo | [] [] | + gpe-package | | + gpe-sketchbook | [] [] | + gpe-su | [] [] | + gpe-taskmanager | [] [] | + gpe-timesheet | [] | + gpe-today | [] [] | + gpe-todo | | + gphoto2 | [] [] [] [] | + gprof | [] [] | + gpsdrive | | + gramadoir | [] [] | + grep | [] [] | + gretl | () | + gsasl | | + gss | | + gst-plugins-bad | [] [] | + gst-plugins-base | [] [] | + gst-plugins-good | [] [] [] | + gst-plugins-ugly | [] [] | + gstreamer | [] [] [] [] [] [] [] | + gtick | () | + gtkam | [] [] [] [] | + gtkorphan | [] [] | + gtkspell | [] [] [] [] | + gutenprint | [] | + hello | [] [] [] [] [] | + herrie | [] | + hylafax | | + idutils | [] [] | + indent | [] [] [] [] | + iso_15924 | | + iso_3166 | [] [] [] [] [] [] [] [] [] [] [] | + iso_3166_2 | | + iso_4217 | [] [] [] | + iso_639 | [] [] [] [] | + jpilot | [] | + jtag | | + jwhois | | + kbd | [] [] [] [] | + keytouch | [] [] | + keytouch-editor | [] | + keytouch-keyboa... | [] | + latrine | () | + ld | [] | + leafpad | [] [] [] [] [] | + libc | [] [] [] [] | + libexif | [] | + libextractor | [] | + libgpewidget | [] [] [] | + libgpg-error | [] | + libgphoto2 | [] [] | + libgphoto2_port | [] [] | + libgsasl | | + libiconv | [] [] | + libidn | [] [] [] | + lifelines | [] () | + lilypond | [] | + lingoteach | | + lprng | | + lynx | [] [] [] [] | + m4 | [] [] [] [] | + mailfromd | | + mailutils | [] | + make | [] [] | + man-db | [] [] [] | + minicom | [] [] [] | + nano | [] [] [] | + opcodes | [] | + parted | [] [] | + pilot-qof | | + popt | [] [] [] | + psmisc | [] | + pwdutils | | + qof | | + radius | [] | + recode | [] [] [] [] [] [] | + rpm | [] | + screem | | + scrollkeeper | [] [] [] [] [] [] [] [] | + sed | [] [] [] | + shared-mime-info | [] [] [] [] () [] [] [] | + sharutils | [] [] [] [] [] [] | + shishi | | + skencil | [] () | + solfege | | + soundtracker | [] [] | + sp | [] | + system-tools-ba... | [] [] [] [] [] [] [] [] [] | + tar | [] [] | + texinfo | [] [] [] | + tin | () () | + tuxpaint | [] [] [] [] [] [] | + unicode-han-tra... | | + unicode-transla... | | + util-linux | [] [] [] [] | + util-linux-ng | [] [] [] [] | + vorbis-tools | [] | + wastesedge | () | + wdiff | [] [] [] [] | + wget | [] [] [] | + xchat | [] [] [] [] [] [] [] | + xkeyboard-config | [] | + xpad | [] [] [] | + +----------------------------------------------------+ + af am ar az be bg bs ca cs cy da de el en en_GB eo + 6 0 2 1 8 26 2 40 48 2 56 88 15 1 15 18 + + es et eu fa fi fr ga gl gu he hi hr hu id is it + +--------------------------------------------------+ + Compendium | [] [] [] [] [] | + a2ps | [] [] [] () | + aegis | | + ant-phone | [] | + anubis | [] | + ap-utils | [] [] | + aspell | [] [] [] | + bash | [] | + bfd | [] [] | + bibshelf | [] [] [] | + binutils | [] [] [] | + bison | [] [] [] [] [] [] | + bison-runtime | [] [] [] [] [] | + bluez-pin | [] [] [] [] [] | + cflow | [] | + clisp | [] [] | + console-tools | | + coreutils | [] [] [] [] [] [] | + cpio | [] [] [] | + cpplib | [] [] | + cryptonit | [] | + dialog | [] [] [] | + diffutils | [] [] [] [] [] [] [] [] [] | + doodle | [] [] | + e2fsprogs | [] [] [] | + enscript | [] [] [] | + fetchmail | [] | + findutils | [] [] [] | + findutils_stable | [] [] [] [] | + flex | [] [] [] | + fslint | | + gas | [] [] | + gawk | [] [] [] [] () | + gcal | [] [] | + gcc | [] | + gettext-examples | [] [] [] [] [] [] [] | + gettext-runtime | [] [] [] [] [] [] | + gettext-tools | [] [] [] [] | + gip | [] [] [] [] | + gliv | () | + glunarclock | [] [] [] | + gmult | [] [] [] | + gnubiff | () () | + gnucash | () () () | + gnuedu | [] | + gnulib | [] [] [] | + gnunet | | + gnunet-gtk | | + gnutls | | + gpe-aerial | [] [] | + gpe-beam | [] [] | + gpe-calendar | | + gpe-clock | [] [] [] [] | + gpe-conf | [] | + gpe-contacts | [] [] | + gpe-edit | [] [] [] [] | + gpe-filemanager | [] | + gpe-go | [] [] [] | + gpe-login | [] [] [] | + gpe-ownerinfo | [] [] [] [] [] | + gpe-package | [] | + gpe-sketchbook | [] [] | + gpe-su | [] [] [] [] | + gpe-taskmanager | [] [] [] | + gpe-timesheet | [] [] [] [] | + gpe-today | [] [] [] [] | + gpe-todo | [] | + gphoto2 | [] [] [] [] [] | + gprof | [] [] [] [] [] | + gpsdrive | [] | + gramadoir | [] [] | + grep | [] [] [] | + gretl | [] [] [] () | + gsasl | [] [] | + gss | [] [] | + gst-plugins-bad | [] [] [] [] | + gst-plugins-base | [] [] [] [] | + gst-plugins-good | [] [] [] [] [] | + gst-plugins-ugly | [] [] [] [] | + gstreamer | [] [] [] | + gtick | [] [] [] | + gtkam | [] [] [] [] | + gtkorphan | [] [] | + gtkspell | [] [] [] [] [] [] [] | + gutenprint | [] | + hello | [] [] [] [] [] [] [] [] [] [] [] [] [] | + herrie | [] | + hylafax | | + idutils | [] [] [] [] [] | + indent | [] [] [] [] [] [] [] [] [] [] | + iso_15924 | [] | + iso_3166 | [] [] [] [] [] [] [] [] [] [] [] [] [] | + iso_3166_2 | [] | + iso_4217 | [] [] [] [] [] [] | + iso_639 | [] [] [] [] [] [] | + jpilot | [] [] | + jtag | [] | + jwhois | [] [] [] [] [] | + kbd | [] [] | + keytouch | [] [] [] | + keytouch-editor | [] | + keytouch-keyboa... | [] [] | + latrine | [] [] | + ld | [] [] [] [] | + leafpad | [] [] [] [] [] [] | + libc | [] [] [] [] [] | + libexif | [] | + libextractor | [] | + libgpewidget | [] [] [] [] [] | + libgpg-error | [] | + libgphoto2 | [] [] [] | + libgphoto2_port | [] [] | + libgsasl | [] [] | + libiconv | [] [] [] | + libidn | [] [] | + lifelines | () | + lilypond | [] [] [] | + lingoteach | [] [] [] | + lprng | | + lynx | [] [] [] | + m4 | [] [] [] [] | + mailfromd | | + mailutils | [] [] | + make | [] [] [] [] [] [] [] [] | + man-db | [] | + minicom | [] [] [] [] | + nano | [] [] [] [] [] [] [] | + opcodes | [] [] [] [] | + parted | [] [] [] | + pilot-qof | | + popt | [] [] [] [] | + psmisc | [] [] | + pwdutils | | + qof | [] | + radius | [] [] | + recode | [] [] [] [] [] [] [] [] | + rpm | [] [] | + screem | | + scrollkeeper | [] [] [] | + sed | [] [] [] [] [] | + shared-mime-info | [] [] [] [] [] [] | + sharutils | [] [] [] [] [] [] [] [] | + shishi | [] | + skencil | [] [] | + solfege | [] | + soundtracker | [] [] [] | + sp | [] | + system-tools-ba... | [] [] [] [] [] [] [] [] [] | + tar | [] [] [] [] [] | + texinfo | [] [] [] | + tin | [] () | + tuxpaint | [] [] | + unicode-han-tra... | | + unicode-transla... | [] [] | + util-linux | [] [] [] [] [] [] [] | + util-linux-ng | [] [] [] [] [] [] [] | + vorbis-tools | | + wastesedge | () | + wdiff | [] [] [] [] [] [] [] [] | + wget | [] [] [] [] [] [] [] [] | + xchat | [] [] [] [] [] [] [] | + xkeyboard-config | [] [] [] [] | + xpad | [] [] [] | + +--------------------------------------------------+ + es et eu fa fi fr ga gl gu he hi hr hu id is it + 85 22 14 2 48 101 61 12 2 8 2 6 53 29 1 52 + + ja ka ko ku ky lg lt lv mk mn ms mt nb ne nl nn + +--------------------------------------------------+ + Compendium | [] | + a2ps | () [] [] | + aegis | () | + ant-phone | [] | + anubis | [] [] [] | + ap-utils | [] | + aspell | [] [] | + bash | [] | + bfd | | + bibshelf | [] | + binutils | | + bison | [] [] [] | + bison-runtime | [] [] [] | + bluez-pin | [] [] [] | + cflow | | + clisp | [] | + console-tools | | + coreutils | [] | + cpio | [] | + cpplib | [] | + cryptonit | [] | + dialog | [] [] | + diffutils | [] [] [] | + doodle | | + e2fsprogs | [] | + enscript | [] | + fetchmail | [] [] | + findutils | [] | + findutils_stable | [] | + flex | [] [] | + fslint | | + gas | | + gawk | [] [] | + gcal | | + gcc | | + gettext-examples | [] [] [] | + gettext-runtime | [] [] [] | + gettext-tools | [] [] | + gip | [] [] | + gliv | [] | + glunarclock | [] [] | + gmult | [] [] [] | + gnubiff | | + gnucash | () () () | + gnuedu | | + gnulib | [] [] | + gnunet | | + gnunet-gtk | | + gnutls | [] | + gpe-aerial | [] | + gpe-beam | [] | + gpe-calendar | [] | + gpe-clock | [] [] [] | + gpe-conf | [] [] [] | + gpe-contacts | [] | + gpe-edit | [] [] [] | + gpe-filemanager | [] [] | + gpe-go | [] [] [] | + gpe-login | [] [] [] | + gpe-ownerinfo | [] [] | + gpe-package | [] [] | + gpe-sketchbook | [] [] | + gpe-su | [] [] [] | + gpe-taskmanager | [] [] [] [] | + gpe-timesheet | [] | + gpe-today | [] [] | + gpe-todo | [] | + gphoto2 | [] [] | + gprof | [] | + gpsdrive | [] | + gramadoir | () | + grep | [] [] | + gretl | | + gsasl | [] | + gss | | + gst-plugins-bad | [] | + gst-plugins-base | [] | + gst-plugins-good | [] | + gst-plugins-ugly | [] | + gstreamer | [] | + gtick | [] | + gtkam | [] [] | + gtkorphan | [] | + gtkspell | [] [] | + gutenprint | [] | + hello | [] [] [] [] [] [] [] | + herrie | [] | + hylafax | | + idutils | [] | + indent | [] [] | + iso_15924 | [] | + iso_3166 | [] [] [] [] [] [] [] [] | + iso_3166_2 | [] | + iso_4217 | [] [] [] | + iso_639 | [] [] [] [] | + jpilot | () () | + jtag | | + jwhois | [] | + kbd | [] | + keytouch | [] | + keytouch-editor | [] | + keytouch-keyboa... | | + latrine | [] | + ld | | + leafpad | [] [] | + libc | [] [] [] | + libexif | | + libextractor | | + libgpewidget | [] | + libgpg-error | | + libgphoto2 | [] | + libgphoto2_port | [] | + libgsasl | [] | + libiconv | [] | + libidn | [] [] | + lifelines | [] | + lilypond | [] | + lingoteach | [] | + lprng | | + lynx | [] [] | + m4 | [] [] | + mailfromd | | + mailutils | | + make | [] [] [] | + man-db | | + minicom | [] | + nano | [] [] [] | + opcodes | [] | + parted | [] [] | + pilot-qof | | + popt | [] [] [] | + psmisc | [] [] [] | + pwdutils | | + qof | | + radius | | + recode | [] | + rpm | [] [] | + screem | [] | + scrollkeeper | [] [] [] [] | + sed | [] [] | + shared-mime-info | [] [] [] [] [] [] [] | + sharutils | [] [] | + shishi | | + skencil | | + solfege | () () | + soundtracker | | + sp | () | + system-tools-ba... | [] [] [] [] | + tar | [] [] [] | + texinfo | [] [] | + tin | | + tuxpaint | () [] [] | + unicode-han-tra... | | + unicode-transla... | | + util-linux | [] [] | + util-linux-ng | [] [] | + vorbis-tools | | + wastesedge | [] | + wdiff | [] [] | + wget | [] [] | + xchat | [] [] [] [] | + xkeyboard-config | [] [] [] | + xpad | [] [] [] | + +--------------------------------------------------+ + ja ka ko ku ky lg lt lv mk mn ms mt nb ne nl nn + 51 2 25 3 2 0 6 0 2 2 20 0 11 1 103 6 + + or pa pl pt pt_BR rm ro ru rw sk sl sq sr sv ta + +--------------------------------------------------+ + Compendium | [] [] [] [] [] | + a2ps | () [] [] [] [] [] [] | + aegis | () () | + ant-phone | [] [] | + anubis | [] [] [] | + ap-utils | () | + aspell | [] [] [] | + bash | [] [] | + bfd | | + bibshelf | [] | + binutils | [] [] | + bison | [] [] [] [] [] | + bison-runtime | [] [] [] [] [] | + bluez-pin | [] [] [] [] [] [] [] [] [] | + cflow | [] | + clisp | [] | + console-tools | [] | + coreutils | [] [] [] [] | + cpio | [] [] [] | + cpplib | [] | + cryptonit | [] [] | + dialog | [] | + diffutils | [] [] [] [] [] [] | + doodle | [] [] | + e2fsprogs | [] [] | + enscript | [] [] [] [] [] | + fetchmail | [] [] [] | + findutils | [] [] [] | + findutils_stable | [] [] [] [] [] [] | + flex | [] [] [] [] [] | + fslint | [] | + gas | | + gawk | [] [] [] [] | + gcal | [] | + gcc | [] [] | + gettext-examples | [] [] [] [] [] [] [] [] | + gettext-runtime | [] [] [] [] [] [] [] [] | + gettext-tools | [] [] [] [] [] [] [] | + gip | [] [] [] [] | + gliv | [] [] [] [] [] [] | + glunarclock | [] [] [] [] [] [] | + gmult | [] [] [] [] | + gnubiff | () [] | + gnucash | () [] | + gnuedu | | + gnulib | [] [] [] | + gnunet | | + gnunet-gtk | [] | + gnutls | [] [] | + gpe-aerial | [] [] [] [] [] [] [] | + gpe-beam | [] [] [] [] [] [] [] | + gpe-calendar | [] [] [] [] | + gpe-clock | [] [] [] [] [] [] [] [] | + gpe-conf | [] [] [] [] [] [] [] | + gpe-contacts | [] [] [] [] [] | + gpe-edit | [] [] [] [] [] [] [] [] [] | + gpe-filemanager | [] [] | + gpe-go | [] [] [] [] [] [] [] [] | + gpe-login | [] [] [] [] [] [] [] [] | + gpe-ownerinfo | [] [] [] [] [] [] [] [] | + gpe-package | [] [] | + gpe-sketchbook | [] [] [] [] [] [] [] [] | + gpe-su | [] [] [] [] [] [] [] [] | + gpe-taskmanager | [] [] [] [] [] [] [] [] | + gpe-timesheet | [] [] [] [] [] [] [] [] | + gpe-today | [] [] [] [] [] [] [] [] | + gpe-todo | [] [] [] [] | + gphoto2 | [] [] [] [] [] [] | + gprof | [] [] [] | + gpsdrive | [] [] | + gramadoir | [] [] | + grep | [] [] [] [] | + gretl | [] [] [] | + gsasl | [] [] [] | + gss | [] [] [] [] | + gst-plugins-bad | [] [] [] | + gst-plugins-base | [] [] | + gst-plugins-good | [] [] | + gst-plugins-ugly | [] [] [] | + gstreamer | [] [] [] [] | + gtick | [] | + gtkam | [] [] [] [] [] | + gtkorphan | [] | + gtkspell | [] [] [] [] [] [] [] [] | + gutenprint | [] | + hello | [] [] [] [] [] [] [] [] | + herrie | [] [] [] | + hylafax | | + idutils | [] [] [] [] [] | + indent | [] [] [] [] [] [] [] | + iso_15924 | | + iso_3166 | [] [] [] [] [] [] [] [] [] [] [] [] [] | + iso_3166_2 | | + iso_4217 | [] [] [] [] [] [] [] | + iso_639 | [] [] [] [] [] [] [] | + jpilot | | + jtag | [] | + jwhois | [] [] [] [] | + kbd | [] [] [] | + keytouch | [] | + keytouch-editor | [] | + keytouch-keyboa... | [] | + latrine | | + ld | [] | + leafpad | [] [] [] [] [] [] | + libc | [] [] [] [] | + libexif | [] [] | + libextractor | [] [] | + libgpewidget | [] [] [] [] [] [] [] [] | + libgpg-error | [] [] [] | + libgphoto2 | [] | + libgphoto2_port | [] [] [] | + libgsasl | [] [] [] [] | + libiconv | [] [] [] | + libidn | [] [] () | + lifelines | [] [] | + lilypond | | + lingoteach | [] | + lprng | [] | + lynx | [] [] [] | + m4 | [] [] [] [] [] | + mailfromd | [] | + mailutils | [] [] [] | + make | [] [] [] [] | + man-db | [] [] [] [] | + minicom | [] [] [] [] [] | + nano | [] [] [] [] | + opcodes | [] [] | + parted | [] | + pilot-qof | | + popt | [] [] [] [] | + psmisc | [] [] | + pwdutils | [] [] | + qof | [] [] | + radius | [] [] | + recode | [] [] [] [] [] [] [] | + rpm | [] [] [] [] | + screem | | + scrollkeeper | [] [] [] [] [] [] [] | + sed | [] [] [] [] [] [] [] [] [] | + shared-mime-info | [] [] [] [] [] [] | + sharutils | [] [] [] [] | + shishi | [] | + skencil | [] [] [] | + solfege | [] | + soundtracker | [] [] | + sp | | + system-tools-ba... | [] [] [] [] [] [] [] [] [] | + tar | [] [] [] [] | + texinfo | [] [] [] [] | + tin | () | + tuxpaint | [] [] [] [] [] [] | + unicode-han-tra... | | + unicode-transla... | | + util-linux | [] [] [] [] | + util-linux-ng | [] [] [] [] | + vorbis-tools | [] | + wastesedge | | + wdiff | [] [] [] [] [] [] [] | + wget | [] [] [] [] | + xchat | [] [] [] [] [] [] [] | + xkeyboard-config | [] [] [] | + xpad | [] [] [] | + +--------------------------------------------------+ + or pa pl pt pt_BR rm ro ru rw sk sl sq sr sv ta + 0 5 77 31 53 4 58 72 3 45 46 9 45 122 3 + + tg th tk tr uk ven vi wa xh zh_CN zh_HK zh_TW zu + +---------------------------------------------------+ + Compendium | [] [] [] [] | 19 + a2ps | [] [] [] | 19 + aegis | [] | 1 + ant-phone | [] [] | 6 + anubis | [] [] [] | 11 + ap-utils | () [] | 4 + aspell | [] [] [] | 16 + bash | [] | 6 + bfd | | 2 + bibshelf | [] | 7 + binutils | [] [] [] [] | 9 + bison | [] [] [] [] | 20 + bison-runtime | [] [] [] [] | 18 + bluez-pin | [] [] [] [] [] [] | 28 + cflow | [] [] | 5 + clisp | | 9 + console-tools | [] [] | 5 + coreutils | [] [] [] | 18 + cpio | [] [] [] [] | 11 + cpplib | [] [] [] [] [] | 12 + cryptonit | [] | 6 + dialog | [] [] [] | 9 + diffutils | [] [] [] [] [] | 29 + doodle | [] | 6 + e2fsprogs | [] [] | 10 + enscript | [] [] [] | 16 + fetchmail | [] [] | 12 + findutils | [] [] [] | 11 + findutils_stable | [] [] [] [] | 18 + flex | [] [] | 15 + fslint | [] | 2 + gas | [] | 3 + gawk | [] [] [] | 16 + gcal | [] | 5 + gcc | [] [] [] | 7 + gettext-examples | [] [] [] [] [] [] | 29 + gettext-runtime | [] [] [] [] [] [] | 28 + gettext-tools | [] [] [] [] [] | 20 + gip | [] [] | 13 + gliv | [] [] | 11 + glunarclock | [] [] [] | 15 + gmult | [] [] [] [] | 16 + gnubiff | [] | 2 + gnucash | () [] | 5 + gnuedu | [] | 2 + gnulib | [] | 10 + gnunet | | 0 + gnunet-gtk | [] [] | 3 + gnutls | | 4 + gpe-aerial | [] [] | 14 + gpe-beam | [] [] | 14 + gpe-calendar | [] [] | 7 + gpe-clock | [] [] [] [] | 21 + gpe-conf | [] [] [] | 16 + gpe-contacts | [] [] | 10 + gpe-edit | [] [] [] [] [] | 22 + gpe-filemanager | [] [] | 7 + gpe-go | [] [] [] [] | 19 + gpe-login | [] [] [] [] [] | 21 + gpe-ownerinfo | [] [] [] [] | 21 + gpe-package | [] | 6 + gpe-sketchbook | [] [] | 16 + gpe-su | [] [] [] [] | 21 + gpe-taskmanager | [] [] [] [] | 21 + gpe-timesheet | [] [] [] [] | 18 + gpe-today | [] [] [] [] [] | 21 + gpe-todo | [] [] | 8 + gphoto2 | [] [] [] [] | 21 + gprof | [] [] | 13 + gpsdrive | [] | 5 + gramadoir | [] | 7 + grep | [] | 12 + gretl | | 6 + gsasl | [] [] [] | 9 + gss | [] | 7 + gst-plugins-bad | [] [] [] | 13 + gst-plugins-base | [] [] | 11 + gst-plugins-good | [] [] [] [] [] | 16 + gst-plugins-ugly | [] [] [] | 13 + gstreamer | [] [] [] | 18 + gtick | [] [] | 7 + gtkam | [] | 16 + gtkorphan | [] | 7 + gtkspell | [] [] [] [] [] [] | 27 + gutenprint | | 4 + hello | [] [] [] [] [] | 38 + herrie | [] [] | 8 + hylafax | | 0 + idutils | [] [] | 15 + indent | [] [] [] [] [] | 28 + iso_15924 | [] [] | 4 + iso_3166 | [] [] [] [] [] [] [] [] [] | 54 + iso_3166_2 | [] [] | 4 + iso_4217 | [] [] [] [] [] | 24 + iso_639 | [] [] [] [] [] | 26 + jpilot | [] [] [] [] | 7 + jtag | [] | 3 + jwhois | [] [] [] | 13 + kbd | [] [] [] | 13 + keytouch | [] | 8 + keytouch-editor | [] | 5 + keytouch-keyboa... | [] | 5 + latrine | [] [] | 5 + ld | [] [] [] [] | 10 + leafpad | [] [] [] [] [] | 24 + libc | [] [] [] | 19 + libexif | [] | 5 + libextractor | [] | 5 + libgpewidget | [] [] [] | 20 + libgpg-error | [] | 6 + libgphoto2 | [] [] | 9 + libgphoto2_port | [] [] [] | 11 + libgsasl | [] | 8 + libiconv | [] [] | 11 + libidn | [] [] | 11 + lifelines | | 4 + lilypond | [] | 6 + lingoteach | [] | 6 + lprng | [] | 2 + lynx | [] [] [] | 15 + m4 | [] [] [] | 18 + mailfromd | [] [] | 3 + mailutils | [] [] | 8 + make | [] [] [] | 20 + man-db | [] | 9 + minicom | [] | 14 + nano | [] [] [] | 20 + opcodes | [] [] | 10 + parted | [] [] [] | 11 + pilot-qof | [] | 1 + popt | [] [] [] [] | 18 + psmisc | [] [] | 10 + pwdutils | [] | 3 + qof | [] | 4 + radius | [] [] | 7 + recode | [] [] [] | 25 + rpm | [] [] [] [] | 13 + screem | [] | 2 + scrollkeeper | [] [] [] [] | 26 + sed | [] [] [] [] | 23 + shared-mime-info | [] [] [] | 29 + sharutils | [] [] [] | 23 + shishi | [] | 3 + skencil | [] | 7 + solfege | [] | 3 + soundtracker | [] [] | 9 + sp | [] | 3 + system-tools-ba... | [] [] [] [] [] [] [] | 38 + tar | [] [] [] | 17 + texinfo | [] [] [] | 15 + tin | | 1 + tuxpaint | [] [] [] | 19 + unicode-han-tra... | | 0 + unicode-transla... | | 2 + util-linux | [] [] [] | 20 + util-linux-ng | [] [] [] | 20 + vorbis-tools | [] [] | 4 + wastesedge | | 1 + wdiff | [] [] | 23 + wget | [] [] [] | 20 + xchat | [] [] [] [] | 29 + xkeyboard-config | [] [] [] | 14 + xpad | [] [] [] | 15 + +---------------------------------------------------+ + 76 teams tg th tk tr uk ven vi wa xh zh_CN zh_HK zh_TW zu + 163 domains 0 3 1 74 51 0 143 21 1 57 7 45 0 2036 + + Some counters in the preceding matrix are higher than the number of +visible blocks let us expect. This is because a few extra PO files are +used for implementing regional variants of languages, or language +dialects. + + For a PO file in the matrix above to be effective, the package to +which it applies should also have been internationalized and +distributed as such by its maintainer. There might be an observable +lag between the mere existence a PO file and its wide availability in a +distribution. + + If November 2007 seems to be old, you may fetch a more recent copy +of this `ABOUT-NLS' file on most GNU archive sites. The most +up-to-date matrix with full percentage details can be found at +`http://translationproject.org/extra/matrix.html'. + +1.6 Using `gettext' in new packages +=================================== + +If you are writing a freely available program and want to +internationalize it you are welcome to use GNU `gettext' in your +package. Of course you have to respect the GNU Library General Public +License which covers the use of the GNU `gettext' library. This means +in particular that even non-free programs can use `libintl' as a shared +library, whereas only free software can use `libintl' as a static +library or use modified versions of `libintl'. + + Once the sources are changed appropriately and the setup can handle +the use of `gettext' the only thing missing are the translations. The +Free Translation Project is also available for packages which are not +developed inside the GNU project. Therefore the information given above +applies also for every other Free Software Project. Contact +`coordinator@translationproject.org' to make the `.pot' files available +to the translation teams. + diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/ChangeLog clutter-0.7.6/ChangeLog --- clutter-0.7.4/ChangeLog 2008-06-25 17:58:16.000000000 +0100 +++ clutter-0.7.6/ChangeLog 2008-06-27 21:23:22.000000000 +0100 @@ -1,3 +1,71 @@ +======== Release 0.7.6 ======================================================== + +2008-06-27 Emmanuele Bassi + + * configure.ac: + * NEWS: Release 0.7.6. + +2008-06-27 Neil Roberts + + Bug 993 - Underline colors are sometimes wrong + + * clutter/pango/pangoclutter-render.c: Fixed so that instead + of trying to set the color in prepare_run it uses draw_glyphs + to draw groups of glyphs and requests the color for each part + from Pango. + +2008-06-26 Emmanuele Bassi + + * clutter/clutter-actor.c: + (clutter_actor_set_min_width), + (clutter_actor_set_min_height), + (clutter_actor_set_natural_width), + (clutter_actor_set_natural_height): Ignore any override of the + minimum and natural size of the stage on backends that only + support static stages. + + * clutter/clutter-stage.c (clutter_stage_allocate): Use the + preferred size of the ClutterStage implementation instead of + the display size. + + * clutter/clutter-backend.[ch]: Remove get_display_size() and + clutter_backend_get_display_size(). + + * clutter/eglnative/clutter-backend-egl.c: + * clutter/fruity/clutter-backend-fruity.c: + * clutter/osx/clutter-backend-osx.c: + * clutter/sdl/clutter-backend-sdl.c: + * clutter/win32/clutter-backend-win32.c: + * clutter/x11/clutter-backend-x11.c: Remove get_display_size() + implementations. + +2008-06-26 Emmanuele Bassi + + * clutter/clutter-shader.c (bind_glsl_shader): Verify that the + vertex shader has been successfully compiled, like we do with + the fragment shader. + +2008-06-26 Emmanuele Bassi + + * clutter/osx/clutter-backend-osx.c: + (clutter_backend_osx_get_display_size): Fix the allocation pool + macro name. + +2008-06-26 Matthew Allum + + * clutter/glx/clutter-glx-texture-pixmap.c: + Move the gl extension probe into the regular object init() rather than + class_init. Should be a little safer. + +2008-06-26 Matthew Allum + + * tests/test-pixmap.c: (main): + Use strtol on arg as to take hex values. Tweak from James Ketrenos + +2008-06-25 Emmanuele Bassi + + * configure.ac: Post release bump to 0.7.5. + ======== Release 0.7.4 ======================================================== 2008-06-25 Emmanuele Bassi diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/HACKING clutter-0.7.6/HACKING --- clutter-0.7.4/HACKING 2008-06-25 17:25:16.000000000 +0100 +++ clutter-0.7.6/HACKING 2008-06-26 14:59:03.000000000 +0100 @@ -69,8 +69,9 @@ even number. - If there was no API change (addition, removal), increment - clutter_interface_age by one. If there was an API change, - set clutter_interface_age to zero. + clutter_interface_age by two. If there was an API change, + set clutter_interface_age to zero. The interface_age is used to + keep the soname the same. - Update NEWS (New feature details, bug #'s), README (Any API changes relevant to developers + version), AUTHORS if relevant. @@ -90,4 +91,4 @@ - Release any dependant add-ons following similar rules to above. Dont forget to check *.pc file version deps! -$LastChangedDate: 2008-04-17 12:10:32 +0100 (Thu, 17 Apr 2008) $ +$LastChangedDate: 2008-06-26 14:59:30 +0100 (Thu, 26 Jun 2008) $ diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/HACKING.backends clutter-0.7.6/HACKING.backends --- clutter-0.7.4/HACKING.backends 2008-06-25 17:25:16.000000000 +0100 +++ clutter-0.7.6/HACKING.backends 2008-06-26 15:16:47.000000000 +0100 @@ -90,6 +90,9 @@ from the GL or GLES implementation, plus the eventual backend-specific features. + ClutterBackend::get_display_size + -- Use this function to retrieve the size of the display. + ClutterBackend::ensure_context -- This function is used to ensure that the backend drawing context is made current for passed ClutterStage, using the backend-specific @@ -126,7 +129,7 @@ - create a new native window handle - if the backend doesn't have a drawing context (either GL or GLES), - create one and assing it to the backend + create one and pass it to the backend - set the CLUTTER_ACTOR_REALIZED flag on itself In case of failure, the CLUTTER_ACTOR_REALIZED flag should be unset on @@ -149,4 +152,4 @@ - calling public API, like clutter_actor_paint(), or checking properties on the stage implementation instead of the ClutterStage wrapper. -$LastChangedDate: 2008-05-13 11:37:17 +0100 (Tue, 13 May 2008) $ +$LastChangedDate: 2008-06-26 15:17:16 +0100 (Thu, 26 Jun 2008) $ diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/Makefile.in clutter-0.7.6/Makefile.in --- clutter-0.7.4/Makefile.in 2008-06-25 17:49:37.000000000 +0100 +++ clutter-0.7.6/Makefile.in 2008-06-27 21:24:19.000000000 +0100 @@ -36,9 +36,10 @@ subdir = . DIST_COMMON = README $(am__configure_deps) $(srcdir)/Makefile.am \ $(srcdir)/Makefile.in $(srcdir)/clutter.pc.in \ - $(srcdir)/config.h.in $(top_srcdir)/configure AUTHORS COPYING \ - ChangeLog INSTALL NEWS TODO config.guess config.sub depcomp \ - install-sh ltmain.sh missing mkinstalldirs + $(srcdir)/config.h.in $(top_srcdir)/configure ABOUT-NLS \ + AUTHORS COPYING ChangeLog INSTALL NEWS TODO config.guess \ + config.rpath config.sub depcomp install-sh ltmain.sh missing \ + mkinstalldirs ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/NEWS clutter-0.7.6/NEWS --- clutter-0.7.4/NEWS 2008-06-25 17:25:27.000000000 +0100 +++ clutter-0.7.6/NEWS 2008-06-27 21:22:52.000000000 +0100 @@ -1,3 +1,19 @@ +Clutter 0.7.6 (27/06/2008) +=============================================================================== + + * List of changes between 0.7.4 and 0.7.6 + + o Removed the ClutterBackend::get_display_size() and wrappers. + + o Verify that the vertex shaders are successfully compiled when binding + them. + + o Increase safety of the ClutterGLXTexturePixmap + + * List of bugs fixed since 0.7.4 + + o #993 - Underline colors are sometimes wrong + Clutter 0.7.4 (25/06/2008), "Killer Koi" =============================================================================== diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/clutter/clutter-actor.c clutter-0.7.6/clutter/clutter-actor.c --- clutter-0.7.4/clutter/clutter-actor.c 2008-06-25 17:25:15.000000000 +0100 +++ clutter-0.7.6/clutter/clutter-actor.c 2008-06-26 20:26:21.000000000 +0100 @@ -3641,25 +3641,14 @@ ClutterActorPrivate *priv = self->priv; ClutterActorBox old = { 0, }; - /* override the minimum width on a top-level actor in case - * we are working on a backend that only provides a fixed - * size stage (e.g. on a framebuffer) + /* if we are setting the size on a top-level actor and the + * backend only supports static top-levels (e.g. framebuffers) + * then we ignore the passed value and we override it with + * the stage implementation's preferred size. */ - if (CLUTTER_PRIVATE_FLAGS (self) & CLUTTER_ACTOR_IS_TOPLEVEL) - { - if (clutter_feature_available (CLUTTER_FEATURE_STAGE_STATIC)) - { - ClutterBackend *backend = clutter_get_default_backend (); - gint display_width; - - clutter_backend_get_display_size (backend, - &display_width, - NULL); - - if (min_width != (CLUTTER_UNITS_FROM_DEVICE (display_width))) - min_width = CLUTTER_UNITS_FROM_DEVICE (display_width); - } - } + if ((CLUTTER_PRIVATE_FLAGS (self) & CLUTTER_ACTOR_IS_TOPLEVEL) && + clutter_feature_available (CLUTTER_FEATURE_STAGE_STATIC)) + return; if (priv->min_width_set && min_width == priv->request_min_width) return; @@ -3687,25 +3676,14 @@ ClutterActorPrivate *priv = self->priv; ClutterActorBox old = { 0, }; - /* override the minimum height on a top-level actor in case - * we are working on a backend that only provides a fixed - * size stage (e.g. on a framebuffer) + /* if we are setting the size on a top-level actor and the + * backend only supports static top-levels (e.g. framebuffers) + * then we ignore the passed value and we override it with + * the stage implementation's preferred size. */ - if (CLUTTER_PRIVATE_FLAGS (self) & CLUTTER_ACTOR_IS_TOPLEVEL) - { - if (clutter_feature_available (CLUTTER_FEATURE_STAGE_STATIC)) - { - ClutterBackend *backend = clutter_get_default_backend (); - gint display_height; - - clutter_backend_get_display_size (backend, - NULL, - &display_height); - - if (min_height != (CLUTTER_UNITS_FROM_DEVICE (display_height))) - min_height = CLUTTER_UNITS_FROM_DEVICE (display_height); - } - } + if ((CLUTTER_PRIVATE_FLAGS (self) & CLUTTER_ACTOR_IS_TOPLEVEL) && + clutter_feature_available (CLUTTER_FEATURE_STAGE_STATIC)) + return; if (priv->min_height_set && min_height == priv->request_min_height) return; @@ -3732,25 +3710,14 @@ ClutterActorPrivate *priv = self->priv; ClutterActorBox old = { 0, }; - /* override the natural width on a top-level actor in case - * we are working on a backend that only provides a fixed - * size stage (e.g. on a framebuffer) + /* if we are setting the size on a top-level actor and the + * backend only supports static top-levels (e.g. framebuffers) + * then we ignore the passed value and we override it with + * the stage implementation's preferred size. */ - if (CLUTTER_PRIVATE_FLAGS (self) & CLUTTER_ACTOR_IS_TOPLEVEL) - { - if (clutter_feature_available (CLUTTER_FEATURE_STAGE_STATIC)) - { - ClutterBackend *backend = clutter_get_default_backend (); - gint display_width; - - clutter_backend_get_display_size (backend, - &display_width, - NULL); - - if (natural_width != (CLUTTER_UNITS_FROM_DEVICE (display_width))) - natural_width = CLUTTER_UNITS_FROM_DEVICE (display_width); - } - } + if ((CLUTTER_PRIVATE_FLAGS (self) & CLUTTER_ACTOR_IS_TOPLEVEL) && + clutter_feature_available (CLUTTER_FEATURE_STAGE_STATIC)) + return; if (priv->natural_width_set && natural_width == priv->request_natural_width) @@ -3778,25 +3745,14 @@ ClutterActorPrivate *priv = self->priv; ClutterActorBox old = { 0, }; - /* override the natural height on a top-level actor in case - * we are working on a backend that only provides a fixed - * size stage (e.g. on a framebuffer) + /* if we are setting the size on a top-level actor and the + * backend only supports static top-levels (e.g. framebuffers) + * then we ignore the passed value and we override it with + * the stage implementation's preferred size. */ - if (CLUTTER_PRIVATE_FLAGS (self) & CLUTTER_ACTOR_IS_TOPLEVEL) - { - if (clutter_feature_available (CLUTTER_FEATURE_STAGE_STATIC)) - { - ClutterBackend *backend = clutter_get_default_backend (); - gint display_height; - - clutter_backend_get_display_size (backend, - NULL, - &display_height); - - if (natural_height != (CLUTTER_UNITS_FROM_DEVICE (display_height))) - natural_height = CLUTTER_UNITS_FROM_DEVICE (display_height); - } - } + if ((CLUTTER_PRIVATE_FLAGS (self) & CLUTTER_ACTOR_IS_TOPLEVEL) && + clutter_feature_available (CLUTTER_FEATURE_STAGE_STATIC)) + return; if (priv->natural_height_set && natural_height == priv->request_natural_height) diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/clutter/clutter-backend.c clutter-0.7.6/clutter/clutter-backend.c --- clutter-0.7.4/clutter/clutter-backend.c 2008-06-25 17:25:15.000000000 +0100 +++ clutter-0.7.6/clutter/clutter-backend.c 2008-06-26 18:50:04.000000000 +0100 @@ -482,34 +482,3 @@ return priv->font_options; } -/** - * clutter_backend_get_display_size: - * @backend: a #ClutterBackend - * @width: return location for the display width in pixels, or %NULL - * @height: return location for the display height in pixels, or %NULL - * - * Retrieves the size of the display from the #ClutterBackend. - * - * Since: 0.8 - */ -void -clutter_backend_get_display_size (ClutterBackend *backend, - gint *width, - gint *height) -{ - ClutterBackendClass *klass; - - g_return_if_fail (CLUTTER_IS_BACKEND (backend)); - - klass = CLUTTER_BACKEND_GET_CLASS (backend); - if (!klass->get_display_size) - { - if (width) - *width = 0; - - if (height) - *height = 0; - } - else - klass->get_display_size (backend, width, height); -} diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/clutter/clutter-backend.h clutter-0.7.6/clutter/clutter-backend.h --- clutter-0.7.4/clutter/clutter-backend.h 2008-06-25 17:25:15.000000000 +0100 +++ clutter-0.7.6/clutter/clutter-backend.h 2008-06-26 18:47:47.000000000 +0100 @@ -75,9 +75,6 @@ ClutterStage *stage); void (* ensure_context) (ClutterBackend *backend, ClutterStage *stage); - void (* get_display_size) (ClutterBackend *backend, - gint *width, - gint *height); }; GType clutter_backend_get_type (void) G_GNUC_CONST; @@ -96,9 +93,6 @@ void clutter_backend_set_font_options (ClutterBackend *backend, cairo_font_options_t *options); cairo_font_options_t *clutter_backend_get_font_options (ClutterBackend *backend); -void clutter_backend_get_display_size (ClutterBackend *backend, - gint *width, - gint *height); G_END_DECLS diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/clutter/clutter-shader.c clutter-0.7.6/clutter/clutter-shader.c --- clutter-0.7.4/clutter/clutter-shader.c 2008-06-25 17:25:15.000000000 +0100 +++ clutter-0.7.6/clutter/clutter-shader.c 2008-06-26 14:01:12.000000000 +0100 @@ -407,11 +407,31 @@ if (priv->vertex_is_glsl && priv->vertex_source != COGL_INVALID_HANDLE) { - priv->vertex_shader = cogl_create_shader (CGL_VERTEX_SHADER); + GLint compiled = CGL_FALSE; - cogl_shader_source (priv->vertex_shader, priv->vertex_source); - cogl_shader_compile (priv->vertex_shader); - cogl_program_attach_shader (priv->program, priv->vertex_shader); + priv->vertex_shader = cogl_create_shader (CGL_VERTEX_SHADER); + + cogl_shader_source (priv->vertex_shader, priv->vertex_source); + cogl_shader_compile (priv->vertex_shader); + + cogl_shader_get_parameteriv (priv->fragment_shader, + CGL_OBJECT_COMPILE_STATUS, + &compiled); + if (compiled != CGL_TRUE) + { + gchar error_buf[512]; + + cogl_shader_get_info_log (priv->fragment_shader, 512, error_buf); + + g_set_error (error, CLUTTER_SHADER_ERROR, + CLUTTER_SHADER_ERROR_COMPILE, + "Vertex shader compilation failed: %s", + error_buf); + + return FALSE; + } + else + cogl_program_attach_shader (priv->program, priv->vertex_shader); } if (priv->fragment_is_glsl && priv->fragment_source != COGL_INVALID_HANDLE) @@ -434,7 +454,7 @@ g_set_error (error, CLUTTER_SHADER_ERROR, CLUTTER_SHADER_ERROR_COMPILE, - "Shader compilation failed: %s", + "Fragment shader compilation failed: %s", error_buf); return FALSE; diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/clutter/clutter-stage.c clutter-0.7.6/clutter/clutter-stage.c --- clutter-0.7.4/clutter/clutter-stage.c 2008-06-25 17:46:40.000000000 +0100 +++ clutter-0.7.6/clutter/clutter-stage.c 2008-06-26 18:37:19.000000000 +0100 @@ -182,25 +182,24 @@ else { ClutterActorBox override = { 0, }; - ClutterBackend *backend = clutter_get_default_backend (); - gint display_width, display_height; ClutterActorClass *klass; + ClutterUnit natural_width, natural_height; - display_width = display_height = 0; - clutter_backend_get_display_size (backend, - &display_width, - &display_height); + /* propagate the allocation */ + klass = CLUTTER_ACTOR_GET_CLASS (priv->impl); + klass->allocate (self, box, origin_changed); + + /* get the preferred size from the backend */ + clutter_actor_get_preferred_size (priv->impl, + NULL, NULL, + &natural_width, &natural_height); override.x1 = 0; override.y1 = 0; - override.x2 = CLUTTER_UNITS_FROM_DEVICE (display_width); - override.y2 = CLUTTER_UNITS_FROM_DEVICE (display_height); - - CLUTTER_NOTE (ACTOR, "Overriding allocation to %dx%d (origin: %s)", - display_width, - display_height, - origin_changed ? "changed" : "not changed"); + override.x2 = natural_width; + override.y2 = natural_height; + /* and store the overridden allocation */ klass = CLUTTER_ACTOR_CLASS (clutter_stage_parent_class); klass->allocate (self, &override, origin_changed); } diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/clutter/clutter-version.h clutter-0.7.6/clutter/clutter-version.h --- clutter-0.7.4/clutter/clutter-version.h 2008-06-25 17:49:44.000000000 +0100 +++ clutter-0.7.6/clutter/clutter-version.h 2008-06-27 21:24:33.000000000 +0100 @@ -53,14 +53,14 @@ * * The micro version of the Clutter library (3, if %CLUTTER_VERSION is 1.2.3) */ -#define CLUTTER_MICRO_VERSION (4) +#define CLUTTER_MICRO_VERSION (6) /** * CLUTTER_VERSION: * * The full version of the Clutter library, like 1.2.3 */ -#define CLUTTER_VERSION 0.7.4 +#define CLUTTER_VERSION 0.7.6 /** * CLUTTER_VERSION_S: @@ -68,7 +68,7 @@ * The full version of the Clutter library, in string form (suited for * string concatenation) */ -#define CLUTTER_VERSION_S "0.7.4" +#define CLUTTER_VERSION_S "0.7.6" /** * CLUTTER_VERSION_HEX: diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/clutter/eglnative/clutter-backend-egl.c clutter-0.7.6/clutter/eglnative/clutter-backend-egl.c --- clutter-0.7.4/clutter/eglnative/clutter-backend-egl.c 2008-06-25 17:25:13.000000000 +0100 +++ clutter-0.7.6/clutter/eglnative/clutter-backend-egl.c 2008-06-26 18:51:18.000000000 +0100 @@ -198,33 +198,6 @@ } static void -clutter_backend_egl_get_display_size (ClutterBackend *backend, - gint *width, - gint *height) -{ - ClutterBackendEGL *backend_egl = CLUTTER_BACKEND_EGL (backend); - gint surface_width, surface_height; - - if (backend_egl->stage) - { - ClutterStageEGL *stage_egl; - - stage_egl = CLUTTER_STAGE_EGL (backend_egl->stage); - - surface_width = stage_egl->surface_width; - surface_height = stage_egl->surface_height; - } - else - surface_width = surface_height = 0; - - if (width) - *width = surface_width; - - if (height) - *height = surface_height; -} - -static void clutter_backend_egl_class_init (ClutterBackendEGLClass *klass) { GObjectClass *gobject_class = G_OBJECT_CLASS (klass); @@ -241,7 +214,6 @@ backend_class->ensure_context = clutter_backend_egl_ensure_context; backend_class->redraw = clutter_backend_egl_redraw; backend_class->get_features = clutter_backend_egl_get_features; - backend_class->get_display_size = clutter_backend_egl_get_display_size; } static void diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/clutter/fruity/clutter-backend-fruity.c clutter-0.7.6/clutter/fruity/clutter-backend-fruity.c --- clutter-0.7.4/clutter/fruity/clutter-backend-fruity.c 2008-06-25 17:25:12.000000000 +0100 +++ clutter-0.7.6/clutter/fruity/clutter-backend-fruity.c 2008-06-26 18:51:34.000000000 +0100 @@ -191,33 +191,6 @@ } static void -clutter_backend_egl_get_display_size (ClutterBackend *backend, - gint *width, - gint *height) -{ - ClutterBackendEGL *backend_egl = CLUTTER_BACKEND_EGL (backend); - gint surface_width, surface_height; - - if (backend_egl->stage) - { - ClutterStageEgl *stage_egl; - - stage_egl = CLUTTER_STAGE_EGL (backend_egl->stage); - - surface_width = stage_egl->surface_width; - surface_height = stage_egl->surface_height; - } - else - surface_width = surface_height = 0; - - if (width) - *width = surface_width; - - if (height) - *height = surface_height; -} - -static void clutter_backend_egl_class_init (ClutterBackendEGLClass *klass) { GObjectClass *gobject_class = G_OBJECT_CLASS (klass); @@ -234,7 +207,6 @@ backend_class->ensure_context = clutter_backend_egl_ensure_context; backend_class->redraw = clutter_backend_egl_redraw; backend_class->get_features = clutter_backend_egl_get_features; - backend_class->get_display_size = clutter_backend_egl_get_display_size; } static void diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/clutter/glx/clutter-glx-texture-pixmap.c clutter-0.7.6/clutter/glx/clutter-glx-texture-pixmap.c --- clutter-0.7.4/clutter/glx/clutter-glx-texture-pixmap.c 2008-06-25 17:25:13.000000000 +0100 +++ clutter-0.7.6/clutter/glx/clutter-glx-texture-pixmap.c 2008-06-26 12:48:52.000000000 +0100 @@ -128,6 +128,28 @@ CLUTTER_GLX_TYPE_TEXTURE_PIXMAP, ClutterGLXTexturePixmapPrivate); + if (_ext_check_done == FALSE) + { + const gchar *glx_extensions = NULL; + + glx_extensions = + glXQueryExtensionsString (clutter_x11_get_default_display (), + clutter_x11_get_default_screen ()); + + /* Check for the texture from pixmap extension */ + if (cogl_check_extension ("GLX_EXT_texture_from_pixmap", glx_extensions)) + { + _gl_bind_tex_image = + (BindTexImage)cogl_get_proc_address ("glXBindTexImageEXT"); + _gl_release_tex_image = + (ReleaseTexImage)cogl_get_proc_address ("glXReleaseTexImageEXT"); + + if (_gl_bind_tex_image && _gl_release_tex_image) + _have_tex_from_pixmap_ext = TRUE; + } + + _ext_check_done = TRUE; + } } static void @@ -612,28 +634,6 @@ x11_texture_class->update_area = clutter_glx_texture_pixmap_update_area; - if (_ext_check_done == FALSE) - { - const gchar *glx_extensions = NULL; - - glx_extensions = - glXQueryExtensionsString (clutter_x11_get_default_display (), - clutter_x11_get_default_screen ()); - - /* Check for the texture from pixmap extension */ - if (cogl_check_extension ("GLX_EXT_texture_from_pixmap", glx_extensions)) - { - _gl_bind_tex_image = - (BindTexImage)cogl_get_proc_address ("glXBindTexImageEXT"); - _gl_release_tex_image = - (ReleaseTexImage)cogl_get_proc_address ("glXReleaseTexImageEXT"); - - if (_gl_bind_tex_image && _gl_release_tex_image) - _have_tex_from_pixmap_ext = TRUE; - } - - _ext_check_done = TRUE; - } } /** diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/clutter/osx/clutter-backend-osx.c clutter-0.7.6/clutter/osx/clutter-backend-osx.c --- clutter-0.7.4/clutter/osx/clutter-backend-osx.c 2008-06-25 17:25:15.000000000 +0100 +++ clutter-0.7.6/clutter/osx/clutter-backend-osx.c 2008-06-26 18:51:59.000000000 +0100 @@ -167,38 +167,6 @@ CLUTTER_OSX_POOL_RELEASE(); } -static void -clutter_backend_osx_get_display_size (ClutterBackend *backend, - gint *width, - gint *height) -{ - int i; - int display_width, display_height; - NSArray *array; - - CLUTTER_OSX_ALLOC_POOL; - - array = [NSScreen screens]; - - display_width = display_height = 0; - - for (i = 0; i < [array count]; i++) - { - NSRect rect = [[array objectAtIndex:i] frame]; - - display_width += rect.size.width; - display_height += rect.size.height; - } - - CLUTTER_OSX_RELEASE_POOL; - - if (width) - *width = display_width; - - if (height) - *height = display_height; -} - /*************************************************************************/ static void @@ -236,7 +204,6 @@ backend_class->ensure_context = clutter_backend_osx_ensure_context; backend_class->init_events = clutter_backend_osx_init_events; backend_class->redraw = clutter_backend_osx_redraw; - backend_class->get_display_size = clutter_backend_osx_get_display_size; } GType diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/clutter/pango/pangoclutter-render.c clutter-0.7.6/clutter/pango/pangoclutter-render.c --- clutter-0.7.4/clutter/pango/pangoclutter-render.c 2008-06-25 17:25:14.000000000 +0100 +++ clutter-0.7.6/clutter/pango/pangoclutter-render.c 2008-06-27 21:17:37.000000000 +0100 @@ -62,12 +62,14 @@ PangoRendererClass class_instance; }; +#define CLUTTER_PANGO_UNIT_TO_FIXED(x) ((x) << (CFX_Q - 10)) + static void pango_clutter_renderer_finalize (GObject *object); -static void pango_clutter_renderer_draw_glyph (PangoRenderer *renderer, - PangoFont *font, - PangoGlyph glyph, - double x, - double y); +static void pango_clutter_renderer_draw_glyphs (PangoRenderer *renderer, + PangoFont *font, + PangoGlyphString *glyphs, + int x, + int y); static void pango_clutter_renderer_draw_rectangle (PangoRenderer *renderer, PangoRenderPart part, int x, @@ -82,8 +84,6 @@ double y2, double x12, double x22); -static void pango_clutter_renderer_prepare_run (PangoRenderer *renderer, - PangoLayoutRun *run); static GObjectClass *parent_class = NULL; @@ -108,10 +108,9 @@ object_class->finalize = pango_clutter_renderer_finalize; - renderer_class->draw_glyph = pango_clutter_renderer_draw_glyph; + renderer_class->draw_glyphs = pango_clutter_renderer_draw_glyphs; renderer_class->draw_rectangle = pango_clutter_renderer_draw_rectangle; renderer_class->draw_trapezoid = pango_clutter_renderer_draw_trapezoid; - renderer_class->prepare_run = pango_clutter_renderer_prepare_run; } static void @@ -316,6 +315,27 @@ } static void +pango_clutter_renderer_set_color_for_part (PangoRenderer *renderer, + PangoRenderPart part) +{ + PangoColor *pango_color = pango_renderer_get_color (renderer, part); + PangoClutterRenderer *priv = PANGO_CLUTTER_RENDERER (renderer); + ClutterColor clutter_color; + + if (pango_color) + { + clutter_color.red = pango_color->red >> 8; + clutter_color.green = pango_color->green >> 8; + clutter_color.blue = pango_color->blue >> 8; + clutter_color.alpha = priv->color.alpha; + } + else + clutter_color = priv->color; + + cogl_color (&clutter_color); +} + +static void pango_clutter_renderer_draw_box (int x, int y, int width, int height) { @@ -327,35 +347,47 @@ } static void -pango_clutter_renderer_draw_rectangle (PangoRenderer *renderer, - PangoRenderPart part, - int x, - int y, - int width, - int height) +pango_clutter_renderer_get_device_units (PangoRenderer *renderer, + int xin, + int yin, + ClutterFixed *xout, + ClutterFixed *yout) { - float x1, x2, y1, y2; const PangoMatrix *matrix; if ((matrix = pango_renderer_get_matrix (renderer))) { /* Convert user-space coords to device coords */ - x1 = (x * matrix->xx + y * matrix->xy) / PANGO_SCALE + matrix->x0; - x2 = ((x + width) * matrix->xx + (y + height) * matrix->xy) - / PANGO_SCALE + matrix->x0; - y1 = (y * matrix->yy + x * matrix->yx) / PANGO_SCALE + matrix->y0; - y2 = ((y + height) * matrix->yy + (x + width) * matrix->yx) - / PANGO_SCALE + matrix->y0; + *xout = CLUTTER_FLOAT_TO_FIXED ((xin * matrix->xx + yin * matrix->xy) + / PANGO_SCALE + matrix->x0); + *yout = CLUTTER_FLOAT_TO_FIXED ((yin * matrix->yy + xin * matrix->yx) + / PANGO_SCALE + matrix->y0); } else { - x1 = x / PANGO_SCALE; - x2 = (x + width) / PANGO_SCALE; - y1 = y / PANGO_SCALE; - y2 = (y + height) / PANGO_SCALE; + *xout = CLUTTER_PANGO_UNIT_TO_FIXED (xin); + *yout = CLUTTER_PANGO_UNIT_TO_FIXED (yin); } +} - cogl_rectangle (x1, y1, x2 - x1, y2 - y1); +static void +pango_clutter_renderer_draw_rectangle (PangoRenderer *renderer, + PangoRenderPart part, + int x, + int y, + int width, + int height) +{ + ClutterFixed x1, x2, y1, y2; + + pango_clutter_renderer_set_color_for_part (renderer, part); + + pango_clutter_renderer_get_device_units (renderer, x, y, + &x1, &y1); + pango_clutter_renderer_get_device_units (renderer, x + width, y + height, + &x2, &y2); + + cogl_rectanglex (x1, y1, x2 - x1, y2 - y1); } static void @@ -379,110 +411,84 @@ points[6] = CLUTTER_FLOAT_TO_FIXED (x21); points[7] = points[1]; + pango_clutter_renderer_set_color_for_part (renderer, part); cogl_path_polygon (points, 4); cogl_path_fill (); } static void -pango_clutter_renderer_draw_glyph (PangoRenderer *renderer, - PangoFont *font, - PangoGlyph glyph, - double xd, - double yd) +pango_clutter_renderer_draw_glyphs (PangoRenderer *renderer, + PangoFont *font, + PangoGlyphString *glyphs, + int xi, + int yi) { PangoClutterGlyphCacheValue *cache_value; - ClutterFixed x = CLUTTER_FLOAT_TO_FIXED ((float) xd); - ClutterFixed y = CLUTTER_FLOAT_TO_FIXED ((float) yd); - - if ((glyph & PANGO_GLYPH_UNKNOWN_FLAG)) - { - PangoFontMetrics *metrics; - - if (font == NULL - || (metrics = pango_font_get_metrics (font, NULL)) == NULL) - pango_clutter_renderer_draw_box (CLUTTER_FIXED_TO_INT (x), - CLUTTER_FIXED_TO_INT (y), - PANGO_UNKNOWN_GLYPH_WIDTH, - PANGO_UNKNOWN_GLYPH_HEIGHT); - else - { - pango_clutter_renderer_draw_box (CLUTTER_FIXED_TO_INT (x), - CLUTTER_FIXED_TO_INT (y), - metrics->approximate_char_width - / PANGO_SCALE, - metrics->ascent / PANGO_SCALE); - - pango_font_metrics_unref (metrics); - } - - return; - } + int i; - /* Get the texture containing the glyph. This will create the cache - entry if there isn't already one */ - cache_value = pango_clutter_renderer_get_cached_glyph (renderer, font, glyph); + pango_clutter_renderer_set_color_for_part (renderer, + PANGO_RENDER_PART_FOREGROUND); - if (cache_value == NULL) + for (i = 0; i < glyphs->num_glyphs; i++) { - pango_clutter_renderer_draw_box (CLUTTER_FIXED_TO_INT (x), - CLUTTER_FIXED_TO_INT (y), - PANGO_UNKNOWN_GLYPH_WIDTH, - PANGO_UNKNOWN_GLYPH_HEIGHT); - - return; - } - - x += CLUTTER_INT_TO_FIXED (cache_value->draw_x); - y += CLUTTER_INT_TO_FIXED (cache_value->draw_y); + PangoGlyphInfo *gi = glyphs->glyphs + i; + ClutterFixed x, y; - /* Render the glyph from the texture */ - cogl_texture_rectangle (cache_value->texture, x, y, - x + CLUTTER_INT_TO_FIXED (cache_value->draw_width), - y + CLUTTER_INT_TO_FIXED (cache_value->draw_height), - cache_value->tx1, cache_value->ty1, - cache_value->tx2, cache_value->ty2); -} + pango_clutter_renderer_get_device_units (renderer, + xi + gi->geometry.x_offset, + yi + gi->geometry.y_offset, + &x, &y); -static void -pango_clutter_renderer_prepare_run (PangoRenderer *renderer, - PangoLayoutRun *run) -{ - GSList *node; - PangoColor *fg = NULL; - ClutterColor col; - PangoClutterRenderer *priv = PANGO_CLUTTER_RENDERER (renderer); + if ((gi->glyph & PANGO_GLYPH_UNKNOWN_FLAG)) + { + PangoFontMetrics *metrics; - for (node = run->item->analysis.extra_attrs; node; node = node->next) - { - PangoAttribute *attr = node->data; + if (font == NULL + || (metrics = pango_font_get_metrics (font, NULL)) == NULL) + pango_clutter_renderer_draw_box (CLUTTER_FIXED_TO_INT (x), + CLUTTER_FIXED_TO_INT (y), + PANGO_UNKNOWN_GLYPH_WIDTH, + PANGO_UNKNOWN_GLYPH_HEIGHT); + else + { + pango_clutter_renderer_draw_box (CLUTTER_FIXED_TO_INT (x), + CLUTTER_FIXED_TO_INT (y), + metrics->approximate_char_width + / PANGO_SCALE, + metrics->ascent / PANGO_SCALE); - switch (attr->klass->type) + pango_font_metrics_unref (metrics); + } + } + else { - case PANGO_ATTR_FOREGROUND: - fg = &((PangoAttrColor *) attr)->color; + /* Get the texture containing the glyph. This will create + the cache entry if there isn't already one */ + cache_value + = pango_clutter_renderer_get_cached_glyph (renderer, font, + gi->glyph); - default: - break; + if (cache_value == NULL) + pango_clutter_renderer_draw_box (CLUTTER_FIXED_TO_INT (x), + CLUTTER_FIXED_TO_INT (y), + PANGO_UNKNOWN_GLYPH_WIDTH, + PANGO_UNKNOWN_GLYPH_HEIGHT); + else + { + x += CLUTTER_INT_TO_FIXED (cache_value->draw_x); + y += CLUTTER_INT_TO_FIXED (cache_value->draw_y); + + /* Render the glyph from the texture */ + cogl_texture_rectangle (cache_value->texture, x, y, + x + CLUTTER_INT_TO_FIXED (cache_value + ->draw_width), + y + CLUTTER_INT_TO_FIXED (cache_value + ->draw_height), + cache_value->tx1, cache_value->ty1, + cache_value->tx2, cache_value->ty2); + } } - } - if (fg) - { - col.red = (fg->red * 255) / 65535; - col.green = (fg->green * 255) / 65535; - col.blue = (fg->blue * 255) / 65535; - } - else - { - col.red = priv->color.red; - col.green = priv->color.green; - col.blue = priv->color.blue; + xi += gi->geometry.width; } - - col.alpha = priv->color.alpha; - - cogl_color (&col); - - /* Chain up */ - (* PANGO_RENDERER_CLASS (parent_class)->prepare_run) (renderer, run); } diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/clutter/sdl/clutter-backend-sdl.c clutter-0.7.6/clutter/sdl/clutter-backend-sdl.c --- clutter-0.7.4/clutter/sdl/clutter-backend-sdl.c 2008-06-25 17:25:13.000000000 +0100 +++ clutter-0.7.6/clutter/sdl/clutter-backend-sdl.c 2008-06-26 18:52:27.000000000 +0100 @@ -168,32 +168,6 @@ } static void -clutter_backend_sdl_get_display_size (ClutterBackend *backend, - gint *width, - gint *height) -{ - SDL_Surface *surface; - - surface = SDL_GetVideoSurface (); - if (!surface) - { - if (width) - *width = 0; - - if (height) - *height = 0; - } - else - { - if (width) - *width = surface->w; - - if (height) - *height = surface->h; - } -} - -static void clutter_backend_sdl_class_init (ClutterBackendSDLClass *klass) { GObjectClass *gobject_class = G_OBJECT_CLASS (klass); @@ -210,7 +184,6 @@ backend_class->ensure_context = clutter_backend_sdl_ensure_context; backend_class->redraw = clutter_backend_sdl_redraw; backend_class->get_features = clutter_backend_sdl_get_features; - backend_class->get_display_size = clutter_backend_sdl_get_display_size; } static void diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/clutter/win32/clutter-backend-win32.c clutter-0.7.6/clutter/win32/clutter-backend-win32.c --- clutter-0.7.4/clutter/win32/clutter-backend-win32.c 2008-06-25 17:57:49.000000000 +0100 +++ clutter-0.7.6/clutter/win32/clutter-backend-win32.c 2008-06-26 18:52:13.000000000 +0100 @@ -230,30 +230,6 @@ } static void -clutter_backend_win32_get_display_size (ClutterBackend *backend, - gint *width, - gint *height) -{ - gint display_width, display_height; - - /* Try get the combined size of all of the monitors */ - if ((display_width = GetSystemMetrics (SM_CXVIRTUALSCREEN)) == 0 - || (display_height = GetSystemMetrics (SM_CYVIRTUALSCREEN)) == 0) - { - /* If the multi-monitor API isn't supported then just return the - size of the primary display */ - display_width = GetSystemMetrics (SM_CXSCREEN); - display_height = GetSystemMetrics (SM_CYSCREEN); - } - - if (width) - *width = display_width; - - if (height) - *height = display_height; -} - -static void clutter_backend_win32_ensure_context (ClutterBackend *backend, ClutterStage *stage) { @@ -365,7 +341,6 @@ backend_class->create_stage = clutter_backend_win32_create_stage; backend_class->add_options = clutter_backend_win32_add_options; backend_class->get_features = clutter_backend_win32_get_features; - backend_class->get_display_size = clutter_backend_win32_get_display_size; backend_class->redraw = clutter_backend_win32_redraw; backend_class->ensure_context = clutter_backend_win32_ensure_context; } diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/clutter/x11/clutter-backend-x11.c clutter-0.7.6/clutter/x11/clutter-backend-x11.c --- clutter-0.7.4/clutter/x11/clutter-backend-x11.c 2008-06-25 17:25:15.000000000 +0100 +++ clutter-0.7.6/clutter/x11/clutter-backend-x11.c 2008-06-26 23:34:32.000000000 +0100 @@ -312,31 +312,6 @@ } static void -clutter_backend_x11_get_display_size (ClutterBackend *backend, - gint *width, - gint *height) -{ - ClutterBackendX11 *backend_x11 = CLUTTER_BACKEND_X11 (backend); - gint display_width, display_height; - - if (G_LIKELY (backend_x11->xdpy)) - { - display_width = DisplayWidth (backend_x11->xdpy, - backend_x11->xscreen_num); - display_height = DisplayHeight (backend_x11->xdpy, - backend_x11->xscreen_num); - } - else - display_width = display_height = 0; - - if (width) - *width = display_width; - - if (height) - *height = display_height; -} - -static void clutter_backend_x11_class_init (ClutterBackendX11Class *klass) { GObjectClass *gobject_class = G_OBJECT_CLASS (klass); @@ -351,7 +326,6 @@ backend_class->init_events = clutter_backend_x11_init_events; backend_class->add_options = clutter_backend_x11_add_options; backend_class->get_features = clutter_backend_x11_get_features; - backend_class->get_display_size = clutter_backend_x11_get_display_size; } static void diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/config.rpath clutter-0.7.6/config.rpath --- clutter-0.7.4/config.rpath 1970-01-01 01:00:00.000000000 +0100 +++ clutter-0.7.6/config.rpath 2008-06-10 15:11:42.000000000 +0100 @@ -0,0 +1,666 @@ +#! /bin/sh +# Output a system dependent set of variables, describing how to set the +# run time search path of shared libraries in an executable. +# +# Copyright 1996-2007 Free Software Foundation, Inc. +# Taken from GNU libtool, 2001 +# Originally by Gordon Matzigkeit , 1996 +# +# This file is free software; the Free Software Foundation gives +# unlimited permission to copy and/or distribute it, with or without +# modifications, as long as this notice is preserved. +# +# The first argument passed to this file is the canonical host specification, +# CPU_TYPE-MANUFACTURER-OPERATING_SYSTEM +# or +# CPU_TYPE-MANUFACTURER-KERNEL-OPERATING_SYSTEM +# The environment variables CC, GCC, LDFLAGS, LD, with_gnu_ld +# should be set by the caller. +# +# The set of defined variables is at the end of this script. + +# Known limitations: +# - On IRIX 6.5 with CC="cc", the run time search patch must not be longer +# than 256 bytes, otherwise the compiler driver will dump core. The only +# known workaround is to choose shorter directory names for the build +# directory and/or the installation directory. + +# All known linkers require a `.a' archive for static linking (except MSVC, +# which needs '.lib'). +libext=a +shrext=.so + +host="$1" +host_cpu=`echo "$host" | sed 's/^\([^-]*\)-\([^-]*\)-\(.*\)$/\1/'` +host_vendor=`echo "$host" | sed 's/^\([^-]*\)-\([^-]*\)-\(.*\)$/\2/'` +host_os=`echo "$host" | sed 's/^\([^-]*\)-\([^-]*\)-\(.*\)$/\3/'` + +# Code taken from libtool.m4's _LT_CC_BASENAME. + +for cc_temp in $CC""; do + case $cc_temp in + compile | *[\\/]compile | ccache | *[\\/]ccache ) ;; + distcc | *[\\/]distcc | purify | *[\\/]purify ) ;; + \-*) ;; + *) break;; + esac +done +cc_basename=`echo "$cc_temp" | sed -e 's%^.*/%%'` + +# Code taken from libtool.m4's AC_LIBTOOL_PROG_COMPILER_PIC. + +wl= +if test "$GCC" = yes; then + wl='-Wl,' +else + case "$host_os" in + aix*) + wl='-Wl,' + ;; + darwin*) + case $cc_basename in + xlc*) + wl='-Wl,' + ;; + esac + ;; + mingw* | cygwin* | pw32* | os2*) + ;; + hpux9* | hpux10* | hpux11*) + wl='-Wl,' + ;; + irix5* | irix6* | nonstopux*) + wl='-Wl,' + ;; + newsos6) + ;; + linux* | k*bsd*-gnu) + case $cc_basename in + icc* | ecc*) + wl='-Wl,' + ;; + pgcc | pgf77 | pgf90) + wl='-Wl,' + ;; + ccc*) + wl='-Wl,' + ;; + como) + wl='-lopt=' + ;; + *) + case `$CC -V 2>&1 | sed 5q` in + *Sun\ C*) + wl='-Wl,' + ;; + esac + ;; + esac + ;; + osf3* | osf4* | osf5*) + wl='-Wl,' + ;; + rdos*) + ;; + solaris*) + wl='-Wl,' + ;; + sunos4*) + wl='-Qoption ld ' + ;; + sysv4 | sysv4.2uw2* | sysv4.3*) + wl='-Wl,' + ;; + sysv4*MP*) + ;; + sysv5* | unixware* | sco3.2v5* | sco5v6* | OpenUNIX*) + wl='-Wl,' + ;; + unicos*) + wl='-Wl,' + ;; + uts4*) + ;; + esac +fi + +# Code taken from libtool.m4's AC_LIBTOOL_PROG_LD_SHLIBS. + +hardcode_libdir_flag_spec= +hardcode_libdir_separator= +hardcode_direct=no +hardcode_minus_L=no + +case "$host_os" in + cygwin* | mingw* | pw32*) + # FIXME: the MSVC++ port hasn't been tested in a loooong time + # When not using gcc, we currently assume that we are using + # Microsoft Visual C++. + if test "$GCC" != yes; then + with_gnu_ld=no + fi + ;; + interix*) + # we just hope/assume this is gcc and not c89 (= MSVC++) + with_gnu_ld=yes + ;; + openbsd*) + with_gnu_ld=no + ;; +esac + +ld_shlibs=yes +if test "$with_gnu_ld" = yes; then + # Set some defaults for GNU ld with shared library support. These + # are reset later if shared libraries are not supported. Putting them + # here allows them to be overridden if necessary. + # Unlike libtool, we use -rpath here, not --rpath, since the documented + # option of GNU ld is called -rpath, not --rpath. + hardcode_libdir_flag_spec='${wl}-rpath ${wl}$libdir' + case "$host_os" in + aix3* | aix4* | aix5*) + # On AIX/PPC, the GNU linker is very broken + if test "$host_cpu" != ia64; then + ld_shlibs=no + fi + ;; + amigaos*) + hardcode_libdir_flag_spec='-L$libdir' + hardcode_minus_L=yes + # Samuel A. Falvo II reports + # that the semantics of dynamic libraries on AmigaOS, at least up + # to version 4, is to share data among multiple programs linked + # with the same dynamic library. Since this doesn't match the + # behavior of shared libraries on other platforms, we cannot use + # them. + ld_shlibs=no + ;; + beos*) + if $LD --help 2>&1 | grep ': supported targets:.* elf' > /dev/null; then + : + else + ld_shlibs=no + fi + ;; + cygwin* | mingw* | pw32*) + # hardcode_libdir_flag_spec is actually meaningless, as there is + # no search path for DLLs. + hardcode_libdir_flag_spec='-L$libdir' + if $LD --help 2>&1 | grep 'auto-import' > /dev/null; then + : + else + ld_shlibs=no + fi + ;; + interix[3-9]*) + hardcode_direct=no + hardcode_libdir_flag_spec='${wl}-rpath,$libdir' + ;; + gnu* | linux* | k*bsd*-gnu) + if $LD --help 2>&1 | grep ': supported targets:.* elf' > /dev/null; then + : + else + ld_shlibs=no + fi + ;; + netbsd*) + ;; + solaris*) + if $LD -v 2>&1 | grep 'BFD 2\.8' > /dev/null; then + ld_shlibs=no + elif $LD --help 2>&1 | grep ': supported targets:.* elf' > /dev/null; then + : + else + ld_shlibs=no + fi + ;; + sysv5* | sco3.2v5* | sco5v6* | unixware* | OpenUNIX*) + case `$LD -v 2>&1` in + *\ [01].* | *\ 2.[0-9].* | *\ 2.1[0-5].*) + ld_shlibs=no + ;; + *) + if $LD --help 2>&1 | grep ': supported targets:.* elf' > /dev/null; then + hardcode_libdir_flag_spec='`test -z "$SCOABSPATH" && echo ${wl}-rpath,$libdir`' + else + ld_shlibs=no + fi + ;; + esac + ;; + sunos4*) + hardcode_direct=yes + ;; + *) + if $LD --help 2>&1 | grep ': supported targets:.* elf' > /dev/null; then + : + else + ld_shlibs=no + fi + ;; + esac + if test "$ld_shlibs" = no; then + hardcode_libdir_flag_spec= + fi +else + case "$host_os" in + aix3*) + # Note: this linker hardcodes the directories in LIBPATH if there + # are no directories specified by -L. + hardcode_minus_L=yes + if test "$GCC" = yes; then + # Neither direct hardcoding nor static linking is supported with a + # broken collect2. + hardcode_direct=unsupported + fi + ;; + aix4* | aix5*) + if test "$host_cpu" = ia64; then + # On IA64, the linker does run time linking by default, so we don't + # have to do anything special. + aix_use_runtimelinking=no + else + aix_use_runtimelinking=no + # Test if we are trying to use run time linking or normal + # AIX style linking. If -brtl is somewhere in LDFLAGS, we + # need to do runtime linking. + case $host_os in aix4.[23]|aix4.[23].*|aix5*) + for ld_flag in $LDFLAGS; do + if (test $ld_flag = "-brtl" || test $ld_flag = "-Wl,-brtl"); then + aix_use_runtimelinking=yes + break + fi + done + ;; + esac + fi + hardcode_direct=yes + hardcode_libdir_separator=':' + if test "$GCC" = yes; then + case $host_os in aix4.[012]|aix4.[012].*) + collect2name=`${CC} -print-prog-name=collect2` + if test -f "$collect2name" && \ + strings "$collect2name" | grep resolve_lib_name >/dev/null + then + # We have reworked collect2 + : + else + # We have old collect2 + hardcode_direct=unsupported + hardcode_minus_L=yes + hardcode_libdir_flag_spec='-L$libdir' + hardcode_libdir_separator= + fi + ;; + esac + fi + # Begin _LT_AC_SYS_LIBPATH_AIX. + echo 'int main () { return 0; }' > conftest.c + ${CC} ${LDFLAGS} conftest.c -o conftest + aix_libpath=`dump -H conftest 2>/dev/null | sed -n -e '/Import File Strings/,/^$/ { /^0/ { s/^0 *\(.*\)$/\1/; p; } +}'` + if test -z "$aix_libpath"; then + aix_libpath=`dump -HX64 conftest 2>/dev/null | sed -n -e '/Import File Strings/,/^$/ { /^0/ { s/^0 *\(.*\)$/\1/; p; } +}'` + fi + if test -z "$aix_libpath"; then + aix_libpath="/usr/lib:/lib" + fi + rm -f conftest.c conftest + # End _LT_AC_SYS_LIBPATH_AIX. + if test "$aix_use_runtimelinking" = yes; then + hardcode_libdir_flag_spec='${wl}-blibpath:$libdir:'"$aix_libpath" + else + if test "$host_cpu" = ia64; then + hardcode_libdir_flag_spec='${wl}-R $libdir:/usr/lib:/lib' + else + hardcode_libdir_flag_spec='${wl}-blibpath:$libdir:'"$aix_libpath" + fi + fi + ;; + amigaos*) + hardcode_libdir_flag_spec='-L$libdir' + hardcode_minus_L=yes + # see comment about different semantics on the GNU ld section + ld_shlibs=no + ;; + bsdi[45]*) + ;; + cygwin* | mingw* | pw32*) + # When not using gcc, we currently assume that we are using + # Microsoft Visual C++. + # hardcode_libdir_flag_spec is actually meaningless, as there is + # no search path for DLLs. + hardcode_libdir_flag_spec=' ' + libext=lib + ;; + darwin* | rhapsody*) + hardcode_direct=no + if test "$GCC" = yes ; then + : + else + case $cc_basename in + xlc*) + ;; + *) + ld_shlibs=no + ;; + esac + fi + ;; + dgux*) + hardcode_libdir_flag_spec='-L$libdir' + ;; + freebsd1*) + ld_shlibs=no + ;; + freebsd2.2*) + hardcode_libdir_flag_spec='-R$libdir' + hardcode_direct=yes + ;; + freebsd2*) + hardcode_direct=yes + hardcode_minus_L=yes + ;; + freebsd* | dragonfly*) + hardcode_libdir_flag_spec='-R$libdir' + hardcode_direct=yes + ;; + hpux9*) + hardcode_libdir_flag_spec='${wl}+b ${wl}$libdir' + hardcode_libdir_separator=: + hardcode_direct=yes + # hardcode_minus_L: Not really in the search PATH, + # but as the default location of the library. + hardcode_minus_L=yes + ;; + hpux10*) + if test "$with_gnu_ld" = no; then + hardcode_libdir_flag_spec='${wl}+b ${wl}$libdir' + hardcode_libdir_separator=: + hardcode_direct=yes + # hardcode_minus_L: Not really in the search PATH, + # but as the default location of the library. + hardcode_minus_L=yes + fi + ;; + hpux11*) + if test "$with_gnu_ld" = no; then + hardcode_libdir_flag_spec='${wl}+b ${wl}$libdir' + hardcode_libdir_separator=: + case $host_cpu in + hppa*64*|ia64*) + hardcode_direct=no + ;; + *) + hardcode_direct=yes + # hardcode_minus_L: Not really in the search PATH, + # but as the default location of the library. + hardcode_minus_L=yes + ;; + esac + fi + ;; + irix5* | irix6* | nonstopux*) + hardcode_libdir_flag_spec='${wl}-rpath ${wl}$libdir' + hardcode_libdir_separator=: + ;; + netbsd*) + hardcode_libdir_flag_spec='-R$libdir' + hardcode_direct=yes + ;; + newsos6) + hardcode_direct=yes + hardcode_libdir_flag_spec='${wl}-rpath ${wl}$libdir' + hardcode_libdir_separator=: + ;; + openbsd*) + if test -f /usr/libexec/ld.so; then + hardcode_direct=yes + if test -z "`echo __ELF__ | $CC -E - | grep __ELF__`" || test "$host_os-$host_cpu" = "openbsd2.8-powerpc"; then + hardcode_libdir_flag_spec='${wl}-rpath,$libdir' + else + case "$host_os" in + openbsd[01].* | openbsd2.[0-7] | openbsd2.[0-7].*) + hardcode_libdir_flag_spec='-R$libdir' + ;; + *) + hardcode_libdir_flag_spec='${wl}-rpath,$libdir' + ;; + esac + fi + else + ld_shlibs=no + fi + ;; + os2*) + hardcode_libdir_flag_spec='-L$libdir' + hardcode_minus_L=yes + ;; + osf3*) + hardcode_libdir_flag_spec='${wl}-rpath ${wl}$libdir' + hardcode_libdir_separator=: + ;; + osf4* | osf5*) + if test "$GCC" = yes; then + hardcode_libdir_flag_spec='${wl}-rpath ${wl}$libdir' + else + # Both cc and cxx compiler support -rpath directly + hardcode_libdir_flag_spec='-rpath $libdir' + fi + hardcode_libdir_separator=: + ;; + solaris*) + hardcode_libdir_flag_spec='-R$libdir' + ;; + sunos4*) + hardcode_libdir_flag_spec='-L$libdir' + hardcode_direct=yes + hardcode_minus_L=yes + ;; + sysv4) + case $host_vendor in + sni) + hardcode_direct=yes # is this really true??? + ;; + siemens) + hardcode_direct=no + ;; + motorola) + hardcode_direct=no #Motorola manual says yes, but my tests say they lie + ;; + esac + ;; + sysv4.3*) + ;; + sysv4*MP*) + if test -d /usr/nec; then + ld_shlibs=yes + fi + ;; + sysv4*uw2* | sysv5OpenUNIX* | sysv5UnixWare7.[01].[10]* | unixware7* | sco3.2v5.0.[024]*) + ;; + sysv5* | sco3.2v5* | sco5v6*) + hardcode_libdir_flag_spec='`test -z "$SCOABSPATH" && echo ${wl}-R,$libdir`' + hardcode_libdir_separator=':' + ;; + uts4*) + hardcode_libdir_flag_spec='-L$libdir' + ;; + *) + ld_shlibs=no + ;; + esac +fi + +# Check dynamic linker characteristics +# Code taken from libtool.m4's AC_LIBTOOL_SYS_DYNAMIC_LINKER. +# Unlike libtool.m4, here we don't care about _all_ names of the library, but +# only about the one the linker finds when passed -lNAME. This is the last +# element of library_names_spec in libtool.m4, or possibly two of them if the +# linker has special search rules. +library_names_spec= # the last element of library_names_spec in libtool.m4 +libname_spec='lib$name' +case "$host_os" in + aix3*) + library_names_spec='$libname.a' + ;; + aix4* | aix5*) + library_names_spec='$libname$shrext' + ;; + amigaos*) + library_names_spec='$libname.a' + ;; + beos*) + library_names_spec='$libname$shrext' + ;; + bsdi[45]*) + library_names_spec='$libname$shrext' + ;; + cygwin* | mingw* | pw32*) + shrext=.dll + library_names_spec='$libname.dll.a $libname.lib' + ;; + darwin* | rhapsody*) + shrext=.dylib + library_names_spec='$libname$shrext' + ;; + dgux*) + library_names_spec='$libname$shrext' + ;; + freebsd1*) + ;; + freebsd* | dragonfly*) + case "$host_os" in + freebsd[123]*) + library_names_spec='$libname$shrext$versuffix' ;; + *) + library_names_spec='$libname$shrext' ;; + esac + ;; + gnu*) + library_names_spec='$libname$shrext' + ;; + hpux9* | hpux10* | hpux11*) + case $host_cpu in + ia64*) + shrext=.so + ;; + hppa*64*) + shrext=.sl + ;; + *) + shrext=.sl + ;; + esac + library_names_spec='$libname$shrext' + ;; + interix[3-9]*) + library_names_spec='$libname$shrext' + ;; + irix5* | irix6* | nonstopux*) + library_names_spec='$libname$shrext' + case "$host_os" in + irix5* | nonstopux*) + libsuff= shlibsuff= + ;; + *) + case $LD in + *-32|*"-32 "|*-melf32bsmip|*"-melf32bsmip ") libsuff= shlibsuff= ;; + *-n32|*"-n32 "|*-melf32bmipn32|*"-melf32bmipn32 ") libsuff=32 shlibsuff=N32 ;; + *-64|*"-64 "|*-melf64bmip|*"-melf64bmip ") libsuff=64 shlibsuff=64 ;; + *) libsuff= shlibsuff= ;; + esac + ;; + esac + ;; + linux*oldld* | linux*aout* | linux*coff*) + ;; + linux* | k*bsd*-gnu) + library_names_spec='$libname$shrext' + ;; + knetbsd*-gnu) + library_names_spec='$libname$shrext' + ;; + netbsd*) + library_names_spec='$libname$shrext' + ;; + newsos6) + library_names_spec='$libname$shrext' + ;; + nto-qnx*) + library_names_spec='$libname$shrext' + ;; + openbsd*) + library_names_spec='$libname$shrext$versuffix' + ;; + os2*) + libname_spec='$name' + shrext=.dll + library_names_spec='$libname.a' + ;; + osf3* | osf4* | osf5*) + library_names_spec='$libname$shrext' + ;; + rdos*) + ;; + solaris*) + library_names_spec='$libname$shrext' + ;; + sunos4*) + library_names_spec='$libname$shrext$versuffix' + ;; + sysv4 | sysv4.3*) + library_names_spec='$libname$shrext' + ;; + sysv4*MP*) + library_names_spec='$libname$shrext' + ;; + sysv5* | sco3.2v5* | sco5v6* | unixware* | OpenUNIX* | sysv4*uw2*) + library_names_spec='$libname$shrext' + ;; + uts4*) + library_names_spec='$libname$shrext' + ;; +esac + +sed_quote_subst='s/\(["`$\\]\)/\\\1/g' +escaped_wl=`echo "X$wl" | sed -e 's/^X//' -e "$sed_quote_subst"` +shlibext=`echo "$shrext" | sed -e 's,^\.,,'` +escaped_libname_spec=`echo "X$libname_spec" | sed -e 's/^X//' -e "$sed_quote_subst"` +escaped_library_names_spec=`echo "X$library_names_spec" | sed -e 's/^X//' -e "$sed_quote_subst"` +escaped_hardcode_libdir_flag_spec=`echo "X$hardcode_libdir_flag_spec" | sed -e 's/^X//' -e "$sed_quote_subst"` + +LC_ALL=C sed -e 's/^\([a-zA-Z0-9_]*\)=/acl_cv_\1=/' <. # @@ -728,8 +728,8 @@ # Identity of this package. PACKAGE_NAME='clutter' PACKAGE_TARNAME='clutter' -PACKAGE_VERSION='0.7.4' -PACKAGE_STRING='clutter 0.7.4' +PACKAGE_VERSION='0.7.6' +PACKAGE_STRING='clutter 0.7.6' PACKAGE_BUGREPORT='http://bugzilla.o-hand.com/enter_bug.cgi?product=Clutter' ac_unique_file="clutter/clutter.h" @@ -1471,7 +1471,7 @@ # Omit some internal or obsolete options to make the list less imposing. # This message is too long to be a string in the A/UX 3.1 sh. cat <<_ACEOF -\`configure' configures clutter 0.7.4 to adapt to many kinds of systems. +\`configure' configures clutter 0.7.6 to adapt to many kinds of systems. Usage: $0 [OPTION]... [VAR=VALUE]... @@ -1545,7 +1545,7 @@ if test -n "$ac_init_help"; then case $ac_init_help in - short | recursive ) echo "Configuration of clutter 0.7.4:";; + short | recursive ) echo "Configuration of clutter 0.7.6:";; esac cat <<\_ACEOF @@ -1682,7 +1682,7 @@ test -n "$ac_init_help" && exit $ac_status if $ac_init_version; then cat <<\_ACEOF -clutter configure 0.7.4 +clutter configure 0.7.6 generated by GNU Autoconf 2.61 Copyright (C) 1992, 1993, 1994, 1995, 1996, 1998, 1999, 2000, 2001, @@ -1696,7 +1696,7 @@ This file contains any messages produced by compilers while running configure, to aid debugging if configure makes a mistake. -It was created by clutter $as_me 0.7.4, which was +It was created by clutter $as_me 0.7.6, which was generated by GNU Autoconf 2.61. Invocation command line was $ $0 $@ @@ -2390,7 +2390,7 @@ # Define the identity of the package. PACKAGE='clutter' - VERSION='0.7.4' + VERSION='0.7.6' cat >>confdefs.h <<_ACEOF @@ -2539,8 +2539,8 @@ CLUTTER_MAJOR_VERSION=0 CLUTTER_MINOR_VERSION=7 -CLUTTER_MICRO_VERSION=4 -CLUTTER_VERSION=0.7.4 +CLUTTER_MICRO_VERSION=6 +CLUTTER_VERSION=0.7.6 CLUTTER_API_VERSION=0.7 CLUTTER_MAJORMINOR=0.7 @@ -2553,9 +2553,9 @@ -CLUTTER_LT_CURRENT=704 +CLUTTER_LT_CURRENT=706 CLUTTER_LT_REV=0 -CLUTTER_LT_AGE=704 +CLUTTER_LT_AGE=706 CLUTTER_LT_VERSION="$CLUTTER_LT_CURRENT:$CLUTTER_LT_REV:$CLUTTER_LT_AGE" CLUTTER_LT_LDFLAGS="-version-info $CLUTTER_LT_VERSION" @@ -26706,7 +26706,7 @@ # report actual input values of CONFIG_FILES etc. instead of their # values after options handling. ac_log=" -This file was extended by clutter $as_me 0.7.4, which was +This file was extended by clutter $as_me 0.7.6, which was generated by GNU Autoconf 2.61. Invocation command line was CONFIG_FILES = $CONFIG_FILES @@ -26759,7 +26759,7 @@ _ACEOF cat >>$CONFIG_STATUS <<_ACEOF ac_cs_version="\\ -clutter config.status 0.7.4 +clutter config.status 0.7.6 configured by $0, generated by GNU Autoconf 2.61, with options \\"`echo "$ac_configure_args" | sed 's/^ //; s/[\\""\`\$]/\\\\&/g'`\\" diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/configure.ac clutter-0.7.6/configure.ac --- clutter-0.7.4/configure.ac 2008-06-25 17:46:58.000000000 +0100 +++ clutter-0.7.6/configure.ac 2008-06-27 21:23:51.000000000 +0100 @@ -3,7 +3,7 @@ # An even micro number indicates a released version. m4_define([clutter_major_version], [0]) m4_define([clutter_minor_version], [7]) -m4_define([clutter_micro_version], [4]) +m4_define([clutter_micro_version], [6]) m4_define([clutter_version], [clutter_major_version.clutter_minor_version.clutter_micro_version]) diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/ChangeLog clutter-0.7.6/doc/reference/ChangeLog --- clutter-0.7.4/doc/reference/ChangeLog 2008-06-25 17:49:14.000000000 +0100 +++ clutter-0.7.6/doc/reference/ChangeLog 2008-06-26 10:02:04.000000000 +0100 @@ -1,3 +1,21 @@ +2008-06-26 Emmanuele Bassi + + * clutter/clutter-overview.xml: Split the overview into its own + file, so we gtk-doc can linkify all class names. + + * clutter/building-clutter.xml: Split the building instructions + into its own file, for better maintainability. + + * clutter/clutter-animation.xml: + * clutter/creating-behaviours.xml: + * clutter/subclassing-ClutterActor.xml: Rename from SGML to XML; + these were not SGML files anyway, but templates. + + * clutter/clutter-docs.sgml: Use XInclude instead of the ugly + entities hack. + + * clutter/Makefile.am: Update the build. + 2008-06-25 Emmanuele Bassi * clutter/clutter-sections.txt: Add missing symbols. diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/Makefile.am clutter-0.7.6/doc/reference/clutter/Makefile.am --- clutter-0.7.4/doc/reference/clutter/Makefile.am 2008-06-25 17:25:16.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/Makefile.am 2008-06-26 09:56:35.000000000 +0100 @@ -97,18 +97,22 @@ # Extra SGML files that are included by $(DOC_MAIN_SGML_FILE). # e.g. content_files=running.sgml building.sgml changes-2.0.sgml content_files= \ - subclassing-ClutterActor.sgml \ - clutter-animation.sgml \ - creating-your-own-behaviours.sgml \ - version.xml + version.xml \ + subclassing-ClutterActor.xml \ + clutter-animation.xml \ + creating-behaviours.xml \ + clutter-overview.xml \ + building-clutter.xml # SGML files where gtk-doc abbrevations (#GtkWidget) are expanded # These files must be listed here *and* in content_files # e.g. expand_content_files=running.sgml expand_content_files= \ - subclassing-ClutterActor.sgml \ - clutter-animation.sgml \ - creating-your-own-behaviours.sgml + subclassing-ClutterActor.xml \ + clutter-animation.xml \ + creating-behaviours.xml \ + clutter-overview.xml \ + building-clutter.xml # CFLAGS and LDFLAGS for compiling gtkdoc-scangobj with your library. # Only needed if you are using gtkdoc-scangobj to dynamically query widget diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/Makefile.in clutter-0.7.6/doc/reference/clutter/Makefile.in --- clutter-0.7.4/doc/reference/clutter/Makefile.in 2008-06-25 17:49:37.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/Makefile.in 2008-06-27 21:24:19.000000000 +0100 @@ -318,19 +318,23 @@ # Extra SGML files that are included by $(DOC_MAIN_SGML_FILE). # e.g. content_files=running.sgml building.sgml changes-2.0.sgml content_files = \ - subclassing-ClutterActor.sgml \ - clutter-animation.sgml \ - creating-your-own-behaviours.sgml \ - version.xml + version.xml \ + subclassing-ClutterActor.xml \ + clutter-animation.xml \ + creating-behaviours.xml \ + clutter-overview.xml \ + building-clutter.xml # SGML files where gtk-doc abbrevations (#GtkWidget) are expanded # These files must be listed here *and* in content_files # e.g. expand_content_files=running.sgml expand_content_files = \ - subclassing-ClutterActor.sgml \ - clutter-animation.sgml \ - creating-your-own-behaviours.sgml + subclassing-ClutterActor.xml \ + clutter-animation.xml \ + creating-behaviours.xml \ + clutter-overview.xml \ + building-clutter.xml # CFLAGS and LDFLAGS for compiling gtkdoc-scangobj with your library. diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/building-clutter.xml clutter-0.7.6/doc/reference/clutter/building-clutter.xml --- clutter-0.7.4/doc/reference/clutter/building-clutter.xml 1970-01-01 01:00:00.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/building-clutter.xml 2008-06-26 23:43:33.000000000 +0100 @@ -0,0 +1,236 @@ + + + + Emmanuele + Bassi + +
+ ebassi@openedhand.com +
+ + + + + Building Clutter + + + +
+ Clutter Dependencies + + + + GLib + + A general-purpose utility library, not specific to + graphical user interfaces. GLib provides many useful data + types, macros, type conversions, string utilities, file + utilities, a main loop abstraction, and so on. + + + + GObject + + The GLib Object System provides the required + implementations of a flexible, extensible and intentionally + easy to map (into other languages) object-oriented framework + for C. + + + + Pango + + Pango is a library for laying out and rendering + text, with an emphasis on internationalization. + + + + Backend Windowing System Library + + GLX, EGL (1.1), SDL, Cocoa (OS X) and WGL (Windows) + + + + Graphics Rendering + + Open GL (1.4+) or Open GL ES (1.1 or 2.0) + + + + +
+ +
+ Platform-specific instructions + +
+ Linux + + If you are using Debian or Ubuntu, you can install pre-compiled + binary packages the normal Debian way following the instructions at + + http://debian.o-hand.com/. + + + To build Clutter clutter from sources, get the latest source + archives from + http://www.clutter-project.org/sources/. Once you have extracted + the sources from the archive execute the following commands in the + top-level directory: + + + + $ ./configure + $ make + # make install + + + You can configure the build with number of additional arguments + passed to the configure script, the full list of which can be obtained + by running ./configure --help. The following arguments are specific to + Clutter: + + + + --enable-debug=[no/minimum/yes] + + Turns on debugging. Possible values are: yes - all + glib asserts, checks and runtime clutter verbose messages; + minimum - just glib cast checks and runtime clutter verbose + messagaes; no - no glib asserts or checks and no runtime + clutter verbose messages; default=yes. + + + + + + --enable-maintainer-flags=[no/yes] + + Use strict compiler flags; default=no. + + + + + + --enable-gtk-doc + + Use gtk-doc to build documentation; default=no. + + + + + + --enable-manual=[no/yes] + + Build application developers manual; requires jw and + xmlto binaries; default=no. + + + + + + --with-flavour=[glx/eglx/eglnative/sdl] + + Select the Clutter backend; default=glx. + + + + + + + + +
+ +
+ Windows + + The recommended way of building Clutter for Windows is using the + mingw tool + chain. One option is to cross-compile Clutter under Linux -- you + can use the script found in the build/mingw/ + directory to simplify the process (the script takes care of setting + up the necessary dependencies). + + + + If you wish to build Clutter using mingw direcly under Windows, you + can do so the normal *nix way (described above) using the mingw + POSIX shell. Should you prefer to use Microsoft Visual Studio, a + project file for MSVC 2005 is located in the + build/msvc_2k5/ directory. In either case, you + will need to first install the required dependencies. + + + There are currently two backends that are supported on + Windows. One uses the Win32 and WGL APIs directly and the + other is built on top of SDL. You must choose one of the + backends when running the configure script using the + following argument: + + + --with-flavour=[win32/sdl] + + Select the Clutter backend; default=glx. + + + + + +
+ +
+ OSX + For developing an application with Clutter, the recommended + way of installing it using the MacPorts + project, by simply invoking: + + + $ sudo port install clutter + + + on a terminal, after installing and updating MacPorts. + + For developing Clutter itself, the recommended way of building + it OSX is to use Jhbuild, + following the documentation for building the GTK+ stack as shown + here. + + + Jhbuild depends on SVN, which can be installed on OSX by using + the MacPorts + project. + + + + XCode should also be installed, either from the OSX installation + disk or downloading it from the Apple website. It is recommended + to also install the X11 development files, even though Clutter + does not strictly depend on them. + + + + The Clutter Quartz backend is built by passing the + --with-flavour=osx command line argument + to the configure script. If not passed, the GLX backend will + be built. By default, the Quartz backend depends on CoreGraphics + in order to load images into textures, but it can also depend + on GDK-Pixbuf or an internal, highly experimental PNG and JPEG + loader. + + + + GTK-Doc is not working on OSX, so API reference generation + should also be disabled when building Clutter, by using + the --disable-docs and + --disable-gtk-doc command line argument + to the configure script. + + +
+ +
+ + + diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/clutter-animation.sgml clutter-0.7.6/doc/reference/clutter/clutter-animation.sgml --- clutter-0.7.4/doc/reference/clutter/clutter-animation.sgml 2008-06-25 17:25:16.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/clutter-animation.sgml 1970-01-01 01:00:00.000000000 +0100 @@ -1,600 +0,0 @@ - - - - Matthew - Allum - -
- mallum@openedhand.com -
- - - - - Creating Animations with Clutter - - - - With Clutter using hardware accelration for graphics rendering, - complex and fast animations are possible. This chapter describes basic - techniques and the utilities Clutter provides in aiding animation - creation. - - - -
- Basic Animations - - - - The most basic way to create animations with Clutter is via the use of - g_timeout_add(). This enables a callback function to be called at a - defined interval. The callback function can then modify actors visual - properties as to produce an animation. - - - - - - Simple Rotation... - - -struct RotationClosure { - ClutterActor *actor; - ClutterFixed final_angle; - ClutterFixed current_angle; -}; - -static gboolean -rotate_actor (gpointer data) -{ - RotationClosure *clos = data; - - clutter_actor_set_rotationx (clos->actor, clos->current_angle, 0, 0, 0); - - clos->current_angle += CFX_ONE; - - if (clos->current_angle == clos->final_angle) - return FALSE; - - return TRUE; -} - -... - RotationClosure clos = { NULL, } - - clos.actor = an_actor; - clos.final_angle = CLUTTER_FLOAT_TO_FIXED (360.0); - clos.current_angle = 0; - - g_timeout_add (1000 / 360, /* fps to interval in milliseconds */ - rotate_actor, - &clos); - - - - Priorities - - - %G_PRIORITY_DEFAULT should always be used as the timeouts priority - (in case of g_timeout_add_full()) as not to intefere with Clutter's - scheduling of repaints and input event handling. - - - - -
-
- Timelines - - #ClutterTimelines abstract a set period of time with a set frame - rate at which to call a provided callback. - - - - #ClutterTimelines also extend the timeout sources functionality - further by: - - - - Having a set duration (in milliseconds) and a set - 'frame rate' - that is, the rate at which the callback is - called - Passing current progress information to the - callback - Handling 'dropped frames' and guarenteeing the set - duration by skipping over frames if the callback cannot keep up with - the set frame rate - Querying the number of milliseconds elapsed between - the current and previous callback. - Allowing the timeline to be modified on the fly as - well as being stopped, started, looped, rewound and - reversed - Using a #ClutterTimeoutPool to more efficiently - schedule multiple timeout sources without incurring in potential - starvation of the main loop slices - - - - A Timeline is created with; - - - -clutter_timeline_new (n_frames, frames_per_seconds); - - - - Taking a number of frames and a frames per second, or by; - - - -clutter_timeline_new_for_duration (msecs); - - - - Which takes the duration of the timeline in milliseconds with a - default frame rate (See clutter_get_default_frame_rate()). - - - - - The speed, duration and number of frames of the timeline then be - modifed via the objects properties and API calls. The timeline can - be made to loop by settings it "loop" property to %TRUE. - - - - - The timelines is started via clutter_timeline_start() and its - playback further manipulated by the clutter_timeline_pause(), - clutter_timeline_stop(), clutter_timeline_rewind() and - clutter_timeline_skip() calls. - - - - - By attaching a handler to the timeline's ClutterTimeline::new-frame - signal a timeline can then be used to drive an animation by altering - an actor's visual properties in this callback. The callback looks like: - - - -void -on_new_frame (ClutterTimeline *timeline, - gint frame_num, - gpointer user_data) -{ - -} - - - - The frame_num parameter is set to the timeline's - current frame number (which is between 0 and the "num-frames" property). - This value can be used to compute the state of a particular animation - that is dependant on the frame numer. The clutter_timeline_get_progress() - function can also be used to get a normalised value of the timeline's - current position between 0 and 1. - - - - - Timelines can also be played in reverse by setting the direction using - clutter_timeline_set_direction(), and can also have a one-time delay set - before they begin playing by using clutter_timeline_set_delay(). - - - - - Timelines can also control a pyshical simulation; the - clutter_timeline_get_delta() function allows retrieving the number of - frames and milliseconds elapsed since the previous callback to ensure - the physics engine to be able to take the actual time elapsed between - iterations into account. - - - - - - The following example demonstrates rotating an actor with a timeline. - - -#include <clutter/clutter.h> - -void -on_new_frame (ClutterTimeline *timeline, - gint frame_num, - gpointer data) -{ - ClutterActor *actor = CLUTTER_ACTOR(data); - - clutter_actor_set_rotation (actor, CLUTTER_Z_AXIS, - (gdouble) frame_num, - clutter_actor_get_width (actor) / 2, - clutter_actor_get_height (actor) / 2, - 0); -} - -int -main (int argc, char *argv[]) -{ - ClutterTimeline *timeline; - - ClutterActor *stage, *actor; - GdkPixbuf *pixbuf; - - clutter_init (&argc, &argv); - - stage = clutter_stage_get_default (); - - pixbuf = gdk_pixbuf_new_from_file ("an-image.png", NULL); - - actor = clutter_texture_new_from_pixbuf (pixbuf); - - clutter_container_add_actor (CLUTTER_CONTAINER (stage), actor); - - clutter_actor_set_position (actor, 100, 100); - - timeline = clutter_timeline_new_for (360, 60); /* a degree per frame */ - clutter_timeline_set_loop (timeline, TRUE); - - g_signal_connect (timeline, "new-frame", G_CALLBACK (on_new_frame), actor); - - clutter_actor_show_all (stage); - - clutter_timeline_start (timeline); - - clutter_main(); - - return 0; -} - - - - - Multiple timelines can be sequenced in order by means of the - #ClutterScore. See the #ClutterScore documentation for more details on - using this. - - -
-
- Behaviours - - - With a large application containing many animations, the use of just - timelines can become unweldy and difficult to manage with much code - duplication in the new-frame handlers that can require over complex - code changes for minor animation modifications. To ease these - problems the #ClutterAlpha and #ClutterBehaviour classes were created. - - - - - #ClutterAlpha and #ClutterBehaviour attempt to generalise the - new-frame function by defining common actions or behaviours that can - be quickly modified, applied to multiple actors or mixed on a single - actor. - - - - - A ClutterAlpha is simply a 'function of time' (not pixel alpha!). It - is created by referencing a source timeline and a function which - produces a value between 0 and %CLUTTER_ALPHA_MAX dependant on the - timeline position. Various prebuilt alpha functions are included - with Clutter these include - - - - - - - %CLUTTER_ALPHA_RAMP_INC - Increasing ramp function - - - %CLUTTER_ALPHA_RAMP_DEC - Decreasing ramp function - - - %CLUTTER_ALPHA_RAMP - Full ramp function - - - %CLUTTER_ALPHA_SINE_INC - Increasing sine function - - - %CLUTTER_ALPHA_SINE_DEC - Decreasing sine function - - - %CLUTTER_ALPHA_SINE_HALF - Half sine function - - - %CLUTTER_ALPHA_SINE - Full sine function - - - %CLUTTER_ALPHA_SQUARE - Square waveform ("step") function - - - %CLUTTER_ALPHA_SMOOTHSTEP_INC - Increasing smooth transition step - function - - - %CLUTTER_ALPHA_SMOOTHSTEP_DEC - Decreasing smooth transition step - function - - - %CLUTTER_ALPHA_EXP_INC - Increasing exponential function - - - %CLUTTER_ALPHA_EXP_DEC - Decreasing exponential function - - - - - - A Behaviour is created with a #ClutterAlpha and a set of limits for - whatever the behaviour modifys actor wise. The current #ClutterAlpha - value is then mapped to a value between these limits and this value - set on any applied actors. With the #ClutterAlpha's underlying - timeline playing the produced value will change and the behaviour - will animate the actor. - - - - - A #ClutterBehaviour is effectively 'driven' by a supplied #ClutterAlpha and - when then applied to an actor it will modify a visual property or - feature of the actor dependant on the Alpha's value. For example a - path based behaviour applied to an actor will alter its position - along the path dependant on the current alpha value over time. The - actual motion will depend on the chosen #ClutterAlphaFunc - a - #CLUTTER_ALPHA_RAMP_INC making it to move at constant speed along the - path, a #CLUTTER_ALPHA_SINE making it alternate from one end of the - path to the other with non constant speed. - - - - - Multiple behaviours can of course be applied to an actor as well as - a single behaviour being applied to multiple actors. The separation - of timelines, alphas and behaviours allows for a single timeline to - drive many behaviours each potentially using different alpha - functions. Behaviour parameters can also be changed on the fly. - - - - - -
- Effects of alpha functions on a path - -
- The actors position between the path's end points directly correlates - to the #ClutterAlpha's current alpha value driving the behaviour. With - the #ClutterAlpha's function set to %CLUTTER_ALPHA_RAMP_INC the actor - will follow the path at a constant velocity, but when changing to - %CLUTTER_ALPHA_SINE_INC the actor initially accelerates before quickly - decelerating. -
-
- - - - - The behaviours included in Clutter are - - - - - - - #ClutterBehaviourBspline - Moves actors along a B-spline path - - - #ClutterBehaviourDepth - Changes the depth of actors - - - #ClutterBehaviourEllipse - Moves actors along an ellipsis - - - #ClutterBehaviourOpacity - Changes the opacity of actors - - - #ClutterBehaviourPath - Moves actors along a path - - - #ClutterBehaviourRotate - Rotates actors along an axis - - - #ClutterBehaviourScale - Changes the scaling factors of - actors - - - - - - - - The following example demonstrates an ellipse behaviour in action. - - -#include <clutter/clutter.h> - -int -main (int argc, char *argv[]) -{ - ClutterTimeline *timeline; - ClutterBehaviour *behave; - ClutterAlpha *alpha; - ClutterActor *stage, *actor; - GdkPixbuf *pixbuf; - - clutter_init (&argc, &argv); - - stage = clutter_stage_get_default (); - - pixbuf = gdk_pixbuf_new_from_file ("ohpowers.png", NULL); - - actor = clutter_texture_new_from_pixbuf (pixbuf); - - clutter_container_add_actor (CLUTTER_CONTAINER (stage), actor); - - timeline = clutter_timeline_new_for_duration (4000); /* milliseconds */ - clutter_timeline_set_loop (timeline, TRUE); - - /* Set an alpha func to power the behaviour */ - alpha = clutter_alpha_new_full (timeline, - CLUTTER_ALPHA_SINE, - NULL, NULL); - - behave = clutter_behaviour_ellipse_new (alpha, - 200, /* center x */ - 200, /* center y */ - 400, /* width */ - 300, /* height */ - CLUTTER_ROTATE_CW, /* direction */ - 0.0, /* initial angle */ - 360.0); /* final angle */ - - clutter_behaviour_apply (behave, actor); - - clutter_actor_show_all (stage); - - clutter_timeline_start (timeline); - - clutter_main(); - - /* clean up */ - g_object_unref (behave); - g_object_unref (timeline); - - return 0; -} - - - - - Behaviour parameters can be changed whilst a animation is running - - - There can be many #ClutterAlpha's attached to a single timeline. There - can be many behaviours for a #ClutterAlpha. There can be many behaviours - applied to an actor. A #ClutterScore can be used to chain many behaviour - together. - - - Combining behaviours that effect the same actor properties - (i.e two separate paths) will cause unexpected results. The values - will not be merged in any way with essentially a the last applied - behaviour taking precedence. - - - Tips for implementing a new behaviour can be found here. - - -
-
- Effects - - - - Clutter effects API provide a simplified abstraction for firing simple - transitions from code. Clutter effects are created from a - #ClutterEffectTemplate which is an abstraction of a timeline and - an alpha function. An effect template can be created with: - - - -ClutterEffectTemplate *etemplate = - clutter_effect_template_new_for_duration (2000, CLUTTER_ALPHA_RAMP_INC); - - - - This will create an effect template lasting 2000 milliseconds (2 - seconds) and use an alpha function of %CLUTTER_ALPHA_RAMP_INC, there - are other more advanced forms for creating effect templates from - existing timelines, as well as attaching a callback to be called - with user_data when the effect template is destroyed. - - - - - When we have an effect template we can create a temporary behaviour - animating an actor simply by issuing: - - - -clutter_effect_move (etemplate, actor, 23, 42, NULL, NULL); - - -and the actor will move from its current position to the coordinates -(23, 42) in 2 seconds. Effects can also be stacked, so calling: - - -clutter_effect_move (etemplate, actor, 23, 42, NULL, NULL); -clutter_effect_fade (etemplate, actor, 0, NULL, NULL); - - -The actor will move and fade out at the same time. - - - - Since effects return a #ClutterTimeline, you can stop an effect from - immediatly happening by calling clutter_timeline_stop () on the - returned timeline. - - - - - The timeline and all the effect infrastructure is unreferenced as soon - as the timeline emits the ClutterTimeline::completed signal. - - -
- -
- Conclusion - - - Clutter provides a number of utility classes to aid animations and - complex animations can be produced by combining the various features - provided. - - - - - Of course animations can be created outside of Clutter Utilities, - they are not expected to cover every kind of possible animation - scenario. - - - - - The animation functionality in Clutter is primarily suited to - building animations with a set or finite running time - i.e transitions - and the like. For animations involving variable input (such as touchscreen - handling) physical simulations may be more suited. - - - -
- diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/clutter-animation.xml clutter-0.7.6/doc/reference/clutter/clutter-animation.xml --- clutter-0.7.4/doc/reference/clutter/clutter-animation.xml 1970-01-01 01:00:00.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/clutter-animation.xml 2008-06-26 09:56:00.000000000 +0100 @@ -0,0 +1,600 @@ + + + + Matthew + Allum + +
+ mallum@openedhand.com +
+ + + + + Creating Animations with Clutter + + + + With Clutter using hardware accelration for graphics rendering, + complex and fast animations are possible. This chapter describes basic + techniques and the utilities Clutter provides in aiding animation + creation. + + + +
+ Basic Animations + + + + The most basic way to create animations with Clutter is via the use of + g_timeout_add(). This enables a callback function to be called at a + defined interval. The callback function can then modify actors visual + properties as to produce an animation. + + + + + + Simple Rotation... + + +struct RotationClosure { + ClutterActor *actor; + ClutterFixed final_angle; + ClutterFixed current_angle; +}; + +static gboolean +rotate_actor (gpointer data) +{ + RotationClosure *clos = data; + + clutter_actor_set_rotationx (clos->actor, clos->current_angle, 0, 0, 0); + + clos->current_angle += CFX_ONE; + + if (clos->current_angle == clos->final_angle) + return FALSE; + + return TRUE; +} + +... + RotationClosure clos = { NULL, } + + clos.actor = an_actor; + clos.final_angle = CLUTTER_FLOAT_TO_FIXED (360.0); + clos.current_angle = 0; + + g_timeout_add (1000 / 360, /* fps to interval in milliseconds */ + rotate_actor, + &clos); + + + + Priorities + + + %G_PRIORITY_DEFAULT should always be used as the timeouts priority + (in case of g_timeout_add_full()) as not to intefere with Clutter's + scheduling of repaints and input event handling. + + + + +
+
+ Timelines + + #ClutterTimelines abstract a set period of time with a set frame + rate at which to call a provided callback. + + + + #ClutterTimelines also extend the timeout sources functionality + further by: + + + + Having a set duration (in milliseconds) and a set + 'frame rate' - that is, the rate at which the callback is + called + Passing current progress information to the + callback + Handling 'dropped frames' and guarenteeing the set + duration by skipping over frames if the callback cannot keep up with + the set frame rate + Querying the number of milliseconds elapsed between + the current and previous callback. + Allowing the timeline to be modified on the fly as + well as being stopped, started, looped, rewound and + reversed + Using a #ClutterTimeoutPool to more efficiently + schedule multiple timeout sources without incurring in potential + starvation of the main loop slices + + + + A Timeline is created with; + + + +clutter_timeline_new (n_frames, frames_per_seconds); + + + + Taking a number of frames and a frames per second, or by; + + + +clutter_timeline_new_for_duration (msecs); + + + + Which takes the duration of the timeline in milliseconds with a + default frame rate (See clutter_get_default_frame_rate()). + + + + + The speed, duration and number of frames of the timeline then be + modifed via the objects properties and API calls. The timeline can + be made to loop by settings it "loop" property to %TRUE. + + + + + The timelines is started via clutter_timeline_start() and its + playback further manipulated by the clutter_timeline_pause(), + clutter_timeline_stop(), clutter_timeline_rewind() and + clutter_timeline_skip() calls. + + + + + By attaching a handler to the timeline's ClutterTimeline::new-frame + signal a timeline can then be used to drive an animation by altering + an actor's visual properties in this callback. The callback looks like: + + + +void +on_new_frame (ClutterTimeline *timeline, + gint frame_num, + gpointer user_data) +{ + +} + + + + The frame_num parameter is set to the timeline's + current frame number (which is between 0 and the "num-frames" property). + This value can be used to compute the state of a particular animation + that is dependant on the frame numer. The clutter_timeline_get_progress() + function can also be used to get a normalised value of the timeline's + current position between 0 and 1. + + + + + Timelines can also be played in reverse by setting the direction using + clutter_timeline_set_direction(), and can also have a one-time delay set + before they begin playing by using clutter_timeline_set_delay(). + + + + + Timelines can also control a pyshical simulation; the + clutter_timeline_get_delta() function allows retrieving the number of + frames and milliseconds elapsed since the previous callback to ensure + the physics engine to be able to take the actual time elapsed between + iterations into account. + + + + + + The following example demonstrates rotating an actor with a timeline. + + +#include <clutter/clutter.h> + +void +on_new_frame (ClutterTimeline *timeline, + gint frame_num, + gpointer data) +{ + ClutterActor *actor = CLUTTER_ACTOR(data); + + clutter_actor_set_rotation (actor, CLUTTER_Z_AXIS, + (gdouble) frame_num, + clutter_actor_get_width (actor) / 2, + clutter_actor_get_height (actor) / 2, + 0); +} + +int +main (int argc, char *argv[]) +{ + ClutterTimeline *timeline; + + ClutterActor *stage, *actor; + GdkPixbuf *pixbuf; + + clutter_init (&argc, &argv); + + stage = clutter_stage_get_default (); + + pixbuf = gdk_pixbuf_new_from_file ("an-image.png", NULL); + + actor = clutter_texture_new_from_pixbuf (pixbuf); + + clutter_container_add_actor (CLUTTER_CONTAINER (stage), actor); + + clutter_actor_set_position (actor, 100, 100); + + timeline = clutter_timeline_new_for (360, 60); /* a degree per frame */ + clutter_timeline_set_loop (timeline, TRUE); + + g_signal_connect (timeline, "new-frame", G_CALLBACK (on_new_frame), actor); + + clutter_actor_show_all (stage); + + clutter_timeline_start (timeline); + + clutter_main(); + + return 0; +} + + + + + Multiple timelines can be sequenced in order by means of the + #ClutterScore. See the #ClutterScore documentation for more details on + using this. + + +
+
+ Behaviours + + + With a large application containing many animations, the use of just + timelines can become unweldy and difficult to manage with much code + duplication in the new-frame handlers that can require over complex + code changes for minor animation modifications. To ease these + problems the #ClutterAlpha and #ClutterBehaviour classes were created. + + + + + #ClutterAlpha and #ClutterBehaviour attempt to generalise the + new-frame function by defining common actions or behaviours that can + be quickly modified, applied to multiple actors or mixed on a single + actor. + + + + + A ClutterAlpha is simply a 'function of time' (not pixel alpha!). It + is created by referencing a source timeline and a function which + produces a value between 0 and %CLUTTER_ALPHA_MAX dependant on the + timeline position. Various prebuilt alpha functions are included + with Clutter these include + + + + + + + %CLUTTER_ALPHA_RAMP_INC + Increasing ramp function + + + %CLUTTER_ALPHA_RAMP_DEC + Decreasing ramp function + + + %CLUTTER_ALPHA_RAMP + Full ramp function + + + %CLUTTER_ALPHA_SINE_INC + Increasing sine function + + + %CLUTTER_ALPHA_SINE_DEC + Decreasing sine function + + + %CLUTTER_ALPHA_SINE_HALF + Half sine function + + + %CLUTTER_ALPHA_SINE + Full sine function + + + %CLUTTER_ALPHA_SQUARE + Square waveform ("step") function + + + %CLUTTER_ALPHA_SMOOTHSTEP_INC + Increasing smooth transition step + function + + + %CLUTTER_ALPHA_SMOOTHSTEP_DEC + Decreasing smooth transition step + function + + + %CLUTTER_ALPHA_EXP_INC + Increasing exponential function + + + %CLUTTER_ALPHA_EXP_DEC + Decreasing exponential function + + + + + + A Behaviour is created with a #ClutterAlpha and a set of limits for + whatever the behaviour modifys actor wise. The current #ClutterAlpha + value is then mapped to a value between these limits and this value + set on any applied actors. With the #ClutterAlpha's underlying + timeline playing the produced value will change and the behaviour + will animate the actor. + + + + + A #ClutterBehaviour is effectively 'driven' by a supplied #ClutterAlpha and + when then applied to an actor it will modify a visual property or + feature of the actor dependant on the Alpha's value. For example a + path based behaviour applied to an actor will alter its position + along the path dependant on the current alpha value over time. The + actual motion will depend on the chosen #ClutterAlphaFunc - a + #CLUTTER_ALPHA_RAMP_INC making it to move at constant speed along the + path, a #CLUTTER_ALPHA_SINE making it alternate from one end of the + path to the other with non constant speed. + + + + + Multiple behaviours can of course be applied to an actor as well as + a single behaviour being applied to multiple actors. The separation + of timelines, alphas and behaviours allows for a single timeline to + drive many behaviours each potentially using different alpha + functions. Behaviour parameters can also be changed on the fly. + + + + + +
+ Effects of alpha functions on a path + +
+ The actors position between the path's end points directly correlates + to the #ClutterAlpha's current alpha value driving the behaviour. With + the #ClutterAlpha's function set to %CLUTTER_ALPHA_RAMP_INC the actor + will follow the path at a constant velocity, but when changing to + %CLUTTER_ALPHA_SINE_INC the actor initially accelerates before quickly + decelerating. +
+
+ + + + + The behaviours included in Clutter are + + + + + + + #ClutterBehaviourBspline + Moves actors along a B-spline path + + + #ClutterBehaviourDepth + Changes the depth of actors + + + #ClutterBehaviourEllipse + Moves actors along an ellipsis + + + #ClutterBehaviourOpacity + Changes the opacity of actors + + + #ClutterBehaviourPath + Moves actors along a path + + + #ClutterBehaviourRotate + Rotates actors along an axis + + + #ClutterBehaviourScale + Changes the scaling factors of + actors + + + + + + + + The following example demonstrates an ellipse behaviour in action. + + +#include <clutter/clutter.h> + +int +main (int argc, char *argv[]) +{ + ClutterTimeline *timeline; + ClutterBehaviour *behave; + ClutterAlpha *alpha; + ClutterActor *stage, *actor; + GdkPixbuf *pixbuf; + + clutter_init (&argc, &argv); + + stage = clutter_stage_get_default (); + + pixbuf = gdk_pixbuf_new_from_file ("ohpowers.png", NULL); + + actor = clutter_texture_new_from_pixbuf (pixbuf); + + clutter_container_add_actor (CLUTTER_CONTAINER (stage), actor); + + timeline = clutter_timeline_new_for_duration (4000); /* milliseconds */ + clutter_timeline_set_loop (timeline, TRUE); + + /* Set an alpha func to power the behaviour */ + alpha = clutter_alpha_new_full (timeline, + CLUTTER_ALPHA_SINE, + NULL, NULL); + + behave = clutter_behaviour_ellipse_new (alpha, + 200, /* center x */ + 200, /* center y */ + 400, /* width */ + 300, /* height */ + CLUTTER_ROTATE_CW, /* direction */ + 0.0, /* initial angle */ + 360.0); /* final angle */ + + clutter_behaviour_apply (behave, actor); + + clutter_actor_show_all (stage); + + clutter_timeline_start (timeline); + + clutter_main(); + + /* clean up */ + g_object_unref (behave); + g_object_unref (timeline); + + return 0; +} + + + + + Behaviour parameters can be changed whilst a animation is running + + + There can be many #ClutterAlpha's attached to a single timeline. There + can be many behaviours for a #ClutterAlpha. There can be many behaviours + applied to an actor. A #ClutterScore can be used to chain many behaviour + together. + + + Combining behaviours that effect the same actor properties + (i.e two separate paths) will cause unexpected results. The values + will not be merged in any way with essentially a the last applied + behaviour taking precedence. + + + Tips for implementing a new behaviour can be found here. + + +
+
+ Effects + + + + Clutter effects API provide a simplified abstraction for firing simple + transitions from code. Clutter effects are created from a + #ClutterEffectTemplate which is an abstraction of a timeline and + an alpha function. An effect template can be created with: + + + +ClutterEffectTemplate *etemplate = + clutter_effect_template_new_for_duration (2000, CLUTTER_ALPHA_RAMP_INC); + + + + This will create an effect template lasting 2000 milliseconds (2 + seconds) and use an alpha function of %CLUTTER_ALPHA_RAMP_INC, there + are other more advanced forms for creating effect templates from + existing timelines, as well as attaching a callback to be called + with user_data when the effect template is destroyed. + + + + + When we have an effect template we can create a temporary behaviour + animating an actor simply by issuing: + + + +clutter_effect_move (etemplate, actor, 23, 42, NULL, NULL); + + +and the actor will move from its current position to the coordinates +(23, 42) in 2 seconds. Effects can also be stacked, so calling: + + +clutter_effect_move (etemplate, actor, 23, 42, NULL, NULL); +clutter_effect_fade (etemplate, actor, 0, NULL, NULL); + + +The actor will move and fade out at the same time. + + + + Since effects return a #ClutterTimeline, you can stop an effect from + immediatly happening by calling clutter_timeline_stop () on the + returned timeline. + + + + + The timeline and all the effect infrastructure is unreferenced as soon + as the timeline emits the ClutterTimeline::completed signal. + + +
+ +
+ Conclusion + + + Clutter provides a number of utility classes to aid animations and + complex animations can be produced by combining the various features + provided. + + + + + Of course animations can be created outside of Clutter Utilities, + they are not expected to cover every kind of possible animation + scenario. + + + + + The animation functionality in Clutter is primarily suited to + building animations with a set or finite running time - i.e transitions + and the like. For animations involving variable input (such as touchscreen + handling) physical simulations may be more suited. + + + +
+ diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/clutter-docs.sgml clutter-0.7.6/doc/reference/clutter/clutter-docs.sgml --- clutter-0.7.4/doc/reference/clutter/clutter-docs.sgml 2008-06-25 17:25:16.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/clutter-docs.sgml 2008-06-26 09:56:39.000000000 +0100 @@ -2,9 +2,6 @@ - - - ]> @@ -40,297 +37,9 @@ - - Clutter Overview - - - - - - Clutter is a GObject based library for creating fast, visually - rich, graphical user interfaces. - - - - - - Clutter works by manipulating a scene-graph of 2D surfaces, or 'actors', - inside a 3D space. - - - - - #ClutterActor is the base class for such surfaces. All - #ClutterActors can be positioned, scaled and rotated in 3D space. - In addition, other properties can be set, such as 2D clipping, children and - opacity. Tranforms applied to a parent actor also apply to any children. - Actors are also able to receive events. - - - - - Subclasses of #ClutterActor include #ClutterStage, #ClutterTexture, - #ClutterLabel, #ClutterRectangle, #ClutterEntry and - #ClutterGroup. #ClutterActors are added to a parent, transformed - and then made visible. - - - - - #ClutterStage is the top level #ClutterActor - it's the representation - of a window, or framebuffer. It is created automatically when Clutter is - initialised. #ClutterStage is a #ClutterGroup, a class - implementing the #ClutterCointainer interface. Clutter currently - only supports a single stage. - - - - - #ClutterTimelines provide the basis for Clutter's animation - utilities. Multiple timelines can be synchronised using #ClutterScore, - and #ClutterBehaviour and #ClutterEffect allow for the creation of - animation effects such as transitions. - - - - - Clutter further contains a number of utilities, including; - #ClutterScript - for loading 'UI definition' files formatted in - JSON, #ClutterShader - a class for applying GPU shaders to actors, - #ClutterModel - a utility class for MVC list type implementations - and #ClutterFixed - fixed point math utilities. - - - - - - - - Building Clutter - - - -
- Clutter Dependencies - - - - GLib - - A general-purpose utility library, not specific to - graphical user interfaces. GLib provides many useful data - types, macros, type conversions, string utilities, file - utilities, a main loop abstraction, and so on. - - - - GObject - - The GLib Object System provides the required - implementations of a flexible, extensible and intentionally - easy to map (into other languages) object-oriented framework - for C. - - - - Pango - - Pango is a library for laying out and rendering - text, with an emphasis on internationalization. - - - - GDK-Pixbuf - - GDK-Pixbuf is a library for loading and manipulating - various image file formats. - - Backend Windowing System Library - - GLX, EGL (1.1), SDL, Cocoa (OS X) and WGL (Windows) - - Graphics Rendering - - Open GL (1.2+) ir Open GL ES (1.1) - - - - -
- -
- Platform-specific instructions - -
- Linux - - If you are using Debian or Ubuntu, you can install pre-compiled - binary packages the normal Debian way following the instructions at - - http://debian.o-hand.com/. - - - To build Clutter clutter from sources, get the latest source - archives from - http://www.clutter-project.org/sources/. Once you have extracted - the sources from the archive execute the following commands in the - top-level directory: - - - - ./configure - make - make install - - - You can configure the build with number of additional arguments - passed to the configure script, the full list of which can be obtained - by running ./configure --help. The following arguments are specific to - Clutter: - - - - --enable-debug=[no/minimum/yes] - - Turns on debugging. Possible values are: yes - all - glib asserts, checks and runtime clutter verbose messages; - minimum - just glib cast checks and runtime clutter verbose - messagaes; no - no glib asserts or checks and no runtime - clutter verbose messages; default=yes. - - - - - - --enable-maintainer-flags=[no/yes] - - Use strict compiler flags; default=no. - - - - - - --enable-gtk-doc - - Use gtk-doc to build documentation; default=no. - - - - - - --enable-manual=[no/yes] - - Build application developers manual; requires jw and - xmlto binaries; default=no. - - - - - - --with-flavour=[glx/eglx/eglnative/sdl] - - Select the Clutter backend; default=glx. - - - - - - - -
- -
- Windows - - The recommended way of building Clutter for Windows is using the - mingw tool - chain. One option is to cross-compile Clutter under Linux -- you - can use the script found in the build/mingw/ - directory to simplify the process (the script takes care of setting - up the necessary dependencies). - - - - If you wish to build Clutter using mingw direcly under Windows, you - can do so the normal *nix way (described above) using the mingw - POSIX shell. Should you prefer to use Microsoft Visual Studio, a - project file for MSVC 2005 is located in the - build/msvc_2k5/ directory. In either case, you - will need to first install the required dependencies. - - - There are currently two backends that are supported on - Windows. One uses the Win32 and WGL APIs directly and the - other is built on top of SDL. You must choose one of the - backends when running the configure script using the - following argument: - - - --with-flavour=[win32/sdl] - - Select the Clutter backend; default=glx. - - - - - -
- -
- OSX - For developing an application with Clutter, the recommended - way of installing it using the MacPorts - project, by simply invoking: - - - $ sudo port install clutter - - - on a terminal, after installing and updating MacPorts. - - For developing Clutter itself, the recommended way of building - it OSX is to use Jhbuild, - following the documentation for building the GTK+ stack as shown - here. - - - Jhbuild depends on SVN, which can be installed on OSX by using - the MacPorts - project. - - - - XCode should also be installed, either from the OSX installation - disk or downloading it from the Apple website. It is recommended - to also install the X11 development files, even though Clutter - does not strictly depend on them. - - - - The Clutter Quartz backend is built by passing the - --with-flavour=osx command line argument - to the configure script. If not passed, the GLX backend will - be built. By default, the Quartz backend depends on CoreGraphics - in order to load images into textures, but it can also depend - on GDK-Pixbuf or an internal, highly experimental PNG and JPEG - loader. - - - - GTK-Doc is not working on OSX, so API reference generation - should also be disabled when building Clutter, by using - the --disable-docs and - --disable-gtk-doc command line argument - to the configure script. - - -
-
- - - + + Clutter Core Reference @@ -453,11 +162,11 @@ developing with Clutter. - &clutter-SubclassingActor; + - &clutter-animation; + - &creating-your-own-behaviours; + diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/clutter-overview.xml clutter-0.7.6/doc/reference/clutter/clutter-overview.xml --- clutter-0.7.4/doc/reference/clutter/clutter-overview.xml 1970-01-01 01:00:00.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/clutter-overview.xml 2008-06-26 09:44:32.000000000 +0100 @@ -0,0 +1,53 @@ + + + + Emmanuele + Bassi + +
+ ebassi@openedhand.com +
+ + + + + Overview + + + + Clutter is a GObject based library for creating fast, visually + rich, graphical user interfaces. + + Clutter works by manipulating a scene-graph of 2D surfaces, or + 'actors', inside a 3D space. + + #ClutterActor is the base class for such surfaces. All + #ClutterActors can be positioned, scaled and rotated in 3D space. + In addition, other properties can be set, such as 2D clipping, children and + opacity. Tranforms applied to a parent actor also apply to any children. + Actors are also able to receive events. + + Subclasses of #ClutterActor include #ClutterStage, #ClutterTexture, + #ClutterLabel, #ClutterRectangle, #ClutterEntry and + #ClutterGroup. #ClutterActors are added to a parent, transformed + and then made visible. + + #ClutterStage is the top level #ClutterActor - it's the + representation of a window, or framebuffer. It is created automatically + when Clutter is initialised. #ClutterStage is a #ClutterGroup, a class + implementing the #ClutterCointainer interface. + + #ClutterTimelines provide the basis for Clutter's animation + utilities. Multiple timelines can be synchronised using #ClutterScore, + and #ClutterBehaviour and #ClutterEffect allow for the creation of + animation effects such as transitions. + + Clutter further contains a number of utilities, including; + #ClutterScript - for loading 'UI definition' files formatted in + JSON, #ClutterShader - a + class for applying GPU shaders to actors, #ClutterModel - a utility class + for MVC list type implementations, and fixed point math utilities. + + + + diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/clutter-sections.txt clutter-0.7.6/doc/reference/clutter/clutter-sections.txt --- clutter-0.7.4/doc/reference/clutter/clutter-sections.txt 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/clutter-sections.txt 2008-06-27 21:32:04.000000000 +0100 @@ -843,7 +843,6 @@ clutter_backend_set_double_click_distance clutter_backend_set_font_options clutter_backend_get_font_options -clutter_backend_get_display_size CLUTTER_BACKEND CLUTTER_IS_BACKEND diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/creating-behaviours.xml clutter-0.7.6/doc/reference/clutter/creating-behaviours.xml --- clutter-0.7.4/doc/reference/clutter/creating-behaviours.xml 1970-01-01 01:00:00.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/creating-behaviours.xml 2008-06-26 09:55:40.000000000 +0100 @@ -0,0 +1,81 @@ + + + + Matthew + Allum + +
+ mallum@openedhand.com +
+ + + + + Creating You Own Behaviours + + + Clutter comes with a number of fairly generic prebuilt behaviour + classes which provide a basis for transitions, animations and other + visual effects. However even with the ability to combine a number of + these behaviours sometimes they are not enough and a custom + behaviour is needed to create a spcific animation. + + + + + + In order to implement a new #ClutterBehaviour subclass the usual + machinery for subclassing a GObject should be used. The new subclass + then just overides the ClutterBehaviour::alpha_notify() method. This + method is passed an alpha value which is then used to compute + modifications to any actors the behaviour is applied to. + + + + + This example demonstrates a behaviour that produces a vertical + 'wipe' like affect by modifying the actors clip region + + +static void +clutter_behaviour_foo_alpha_notify (ClutterBehaviour *behaviour, + guint32 alpha_value) +{ + ClutterActor *actor + gint i, n; + gdouble factor; + + /* Normalise alpha value */ + factor = (gdouble) alpha_value / CLUTTER_ALPHA_MAX_ALPHA; + + n = clutter_behaviour_get_n_actors (behaviour); + + /* Change clip height of each applied actor. Note usually better to use + * clutter_behaviour_actors_foreach () for performance reasons. + */ + for (i = 0; i<n; i++) + { + int clip_height; + + actor = clutter_behaviour_get_nth_actor (behaviour, i); + + clip_height = clutter_actor_get_height (actor) + - (clutter_actor_get_height (actor) * factor); + + clutter_actor_set_clip (actor, + 0, + 0, + clutter_actor_get_width (actor), + clip_height); + } +} + + + + + If the new behaviour is meant to set an initial state on the + actors to which its applied to, then the ClutterBehaviour::applied + signal class handler should be overridden. + + + diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/creating-your-own-behaviours.sgml clutter-0.7.6/doc/reference/clutter/creating-your-own-behaviours.sgml --- clutter-0.7.4/doc/reference/clutter/creating-your-own-behaviours.sgml 2008-06-25 17:25:16.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/creating-your-own-behaviours.sgml 1970-01-01 01:00:00.000000000 +0100 @@ -1,81 +0,0 @@ - - - - Matthew - Allum - -
- mallum@openedhand.com -
- - - - - Creating You Own Behaviours - - - Clutter comes with a number of fairly generic prebuilt behaviour - classes which provide a basis for transitions, animations and other - visual effects. However even with the ability to combine a number of - these behaviours sometimes they are not enough and a custom - behaviour is needed to create a spcific animation. - - - - - - In order to implement a new #ClutterBehaviour subclass the usual - machinery for subclassing a GObject should be used. The new subclass - then just overides the ClutterBehaviour::alpha_notify() method. This - method is passed an alpha value which is then used to compute - modifications to any actors the behaviour is applied to. - - - - - This example demonstrates a behaviour that produces a vertical - 'wipe' like affect by modifying the actors clip region - - -static void -clutter_behaviour_foo_alpha_notify (ClutterBehaviour *behaviour, - guint32 alpha_value) -{ - ClutterActor *actor - gint i, n; - gdouble factor; - - /* Normalise alpha value */ - factor = (gdouble) alpha_value / CLUTTER_ALPHA_MAX_ALPHA; - - n = clutter_behaviour_get_n_actors (behaviour); - - /* Change clip height of each applied actor. Note usually better to use - * clutter_behaviour_actors_foreach () for performance reasons. - */ - for (i = 0; i<n; i++) - { - int clip_height; - - actor = clutter_behaviour_get_nth_actor (behaviour, i); - - clip_height = clutter_actor_get_height (actor) - - (clutter_actor_get_height (actor) * factor); - - clutter_actor_set_clip (actor, - 0, - 0, - clutter_actor_get_width (actor), - clip_height); - } -} - - - - - If the new behaviour is meant to set an initial state on the - actors to which its applied to, then the ClutterBehaviour::applied - signal class handler should be overridden. - - - diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ClutterActor.html clutter-0.7.6/doc/reference/clutter/html/ClutterActor.html --- clutter-0.7.4/doc/reference/clutter/html/ClutterActor.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ClutterActor.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ ClutterActor - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next @@ -580,7 +580,7 @@ code.

-For implementing a new custom actor class, please read the corresponding section +For implementing a new custom actor class, please read the corresponding section of the API reference.

diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ClutterAlpha.html clutter-0.7.6/doc/reference/clutter/html/ClutterAlpha.html --- clutter-0.7.4/doc/reference/clutter/html/ClutterAlpha.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ClutterAlpha.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ ClutterAlpha - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ClutterBehaviour.html clutter-0.7.6/doc/reference/clutter/html/ClutterBehaviour.html --- clutter-0.7.4/doc/reference/clutter/html/ClutterBehaviour.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ClutterBehaviour.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ ClutterBehaviour - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ClutterBehaviourBspline.html clutter-0.7.6/doc/reference/clutter/html/ClutterBehaviourBspline.html --- clutter-0.7.4/doc/reference/clutter/html/ClutterBehaviourBspline.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ClutterBehaviourBspline.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ ClutterBehaviourBspline - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ClutterBehaviourDepth.html clutter-0.7.6/doc/reference/clutter/html/ClutterBehaviourDepth.html --- clutter-0.7.4/doc/reference/clutter/html/ClutterBehaviourDepth.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ClutterBehaviourDepth.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ ClutterBehaviourDepth - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ClutterBehaviourEllipse.html clutter-0.7.6/doc/reference/clutter/html/ClutterBehaviourEllipse.html --- clutter-0.7.4/doc/reference/clutter/html/ClutterBehaviourEllipse.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ClutterBehaviourEllipse.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ ClutterBehaviourEllipse - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ClutterBehaviourOpacity.html clutter-0.7.6/doc/reference/clutter/html/ClutterBehaviourOpacity.html --- clutter-0.7.4/doc/reference/clutter/html/ClutterBehaviourOpacity.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ClutterBehaviourOpacity.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ ClutterBehaviourOpacity - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ClutterBehaviourPath.html clutter-0.7.6/doc/reference/clutter/html/ClutterBehaviourPath.html --- clutter-0.7.4/doc/reference/clutter/html/ClutterBehaviourPath.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ClutterBehaviourPath.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ ClutterBehaviourPath - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ClutterBehaviourRotate.html clutter-0.7.6/doc/reference/clutter/html/ClutterBehaviourRotate.html --- clutter-0.7.4/doc/reference/clutter/html/ClutterBehaviourRotate.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ClutterBehaviourRotate.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ ClutterBehaviourRotate - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ClutterBehaviourScale.html clutter-0.7.6/doc/reference/clutter/html/ClutterBehaviourScale.html --- clutter-0.7.4/doc/reference/clutter/html/ClutterBehaviourScale.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ClutterBehaviourScale.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ ClutterBehaviourScale - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ClutterChildMeta.html clutter-0.7.6/doc/reference/clutter/html/ClutterChildMeta.html --- clutter-0.7.4/doc/reference/clutter/html/ClutterChildMeta.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ClutterChildMeta.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ ClutterChildMeta - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ClutterCloneTexture.html clutter-0.7.6/doc/reference/clutter/html/ClutterCloneTexture.html --- clutter-0.7.4/doc/reference/clutter/html/ClutterCloneTexture.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ClutterCloneTexture.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ ClutterCloneTexture - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ClutterContainer.html clutter-0.7.6/doc/reference/clutter/html/ClutterContainer.html --- clutter-0.7.4/doc/reference/clutter/html/ClutterContainer.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ClutterContainer.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ ClutterContainer - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ClutterEntry.html clutter-0.7.6/doc/reference/clutter/html/ClutterEntry.html --- clutter-0.7.4/doc/reference/clutter/html/ClutterEntry.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ClutterEntry.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ ClutterEntry - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ClutterGroup.html clutter-0.7.6/doc/reference/clutter/html/ClutterGroup.html --- clutter-0.7.4/doc/reference/clutter/html/ClutterGroup.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ClutterGroup.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ ClutterGroup - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ClutterLabel.html clutter-0.7.6/doc/reference/clutter/html/ClutterLabel.html --- clutter-0.7.4/doc/reference/clutter/html/ClutterLabel.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ClutterLabel.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ ClutterLabel - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ClutterListModel.html clutter-0.7.6/doc/reference/clutter/html/ClutterListModel.html --- clutter-0.7.4/doc/reference/clutter/html/ClutterListModel.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ClutterListModel.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ ClutterListModel - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ClutterMedia.html clutter-0.7.6/doc/reference/clutter/html/ClutterMedia.html --- clutter-0.7.4/doc/reference/clutter/html/ClutterMedia.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ClutterMedia.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ ClutterMedia - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ClutterModel.html clutter-0.7.6/doc/reference/clutter/html/ClutterModel.html --- clutter-0.7.4/doc/reference/clutter/html/ClutterModel.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ClutterModel.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ ClutterModel - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ClutterModelIter.html clutter-0.7.6/doc/reference/clutter/html/ClutterModelIter.html --- clutter-0.7.4/doc/reference/clutter/html/ClutterModelIter.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ClutterModelIter.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ ClutterModelIter - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ClutterRectangle.html clutter-0.7.6/doc/reference/clutter/html/ClutterRectangle.html --- clutter-0.7.4/doc/reference/clutter/html/ClutterRectangle.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ClutterRectangle.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ ClutterRectangle - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ClutterScore.html clutter-0.7.6/doc/reference/clutter/html/ClutterScore.html --- clutter-0.7.4/doc/reference/clutter/html/ClutterScore.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ClutterScore.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ ClutterScore - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ClutterScript.html clutter-0.7.6/doc/reference/clutter/html/ClutterScript.html --- clutter-0.7.4/doc/reference/clutter/html/ClutterScript.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ClutterScript.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ ClutterScript - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ClutterShader.html clutter-0.7.6/doc/reference/clutter/html/ClutterShader.html --- clutter-0.7.4/doc/reference/clutter/html/ClutterShader.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ClutterShader.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ ClutterShader - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ClutterStage.html clutter-0.7.6/doc/reference/clutter/html/ClutterStage.html --- clutter-0.7.4/doc/reference/clutter/html/ClutterStage.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ClutterStage.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ ClutterStage - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ClutterTexture.html clutter-0.7.6/doc/reference/clutter/html/ClutterTexture.html --- clutter-0.7.4/doc/reference/clutter/html/ClutterTexture.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ClutterTexture.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ ClutterTexture - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ClutterTimeline.html clutter-0.7.6/doc/reference/clutter/html/ClutterTimeline.html --- clutter-0.7.4/doc/reference/clutter/html/ClutterTimeline.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ClutterTimeline.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ ClutterTimeline - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/building-clutter.html clutter-0.7.6/doc/reference/clutter/html/building-clutter.html --- clutter-0.7.4/doc/reference/clutter/html/building-clutter.html 1970-01-01 01:00:00.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/building-clutter.html 2008-06-27 21:32:04.000000000 +0100 @@ -0,0 +1,253 @@ + + + + +Part II. Building Clutter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+
+

+Part II. Building Clutter

+
+

+Emmanuele Bassi +

+


+          
+        

+
+
+
+
+
+

+Clutter Dependencies

+
++ + + + + + + + + + + + + + + + + + + + + + +

GLib

A general-purpose utility library, not specific to + graphical user interfaces. GLib provides many useful data + types, macros, type conversions, string utilities, file + utilities, a main loop abstraction, and so on.

GObject

The GLib Object System provides the required + implementations of a flexible, extensible and intentionally + easy to map (into other languages) object-oriented framework + for C.

Pango

Pango is a library for laying out and rendering + text, with an emphasis on internationalization.

Backend Windowing System Library

GLX, EGL (1.1), SDL, Cocoa (OS X) and WGL (Windows)

Graphics Rendering

Open GL (1.4+) or Open GL ES (1.1 or 2.0)

+
+
+

+Platform-specific instructions

+
+

+Linux

+

If you are using Debian or Ubuntu, you can install pre-compiled + binary packages the normal Debian way following the instructions at + + http://debian.o-hand.com/. +

+

To build Clutter clutter from sources, get the latest source + archives from + http://www.clutter-project.org/sources/. Once you have extracted + the sources from the archive execute the following commands in the + top-level directory: +

+


+    $ ./configure
+    $ make
+    # make install
+        

+

You can configure the build with number of additional arguments + passed to the configure script, the full list of which can be obtained + by running ./configure --help. The following arguments are specific to + Clutter: + +

+
++ + + + + + + + + + + + + + + + + + + + + + +

--enable-debug=[no/minimum/yes]

Turns on debugging. Possible values are: yes - all + glib asserts, checks and runtime clutter verbose messages; + minimum - just glib cast checks and runtime clutter verbose + messagaes; no - no glib asserts or checks and no runtime + clutter verbose messages; default=yes. +

--enable-maintainer-flags=[no/yes]

Use strict compiler flags; default=no. +

--enable-gtk-doc

Use gtk-doc to build documentation; default=no. +

--enable-manual=[no/yes]

Build application developers manual; requires jw and + xmlto binaries; default=no. +

--with-flavour=[glx/eglx/eglnative/sdl]

Select the Clutter backend; default=glx. +

+

+ +

+
+
+

+Windows

+

+ The recommended way of building Clutter for Windows is using the + mingw tool + chain. One option is to cross-compile Clutter under Linux -- you + can use the script found in the build/mingw/ + directory to simplify the process (the script takes care of setting + up the necessary dependencies). +

+

+ If you wish to build Clutter using mingw direcly under Windows, you + can do so the normal *nix way (described above) using the mingw + POSIX shell. Should you prefer to use Microsoft Visual Studio, a + project file for MSVC 2005 is located in the + build/msvc_2k5/ directory. In either case, you + will need to first install the required dependencies. +

+

+ There are currently two backends that are supported on + Windows. One uses the Win32 and WGL APIs directly and the + other is built on top of SDL. You must choose one of the + backends when running the configure script using the + following argument: +

+
++ + + + +

--with-flavour=[win32/sdl]

Select the Clutter backend; default=glx. +

+

+

+
+
+

+OSX

+

For developing an application with Clutter, the recommended + way of installing it using the MacPorts + project, by simply invoking:

+
+            $ sudo port install clutter
+
+

on a terminal, after installing and updating MacPorts.

+

For developing Clutter itself, the recommended way of building + it OSX is to use Jhbuild, + following the documentation for building the GTK+ stack as shown + here.

+

+ Jhbuild depends on SVN, which can be installed on OSX by using + the MacPorts + project. +

+

+ XCode should also be installed, either from the OSX installation + disk or downloading it from the Apple website. It is recommended + to also install the X11 development files, even though Clutter + does not strictly depend on them. +

+

+ The Clutter Quartz backend is built by passing the + --with-flavour=osx command line argument + to the configure script. If not passed, the GLX backend will + be built. By default, the Quartz backend depends on CoreGraphics + in order to load images into textures, but it can also depend + on GDK-Pixbuf or an internal, highly experimental PNG and JPEG + loader. +

+

+ GTK-Doc is not working on OSX, so API reference generation + should also be disabled when building Clutter, by using + the --disable-docs and + --disable-gtk-doc command line argument + to the configure script. +

+
+
+
+
+
+
+ Generated by GTK-Doc V1.10
+ + diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ch01.html clutter-0.7.6/doc/reference/clutter/html/ch01.html --- clutter-0.7.4/doc/reference/clutter/html/ch01.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ch01.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ Abstract classes and interfaces - + - - + + @@ -42,13 +42,13 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next

-Abstract classes and interfaces

+Abstract classes and interfaces
ClutterActor — Base abstract class for all visual stage actors. diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ch02.html clutter-0.7.6/doc/reference/clutter/html/ch02.html --- clutter-0.7.4/doc/reference/clutter/html/ch02.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ch02.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ Base actors - + - - + + @@ -42,13 +42,13 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next

-Base actors

+Base actors
ClutterRectangle — An actor that displays a simple rectangle. diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ch03.html clutter-0.7.6/doc/reference/clutter/html/ch03.html --- clutter-0.7.4/doc/reference/clutter/html/ch03.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ch03.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ Container actors - + - - + + @@ -42,13 +42,13 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next

-Container actors

+Container actors
ClutterGroup — Actor class containing multiple children. diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ch04.html clutter-0.7.6/doc/reference/clutter/html/ch04.html --- clutter-0.7.4/doc/reference/clutter/html/ch04.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ch04.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ Base classes - + - - + + @@ -42,13 +42,13 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next

-Base classes

+Base classes
ClutterTimeline — A class for time-based events diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ch05.html clutter-0.7.6/doc/reference/clutter/html/ch05.html --- clutter-0.7.4/doc/reference/clutter/html/ch05.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ch05.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ Behaviours - + - - + + @@ -42,13 +42,13 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next

-Behaviours

+Behaviours
ClutterBehaviourBspline — A behaviour interpolating position along a B-Spline diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ch06.html clutter-0.7.6/doc/reference/clutter/html/ch06.html --- clutter-0.7.4/doc/reference/clutter/html/ch06.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ch06.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ Simple effects API - + - - + + @@ -42,13 +42,13 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next

-Simple effects API

+Simple effects API
Clutter Effects — Utility Class for basic visual effects
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ch07.html clutter-0.7.6/doc/reference/clutter/html/ch07.html --- clutter-0.7.4/doc/reference/clutter/html/ch07.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ch07.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ General purpose API - + - - + + @@ -42,13 +42,13 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next

-General purpose API

+General purpose API
Colors — Color management and manipulation. diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ch08.html clutter-0.7.6/doc/reference/clutter/html/ch08.html --- clutter-0.7.4/doc/reference/clutter/html/ch08.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ch08.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ User interface definition - + - - + + @@ -42,13 +42,13 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next

-User interface definition

+User interface definition
ClutterScript — Loads a scene from UI definition data diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ch09.html clutter-0.7.6/doc/reference/clutter/html/ch09.html --- clutter-0.7.4/doc/reference/clutter/html/ch09.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/ch09.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ Generic list model - + - - + + @@ -42,13 +42,13 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next

-Generic list model

+Generic list model
ClutterModel — A generic model implementation diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/clutter-Clutter-Effects.html clutter-0.7.6/doc/reference/clutter/html/clutter-Clutter-Effects.html --- clutter-0.7.4/doc/reference/clutter/html/clutter-Clutter-Effects.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/clutter-Clutter-Effects.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ Clutter Effects - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/clutter-ClutterBackend.html clutter-0.7.6/doc/reference/clutter/html/clutter-ClutterBackend.html --- clutter-0.7.4/doc/reference/clutter/html/clutter-ClutterBackend.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/clutter-ClutterBackend.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ ClutterBackend - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next @@ -80,9 +80,6 @@ void clutter_backend_set_font_options (ClutterBackend *backend, cairo_font_options_t *options); cairo_font_options_t* clutter_backend_get_font_options (ClutterBackend *backend); -void clutter_backend_get_display_size (ClutterBackend *backend, - gint *width, - gint *height);
@@ -373,40 +370,6 @@

Since 0.8

-
-
-

clutter_backend_get_display_size ()

-
void                clutter_backend_get_display_size    (ClutterBackend *backend,
-                                                         gint *width,
-                                                         gint *height);
-

-Retrieves the size of the display from the ClutterBackend.

-

- -

-
-- - - - - - - - - - - - - - -

backend :

 a ClutterBackend -

width :

 return location for the display width in pixels, or NULL -

height :

 return location for the display height in pixels, or NULL -
-

Since 0.8 -

-
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/clutter-ClutterScriptable.html clutter-0.7.6/doc/reference/clutter/html/clutter-ClutterScriptable.html --- clutter-0.7.4/doc/reference/clutter/html/clutter-ClutterScriptable.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/clutter-ClutterScriptable.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ ClutterScriptable - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/clutter-Colors.html clutter-0.7.6/doc/reference/clutter/html/clutter-Colors.html --- clutter-0.7.4/doc/reference/clutter/html/clutter-Colors.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/clutter-Colors.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ Colors - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/clutter-Events.html clutter-0.7.6/doc/reference/clutter/html/clutter-Events.html --- clutter-0.7.4/doc/reference/clutter/html/clutter-Events.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/clutter-Events.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ Events - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/clutter-Fixed-Point-Support.html clutter-0.7.6/doc/reference/clutter/html/clutter-Fixed-Point-Support.html --- clutter-0.7.4/doc/reference/clutter/html/clutter-Fixed-Point-Support.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/clutter-Fixed-Point-Support.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ Fixed Point Support - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/clutter-General.html clutter-0.7.6/doc/reference/clutter/html/clutter-General.html --- clutter-0.7.4/doc/reference/clutter/html/clutter-General.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/clutter-General.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ General - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/clutter-Unit-conversion.html clutter-0.7.6/doc/reference/clutter/html/clutter-Unit-conversion.html --- clutter-0.7.4/doc/reference/clutter/html/clutter-Unit-conversion.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/clutter-Unit-conversion.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ Unit conversion - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/clutter-Utilities.html clutter-0.7.6/doc/reference/clutter/html/clutter-Utilities.html --- clutter-0.7.4/doc/reference/clutter/html/clutter-Utilities.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/clutter-Utilities.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ Utilities - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/clutter-Versioning-Macros.html clutter-0.7.6/doc/reference/clutter/html/clutter-Versioning-Macros.html --- clutter-0.7.4/doc/reference/clutter/html/clutter-Versioning-Macros.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/clutter-Versioning-Macros.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ Versioning Macros - + - - + + @@ -43,7 +43,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next @@ -110,7 +110,7 @@

CLUTTER_MICRO_VERSION

-
#define CLUTTER_MICRO_VERSION   (4)
+
#define CLUTTER_MICRO_VERSION   (6)
 

 

 The micro version of the Clutter library (3, if CLUTTER_VERSION is 1.2.3)

@@ -121,7 +121,7 @@
 

 

 
CLUTTER_VERSION

-
#define CLUTTER_VERSION         0.7.4
+
#define CLUTTER_VERSION         0.7.6
 

 

 The full version of the Clutter library, like 1.2.3

@@ -132,7 +132,7 @@
 

 

 
CLUTTER_VERSION_S

-
#define CLUTTER_VERSION_S       "0.7.4"
+
#define CLUTTER_VERSION_S       "0.7.6"
 

 

 The full version of the Clutter library, in string form (suited for
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/clutter-Win32-Specific-Support.html clutter-0.7.6/doc/reference/clutter/html/clutter-Win32-Specific-Support.html
--- clutter-0.7.4/doc/reference/clutter/html/clutter-Win32-Specific-Support.html	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/html/clutter-Win32-Specific-Support.html	2008-06-27 21:32:04.000000000 +0100
@@ -4,14 +4,14 @@
 
 Win32 Specific Support
 
-
+
 
 
 
 
 
-
-
+
+
 
 
 
@@ -43,7 +43,7 @@
 Prev
 Up
 Home
-Clutter 0.7.4
+Clutter 0.7.6
  Reference Manual
 Next
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/clutter-X11-Specific-Support.html clutter-0.7.6/doc/reference/clutter/html/clutter-X11-Specific-Support.html
--- clutter-0.7.4/doc/reference/clutter/html/clutter-X11-Specific-Support.html	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/html/clutter-X11-Specific-Support.html	2008-06-27 21:32:04.000000000 +0100
@@ -4,14 +4,14 @@
 
 X11 Specific Support
 
-
+
 
 
 
 
 
-
-
+
+
 
 
 
@@ -43,7 +43,7 @@
 Prev
 Up
 Home
-Clutter 0.7.4
+Clutter 0.7.6
  Reference Manual
 Next
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/clutter-animation-behaviours.html clutter-0.7.6/doc/reference/clutter/html/clutter-animation-behaviours.html
--- clutter-0.7.4/doc/reference/clutter/html/clutter-animation-behaviours.html	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/html/clutter-animation-behaviours.html	2008-06-27 21:32:04.000000000 +0100
@@ -4,14 +4,14 @@
 
 Behaviours
 
-
+
 
 
 
 
 
-
-
+
+
 
 
 
@@ -42,7 +42,7 @@
 Prev
 Up
 Home
-Clutter 0.7.4
+Clutter 0.7.6
  Reference Manual
 Next
 
@@ -55,12 +55,12 @@
   timelines can become unweldy and difficult to manage with much code
   duplication in the new-frame handlers that can require over complex
   code changes for minor animation modifications. To ease these
-  problems the ClutterAlpha and ClutterBehaviour classes were created.
+  problems the #ClutterAlpha and #ClutterBehaviour classes were created.
 
   

 

 
-  ClutterAlpha and ClutterBehaviour attempt to generalise the
+  #ClutterAlpha and #ClutterBehaviour attempt to generalise the
   new-frame function by defining common actions or behaviours that can
   be quickly modified, applied to multiple actors or mixed on a single
   actor.
@@ -70,7 +70,7 @@
 
   A ClutterAlpha is simply a 'function of time' (not pixel alpha!). It
   is created by referencing a source timeline and a function which
-  produces a value between 0 and CLUTTER_ALPHA_MAX dependant on the
+  produces a value between 0 and %CLUTTER_ALPHA_MAX dependant on the
   timeline position. Various prebuilt alpha functions are included
   with Clutter these include
 
@@ -82,53 +82,53 @@
 
 
 
-
CLUTTER_ALPHA_RAMP_INC

+
%CLUTTER_ALPHA_RAMP_INC

 Increasing ramp function
 
 
-
CLUTTER_ALPHA_RAMP_DEC

+
%CLUTTER_ALPHA_RAMP_DEC

 Decreasing ramp function
 
 
-
CLUTTER_ALPHA_RAMP

+
%CLUTTER_ALPHA_RAMP

 Full ramp function
 
 
-
CLUTTER_ALPHA_SINE_INC

+
%CLUTTER_ALPHA_SINE_INC

 Increasing sine function
 
 
-
CLUTTER_ALPHA_SINE_DEC

+
%CLUTTER_ALPHA_SINE_DEC

 Decreasing sine function
 
 
-
CLUTTER_ALPHA_SINE_HALF

+
%CLUTTER_ALPHA_SINE_HALF

 Half sine function
 
 
-
CLUTTER_ALPHA_SINE

+
%CLUTTER_ALPHA_SINE

 Full sine function
 
 
-
CLUTTER_ALPHA_SQUARE

+
%CLUTTER_ALPHA_SQUARE

 Square waveform ("step") function
 
 
-
CLUTTER_ALPHA_SMOOTHSTEP_INC

+
%CLUTTER_ALPHA_SMOOTHSTEP_INC

 Increasing smooth transition step
         function
 
 
-
CLUTTER_ALPHA_SMOOTHSTEP_DEC

+
%CLUTTER_ALPHA_SMOOTHSTEP_DEC

 Decreasing smooth transition step
         function
 
 
-
CLUTTER_ALPHA_EXP_INC

+
%CLUTTER_ALPHA_EXP_INC

 Increasing exponential function
 
 
-
CLUTTER_ALPHA_EXP_DEC

+
%CLUTTER_ALPHA_EXP_DEC

 Decreasing exponential function
 
 
@@ -137,24 +137,24 @@
   

 

 
-  A Behaviour is created with a ClutterAlpha and a set of limits for
-  whatever the behaviour modifys actor wise. The current ClutterAlpha
+  A Behaviour is created with a #ClutterAlpha and a set of limits for
+  whatever the behaviour modifys actor wise. The current #ClutterAlpha
   value is then mapped to a value between these limits and this value
-  set on any applied actors. With the ClutterAlpha's underlying
+  set on any applied actors. With the #ClutterAlpha's underlying
   timeline playing the produced value will change and the behaviour
   will animate the actor.
 
   

 

 
-  A ClutterBehaviour is effectively 'driven' by a supplied ClutterAlpha and
+  A #ClutterBehaviour is effectively 'driven' by a supplied #ClutterAlpha and
   when then applied to an actor it will modify a visual property or
   feature of the actor dependant on the Alpha's value. For example a
   path based behaviour applied to an actor will alter its position
   along the path dependant on the current alpha value over time. The
-  actual motion will depend on the chosen ClutterAlphaFunc - a
-  CLUTTER_ALPHA_RAMP_INC making it to move at constant speed along the
-  path, a CLUTTER_ALPHA_SINE making it alternate from one end of the
+  actual motion will depend on the chosen #ClutterAlphaFunc - a
+  #CLUTTER_ALPHA_RAMP_INC making it to move at constant speed along the
+  path, a #CLUTTER_ALPHA_SINE making it alternate from one end of the
   path to the other with non constant speed.
 
   

@@ -176,10 +176,10 @@
 
Effects of alpha functions on a path

 

     The actors position between the path's end points directly correlates
-    to the ClutterAlpha's current alpha value driving the behaviour. With
-    the ClutterAlpha's function set to CLUTTER_ALPHA_RAMP_INC the actor
+    to the #ClutterAlpha's current alpha value driving the behaviour. With
+    the #ClutterAlpha's function set to %CLUTTER_ALPHA_RAMP_INC the actor
     will follow the path at a constant velocity, but when changing to
-    CLUTTER_ALPHA_SINE_INC the actor initially accelerates before quickly
+    %CLUTTER_ALPHA_SINE_INC the actor initially accelerates before quickly
     decelerating.
     

 

@@ -199,31 +199,31 @@
 
 
 
-
ClutterBehaviourBspline

+
#ClutterBehaviourBspline

 Moves actors along a B-spline path
 
 
-
ClutterBehaviourDepth

+
#ClutterBehaviourDepth

 Changes the depth of actors
 
 
-
ClutterBehaviourEllipse

+
#ClutterBehaviourEllipse

 Moves actors along an ellipsis
 
 
-
ClutterBehaviourOpacity

+
#ClutterBehaviourOpacity

 Changes the opacity of actors
 
 
-
ClutterBehaviourPath

+
#ClutterBehaviourPath

 Moves actors along a path
 
 
-
ClutterBehaviourRotate

+
#ClutterBehaviourRotate

 Rotates actors along an axis
 
 
-
ClutterBehaviourScale

+
#ClutterBehaviourScale

 Changes the scaling factors of
       actors
 
@@ -298,9 +298,9 @@
 

 
Note
Behaviour parameters can be changed whilst a animation is running

 

-  There can be many ClutterAlpha's attached to a single timeline. There
-  can be many behaviours for a ClutterAlpha. There can be many behaviours
-  applied to an actor. A ClutterScore can be used to chain many behaviour
+  There can be many #ClutterAlpha's attached to a single timeline. There
+  can be many behaviours for a #ClutterAlpha. There can be many behaviours
+  applied to an actor. A #ClutterScore can be used to chain many behaviour
   together.
   

 

@@ -311,7 +311,7 @@
   behaviour taking precedence.

 

 

-     Tips for implementing a new behaviour can be found here.
+     Tips for implementing a new behaviour can be found here.
      

 

 

diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/clutter-animation-conclusion.html clutter-0.7.6/doc/reference/clutter/html/clutter-animation-conclusion.html
--- clutter-0.7.4/doc/reference/clutter/html/clutter-animation-conclusion.html	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/html/clutter-animation-conclusion.html	2008-06-27 21:32:04.000000000 +0100
@@ -4,14 +4,14 @@
 
 Conclusion
 
-
+
 
 
 
 
 
-
-
+
+
 
 
 
@@ -42,7 +42,7 @@
 Prev
 Up
 Home
-Clutter 0.7.4
+Clutter 0.7.6
  Reference Manual
 Next
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/clutter-animation-effects.html clutter-0.7.6/doc/reference/clutter/html/clutter-animation-effects.html
--- clutter-0.7.4/doc/reference/clutter/html/clutter-animation-effects.html	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/html/clutter-animation-effects.html	2008-06-27 21:32:04.000000000 +0100
@@ -4,14 +4,14 @@
 
 Effects
 
-
+
 
 
 
 
 
-
-
+
+
 
 
 
@@ -42,7 +42,7 @@
 Prev
 Up
 Home
-Clutter 0.7.4
+Clutter 0.7.6
  Reference Manual
 Next
 
@@ -53,7 +53,7 @@
   
    Clutter effects API provide a simplified abstraction for firing simple
    transitions from code. Clutter effects are created from a
-   ClutterEffectTemplate which is an abstraction of a timeline and
+   #ClutterEffectTemplate which is an abstraction of a timeline and
    an alpha function. An effect template can be created with:
 
   

@@ -64,7 +64,7 @@
 

 
   This will create an effect template lasting 2000 milliseconds (2
-  seconds) and use an alpha function of CLUTTER_ALPHA_RAMP_INC, there
+  seconds) and use an alpha function of %CLUTTER_ALPHA_RAMP_INC, there
   are other more advanced forms for creating effect templates from
   existing timelines, as well as attaching a callback to be called
   with user_data when the effect template is destroyed.
@@ -92,8 +92,8 @@
   

 

 
-  Since effects return a ClutterTimeline, you can stop an effect from
-  immediatly happening by calling clutter_timeline_stop() on the
+  Since effects return a #ClutterTimeline, you can stop an effect from
+  immediatly happening by calling clutter_timeline_stop () on the
   returned timeline.
   
   

diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/clutter-animation-timelines.html clutter-0.7.6/doc/reference/clutter/html/clutter-animation-timelines.html
--- clutter-0.7.4/doc/reference/clutter/html/clutter-animation-timelines.html	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/html/clutter-animation-timelines.html	2008-06-27 21:32:04.000000000 +0100
@@ -4,14 +4,14 @@
 
 Timelines
 
-
+
 
 
 
 
 
-
-
+
+
 
 
 
@@ -42,7 +42,7 @@
 Prev
 Up
 Home
-Clutter 0.7.4
+Clutter 0.7.6
  Reference Manual
 Next
 
@@ -50,11 +50,11 @@
 

 Timelines

 

-  ClutterTimelines abstract a set period of time with a set frame
+  #ClutterTimelines abstract a set period of time with a set frame
   rate at which to call a provided callback.
   

 

-  ClutterTimelines also extend the timeout sources functionality
+  #ClutterTimelines also extend the timeout sources functionality
   further by:
   

 
    
@@ -71,7 +71,7 @@
 
  1. Allowing the timeline to be modified on the fly as
     well as being stopped, started, looped, rewound and
     reversed
    2. 
-
  2. Using a ClutterTimeoutPool to more efficiently
+
  3. Using a #ClutterTimeoutPool to more efficiently
     schedule multiple timeout sources without incurring in potential
     starvation of the main loop slices
    4. 
 

@@ -89,21 +89,21 @@

Which takes the duration of the timeline in milliseconds with a - default frame rate (See clutter_get_default_frame_rate()). + default frame rate (See clutter_get_default_frame_rate()).

The speed, duration and number of frames of the timeline then be modifed via the objects properties and API calls. The timeline can - be made to loop by settings it "loop" property to TRUE. + be made to loop by settings it "loop" property to %TRUE.

- The timelines is started via clutter_timeline_start() and its - playback further manipulated by the clutter_timeline_pause(), - clutter_timeline_stop(), clutter_timeline_rewind() and - clutter_timeline_skip() calls. + The timelines is started via clutter_timeline_start() and its + playback further manipulated by the clutter_timeline_pause(), + clutter_timeline_stop(), clutter_timeline_rewind() and + clutter_timeline_skip() calls.

@@ -127,7 +127,7 @@ The frame_num parameter is set to the timeline's current frame number (which is between 0 and the "num-frames" property). This value can be used to compute the state of a particular animation - that is dependant on the frame numer. The clutter_timeline_get_progress() + that is dependant on the frame numer. The clutter_timeline_get_progress() function can also be used to get a normalised value of the timeline's current position between 0 and 1. @@ -135,14 +135,14 @@

Timelines can also be played in reverse by setting the direction using - clutter_timeline_set_direction(), and can also have a one-time delay set - before they begin playing by using clutter_timeline_set_delay(). + clutter_timeline_set_direction(), and can also have a one-time delay set + before they begin playing by using clutter_timeline_set_delay().

Timelines can also control a pyshical simulation; the - clutter_timeline_get_delta() function allows retrieving the number of + clutter_timeline_get_delta() function allows retrieving the number of frames and milliseconds elapsed since the previous callback to ensure the physics engine to be able to take the actual time elapsed between iterations into account. @@ -211,7 +211,7 @@

Note

Multiple timelines can be sequenced in order by means of the - ClutterScore. See the ClutterScore documentation for more details on + #ClutterScore. See the #ClutterScore documentation for more details on using this.

diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/clutter-animations.html clutter-0.7.6/doc/reference/clutter/html/clutter-animations.html --- clutter-0.7.4/doc/reference/clutter/html/clutter-animations.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/clutter-animations.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ Creating Animations with Clutter - + - - + + @@ -42,7 +42,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next @@ -55,7 +55,7 @@ Matthew Allum


-          
+          
        

@@ -80,7 +80,7 @@

The most basic way to create animations with Clutter is via the use of - g_timeout_add(). This enables a callback function to be called at a + g_timeout_add(). This enables a callback function to be called at a defined interval. The callback function can then modify actors visual properties as to produce an animation. @@ -130,8 +130,8 @@

Priorities

- G_PRIORITY_DEFAULT should always be used as the timeouts priority - (in case of g_timeout_add_full()) as not to intefere with Clutter's + %G_PRIORITY_DEFAULT should always be used as the timeouts priority + (in case of g_timeout_add_full()) as not to intefere with Clutter's scheduling of repaints and input event handling.

diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/clutter-overview.html clutter-0.7.6/doc/reference/clutter/html/clutter-overview.html --- clutter-0.7.4/doc/reference/clutter/html/clutter-overview.html 1970-01-01 01:00:00.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/clutter-overview.html 2008-06-27 21:32:04.000000000 +0100 @@ -0,0 +1,96 @@ + + + + +Part I. Overview + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+

+Part I. Overview

+
+

+Emmanuele Bassi +

+


+          
+        

+
+
+
+
+

Clutter is a GObject based library for creating fast, visually + rich, graphical user interfaces.

+

Clutter works by manipulating a scene-graph of 2D surfaces, or + 'actors', inside a 3D space.

+

ClutterActor is the base class for such surfaces. All + ClutterActors can be positioned, scaled and rotated in 3D space. + In addition, other properties can be set, such as 2D clipping, children and + opacity. Tranforms applied to a parent actor also apply to any children. + Actors are also able to receive events.

+

Subclasses of ClutterActor include ClutterStage, ClutterTexture, + ClutterLabel, ClutterRectangle, ClutterEntry and + ClutterGroup. ClutterActors are added to a parent, transformed + and then made visible.

+

ClutterStage is the top level ClutterActor - it's the + representation of a window, or framebuffer. It is created automatically + when Clutter is initialised. ClutterStage is a ClutterGroup, a class + implementing the ClutterCointainer interface.

+

ClutterTimelines provide the basis for Clutter's animation + utilities. Multiple timelines can be synchronised using ClutterScore, + and ClutterBehaviour and ClutterEffect allow for the creation of + animation effects such as transitions.

+

Clutter further contains a number of utilities, including; + ClutterScript - for loading 'UI definition' files formatted in + JSON, ClutterShader - a + class for applying GPU shaders to actors, ClutterModel - a utility class + for MVC list type implementations, and fixed point math utilities.

+
+
+
+
+ Generated by GTK-Doc V1.10
+ + diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/clutter-subclassing-ClutterActor.html clutter-0.7.6/doc/reference/clutter/html/clutter-subclassing-ClutterActor.html --- clutter-0.7.4/doc/reference/clutter/html/clutter-subclassing-ClutterActor.html 2008-06-25 17:58:29.000000000 +0100 +++ clutter-0.7.6/doc/reference/clutter/html/clutter-subclassing-ClutterActor.html 2008-06-27 21:32:04.000000000 +0100 @@ -4,14 +4,14 @@ Implementing a new actor - + - - + + @@ -42,7 +42,7 @@ Prev Up Home -Clutter 0.7.4 +Clutter 0.7.6 Reference Manual Next @@ -55,12 +55,12 @@ Emmanuele Bassi


-          
+          
        

-

In order to implement a new ClutterActor subclass the usual - machinery for subclassing a GObject should be used:

+

In order to implement a new #ClutterActor subclass the usual + machinery for subclassing a #GObject should be used:

 #define FOO_TYPE_ACTOR            (foo_actor_get_type ())
 #define FOO_ACTOR(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), FOO_TYPE_ACTOR, FooActor))
@@ -123,33 +123,33 @@
 

 
   

-
Container actors should also implement the ClutterContainer
+
Container actors should also implement the #ClutterContainer
   interface to provide a consistent API for adding, removing and iterating
   over their children.

 

 
Size requisition

 
Actors should usually implement the size requisition virtual
     functions unless they depend on explicit sizing by the developer,
-    using the clutter_actor_set_width() and clutter_actor_set_height()
+    using the clutter_actor_set_width() and clutter_actor_set_height()
     functions and their wrappers.

 

 
Note

 
For instance, an actor that depends on the explicit
-    sizing is the ClutterRectangle actor.

+    sizing is the #ClutterRectangle actor.

 

 
The size requisition is split into two different phases: width
     requisition and height requisition.

-
The ClutterActor::get_preferred_width() and
-    ClutterActor::get_preferred_height() methods of a
-    ClutterActor are invoked when clutter_actor_get_preferred_width() and 
-    clutter_actor_get_preferred_height() are respectively called on an instance
+
The ClutterActor::get_preferred_width() and
+    ClutterActor::get_preferred_height() methods of a
+    #ClutterActor are invoked when clutter_actor_get_preferred_width() and 
+    clutter_actor_get_preferred_height() are respectively called on an instance
     of that actor class. They are used to return the preferred size of the 
     actor. Container actors, or composite actors with internal children, 
-    should call clutter_actor_get_preferred_width() and 
-    clutter_actor_get_preferred_height() on each visible child inside
-    their implementation of the get_preferred_width() and get_preferred_height()
+    should call clutter_actor_get_preferred_width() and 
+    clutter_actor_get_preferred_height() on each visible child inside
+    their implementation of the get_preferred_width() and get_preferred_height()
     virtual functions.

-
The get_preferred_width() and get_preferred_height() virtual
+
The get_preferred_width() and get_preferred_height() virtual
     functions return both the minimum size of the actor and its natural
     size. The minimum size is defined as the amount of space an actor
     must occupy to be useful; the natural size is defined as the amount
@@ -157,24 +157,24 @@
 

 
Note

 
The natural size must always be greater than, or equal
-    to the minimum size. ClutterActor will warn in case this assumption
+    to the minimum size. #ClutterActor will warn in case this assumption
     is not respected by an implementation.

 

 
The height request may be computed for a specific width, which
     is passed to the implementation, thus allowing height-for-width
     geometry management. Similarly, the width request may be computed
     for a specific height, allowing width-for-height geometry management.
-    By default, every ClutterActor uses the height-for-width geometry
+    By default, every #ClutterActor uses the height-for-width geometry
     management, but the setting can be changed by using the
-    "request-mode" property.

+    #ClutterActor:request-mode property.

 

 
Note

-
The clutter_actor_get_preferred_size() function will
+
The clutter_actor_get_preferred_size() function will
     automatically check the geometry management preferred by the actor
     and return its preferred size depending on the value of the request-mode
     property and on the natural size of the actor.

 

-
The size requisition starts from the ClutterStage and it is
+
The size requisition starts from the #ClutterStage and it is
     performed on every child of the stage following down the hierarchy
     of the scene graph.

 

@@ -185,9 +185,9 @@
 

 

 
Note

-
All the sizes are expressed using ClutterUnits, the
+
All the sizes are expressed using #ClutterUnits, the
     internal high-precision unit type, which guarantees sub-pixel precision.
-    ClutterUnit currently has the same limitations that ClutterFixed has,
+    #ClutterUnit currently has the same limitations that #ClutterFixed has,
     see the fixed point page.
     

 

@@ -195,11 +195,11 @@
 
Example 1. Width requisition implementation of a container

 

 
This example shows how an actor class should override the
-      get_preferred_width() virtual function of ClutterActor. In this case,
+      get_preferred_width() virtual function of #ClutterActor. In this case,
       the returned widths are the union of the extents of all the
       FooActor children.

-
The get_preferred_height() implementation would be similar to the
-      get_preferred_width() implementation, so it is omitted.

+
The get_preferred_height() implementation would be similar to the
+      get_preferred_width() implementation, so it is omitted.

 
 static void
 foo_actor_get_preferred_width (ClutterActor *actor,
@@ -283,12 +283,12 @@
 

 

 
Size allocation

-
The ClutterActor::allocate() method of a
-    ClutterActor is invoked when clutter_actor_allocate() is called on an
+
The ClutterActor::allocate() method of a
+    #ClutterActor is invoked when clutter_actor_allocate() is called on an
     instance of that actor class. It is used by a parent actor to set the 
     coordinates of the bounding box for its children actors. Hence, 
     container actors, or composite actors with internal children, should 
-    override the allocate() virtual function and call clutter_actor_allocate()
+    override the allocate() virtual function and call clutter_actor_allocate()
     on each visible child.

 
Each actor can know from their allocation box whether they
     have been moved with respect to their parent actor. Each child will
@@ -296,8 +296,8 @@
     to the stage.

 

 
Note

-
The allocate() virtual function implementation will be
-    notified whether the actor has been moved, while clutter_actor_allocate()
+
The allocate() virtual function implementation will be
+    notified whether the actor has been moved, while clutter_actor_allocate()
     will usually be invoked with a boolean flag meaning that the parent
     has been moved.

 

@@ -367,7 +367,7 @@
 

 

 
Painting and picking

-
The ClutterActor::paint() method should be
+
The ClutterActor::paint() method should be
     overridden if the actor needs to control its drawing process, either by
     using the Clutter GL and GLES abstraction library (COGL) or by directly
     using the GL or GLES API.

@@ -380,7 +380,7 @@
 
Example 3. Paint implementation of a simple actor

 

 
In this example, the FooActor
-      implementation of the paint() virtual function is drawing a rectangle
+      implementation of the paint() virtual function is drawing a rectangle
       with rounded corners with a custom color. The COGL API is used, to
       allow portability between GL and GLES platforms.

 
@@ -432,19 +432,19 @@
 

 

 
Note

-
When inside the ClutterActor::paint()
+
When inside the ClutterActor::paint()
     method the actor is already positioned at the coordinates specified by
     its parent; all the paint operations should take place from the (0, 0)
     coordinates.

 

 
Container actors or composite actors with internal children should
-    also override the paint method, and call clutter_actor_paint() on every
+    also override the paint method, and call clutter_actor_paint() on every
     visible child:

 

 
Example 4. Paint implementation of a container

 

 
In this example, FooActor is a simple
-      container invoking clutter_actor_paint() on every visible child. To
+      container invoking clutter_actor_paint() on every visible child. To
       allow transformations on itself to affect the children, the GL modelview
       matrix is pushed at the beginning of the paint sequence, and the popped
       at the end.

@@ -475,14 +475,14 @@
 

 
If the actor has a non-rectangular shape, or it has internal
     children that need to be distinguished by the events delivery mechanism,
-    the ClutterActor::pick() method should also be
-    overridden. The pick() method works exactly like the paint() method, but
+    the ClutterActor::pick() method should also be
+    overridden. The pick() method works exactly like the paint() method, but
     the actor should paint just its shape with the passed colour:

 

 
Example 5. Pick implementation of a simple actor

 

 
In this example, FooActor overrides the
-      pick() virtual function default implementation to paint itself with a
+      pick() virtual function default implementation to paint itself with a
       shaped silhouette, to allow events only on the actual shape of the actor
       instead of the whole paint area.

 
@@ -522,7 +522,7 @@
 

 

 
Containers should simply chain up to the parent class'
-    pick() implementation to get their silhouette painted and then
+    pick() implementation to get their silhouette painted and then
     paint their children:

 

 
Example 6. Pick implementation of a container

@@ -553,25 +553,25 @@
 

 
Implementing Containers

 

-    The ClutterContainer interface should be implemented by subclasses
-    of ClutterActor who wants to provide a general API for adding child
+    The #ClutterContainer interface should be implemented by subclasses
+    of #ClutterActor who wants to provide a general API for adding child
     actors.
     

 

-    If the ClutterActor subclass only handles internal children, or it's
+    If the #ClutterActor subclass only handles internal children, or it's
     not suitable for having generic actors added to it, it should not
-    implement the ClutterContainer interface, but simply use
-    clutter_actor_set_parent():
+    implement the #ClutterContainer interface, but simply use
+    clutter_actor_set_parent():
     

 

 
Example 7. Parenting an actor

 

 
In this example, FooActor has an internal
       child of type BazActor which is assigned using a
-      specific function called foo_actor_add_baz(). The
+      specific function called foo_actor_add_baz(). The
       FooActor instance takes ownership of the
       BazActor instance and sets the parent-child
-      relationship using clutter_actor_set_parent().

+      relationship using clutter_actor_set_parent().

 
 void
 foo_actor_add_baz (FooActor *foo_actor,
@@ -610,7 +610,7 @@
 

 

 

-    In order to implement the ClutterContainer interface, these virtual
+    In order to implement the #ClutterContainer interface, these virtual
     functions must be defined:
 
       

@@ -620,16 +620,16 @@
 
 
ClutterContainer::add

 
The container actor should hold a pointer to the passed
-            ClutterActor, call clutter_actor_set_parent() on it and then
-            emit the "actor-added" signal to notify
+            #ClutterActor, call clutter_actor_set_parent() on it and then
+            emit the #ClutterContainer::actor-added signal to notify
             handlers of the newly added actor.

 
 
 
ClutterContainer::remove

 
The container actor should increase the reference count
-            of the passed ClutterActor, remove the pointer held on the
-            child and call clutter_actor_unparent() on it; then, emit the
-            "actor-removed" signal and decrease the
+            of the passed #ClutterActor, remove the pointer held on the
+            child and call clutter_actor_unparent() on it; then, emit the
+            #ClutterContainer::actor-removed signal and decrease the
             reference count.

 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/clutter.devhelp clutter-0.7.6/doc/reference/clutter/html/clutter.devhelp
--- clutter-0.7.4/doc/reference/clutter/html/clutter.devhelp	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/html/clutter.devhelp	2008-06-27 21:32:04.000000000 +0100
@@ -1,9 +1,9 @@
 
 
-
+
   
-    
-    
+    
+    
     
       
         
@@ -1072,7 +1072,6 @@
     
     
     
-    
     
     
     
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/clutter.devhelp2 clutter-0.7.6/doc/reference/clutter/html/clutter.devhelp2
--- clutter-0.7.4/doc/reference/clutter/html/clutter.devhelp2	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/html/clutter.devhelp2	2008-06-27 21:32:04.000000000 +0100
@@ -1,9 +1,9 @@
 
 
-
+
   
-    
-    
+    
+    
     
       
         
@@ -1072,7 +1072,6 @@
     
     
     
-    
     
     
     
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/clutter.html clutter-0.7.6/doc/reference/clutter/html/clutter.html
--- clutter-0.7.4/doc/reference/clutter/html/clutter.html	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/html/clutter.html	1970-01-01 01:00:00.000000000 +0100
@@ -1,115 +0,0 @@
-
-
-
-
-Part I. Clutter Overview
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-

-

-Part I. Clutter Overview

-

-

-

-
-    Clutter is a GObject based library for creating fast, visually
-    rich, graphical user interfaces.
-
-    

-

-
-    Clutter works by manipulating a scene-graph of 2D surfaces, or 'actors',
-    inside a 3D space.
-
-    

-

-
-    #ClutterActor is the base class for such surfaces. All
-    #ClutterActors can be positioned, scaled and rotated in 3D space.
-    In addition, other properties can be set, such as 2D clipping, children and
-    opacity. Tranforms applied to a parent actor also apply to any children.
-    Actors are also able to receive events.
-
-    

-

-
-    Subclasses of #ClutterActor include #ClutterStage, #ClutterTexture,
-    #ClutterLabel, #ClutterRectangle, #ClutterEntry and
-    #ClutterGroup. #ClutterActors are added to a parent, transformed
-    and then made visible.
-
-    

-

-
-    #ClutterStage is the top level #ClutterActor - it's the representation
-    of a window, or framebuffer. It is created automatically when Clutter is
-    initialised. #ClutterStage is a #ClutterGroup, a class
-    implementing the #ClutterCointainer interface. Clutter currently
-    only supports a single stage.
-
-    

-

-
-    #ClutterTimelines provide the basis for Clutter's animation
-    utilities. Multiple timelines can be synchronised using #ClutterScore,
-    and #ClutterBehaviour and #ClutterEffect allow for the creation of
-    animation effects such as transitions.
-
-    

-

-
-    Clutter further contains a number of utilities, including;
-    #ClutterScript - for loading 'UI definition' files formatted in
-    JSON, #ClutterShader - a class for applying GPU shaders to actors,
-    #ClutterModel - a utility class for MVC list type implementations
-    and #ClutterFixed - fixed point math utilities.
-
-    

-

-

-

-

-          Generated by GTK-Doc V1.10

-
-
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/clutteranimation.html clutter-0.7.6/doc/reference/clutter/html/clutteranimation.html
--- clutter-0.7.4/doc/reference/clutter/html/clutteranimation.html	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/html/clutteranimation.html	2008-06-27 21:32:04.000000000 +0100
@@ -4,14 +4,14 @@
 
 Part IV. Clutter Animation Framework
 
-
-
+
+
 
 
 
 
-
-
+
+
 
 
 
@@ -42,7 +42,7 @@
 Prev
  
 Home
-Clutter 0.7.4
+Clutter 0.7.6
  Reference Manual
 Next
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/clutterbase.html clutter-0.7.6/doc/reference/clutter/html/clutterbase.html
--- clutter-0.7.4/doc/reference/clutter/html/clutterbase.html	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/html/clutterbase.html	2008-06-27 21:32:04.000000000 +0100
@@ -4,14 +4,14 @@
 
 Part III. Clutter Core Reference
 
-
-
-
+
+
+
 
 
 
-
-
+
+
 
 
 
@@ -39,10 +39,10 @@
 
 
 
-
+
-
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/clutterbuilding.html clutter-0.7.6/doc/reference/clutter/html/clutterbuilding.html
--- clutter-0.7.4/doc/reference/clutter/html/clutterbuilding.html	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/html/clutterbuilding.html	1970-01-01 01:00:00.000000000 +0100
@@ -1,244 +0,0 @@
-
-
-
-
-Part II. Building Clutter
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-

-

-Part II. Building Clutter

-

-

-

-

-Clutter Dependencies

-

--
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-


GLib
A general-purpose utility library, not specific to
-            graphical user interfaces. GLib provides many useful data
-            types, macros, type conversions, string utilities, file
-            utilities, a main loop abstraction, and so on.
GObject
The GLib Object System provides the required
-            implementations of a flexible, extensible and intentionally
-            easy to map (into other languages) object-oriented framework
-            for C.
Pango
Pango is a library for laying out and rendering
-            text, with an emphasis on internationalization.
GDK-Pixbuf, Backend Windowing System Library, Graphics Rendering 

-
GDK-Pixbuf is a library for loading and manipulating
-            various image file formats.

-
GLX, EGL (1.1), SDL, Cocoa (OS X) and WGL (Windows)

-
Open GL (1.2+) ir Open GL ES (1.1) 

-

-

-

-

-Platform-specific instructions

-

-

-Linux

-
If you are using Debian or Ubuntu, you can install pre-compiled
-        binary packages the normal Debian way following the instructions at
-        
-        http://debian.o-hand.com/.
-        

-
To build Clutter clutter from sources, get the latest source
-        archives from 
-        http://www.clutter-project.org/sources/. Once you have extracted
-        the sources from the archive execute the following commands in the
-        top-level directory:
-        

-


-    ./configure

-    make

-    make install

-        

-
You can configure the build with number of additional arguments
-        passed to the configure script, the full list of which can be obtained
-        by running ./configure --help. The following arguments are specific to
-        Clutter:
-
-            

-

--
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-


--enable-debug=[no/minimum/yes]
Turns on debugging. Possible values are: yes -  all
-                  glib asserts, checks and runtime clutter verbose messages;
-                 minimum - just glib cast checks and runtime clutter verbose
-                 messagaes; no - no glib asserts or checks and no runtime
-                 clutter verbose messages; default=yes.
-                 
--enable-maintainer-flags=[no/yes]
Use strict compiler flags; default=no.
-                  
--enable-gtk-doc
Use gtk-doc to build documentation; default=no.
-                  
--enable-manual=[no/yes]
Build application developers manual; requires jw and
-                  xmlto binaries; default=no.
-                  
--with-flavour=[glx/eglx/eglnative/sdl]
Select the Clutter backend; default=glx.
-                  

-

-
-            

-

-

-

-Windows

-

-            The recommended way of building Clutter for Windows is using the
-            mingw tool
-            chain. One option is to cross-compile Clutter under Linux -- you
-            can use the script found in the build/mingw/
-            directory to simplify the process (the script takes care of setting
-            up the necessary dependencies).
-            

-

-            If you wish to build Clutter using mingw direcly under Windows, you
-            can do so the normal *nix way (described above) using the mingw
-            POSIX shell. Should you prefer to use Microsoft Visual Studio, a
-            project file for MSVC 2005 is located in the
-            build/msvc_2k5/ directory. In either case, you
-            will need to first install the required dependencies.
-            

-

-            There are currently two backends that are supported on
-            Windows. One uses the Win32 and WGL APIs directly and the
-            other is built on top of SDL. You must choose one of the
-            backends when running the configure script using the
-            following argument:
-            

-

--
-
-
-
-


--with-flavour=[win32/sdl]
Select the Clutter backend; default=glx.
-                  

-

-            

-

-

-

-OSX

-
For developing an application with Clutter, the recommended
-          way of installing it using the MacPorts
-          project, by simply invoking:

-
-            $ sudo port install clutter
-          

-
on a terminal, after installing and updating MacPorts.

-
For developing Clutter itself, the recommended way of building
-          it OSX is to use Jhbuild,
-          following the documentation for building the GTK+ stack as shown
-          here.

-

-            Jhbuild depends on SVN, which can be installed on OSX by using
-            the MacPorts
-            project.
-          

-

-            XCode should also be installed, either from the OSX installation
-            disk or downloading it from the Apple website. It is recommended
-            to also install the X11 development files, even though Clutter
-            does not strictly depend on them.
-          

-

-            The Clutter Quartz backend is built by passing the
-            --with-flavour=osx command line argument
-            to the configure script. If not passed, the GLX backend will
-            be built. By default, the Quartz backend depends on CoreGraphics
-            in order to load images into textures, but it can also depend
-            on GDK-Pixbuf or an internal, highly experimental PNG and JPEG
-            loader.
-          

-

-            GTK-Doc is not working on OSX, so API reference generation
-            should also be disabled when building Clutter, by using
-            the --disable-docs and
-            --disable-gtk-doc command line argument
-            to the configure script.
-          

-

-

-

-

-

-

-          Generated by GTK-Doc V1.10

-
-
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/creating-your-own-behaviours.html clutter-0.7.6/doc/reference/clutter/html/creating-your-own-behaviours.html
--- clutter-0.7.4/doc/reference/clutter/html/creating-your-own-behaviours.html	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/html/creating-your-own-behaviours.html	2008-06-27 21:32:04.000000000 +0100
@@ -4,14 +4,14 @@
 
 Creating You Own Behaviours
 
-
+
 
 
 
 
 
-
-
+
+
 
 
 
@@ -42,7 +42,7 @@
 Prev
 Up
 Home
-Clutter 0.7.4
+Clutter 0.7.6
  Reference Manual
 Next
 
@@ -55,7 +55,7 @@
 Matthew Allum
 
 


-          

+          

         

 

 

@@ -70,9 +70,9 @@
   

 

 
-  In order to implement a new ClutterBehaviour subclass the usual
+  In order to implement a new #ClutterBehaviour subclass the usual
   machinery for subclassing a GObject should be used. The new subclass
-  then just overides the ClutterBehaviour::alpha_notify() method. This
+  then just overides the ClutterBehaviour::alpha_notify() method. This
   method is passed an alpha value which is then used to compute
   modifications to any actors the behaviour is applied to.
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/index.html clutter-0.7.6/doc/reference/clutter/html/index.html
--- clutter-0.7.4/doc/reference/clutter/html/index.html	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/html/index.html	2008-06-27 21:32:04.000000000 +0100
@@ -2,14 +2,14 @@
 
 
 
-Clutter 0.7.4 Reference Manual
+Clutter 0.7.6 Reference Manual
 
-
-
+
+
 
 
-
-
+
+
 
 
 
@@ -39,13 +39,13 @@
 

 

 

-

-
 

 

-Index

+Index

 

 
C

 

@@ -954,8 +954,6 @@
 
 
clutter_atani, clutter_atani ()
 

-
clutter_backend_get_display_size, clutter_backend_get_display_size ()
-

 
clutter_backend_get_double_click_distance, clutter_backend_get_double_click_distance ()
 

 
clutter_backend_get_double_click_time, clutter_backend_get_double_click_time ()
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ix02.html clutter-0.7.6/doc/reference/clutter/html/ix02.html
--- clutter-0.7.4/doc/reference/clutter/html/ix02.html	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/html/ix02.html	2008-06-27 21:32:04.000000000 +0100
@@ -4,14 +4,14 @@
 
 Index of deprecated symbols
 
-
-
+
+
 
 
 
 
-
-
+
+
 
 
 
@@ -42,13 +42,13 @@
 Prev
  
 Home
-Clutter 0.7.4
+Clutter 0.7.6
  Reference Manual
 Next
 
 

 

-Index of deprecated symbols

+Index of deprecated symbols

 

 
C

 

diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ix03.html clutter-0.7.6/doc/reference/clutter/html/ix03.html
--- clutter-0.7.4/doc/reference/clutter/html/ix03.html	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/html/ix03.html	2008-06-27 21:32:04.000000000 +0100
@@ -4,14 +4,14 @@
 
 Index of new symbols in 0.2
 
-
-
+
+
 
 
 
 
-
-
+
+
 
 
 
@@ -42,13 +42,13 @@
 Prev
  
 Home
-Clutter 0.7.4
+Clutter 0.7.6
  Reference Manual
 Next
 
 

 

-Index of new symbols in 0.2

+Index of new symbols in 0.2

 

 
C

 

diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ix04.html clutter-0.7.6/doc/reference/clutter/html/ix04.html
--- clutter-0.7.4/doc/reference/clutter/html/ix04.html	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/html/ix04.html	2008-06-27 21:32:04.000000000 +0100
@@ -4,14 +4,14 @@
 
 Index of new symbols in 0.4
 
-
-
+
+
 
 
 
 
-
-
+
+
 
 
 
@@ -42,13 +42,13 @@
 Prev
  
 Home
-Clutter 0.7.4
+Clutter 0.7.6
  Reference Manual
 Next
 
 

 

-Index of new symbols in 0.4

+Index of new symbols in 0.4

 

 
C

 

diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ix05.html clutter-0.7.6/doc/reference/clutter/html/ix05.html
--- clutter-0.7.4/doc/reference/clutter/html/ix05.html	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/html/ix05.html	2008-06-27 21:32:04.000000000 +0100
@@ -4,14 +4,14 @@
 
 Index of new symbols in 0.6
 
-
-
+
+
 
 
 
 
-
-
+
+
 
 
 
@@ -42,13 +42,13 @@
 Prev
  
 Home
-Clutter 0.7.4
+Clutter 0.7.6
  Reference Manual
 Next
 
 

 

-Index of new symbols in 0.6

+Index of new symbols in 0.6

 

 
C

 

diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/ix06.html clutter-0.7.6/doc/reference/clutter/html/ix06.html
--- clutter-0.7.4/doc/reference/clutter/html/ix06.html	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/html/ix06.html	2008-06-27 21:32:04.000000000 +0100
@@ -4,14 +4,14 @@
 
 Index of new symbols in 0.8
 
-
-
+
+
 
 
 
 
-
-
+
+
 
 
 
@@ -42,13 +42,13 @@
 Prev
  
 Home
-Clutter 0.7.4
+Clutter 0.7.6
  Reference Manual
 Next
 
 

 

-Index of new symbols in 0.8

+Index of new symbols in 0.8

 

 
C

 

@@ -142,8 +142,6 @@
 
 
clutter_alpha_set_closure, clutter_alpha_set_closure ()
 

-
clutter_backend_get_display_size, clutter_backend_get_display_size ()
-

 
clutter_backend_get_font_options, clutter_backend_get_font_options ()
 

 
clutter_backend_set_font_options, clutter_backend_set_font_options ()
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/license.html clutter-0.7.6/doc/reference/clutter/html/license.html
--- clutter-0.7.4/doc/reference/clutter/html/license.html	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/html/license.html	2008-06-27 21:32:04.000000000 +0100
@@ -4,13 +4,13 @@
 
 Appendix A. License
 
-
-
+
+
 
 
 
-
-
+
+
 
 
 
@@ -41,7 +41,7 @@
 Prev
  
 Home
-Clutter 0.7.4
+Clutter 0.7.6
  Reference Manual
  
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/pt05.html clutter-0.7.6/doc/reference/clutter/html/pt05.html
--- clutter-0.7.4/doc/reference/clutter/html/pt05.html	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/html/pt05.html	2008-06-27 21:32:04.000000000 +0100
@@ -4,14 +4,14 @@
 
 Part V. Clutter Tools
 
-
-
+
+
 
 
 
 
-
-
+
+
 
 
 
@@ -42,13 +42,13 @@
 Prev
  
 Home
-Clutter 0.7.4
+Clutter 0.7.6
  Reference Manual
 Next
 
 

 

-Part V. Clutter Tools

+Part V. Clutter Tools

 

 
Table of Contents

 

diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/pt06.html clutter-0.7.6/doc/reference/clutter/html/pt06.html
--- clutter-0.7.4/doc/reference/clutter/html/pt06.html	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/html/pt06.html	2008-06-27 21:32:04.000000000 +0100
@@ -4,14 +4,14 @@
 
 Part VI. Clutter Backends
 
-
-
+
+
 
 
 
 
-
-
+
+
 
 
 
@@ -42,13 +42,13 @@
 Prev
  
 Home
-Clutter 0.7.4
+Clutter 0.7.6
  Reference Manual
 Next
 
 

 

-Part VI. Clutter Backends

+Part VI. Clutter Backends

 

 

 
Clutter is usually compiled against a specific drawing backend.
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/html/pt07.html clutter-0.7.6/doc/reference/clutter/html/pt07.html
--- clutter-0.7.4/doc/reference/clutter/html/pt07.html	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/html/pt07.html	2008-06-27 21:32:04.000000000 +0100
@@ -4,14 +4,14 @@
 
 Part VII. Additional Documentation
 
-
-
+
+
 
 
 
 
-
-
+
+
 
 
 
@@ -42,13 +42,13 @@
 Prev
  
 Home
-Clutter 0.7.4
+Clutter 0.7.6
  Reference Manual
 Next
 
 

 

-Part VII. Additional Documentation

+Part VII. Additional Documentation

 

 

 
This section contains additional useful documentation for
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/subclassing-ClutterActor.sgml clutter-0.7.6/doc/reference/clutter/subclassing-ClutterActor.sgml
--- clutter-0.7.4/doc/reference/clutter/subclassing-ClutterActor.sgml	2008-06-25 17:25:16.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/subclassing-ClutterActor.sgml	1970-01-01 01:00:00.000000000 +0100
@@ -1,631 +0,0 @@
-
-  
-    
-      Emmanuele
-      Bassi
-      
-        

-          ebassi@openedhand.com
-        

-      
-    
-  
-
-  Implementing a new actor
-
-  In order to implement a new #ClutterActor subclass the usual
-  machinery for subclassing a #GObject should be used:
-
-  
-    
-#define FOO_TYPE_ACTOR            (foo_actor_get_type ())
-#define FOO_ACTOR(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), FOO_TYPE_ACTOR, FooActor))
-#define FOO_IS_ACTOR(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), FOO_TYPE_ACTOR))
-#define FOO_ACTOR_CLASS(klass)    (G_TYPE_CHECK_CLASS_CAST ((klass), FOO_TYPE_ACTOR, FooActorClass))
-#define FOO_IS_ACTOR_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), FOO_TYPE_ACTOR))
-#define FOO_ACTOR_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS ((obj), FOO_TYPE_ACTOR, FooActorClass))
-
-typedef struct _FooActor
-{
-  ClutterActor parent_instance;
-} FooActor;
-
-typedef struct _FooActorClass
-{
-  ClutterActorClass parent_class;
-} FooActorClass;
-
-G_DEFINE_TYPE (FooActor, foo_actor, CLUTTER_TYPE_ACTOR);
-
-static void
-foo_actor_class_init (FooActorClass *klass)
-{
-
-}
-
-static void
-foo_actor_init (FooActor *actor)
-{
-
-}
-    
-  
-
-  The implementation of an actor roughly depends on what kind
-  of actor the class should display.
-
-  The implementation process can be broken down into sections:
-
-    
-      
-        size requisition
-        used by containers to know how much space
-        an actor requires for itself and its eventual
-        children.
-      
-
-      
-        size allocation
-        used by containers to define how much space
-        an actor should have for itself and its eventual
-        children.
-      
-
-      
-        painting and picking
-        the actual actor painting and the "picking"
-        done to determine the actors that received events
-      
-
-    
-
-  
-
-  Container actors should also implement the #ClutterContainer
-  interface to provide a consistent API for adding, removing and iterating
-  over their children.
-
-  
-    Size requisition
-
-    Actors should usually implement the size requisition virtual
-    functions unless they depend on explicit sizing by the developer,
-    using the clutter_actor_set_width() and clutter_actor_set_height()
-    functions and their wrappers.
-
-    For instance, an actor that depends on the explicit
-    sizing is the #ClutterRectangle actor.
-
-    The size requisition is split into two different phases: width
-    requisition and height requisition.
-
-    The ClutterActor::get_preferred_width() and
-    ClutterActor::get_preferred_height() methods of a
-    #ClutterActor are invoked when clutter_actor_get_preferred_width() and 
-    clutter_actor_get_preferred_height() are respectively called on an instance
-    of that actor class. They are used to return the preferred size of the 
-    actor. Container actors, or composite actors with internal children, 
-    should call clutter_actor_get_preferred_width() and 
-    clutter_actor_get_preferred_height() on each visible child inside
-    their implementation of the get_preferred_width() and get_preferred_height()
-    virtual functions.
-
-    The get_preferred_width() and get_preferred_height() virtual
-    functions return both the minimum size of the actor and its natural
-    size. The minimum size is defined as the amount of space an actor
-    must occupy to be useful; the natural size is defined as the amount
-    of space an actor would occupy if nothing would constrain it.
-
-    The natural size must always be greater than, or equal
-    to the minimum size. #ClutterActor will warn in case this assumption
-    is not respected by an implementation.
-
-    The height request may be computed for a specific width, which
-    is passed to the implementation, thus allowing height-for-width
-    geometry management. Similarly, the width request may be computed
-    for a specific height, allowing width-for-height geometry management.
-    By default, every #ClutterActor uses the height-for-width geometry
-    management, but the setting can be changed by using the
-    #ClutterActor:request-mode property.
-
-    The clutter_actor_get_preferred_size() function will
-    automatically check the geometry management preferred by the actor
-    and return its preferred size depending on the value of the request-mode
-    property and on the natural size of the actor.
-
-    The size requisition starts from the #ClutterStage and it is
-    performed on every child of the stage following down the hierarchy
-    of the scene graph.
-
-    The size requisition should not take into account the
-    actor's scale, rotation or anchor point unless an actor is performing
-    layout management depending on those properties.
-
-    All the sizes are expressed using #ClutterUnits, the
-    internal high-precision unit type, which guarantees sub-pixel precision.
-    #ClutterUnit currently has the same limitations that #ClutterFixed has,
-    see the fixed point page.
-    
-
-    
-      Width requisition implementation of a container
-
-      This example shows how an actor class should override the
-      get_preferred_width() virtual function of #ClutterActor. In this case,
-      the returned widths are the union of the extents of all the
-      FooActor children.
-
-      The get_preferred_height() implementation would be similar to the
-      get_preferred_width() implementation, so it is omitted.
-
-      
-static void
-foo_actor_get_preferred_width (ClutterActor *actor,
-                               ClutterUnit   for_height,
-                               ClutterUnit  *min_width_p,
-                               ClutterUnit  *natural_width_p)
-{
-  GList *l;
-  ClutterUnit min_left, min_right;
-  ClutterUnit natural_left, natural_right;
-
-  min_left = 0;
-  min_right = 0;
-  natural_left = 0;
-  natural_right = 0;
-
-  for (l = children; l != NULL; l = l->next)
-    {
-      ClutterActor *child = l->data;
-      ClutterUnit child_x, child_min, child_natural;
-
-      child_x = clutter_actor_get_xu (child);
-
-      clutter_actor_get_preferred_width (child, for_height,
-                                         &child_min,
-                                         &child_natural);
-
-      if (l == children)
-        {
-          /* First child */
-          min_left = child_x;
-          natural_left = child_x;
-          min_right = min_left + child_min;
-          natural_right = natural_left + child_natural;
-        }
-      else
-        {
-          if (child_x < min_left)
-            min_left = child_x;
-
-          if (child_x < natural_left)
-            natural_left = child_x;
-
-          if (child_x + child_min > min_right)
-            min_right = child_x + child_min;
-
-          if (child_x + child_natural > natural_right)
-            natural_right = child_x + child_natural;
-        }
-    }
-
-  /* The request is defined as the width and height we want starting from 
-   * our origin, since our allocation will set the origin; so we now need 
-   * to remove any part of the request that is to the left of the origin.
-   */
-  if (min_left < 0)
-    min_left = 0;
-
-  if (natural_left < 0)
-    natural_left = 0;
-
-  if (min_right < 0)
-    min_right = 0;
-
-  if (natural_right < 0)
-    natural_right = 0;
-
-  g_assert (min_right >= min_left);
-  g_assert (natural_right >= natural_left);
-
-  if (min_width_p)
-    *min_width_p = min_right - min_left;
-
-  if (natural_width_p)
-    *natural_width_p = natural_right - min_left;
-}
-      
-    
-
-   
-
-  
-    Size allocation
-
-    The ClutterActor::allocate() method of a
-    #ClutterActor is invoked when clutter_actor_allocate() is called on an
-    instance of that actor class. It is used by a parent actor to set the 
-    coordinates of the bounding box for its children actors. Hence, 
-    container actors, or composite actors with internal children, should 
-    override the allocate() virtual function and call clutter_actor_allocate()
-    on each visible child.
-
-    Each actor can know from their allocation box whether they
-    have been moved with respect to their parent actor. Each child will
-    also be able to tell whether their parent has been moved with respect
-    to the stage.
-
-    The allocate() virtual function implementation will be
-    notified whether the actor has been moved, while clutter_actor_allocate()
-    will usually be invoked with a boolean flag meaning that the parent
-    has been moved.
-
-    
-      Allocation of a container
-      In this example, FooActor acts like a
-      horizontal box with overflowing, like a toolbar which will display
-      more children as it expands. The children falling outside of the
-      allocated area will fade out; the children falling inside the
-      same area will fade in.
-      
-static void
-foo_actor_allocate (ClutterActor          *actor,
-                    const ClutterActorBox *box,
-                    gboolean               absolute_origin_changed)
-{
-  FooActor *foo_actor = FOO_ACTOR (actor);
-  ClutterUnit current_width;
-  GList *l;
-
-  /* chain up to set the allocation of the actor */
-  CLUTTER_ACTOR_CLASS (foo_actor_parent_class)->allocate (actor, box, absolute_origin_changed);
-
-  current_width = foo_actor->padding;
-
-  for (l = foo_actor->children;
-       l != NULL;
-       l = l->next)
-    {
-      FooActorChild *child = l->data;
-      ClutterUnit natural_width, natural_height;
-      ClutterActorBox child_box = { 0, };
-
-      /* each child will get as much space as they require */
-      clutter_actor_get_preferred_size (CLUTTER_ACTOR (child),
-                                        NULL, NULL,
-                                        &natural_width, &natural_height);
-
-      /* if the child is overflowing, we just fade it out */
-      if (current_width + natual_width > box->x2 - box->x1)
-        foo_actor_fade_child (foo_actor, child, 0);
-      else
-        {
-          current_width += natural_width + priv->padding;
-
-          child_box.x1 = current_width;
-          child_box.y1 = 0;
-          child_box.x2 = child_box.x1 + natural_width;
-          child_box.y2 = child_box.y1 + natural_height;
-
-          /* update the allocation */
-          clutter_actor_allocate (CLUTTER_ACTOR (child),
-                                  &child_box,
-                                  absolute_origin_changed);
-
-          /* fade the child in if it wasn't visible */
-          foo_actor_fade_child (foo_actor, child, 255);
-        }
-    }
-}
-      
-    
-
-    The allocation is also the "paint area", that is the area where
-    the paint operations should be performed.
-
-   
-
-  
-    Painting and picking
-
-    The ClutterActor::paint() method should be
-    overridden if the actor needs to control its drawing process, either by
-    using the Clutter GL and GLES abstraction library (COGL) or by directly
-    using the GL or GLES API.
-
-    Actors performing transformations should push the GL matrix
-    first and then pop the GL matrix before returning.
-  
-    
-      Paint implementation of a simple actor
-      In this example, the FooActor
-      implementation of the paint() virtual function is drawing a rectangle
-      with rounded corners with a custom color. The COGL API is used, to
-      allow portability between GL and GLES platforms.
-      
-static void
-foo_actor_paint (ClutterActor *actor)
-{
-  FooActor *foo_actor = FOO_ACTOR (actor);
-  ClutterColor color = { 0, };
-  ClutterUnit w, h, r;
-
-  cogl_push_matrix ();
-
-  /* FooActor has a specific background color */
-  color.red   = foo_actor->bg_color.red;
-  color.green = foo_actor->bg_color.green;
-  color.blue  = foo_actor->bg_color.blue;
-
-  /* the alpha component must take into account the absolute
-   * opacity of the actor on the screen at this point in the
-   * scenegraph; this value is obtained by calling
-   * clutter_actor_get_paint_opacity().
-   */
-  color.alpha = clutter_actor_get_paint_opacity (actor);
-
-  /* set the color of the pen */
-  cogl_color (&color);
-
-  /* get the size of the actor with sub-pixel precision */
-  w = CLUTTER_UNITS_TO_FIXED (clutter_actor_get_widthu (actor));
-  h = CLUTTER_UNITS_TO_FIXED (clutter_actor_get_heightu (actor));
-
-  /* this is the arc radius for the rounded rectangle corners */
-  r = CLUTTER_UNITS_TO_FIXED (foo_actor->radius);
-
-  /* paint a rounded rectangle using GL primitives; the area of
-   * paint is (0, 0) - (width, height), which means the whole
-   * allocation or, if the actor has a fixed size, the size that
-   * has been set.
-   */
-  cogl_round_rectangle (0, 0, w, h, r, 5);
-
-  /* and fill it with the current color */
-  cogl_fill ();
-
-  cogl_pop_matrix ();
-}
-      
-    
-
-    When inside the ClutterActor::paint()
-    method the actor is already positioned at the coordinates specified by
-    its parent; all the paint operations should take place from the (0, 0)
-    coordinates.
-
-    Container actors or composite actors with internal children should
-    also override the paint method, and call clutter_actor_paint() on every
-    visible child:
-
-    
-      Paint implementation of a container
-      In this example, FooActor is a simple
-      container invoking clutter_actor_paint() on every visible child. To
-      allow transformations on itself to affect the children, the GL modelview
-      matrix is pushed at the beginning of the paint sequence, and the popped
-      at the end.
-      
-static void
-foo_actor_paint (ClutterActor *actor)
-{
-  FooActor *foo_actor = FOO_ACTOR (actor);
-  GList *child;
-
-  cogl_push_matrix ();
-
-  for (child = foo_actor->children;
-       child != NULL;
-       child = child->next)
-    {
-      ClutterActor *child_actor = child->data;
-
-      /* paint only visible children */
-      if (CLUTTER_ACTOR_IS_VISIBLE (child_actor))
-        clutter_actor_paint (child_actor);
-    }
-
-  cogl_pop_matrix ();
-}
-      
-    
-
-    If the actor has a non-rectangular shape, or it has internal
-    children that need to be distinguished by the events delivery mechanism,
-    the ClutterActor::pick() method should also be
-    overridden. The pick() method works exactly like the paint() method, but
-    the actor should paint just its shape with the passed colour:
-
-    
-      Pick implementation of a simple actor
-      In this example, FooActor overrides the
-      pick() virtual function default implementation to paint itself with a
-      shaped silhouette, to allow events only on the actual shape of the actor
-      instead of the whole paint area.
-      
-static void
-foo_actor_pick (ClutterActor       *actor,
-                const ClutterColor *pick_color)
-{
-  FooActor *foo_actor = FOO_ACTOR (actor);
-  ClutterUnit w, h, r;
-
-  /* it is possible to avoid a costly paint by checking whether the
-   * actor should really be painted in pick mode
-   */
-  if (!clutter_actor_should_pick_paint (actor))
-    return;
-
-  w = CLUTTER_UNITS_TO_FIXED (clutter_actor_get_widthu (actor));
-  h = CLUTTER_UNITS_TO_FIXED (clutter_actor_get_heightu (actor));
-
-  /* this is the arc radius for the rounded rectangle corners */
-  r = CLUTTER_UNITS_TO_FIXED (foo_actor->radius);
-
-  cogl_push_matrix ();
-
-  /* use the passed color to paint ourselves */
-  cogl_color (pick_color);
-
-  /* paint a round rectangle */
-  cogl_round_rectangle (0, 0, w, h, r, 5);
-
-  /* and fill it with the current color */
-  cogl_fill ();
-
-  cogl_pop_matrix ();
-}
-      
-    
-
-    Containers should simply chain up to the parent class'
-    pick() implementation to get their silhouette painted and then
-    paint their children:
-
-    
-      Pick implementation of a container
-      In this example, FooActor allows the
-      picking of each child it contains, as well as itself.
-      
-static void
-foo_actor_pick (ClutterActor       *actor,
-                const ClutterColor *pick_color)
-{
-  FooActor *foo_actor = FOO_ACTOR (actor);
-
-  /* this will paint a silhouette corresponding to the paint box */
-  CLUTTER_ACTOR_CLASS (foo_actor_parent_class)->pick (actor, pick_color);
-
-  /* clutter_actor_paint() is context-sensitive, and will perform
-   * a pick paint if the scene graph is in pick mode
-   */
-  if (CLUTTER_ACTOR_IS_VISIBLE (foo_actor->child))
-    clutter_actor_paint (foo_actor->child);
-}
-      
-    
-
-   
-
-  
-    Implementing Containers
-
-    
-    The #ClutterContainer interface should be implemented by subclasses
-    of #ClutterActor who wants to provide a general API for adding child
-    actors.
-    
-
-    
-    If the #ClutterActor subclass only handles internal children, or it's
-    not suitable for having generic actors added to it, it should not
-    implement the #ClutterContainer interface, but simply use
-    clutter_actor_set_parent():
-    
-
-    
-      Parenting an actor
-      In this example, FooActor has an internal
-      child of type BazActor which is assigned using a
-      specific function called foo_actor_add_baz(). The
-      FooActor instance takes ownership of the
-      BazActor instance and sets the parent-child
-      relationship using clutter_actor_set_parent().
-      
-void
-foo_actor_add_baz (FooActor *foo_actor,
-                   BazActor *baz_actor)
-{
-  g_return_if_fail (FOO_IS_ACTOR (foo_actor));
-  g_return_if_fail (BAZ_IS_ACTOR (baz_actor));
-
-  /* unparent the previous BazActor; this will automatically call
-   * g_object_unref() on the actor
-   */
-  if (foo_actor->baz)
-    clutter_actor_unparent (foo_actor->baz);
-
-  foo_actor->baz = baz_actor;
-
-  /* this will cause the initial floating reference of ClutterActor to
-   * disappear, and add a new reference on baz_actor. foo_actor has now
-   * taken ownership of baz_actor, so that:
-   *
-   *   foo_actor_add_baz (foo_actor, baz_actor_new ());
-   *
-   * is a safe statement (no reference is leaked).
-   */
-  clutter_actor_set_parent (CLUTTER_ACTOR (baz_actor),
-                            CLUTTER_ACTOR (foo_actor));
-
-  /* a container should queue a change in the layout */
-  clutter_actor_queue_relayout (CLUTTER_ACTOR (foo_actor));
-
-  /* emit a signal and notification */
-  g_signal_emit (foo_actor, foo_actor_signals[BAZ_CHANGED], 0, baz_actor);
-  g_object_notify (G_OBJECT (foo_actor), "baz");
-}
-      
-    
-
-    
-    In order to implement the #ClutterContainer interface, these virtual
-    functions must be defined:
-
-      
-        
-          ClutterContainer::add
-          
-            The container actor should hold a pointer to the passed
-            #ClutterActor, call clutter_actor_set_parent() on it and then
-            emit the #ClutterContainer::actor-added signal to notify
-            handlers of the newly added actor.
-          
-        
-        
-          ClutterContainer::remove
-          
-            The container actor should increase the reference count
-            of the passed #ClutterActor, remove the pointer held on the
-            child and call clutter_actor_unparent() on it; then, emit the
-            #ClutterContainer::actor-removed signal and decrease the
-            reference count.
-          
-        
-        
-          ClutterContainer::foreach
-          
-            The container should invoke the callback on every
-            child it is holding.
-          
-        
-        
-          ClutterContainer::raise
-          
-            The container should move the passed child on top
-            of the given sibling, or on top of the paint stack in
-            case the sibling is NULL.
-          
-        
-        
-          ClutterContainer::lower
-          
-            The container should move the passed child below
-            the given sibling, or on the bottom of the paint stack
-            in case the sibling is NULL.
-          
-        
-        
-          ClutterContainer::sort_depth_order
-          
-            The container should sort the paint stack depending
-            on the relative depths of each child.
-          
-        
-      
-
-    
-
-   
-
-
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/subclassing-ClutterActor.xml clutter-0.7.6/doc/reference/clutter/subclassing-ClutterActor.xml
--- clutter-0.7.4/doc/reference/clutter/subclassing-ClutterActor.xml	1970-01-01 01:00:00.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/subclassing-ClutterActor.xml	2008-06-26 09:55:50.000000000 +0100
@@ -0,0 +1,631 @@
+
+  
+    
+      Emmanuele
+      Bassi
+      
+        

+          ebassi@openedhand.com
+        

+      
+    
+  
+
+  Implementing a new actor
+
+  In order to implement a new #ClutterActor subclass the usual
+  machinery for subclassing a #GObject should be used:
+
+  
+    
+#define FOO_TYPE_ACTOR            (foo_actor_get_type ())
+#define FOO_ACTOR(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), FOO_TYPE_ACTOR, FooActor))
+#define FOO_IS_ACTOR(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), FOO_TYPE_ACTOR))
+#define FOO_ACTOR_CLASS(klass)    (G_TYPE_CHECK_CLASS_CAST ((klass), FOO_TYPE_ACTOR, FooActorClass))
+#define FOO_IS_ACTOR_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), FOO_TYPE_ACTOR))
+#define FOO_ACTOR_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS ((obj), FOO_TYPE_ACTOR, FooActorClass))
+
+typedef struct _FooActor
+{
+  ClutterActor parent_instance;
+} FooActor;
+
+typedef struct _FooActorClass
+{
+  ClutterActorClass parent_class;
+} FooActorClass;
+
+G_DEFINE_TYPE (FooActor, foo_actor, CLUTTER_TYPE_ACTOR);
+
+static void
+foo_actor_class_init (FooActorClass *klass)
+{
+
+}
+
+static void
+foo_actor_init (FooActor *actor)
+{
+
+}
+    
+  
+
+  The implementation of an actor roughly depends on what kind
+  of actor the class should display.
+
+  The implementation process can be broken down into sections:
+
+    
+      
+        size requisition
+        used by containers to know how much space
+        an actor requires for itself and its eventual
+        children.
+      
+
+      
+        size allocation
+        used by containers to define how much space
+        an actor should have for itself and its eventual
+        children.
+      
+
+      
+        painting and picking
+        the actual actor painting and the "picking"
+        done to determine the actors that received events
+      
+
+    
+
+  
+
+  Container actors should also implement the #ClutterContainer
+  interface to provide a consistent API for adding, removing and iterating
+  over their children.
+
+  
+    Size requisition
+
+    Actors should usually implement the size requisition virtual
+    functions unless they depend on explicit sizing by the developer,
+    using the clutter_actor_set_width() and clutter_actor_set_height()
+    functions and their wrappers.
+
+    For instance, an actor that depends on the explicit
+    sizing is the #ClutterRectangle actor.
+
+    The size requisition is split into two different phases: width
+    requisition and height requisition.
+
+    The ClutterActor::get_preferred_width() and
+    ClutterActor::get_preferred_height() methods of a
+    #ClutterActor are invoked when clutter_actor_get_preferred_width() and 
+    clutter_actor_get_preferred_height() are respectively called on an instance
+    of that actor class. They are used to return the preferred size of the 
+    actor. Container actors, or composite actors with internal children, 
+    should call clutter_actor_get_preferred_width() and 
+    clutter_actor_get_preferred_height() on each visible child inside
+    their implementation of the get_preferred_width() and get_preferred_height()
+    virtual functions.
+
+    The get_preferred_width() and get_preferred_height() virtual
+    functions return both the minimum size of the actor and its natural
+    size. The minimum size is defined as the amount of space an actor
+    must occupy to be useful; the natural size is defined as the amount
+    of space an actor would occupy if nothing would constrain it.
+
+    The natural size must always be greater than, or equal
+    to the minimum size. #ClutterActor will warn in case this assumption
+    is not respected by an implementation.
+
+    The height request may be computed for a specific width, which
+    is passed to the implementation, thus allowing height-for-width
+    geometry management. Similarly, the width request may be computed
+    for a specific height, allowing width-for-height geometry management.
+    By default, every #ClutterActor uses the height-for-width geometry
+    management, but the setting can be changed by using the
+    #ClutterActor:request-mode property.
+
+    The clutter_actor_get_preferred_size() function will
+    automatically check the geometry management preferred by the actor
+    and return its preferred size depending on the value of the request-mode
+    property and on the natural size of the actor.
+
+    The size requisition starts from the #ClutterStage and it is
+    performed on every child of the stage following down the hierarchy
+    of the scene graph.
+
+    The size requisition should not take into account the
+    actor's scale, rotation or anchor point unless an actor is performing
+    layout management depending on those properties.
+
+    All the sizes are expressed using #ClutterUnits, the
+    internal high-precision unit type, which guarantees sub-pixel precision.
+    #ClutterUnit currently has the same limitations that #ClutterFixed has,
+    see the fixed point page.
+    
+
+    
+      Width requisition implementation of a container
+
+      This example shows how an actor class should override the
+      get_preferred_width() virtual function of #ClutterActor. In this case,
+      the returned widths are the union of the extents of all the
+      FooActor children.
+
+      The get_preferred_height() implementation would be similar to the
+      get_preferred_width() implementation, so it is omitted.
+
+      
+static void
+foo_actor_get_preferred_width (ClutterActor *actor,
+                               ClutterUnit   for_height,
+                               ClutterUnit  *min_width_p,
+                               ClutterUnit  *natural_width_p)
+{
+  GList *l;
+  ClutterUnit min_left, min_right;
+  ClutterUnit natural_left, natural_right;
+
+  min_left = 0;
+  min_right = 0;
+  natural_left = 0;
+  natural_right = 0;
+
+  for (l = children; l != NULL; l = l->next)
+    {
+      ClutterActor *child = l->data;
+      ClutterUnit child_x, child_min, child_natural;
+
+      child_x = clutter_actor_get_xu (child);
+
+      clutter_actor_get_preferred_width (child, for_height,
+                                         &child_min,
+                                         &child_natural);
+
+      if (l == children)
+        {
+          /* First child */
+          min_left = child_x;
+          natural_left = child_x;
+          min_right = min_left + child_min;
+          natural_right = natural_left + child_natural;
+        }
+      else
+        {
+          if (child_x < min_left)
+            min_left = child_x;
+
+          if (child_x < natural_left)
+            natural_left = child_x;
+
+          if (child_x + child_min > min_right)
+            min_right = child_x + child_min;
+
+          if (child_x + child_natural > natural_right)
+            natural_right = child_x + child_natural;
+        }
+    }
+
+  /* The request is defined as the width and height we want starting from 
+   * our origin, since our allocation will set the origin; so we now need 
+   * to remove any part of the request that is to the left of the origin.
+   */
+  if (min_left < 0)
+    min_left = 0;
+
+  if (natural_left < 0)
+    natural_left = 0;
+
+  if (min_right < 0)
+    min_right = 0;
+
+  if (natural_right < 0)
+    natural_right = 0;
+
+  g_assert (min_right >= min_left);
+  g_assert (natural_right >= natural_left);
+
+  if (min_width_p)
+    *min_width_p = min_right - min_left;
+
+  if (natural_width_p)
+    *natural_width_p = natural_right - min_left;
+}
+      
+    
+
+   
+
+  
+    Size allocation
+
+    The ClutterActor::allocate() method of a
+    #ClutterActor is invoked when clutter_actor_allocate() is called on an
+    instance of that actor class. It is used by a parent actor to set the 
+    coordinates of the bounding box for its children actors. Hence, 
+    container actors, or composite actors with internal children, should 
+    override the allocate() virtual function and call clutter_actor_allocate()
+    on each visible child.
+
+    Each actor can know from their allocation box whether they
+    have been moved with respect to their parent actor. Each child will
+    also be able to tell whether their parent has been moved with respect
+    to the stage.
+
+    The allocate() virtual function implementation will be
+    notified whether the actor has been moved, while clutter_actor_allocate()
+    will usually be invoked with a boolean flag meaning that the parent
+    has been moved.
+
+    
+      Allocation of a container
+      In this example, FooActor acts like a
+      horizontal box with overflowing, like a toolbar which will display
+      more children as it expands. The children falling outside of the
+      allocated area will fade out; the children falling inside the
+      same area will fade in.
+      
+static void
+foo_actor_allocate (ClutterActor          *actor,
+                    const ClutterActorBox *box,
+                    gboolean               absolute_origin_changed)
+{
+  FooActor *foo_actor = FOO_ACTOR (actor);
+  ClutterUnit current_width;
+  GList *l;
+
+  /* chain up to set the allocation of the actor */
+  CLUTTER_ACTOR_CLASS (foo_actor_parent_class)->allocate (actor, box, absolute_origin_changed);
+
+  current_width = foo_actor->padding;
+
+  for (l = foo_actor->children;
+       l != NULL;
+       l = l->next)
+    {
+      FooActorChild *child = l->data;
+      ClutterUnit natural_width, natural_height;
+      ClutterActorBox child_box = { 0, };
+
+      /* each child will get as much space as they require */
+      clutter_actor_get_preferred_size (CLUTTER_ACTOR (child),
+                                        NULL, NULL,
+                                        &natural_width, &natural_height);
+
+      /* if the child is overflowing, we just fade it out */
+      if (current_width + natual_width > box->x2 - box->x1)
+        foo_actor_fade_child (foo_actor, child, 0);
+      else
+        {
+          current_width += natural_width + priv->padding;
+
+          child_box.x1 = current_width;
+          child_box.y1 = 0;
+          child_box.x2 = child_box.x1 + natural_width;
+          child_box.y2 = child_box.y1 + natural_height;
+
+          /* update the allocation */
+          clutter_actor_allocate (CLUTTER_ACTOR (child),
+                                  &child_box,
+                                  absolute_origin_changed);
+
+          /* fade the child in if it wasn't visible */
+          foo_actor_fade_child (foo_actor, child, 255);
+        }
+    }
+}
+      
+    
+
+    The allocation is also the "paint area", that is the area where
+    the paint operations should be performed.
+
+   
+
+  
+    Painting and picking
+
+    The ClutterActor::paint() method should be
+    overridden if the actor needs to control its drawing process, either by
+    using the Clutter GL and GLES abstraction library (COGL) or by directly
+    using the GL or GLES API.
+
+    Actors performing transformations should push the GL matrix
+    first and then pop the GL matrix before returning.
+  
+    
+      Paint implementation of a simple actor
+      In this example, the FooActor
+      implementation of the paint() virtual function is drawing a rectangle
+      with rounded corners with a custom color. The COGL API is used, to
+      allow portability between GL and GLES platforms.
+      
+static void
+foo_actor_paint (ClutterActor *actor)
+{
+  FooActor *foo_actor = FOO_ACTOR (actor);
+  ClutterColor color = { 0, };
+  ClutterUnit w, h, r;
+
+  cogl_push_matrix ();
+
+  /* FooActor has a specific background color */
+  color.red   = foo_actor->bg_color.red;
+  color.green = foo_actor->bg_color.green;
+  color.blue  = foo_actor->bg_color.blue;
+
+  /* the alpha component must take into account the absolute
+   * opacity of the actor on the screen at this point in the
+   * scenegraph; this value is obtained by calling
+   * clutter_actor_get_paint_opacity().
+   */
+  color.alpha = clutter_actor_get_paint_opacity (actor);
+
+  /* set the color of the pen */
+  cogl_color (&color);
+
+  /* get the size of the actor with sub-pixel precision */
+  w = CLUTTER_UNITS_TO_FIXED (clutter_actor_get_widthu (actor));
+  h = CLUTTER_UNITS_TO_FIXED (clutter_actor_get_heightu (actor));
+
+  /* this is the arc radius for the rounded rectangle corners */
+  r = CLUTTER_UNITS_TO_FIXED (foo_actor->radius);
+
+  /* paint a rounded rectangle using GL primitives; the area of
+   * paint is (0, 0) - (width, height), which means the whole
+   * allocation or, if the actor has a fixed size, the size that
+   * has been set.
+   */
+  cogl_round_rectangle (0, 0, w, h, r, 5);
+
+  /* and fill it with the current color */
+  cogl_fill ();
+
+  cogl_pop_matrix ();
+}
+      
+    
+
+    When inside the ClutterActor::paint()
+    method the actor is already positioned at the coordinates specified by
+    its parent; all the paint operations should take place from the (0, 0)
+    coordinates.
+
+    Container actors or composite actors with internal children should
+    also override the paint method, and call clutter_actor_paint() on every
+    visible child:
+
+    
+      Paint implementation of a container
+      In this example, FooActor is a simple
+      container invoking clutter_actor_paint() on every visible child. To
+      allow transformations on itself to affect the children, the GL modelview
+      matrix is pushed at the beginning of the paint sequence, and the popped
+      at the end.
+      
+static void
+foo_actor_paint (ClutterActor *actor)
+{
+  FooActor *foo_actor = FOO_ACTOR (actor);
+  GList *child;
+
+  cogl_push_matrix ();
+
+  for (child = foo_actor->children;
+       child != NULL;
+       child = child->next)
+    {
+      ClutterActor *child_actor = child->data;
+
+      /* paint only visible children */
+      if (CLUTTER_ACTOR_IS_VISIBLE (child_actor))
+        clutter_actor_paint (child_actor);
+    }
+
+  cogl_pop_matrix ();
+}
+      
+    
+
+    If the actor has a non-rectangular shape, or it has internal
+    children that need to be distinguished by the events delivery mechanism,
+    the ClutterActor::pick() method should also be
+    overridden. The pick() method works exactly like the paint() method, but
+    the actor should paint just its shape with the passed colour:
+
+    
+      Pick implementation of a simple actor
+      In this example, FooActor overrides the
+      pick() virtual function default implementation to paint itself with a
+      shaped silhouette, to allow events only on the actual shape of the actor
+      instead of the whole paint area.
+      
+static void
+foo_actor_pick (ClutterActor       *actor,
+                const ClutterColor *pick_color)
+{
+  FooActor *foo_actor = FOO_ACTOR (actor);
+  ClutterUnit w, h, r;
+
+  /* it is possible to avoid a costly paint by checking whether the
+   * actor should really be painted in pick mode
+   */
+  if (!clutter_actor_should_pick_paint (actor))
+    return;
+
+  w = CLUTTER_UNITS_TO_FIXED (clutter_actor_get_widthu (actor));
+  h = CLUTTER_UNITS_TO_FIXED (clutter_actor_get_heightu (actor));
+
+  /* this is the arc radius for the rounded rectangle corners */
+  r = CLUTTER_UNITS_TO_FIXED (foo_actor->radius);
+
+  cogl_push_matrix ();
+
+  /* use the passed color to paint ourselves */
+  cogl_color (pick_color);
+
+  /* paint a round rectangle */
+  cogl_round_rectangle (0, 0, w, h, r, 5);
+
+  /* and fill it with the current color */
+  cogl_fill ();
+
+  cogl_pop_matrix ();
+}
+      
+    
+
+    Containers should simply chain up to the parent class'
+    pick() implementation to get their silhouette painted and then
+    paint their children:
+
+    
+      Pick implementation of a container
+      In this example, FooActor allows the
+      picking of each child it contains, as well as itself.
+      
+static void
+foo_actor_pick (ClutterActor       *actor,
+                const ClutterColor *pick_color)
+{
+  FooActor *foo_actor = FOO_ACTOR (actor);
+
+  /* this will paint a silhouette corresponding to the paint box */
+  CLUTTER_ACTOR_CLASS (foo_actor_parent_class)->pick (actor, pick_color);
+
+  /* clutter_actor_paint() is context-sensitive, and will perform
+   * a pick paint if the scene graph is in pick mode
+   */
+  if (CLUTTER_ACTOR_IS_VISIBLE (foo_actor->child))
+    clutter_actor_paint (foo_actor->child);
+}
+      
+    
+
+   
+
+  
+    Implementing Containers
+
+    
+    The #ClutterContainer interface should be implemented by subclasses
+    of #ClutterActor who wants to provide a general API for adding child
+    actors.
+    
+
+    
+    If the #ClutterActor subclass only handles internal children, or it's
+    not suitable for having generic actors added to it, it should not
+    implement the #ClutterContainer interface, but simply use
+    clutter_actor_set_parent():
+    
+
+    
+      Parenting an actor
+      In this example, FooActor has an internal
+      child of type BazActor which is assigned using a
+      specific function called foo_actor_add_baz(). The
+      FooActor instance takes ownership of the
+      BazActor instance and sets the parent-child
+      relationship using clutter_actor_set_parent().
+      
+void
+foo_actor_add_baz (FooActor *foo_actor,
+                   BazActor *baz_actor)
+{
+  g_return_if_fail (FOO_IS_ACTOR (foo_actor));
+  g_return_if_fail (BAZ_IS_ACTOR (baz_actor));
+
+  /* unparent the previous BazActor; this will automatically call
+   * g_object_unref() on the actor
+   */
+  if (foo_actor->baz)
+    clutter_actor_unparent (foo_actor->baz);
+
+  foo_actor->baz = baz_actor;
+
+  /* this will cause the initial floating reference of ClutterActor to
+   * disappear, and add a new reference on baz_actor. foo_actor has now
+   * taken ownership of baz_actor, so that:
+   *
+   *   foo_actor_add_baz (foo_actor, baz_actor_new ());
+   *
+   * is a safe statement (no reference is leaked).
+   */
+  clutter_actor_set_parent (CLUTTER_ACTOR (baz_actor),
+                            CLUTTER_ACTOR (foo_actor));
+
+  /* a container should queue a change in the layout */
+  clutter_actor_queue_relayout (CLUTTER_ACTOR (foo_actor));
+
+  /* emit a signal and notification */
+  g_signal_emit (foo_actor, foo_actor_signals[BAZ_CHANGED], 0, baz_actor);
+  g_object_notify (G_OBJECT (foo_actor), "baz");
+}
+      
+    
+
+    
+    In order to implement the #ClutterContainer interface, these virtual
+    functions must be defined:
+
+      
+        
+          ClutterContainer::add
+          
+            The container actor should hold a pointer to the passed
+            #ClutterActor, call clutter_actor_set_parent() on it and then
+            emit the #ClutterContainer::actor-added signal to notify
+            handlers of the newly added actor.
+          
+        
+        
+          ClutterContainer::remove
+          
+            The container actor should increase the reference count
+            of the passed #ClutterActor, remove the pointer held on the
+            child and call clutter_actor_unparent() on it; then, emit the
+            #ClutterContainer::actor-removed signal and decrease the
+            reference count.
+          
+        
+        
+          ClutterContainer::foreach
+          
+            The container should invoke the callback on every
+            child it is holding.
+          
+        
+        
+          ClutterContainer::raise
+          
+            The container should move the passed child on top
+            of the given sibling, or on top of the paint stack in
+            case the sibling is NULL.
+          
+        
+        
+          ClutterContainer::lower
+          
+            The container should move the passed child below
+            the given sibling, or on the bottom of the paint stack
+            in case the sibling is NULL.
+          
+        
+        
+          ClutterContainer::sort_depth_order
+          
+            The container should sort the paint stack depending
+            on the relative depths of each child.
+          
+        
+      
+
+    
+
+   
+
+
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-actor.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-actor.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-actor.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-actor.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-alpha.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-alpha.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-alpha.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-alpha.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-backend.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-backend.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-backend.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-backend.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
@@ -99,13 +97,3 @@
 @Returns: 
 
 
-
-
-
-
-
-@backend: 
-@width: 
-@height: 
-
-
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-behaviour-bspline.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-behaviour-bspline.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-behaviour-bspline.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-behaviour-bspline.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-behaviour-depth.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-behaviour-depth.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-behaviour-depth.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-behaviour-depth.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-behaviour-ellipse.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-behaviour-ellipse.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-behaviour-ellipse.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-behaviour-ellipse.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-behaviour-opacity.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-behaviour-opacity.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-behaviour-opacity.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-behaviour-opacity.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-behaviour-path.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-behaviour-path.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-behaviour-path.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-behaviour-path.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-behaviour-rotate.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-behaviour-rotate.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-behaviour-rotate.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-behaviour-rotate.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-behaviour-scale.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-behaviour-scale.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-behaviour-scale.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-behaviour-scale.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-behaviour.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-behaviour.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-behaviour.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-behaviour.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-child-meta.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-child-meta.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-child-meta.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-child-meta.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-clone-texture.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-clone-texture.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-clone-texture.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-clone-texture.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-color.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-color.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-color.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-color.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-container.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-container.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-container.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-container.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-effect.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-effect.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-effect.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-effect.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-entry.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-entry.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-entry.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-entry.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-event.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-event.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-event.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-event.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-feature.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-feature.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-feature.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-feature.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-fixed.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-fixed.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-fixed.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-fixed.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-group.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-group.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-group.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-group.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-label.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-label.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-label.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-label.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-list-model.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-list-model.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-list-model.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-list-model.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-main.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-main.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-main.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-main.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-media.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-media.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-media.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-media.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-model-iter.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-model-iter.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-model-iter.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-model-iter.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-model.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-model.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-model.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-model.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-rectangle.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-rectangle.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-rectangle.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-rectangle.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-score.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-score.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-score.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-score.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-script.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-script.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-script.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-script.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-scriptable.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-scriptable.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-scriptable.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-scriptable.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-shader.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-shader.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-shader.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-shader.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-stage.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-stage.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-stage.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-stage.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-texture.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-texture.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-texture.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-texture.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-timeline.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-timeline.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-timeline.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-timeline.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-units.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-units.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-units.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-units.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-unused.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-unused.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-unused.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-unused.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -0,0 +1,24 @@
+
+
+
+
+
+@clutteractor: the object which received the signal.
+
+
+
+
+
+
+@self: 
+@box: 
+
+
+
+
+
+
+@backend: 
+@width: 
+@height: 
+
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-util.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-util.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-util.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-util.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-version.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-version.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-version.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-version.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-win32.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-win32.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-win32.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-win32.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/tmpl/clutter-x11.sgml clutter-0.7.6/doc/reference/clutter/tmpl/clutter-x11.sgml
--- clutter-0.7.4/doc/reference/clutter/tmpl/clutter-x11.sgml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/tmpl/clutter-x11.sgml	2008-06-27 21:32:04.000000000 +0100
@@ -9,13 +9,11 @@
 
 
 
-
 
 
 
 
 
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/version.xml clutter-0.7.6/doc/reference/clutter/version.xml
--- clutter-0.7.4/doc/reference/clutter/version.xml	2008-06-25 17:49:45.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/version.xml	2008-06-27 21:24:35.000000000 +0100
@@ -1 +1 @@
-0.7.4
+0.7.6
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/building-clutter.xml clutter-0.7.6/doc/reference/clutter/xml/building-clutter.xml
--- clutter-0.7.4/doc/reference/clutter/xml/building-clutter.xml	1970-01-01 01:00:00.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/building-clutter.xml	2008-06-27 21:32:04.000000000 +0100
@@ -0,0 +1,236 @@
+
+  
+    
+      Emmanuele
+      Bassi
+      
+        

+          ebassiopenedhand.com
+        

+      
+    
+  
+
+  Building Clutter
+
+  
+
+    

+      Clutter Dependencies
+
+      
+        
+          GLib
+          
+            A general-purpose utility library, not specific to
+            graphical user interfaces. GLib provides many useful data
+            types, macros, type conversions, string utilities, file
+            utilities, a main loop abstraction, and so on.
+          
+        
+        
+          GObject
+          
+            The GLib Object System provides the required
+            implementations of a flexible, extensible and intentionally
+            easy to map (into other languages) object-oriented framework
+            for C.
+          
+        
+        
+          Pango
+          
+            Pango is a library for laying out and rendering
+            text, with an emphasis on internationalization.
+          
+        
+        
+          Backend Windowing System Library
+          
+            GLX, EGL (1.1), SDL, Cocoa (OS X) and WGL (Windows)
+          
+        
+        
+          Graphics Rendering 
+          
+            Open GL (1.4+) or Open GL ES (1.1 or 2.0) 
+          
+        
+      
+
+    

+
+    

+      Platform-specific instructions
+
+      

+        Linux
+
+        If you are using Debian or Ubuntu, you can install pre-compiled
+        binary packages the normal Debian way following the instructions at
+        
+        http://debian.o-hand.com/.
+        
+
+        To build Clutter clutter from sources, get the latest source
+        archives from 
+        http://www.clutter-project.org/sources/. Once you have extracted
+        the sources from the archive execute the following commands in the
+        top-level directory:
+        
+
+        
+    $ ./configure
+    $ make
+    # make install
+        
+
+        You can configure the build with number of additional arguments
+        passed to the configure script, the full list of which can be obtained
+        by running ./configure --help. The following arguments are specific to
+        Clutter:
+
+            
+              
+                --enable-debug=[no/minimum/yes]
+                
+                  Turns on debugging. Possible values are: yes -  all
+                  glib asserts, checks and runtime clutter verbose messages;
+                 minimum - just glib cast checks and runtime clutter verbose
+                 messagaes; no - no glib asserts or checks and no runtime
+                 clutter verbose messages; default=yes.
+                 
+                
+              
+
+              
+                --enable-maintainer-flags=[no/yes]
+                
+                  Use strict compiler flags; default=no.
+                  
+                
+              
+
+              
+                --enable-gtk-doc
+                
+                  Use gtk-doc to build documentation; default=no.
+                  
+                
+              
+
+              
+                --enable-manual=[no/yes]
+                
+                  Build application developers manual; requires jw and
+                  xmlto binaries; default=no.
+                  
+                
+              
+
+              
+                --with-flavour=[glx/eglx/eglnative/sdl]
+                
+                  Select the Clutter backend; default=glx.
+                  
+                
+              
+
+            
+
+        
+
+      

+
+      

+        Windows
+          
+            The recommended way of building Clutter for Windows is using the
+            mingw tool
+            chain. One option is to cross-compile Clutter under Linux -- you
+            can use the script found in the build/mingw/
+            directory to simplify the process (the script takes care of setting
+            up the necessary dependencies).
+          
+
+          
+            If you wish to build Clutter using mingw direcly under Windows, you
+            can do so the normal *nix way (described above) using the mingw
+            POSIX shell. Should you prefer to use Microsoft Visual Studio, a
+            project file for MSVC 2005 is located in the
+            build/msvc_2k5/ directory. In either case, you
+            will need to first install the required dependencies.
+            
+            
+            There are currently two backends that are supported on
+            Windows. One uses the Win32 and WGL APIs directly and the
+            other is built on top of SDL. You must choose one of the
+            backends when running the configure script using the
+            following argument:
+            
+              
+                --with-flavour=[win32/sdl]
+                
+                  Select the Clutter backend; default=glx.
+                  
+                
+              
+            
+            
+      

+
+      

+          OSX
+          For developing an application with Clutter, the recommended
+          way of installing it using the MacPorts
+          project, by simply invoking:
+
+          
+            $ sudo port install clutter
+          
+
+          on a terminal, after installing and updating MacPorts.
+
+          For developing Clutter itself, the recommended way of building
+          it OSX is to use Jhbuild,
+          following the documentation for building the GTK+ stack as shown
+          here.
+
+          
+            Jhbuild depends on SVN, which can be installed on OSX by using
+            the MacPorts
+            project.
+          
+
+          
+            XCode should also be installed, either from the OSX installation
+            disk or downloading it from the Apple website. It is recommended
+            to also install the X11 development files, even though Clutter
+            does not strictly depend on them.
+          
+
+          
+            The Clutter Quartz backend is built by passing the
+            --with-flavour=osx command line argument
+            to the configure script. If not passed, the GLX backend will
+            be built. By default, the Quartz backend depends on CoreGraphics
+            in order to load images into textures, but it can also depend
+            on GDK-Pixbuf or an internal, highly experimental PNG and JPEG
+            loader.
+          
+
+          
+            GTK-Doc is not working on OSX, so API reference generation
+            should also be disabled when building Clutter, by using
+            the --disable-docs and
+            --disable-gtk-doc command line argument
+            to the configure script.
+          
+
+      

+
+    

+
+  
+
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-actor.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-actor.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-actor.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-actor.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-alpha.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-alpha.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-alpha.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-alpha.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-animation.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-animation.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-animation.xml	1970-01-01 01:00:00.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-animation.xml	2008-06-27 21:32:04.000000000 +0100
@@ -0,0 +1,600 @@
+
+  
+    
+      Matthew
+      Allum
+      
+        

+          mallumopenedhand.com
+        

+      
+    
+  
+
+  Creating Animations with Clutter
+
+  
+
+  With Clutter using hardware accelration for graphics rendering,
+  complex and fast animations are possible. This chapter describes basic
+  techniques and the utilities Clutter provides in aiding animation
+  creation.
+
+  
+
+  

+  Basic Animations
+
+  
+
+   The most basic way to create animations with Clutter is via the use of
+   g_timeout_add(). This enables a callback function to be called at a
+   defined interval. The callback function can then modify actors visual
+   properties as to produce an animation.
+
+  
+
+  
+  
+  Simple Rotation...
+  
+  
+struct RotationClosure {
+  ClutterActor *actor;
+  ClutterFixed final_angle;
+  ClutterFixed current_angle;
+};
+
+static gboolean
+rotate_actor (gpointer data)
+{
+  RotationClosure *clos = data;
+
+  clutter_actor_set_rotationx (clos->actor, clos->current_angle, 0, 0, 0);
+
+  clos->current_angle += CFX_ONE;
+
+  if (clos->current_angle == clos->final_angle)
+    return FALSE;
+
+  return TRUE;
+}
+
+...
+  RotationClosure clos = { NULL, }
+
+  clos.actor = an_actor;
+  clos.final_angle = CLUTTER_FLOAT_TO_FIXED (360.0);
+  clos.current_angle = 0;
+
+  g_timeout_add (1000 / 360, /* fps to interval in milliseconds */
+                 rotate_actor,
+                 &clos);
+  
+  
+
+  Priorities
+  
+
+  G_PRIORITY_DEFAULT should always be used as the timeouts priority
+  (in case of g_timeout_add_full()) as not to intefere with Clutter's
+  scheduling of repaints and input event handling.
+
+  
+  
+
+  

+  

+  Timelines
+  
+  ClutterTimelines abstract a set period of time with a set frame
+  rate at which to call a provided callback.
+  
+  
+  
+  ClutterTimelines also extend the timeout sources functionality
+  further by:
+  
+  
+  
+    Having a set duration (in milliseconds) and a set
+    'frame rate' - that is, the rate at which the callback is
+    called
+    Passing current progress information to the
+    callback
+    Handling 'dropped frames' and guarenteeing the set
+    duration by skipping over frames if the callback cannot keep up with
+    the set frame rate
+    Querying the number of milliseconds elapsed between
+    the current and previous callback.
+    Allowing the timeline to be modified on the fly as
+    well as being stopped, started, looped, rewound and
+    reversed
+    Using a ClutterTimeoutPool to more efficiently
+    schedule multiple timeout sources without incurring in potential
+    starvation of the main loop slices
+  
+
+  
+  A Timeline is created with;
+  
+
+  
+clutter_timeline_new (n_frames, frames_per_seconds); 
+  
+
+  
+  Taking a number of frames and a frames per second, or by;
+  
+
+  
+clutter_timeline_new_for_duration (msecs);
+  
+
+  
+  Which takes the duration of the timeline in milliseconds with a
+  default frame rate (See clutter_get_default_frame_rate()).
+  
+
+  
+ 
+  The speed, duration and number of frames of the timeline then be
+  modifed via the objects properties and API calls. The timeline can
+  be made to loop by settings it "loop" property to TRUE.
+
+  
+  
+
+  The timelines is started via clutter_timeline_start() and its
+  playback further manipulated by the clutter_timeline_pause(),
+  clutter_timeline_stop(), clutter_timeline_rewind() and
+  clutter_timeline_skip() calls.
+
+  
+  
+
+  By attaching a handler to the timeline's ClutterTimeline::new-frame
+  signal a timeline can then be used to drive an animation by altering
+  an actor's visual properties in this callback. The callback looks like:
+
+  
+  
+void
+on_new_frame (ClutterTimeline *timeline,
+              gint             frame_num,
+              gpointer         user_data)
+{
+
+}
+  
+  
+
+  The frame_num parameter is set to the timeline's
+  current frame number (which is between 0 and the "num-frames" property).
+  This value can be used to compute the state of a particular animation
+  that is dependant on the frame numer. The clutter_timeline_get_progress()
+  function can also be used to get a normalised value of the timeline's
+  current position between 0 and 1.
+
+  
+  
+
+  Timelines can also be played in reverse by setting the direction using
+  clutter_timeline_set_direction(), and can also have a one-time delay set
+  before they begin playing by using clutter_timeline_set_delay().
+
+  
+  
+
+  Timelines can also control a pyshical simulation; the
+  clutter_timeline_get_delta() function allows retrieving the number of
+  frames and milliseconds elapsed since the previous callback to ensure
+  the physics engine to be able to take the actual time elapsed between
+  iterations into account.
+
+  
+
+  
+  
+  The following example demonstrates rotating an actor with a timeline.
+  
+  
+#include <clutter/clutter.h>
+
+void
+on_new_frame (ClutterTimeline *timeline, 
+	      gint             frame_num, 
+	      gpointer         data)
+{
+  ClutterActor *actor = CLUTTER_ACTOR(data);
+
+  clutter_actor_set_rotation (actor, CLUTTER_Z_AXIS,
+                              (gdouble) frame_num,
+                              clutter_actor_get_width (actor) / 2,
+			      clutter_actor_get_height (actor) / 2,
+                              0);
+}
+
+int
+main (int argc, char *argv[])
+{
+  ClutterTimeline *timeline;
+
+  ClutterActor    *stage, *actor;
+  GdkPixbuf       *pixbuf;
+
+  clutter_init (&argc, &argv);
+
+  stage = clutter_stage_get_default ();
+
+  pixbuf = gdk_pixbuf_new_from_file ("an-image.png", NULL);
+
+  actor  = clutter_texture_new_from_pixbuf (pixbuf);
+
+  clutter_container_add_actor (CLUTTER_CONTAINER (stage), actor);
+
+  clutter_actor_set_position (actor, 100, 100);
+
+  timeline = clutter_timeline_new_for (360, 60); /* a degree per frame */
+  clutter_timeline_set_loop (timeline, TRUE);
+
+  g_signal_connect (timeline, "new-frame", G_CALLBACK (on_new_frame), actor);
+
+  clutter_actor_show_all (stage);
+
+  clutter_timeline_start (timeline);
+
+  clutter_main();
+
+  return 0;
+}
+  
+  
+
+  
+  Multiple timelines can be sequenced in order by means of the
+  ClutterScore. See the ClutterScore documentation for more details on
+  using this.
+  
+
+  

+  

+  Behaviours
+  
+
+  With a large application containing many animations, the use of just
+  timelines can become unweldy and difficult to manage with much code
+  duplication in the new-frame handlers that can require over complex
+  code changes for minor animation modifications. To ease these
+  problems the ClutterAlpha and ClutterBehaviour classes were created.
+
+  
+  
+
+  ClutterAlpha and ClutterBehaviour attempt to generalise the
+  new-frame function by defining common actions or behaviours that can
+  be quickly modified, applied to multiple actors or mixed on a single
+  actor.
+
+  
+  
+
+  A ClutterAlpha is simply a 'function of time' (not pixel alpha!). It
+  is created by referencing a source timeline and a function which
+  produces a value between 0 and CLUTTER_ALPHA_MAX dependant on the
+  timeline position. Various prebuilt alpha functions are included
+  with Clutter these include
+
+  
+  
+
+    
+      
+        CLUTTER_ALPHA_RAMP_INC
+        Increasing ramp function
+      
+      
+        CLUTTER_ALPHA_RAMP_DEC
+        Decreasing ramp function
+      
+      
+        CLUTTER_ALPHA_RAMP
+        Full ramp function
+      
+      
+        CLUTTER_ALPHA_SINE_INC
+        Increasing sine function
+      
+      
+        CLUTTER_ALPHA_SINE_DEC
+        Decreasing sine function
+      
+      
+        CLUTTER_ALPHA_SINE_HALF
+        Half sine function
+      
+      
+        CLUTTER_ALPHA_SINE
+        Full sine function
+      
+      
+        CLUTTER_ALPHA_SQUARE
+        Square waveform ("step") function
+      
+      
+        CLUTTER_ALPHA_SMOOTHSTEP_INC
+        Increasing smooth transition step
+        function
+      
+      
+        CLUTTER_ALPHA_SMOOTHSTEP_DEC
+        Decreasing smooth transition step
+        function
+      
+      
+        CLUTTER_ALPHA_EXP_INC
+        Increasing exponential function
+      
+      
+        CLUTTER_ALPHA_EXP_DEC
+        Decreasing exponential function
+      
+    
+  
+  
+
+  A Behaviour is created with a ClutterAlpha and a set of limits for
+  whatever the behaviour modifys actor wise. The current ClutterAlpha
+  value is then mapped to a value between these limits and this value
+  set on any applied actors. With the ClutterAlpha's underlying
+  timeline playing the produced value will change and the behaviour
+  will animate the actor.
+
+  
+  
+
+  A ClutterBehaviour is effectively 'driven' by a supplied ClutterAlpha and
+  when then applied to an actor it will modify a visual property or
+  feature of the actor dependant on the Alpha's value. For example a
+  path based behaviour applied to an actor will alter its position
+  along the path dependant on the current alpha value over time. The
+  actual motion will depend on the chosen ClutterAlphaFunc - a
+  CLUTTER_ALPHA_RAMP_INC making it to move at constant speed along the
+  path, a CLUTTER_ALPHA_SINE making it alternate from one end of the
+  path to the other with non constant speed.
+
+  
+  
+
+  Multiple behaviours can of course be applied to an actor as well as
+  a single behaviour being applied to multiple actors.  The separation
+  of timelines, alphas and behaviours allows for a single timeline to
+  drive many behaviours each potentially using different alpha
+  functions. Behaviour parameters can also be changed on the fly.
+
+  
+
+  
+  
+  

+    Effects of alpha functions on a path
+    
+    

+    The actors position between the path's end points directly correlates
+    to the ClutterAlpha's current alpha value driving the behaviour. With
+    the ClutterAlpha's function set to CLUTTER_ALPHA_RAMP_INC the actor
+    will follow the path at a constant velocity, but when changing to
+    CLUTTER_ALPHA_SINE_INC the actor initially accelerates before quickly
+    decelerating.
+    

+  

+
+  
+  
+
+  The behaviours included in Clutter are
+
+  
+  
+
+  
+    
+      ClutterBehaviourBspline
+      Moves actors along a B-spline path
+    
+    
+      ClutterBehaviourDepth
+      Changes the depth of actors
+    
+    
+      ClutterBehaviourEllipse
+      Moves actors along an ellipsis
+    
+    
+      ClutterBehaviourOpacity
+      Changes the opacity of actors
+    
+    
+      ClutterBehaviourPath
+      Moves actors along a path
+    
+    
+      ClutterBehaviourRotate
+      Rotates actors along an axis
+    
+    
+      ClutterBehaviourScale
+      Changes the scaling factors of
+      actors
+    
+  
+
+  
+
+  
+  
+  The following example demonstrates an ellipse behaviour in action.
+  
+  
+#include <clutter/clutter.h>
+
+int
+main (int argc, char *argv[])
+{
+  ClutterTimeline  *timeline;
+  ClutterBehaviour *behave;
+  ClutterAlpha     *alpha;
+  ClutterActor     *stage, *actor;
+  GdkPixbuf        *pixbuf;
+
+  clutter_init (&argc, &argv);
+
+  stage = clutter_stage_get_default ();
+
+  pixbuf = gdk_pixbuf_new_from_file ("ohpowers.png", NULL);
+
+  actor  = clutter_texture_new_from_pixbuf (pixbuf);
+
+  clutter_container_add_actor (CLUTTER_CONTAINER (stage), actor);
+
+  timeline = clutter_timeline_new_for_duration (4000); /* milliseconds */
+  clutter_timeline_set_loop (timeline, TRUE);
+
+  /* Set an alpha func to power the behaviour */
+  alpha = clutter_alpha_new_full (timeline,
+                                  CLUTTER_ALPHA_SINE,
+                                  NULL, NULL);
+
+  behave = clutter_behaviour_ellipse_new (alpha, 
+					  200,               /* center x */
+					  200,               /* center y */
+					  400,               /* width */
+					  300,               /* height */
+					  CLUTTER_ROTATE_CW, /* direction */
+					  0.0,               /* initial angle */
+					  360.0);            /* final angle */
+
+  clutter_behaviour_apply (behave, actor);
+
+  clutter_actor_show_all (stage);
+
+  clutter_timeline_start (timeline);
+
+  clutter_main();
+
+  /* clean up */
+  g_object_unref (behave);
+  g_object_unref (timeline);
+
+  return 0;
+}
+
+  
+  
+
+  Behaviour parameters can be changed whilst a animation is running
+
+  
+  There can be many ClutterAlpha's attached to a single timeline. There
+  can be many behaviours for a ClutterAlpha. There can be many behaviours
+  applied to an actor. A ClutterScore can be used to chain many behaviour
+  together.
+  
+
+  Combining behaviours that effect the same actor properties
+  (i.e two separate paths) will cause unexpected results. The values
+  will not be merged in any way with essentially a the last applied
+  behaviour taking precedence.
+
+     
+     Tips for implementing a new behaviour can be found here.
+     
+
+  

+  

+  Effects
+
+  
+  
+   Clutter effects API provide a simplified abstraction for firing simple
+   transitions from code. Clutter effects are created from a
+   ClutterEffectTemplate which is an abstraction of a timeline and
+   an alpha function. An effect template can be created with:
+
+  
+  
+ClutterEffectTemplate *etemplate =
+  clutter_effect_template_new_for_duration (2000, CLUTTER_ALPHA_RAMP_INC);
+  
+  
+
+  This will create an effect template lasting 2000 milliseconds (2
+  seconds) and use an alpha function of CLUTTER_ALPHA_RAMP_INC, there
+  are other more advanced forms for creating effect templates from
+  existing timelines, as well as attaching a callback to be called
+  with user_data when the effect template is destroyed.
+
+  
+  
+
+  When we have an effect template we can create a temporary behaviour
+  animating an actor simply by issuing:
+
+  
+  
+clutter_effect_move (etemplate, actor, 23, 42, NULL, NULL);
+  
+  
+and the actor will move from its current position to the coordinates
+(23, 42) in 2 seconds. Effects can also be stacked, so calling:
+  
+  
+clutter_effect_move (etemplate, actor, 23, 42, NULL, NULL);
+clutter_effect_fade (etemplate, actor, 0, NULL, NULL);
+  
+  
+The actor will move and fade out at the same time.
+  
+  
+
+  Since effects return a ClutterTimeline, you can stop an effect from
+  immediatly happening by calling clutter_timeline_stop() on the
+  returned timeline.
+  
+  
+  
+
+  The timeline and all the effect infrastructure is unreferenced as soon
+  as the timeline emits the ClutterTimeline::completed signal.
+
+  
+  

+
+  

+  Conclusion
+  
+
+  Clutter provides a number of utility classes to aid animations and
+  complex animations can be produced by combining the various features
+  provided.
+
+  
+  
+
+  Of course animations can be created outside of Clutter Utilities,
+  they are not expected to cover every kind of possible animation
+  scenario.
+
+  
+  
+
+  The animation functionality in Clutter is primarily suited to
+  building animations with a set or finite running time - i.e transitions
+  and the like. For animations involving variable input (such as touchscreen
+  handling) physical simulations may be more suited.
+  
+   
+
+  

+
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-backend.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-backend.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-backend.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-backend.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
@@ -41,9 +38,6 @@
 void                clutter_backend_set_font_options    (ClutterBackend *backend,
                                                          cairo_font_options_t *options);
 cairo_font_options_t* clutter_backend_get_font_options  (ClutterBackend *backend);
-void                clutter_backend_get_display_size    (ClutterBackend *backend,
-                                                         gint *width,
-                                                         gint *height);
 
 
 
@@ -243,27 +237,6 @@
 
 Since  0.8
 
-
-clutter_backend_get_display_size ()
-clutter_backend_get_display_sizevoid                clutter_backend_get_display_size    (ClutterBackend *backend,
-                                                         gint *width,
-                                                         gint *height);
-
-Retrieves the size of the display from the ClutterBackend.
-
-
-
-backend :
- a ClutterBackend
-
-width :
- return location for the display width in pixels, or NULL
-
-height :
- return location for the display height in pixels, or NULL
-
-Since  0.8
-
 
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-behaviour-bspline.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-behaviour-bspline.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-behaviour-bspline.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-behaviour-bspline.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-behaviour-depth.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-behaviour-depth.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-behaviour-depth.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-behaviour-depth.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-behaviour-ellipse.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-behaviour-ellipse.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-behaviour-ellipse.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-behaviour-ellipse.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-behaviour-opacity.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-behaviour-opacity.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-behaviour-opacity.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-behaviour-opacity.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-behaviour-path.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-behaviour-path.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-behaviour-path.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-behaviour-path.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-behaviour-rotate.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-behaviour-rotate.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-behaviour-rotate.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-behaviour-rotate.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-behaviour-scale.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-behaviour-scale.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-behaviour-scale.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-behaviour-scale.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-behaviour.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-behaviour.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-behaviour.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-behaviour.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-child-meta.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-child-meta.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-child-meta.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-child-meta.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-clone-texture.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-clone-texture.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-clone-texture.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-clone-texture.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-color.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-color.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-color.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-color.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-container.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-container.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-container.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-container.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-effect.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-effect.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-effect.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-effect.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-entry.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-entry.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-entry.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-entry.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-event.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-event.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-event.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-event.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-feature.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-feature.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-feature.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-feature.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-fixed.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-fixed.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-fixed.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-fixed.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-group.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-group.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-group.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-group.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-label.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-label.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-label.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-label.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-list-model.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-list-model.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-list-model.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-list-model.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-main.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-main.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-main.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-main.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-media.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-media.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-media.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-media.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-model-iter.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-model-iter.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-model-iter.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-model-iter.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-model.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-model.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-model.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-model.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-overview.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-overview.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-overview.xml	1970-01-01 01:00:00.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-overview.xml	2008-06-27 21:32:04.000000000 +0100
@@ -0,0 +1,53 @@
+
+  
+    
+      Emmanuele
+      Bassi
+      
+        

+          ebassiopenedhand.com
+        

+      
+    
+  
+
+  Overview
+
+  
+
+    Clutter is a GObject based library for creating fast, visually
+    rich, graphical user interfaces.
+
+    Clutter works by manipulating a scene-graph of 2D surfaces, or
+    'actors', inside a 3D space.
+
+    ClutterActor is the base class for such surfaces. All
+    ClutterActors can be positioned, scaled and rotated in 3D space.
+    In addition, other properties can be set, such as 2D clipping, children and
+    opacity. Tranforms applied to a parent actor also apply to any children.
+    Actors are also able to receive events.
+
+    Subclasses of ClutterActor include ClutterStage, ClutterTexture,
+    ClutterLabel, ClutterRectangle, ClutterEntry and
+    ClutterGroup. ClutterActors are added to a parent, transformed
+    and then made visible.
+
+    ClutterStage is the top level ClutterActor - it's the
+    representation of a window, or framebuffer. It is created automatically
+    when Clutter is initialised. ClutterStage is a ClutterGroup, a class
+    implementing the ClutterCointainer interface.
+
+    ClutterTimelines provide the basis for Clutter's animation
+    utilities. Multiple timelines can be synchronised using ClutterScore,
+    and ClutterBehaviour and ClutterEffect allow for the creation of
+    animation effects such as transitions.
+
+    Clutter further contains a number of utilities, including;
+    ClutterScript - for loading 'UI definition' files formatted in
+    JSON, ClutterShader - a
+    class for applying GPU shaders to actors, ClutterModel - a utility class
+    for MVC list type implementations, and fixed point math utilities.
+
+  
+
+
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-rectangle.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-rectangle.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-rectangle.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-rectangle.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-score.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-score.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-score.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-score.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-script.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-script.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-script.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-script.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-scriptable.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-scriptable.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-scriptable.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-scriptable.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-shader.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-shader.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-shader.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-shader.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-stage.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-stage.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-stage.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-stage.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-texture.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-texture.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-texture.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-texture.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-timeline.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-timeline.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-timeline.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-timeline.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-units.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-units.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-units.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-units.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-util.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-util.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-util.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-util.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-version.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-version.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-version.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-version.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
@@ -77,7 +74,7 @@
 
 
 CLUTTER_MICRO_VERSION
-CLUTTER_MICRO_VERSION#define CLUTTER_MICRO_VERSION   (4)
+CLUTTER_MICRO_VERSION#define CLUTTER_MICRO_VERSION   (6)
 
 
 The micro version of the Clutter library (3, if CLUTTER_VERSION is 1.2.3)
@@ -86,7 +83,7 @@
 
 
 CLUTTER_VERSION
-CLUTTER_VERSION#define CLUTTER_VERSION         0.7.4
+CLUTTER_VERSION#define CLUTTER_VERSION         0.7.6
 
 
 The full version of the Clutter library, like 1.2.3
@@ -95,7 +92,7 @@
 
 
 CLUTTER_VERSION_S
-CLUTTER_VERSION_S#define CLUTTER_VERSION_S       "0.7.4"
+CLUTTER_VERSION_S#define CLUTTER_VERSION_S       "0.7.6"
 
 
 The full version of the Clutter library, in string form (suited for
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-win32.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-win32.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-win32.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-win32.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/clutter-x11.xml clutter-0.7.6/doc/reference/clutter/xml/clutter-x11.xml
--- clutter-0.7.4/doc/reference/clutter/xml/clutter-x11.xml	2008-06-25 17:58:28.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/clutter-x11.xml	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,6 @@
 
-
-
-
 ]>
 
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/creating-behaviours.xml clutter-0.7.6/doc/reference/clutter/xml/creating-behaviours.xml
--- clutter-0.7.4/doc/reference/clutter/xml/creating-behaviours.xml	1970-01-01 01:00:00.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/creating-behaviours.xml	2008-06-27 21:32:04.000000000 +0100
@@ -0,0 +1,81 @@
+
+  
+    
+      Matthew
+      Allum
+      
+        

+          mallumopenedhand.com
+        

+      
+    
+  
+
+  Creating You Own Behaviours
+  
+
+  Clutter comes with a number of fairly generic prebuilt behaviour
+  classes which provide a basis for transitions, animations and other
+  visual effects. However even with the ability to combine a number of
+  these behaviours sometimes they are not enough and a custom
+  behaviour is needed to create a spcific animation.
+
+  
+
+  
+
+  In order to implement a new ClutterBehaviour subclass the usual
+  machinery for subclassing a GObject should be used. The new subclass
+  then just overides the ClutterBehaviour::alpha_notify() method. This
+  method is passed an alpha value which is then used to compute
+  modifications to any actors the behaviour is applied to.
+
+  
+
+  
+    This example demonstrates a behaviour that produces a vertical
+    'wipe' like affect by modifying the actors clip region
+
+    
+static void
+clutter_behaviour_foo_alpha_notify (ClutterBehaviour *behaviour,
+                                    guint32           alpha_value)
+{
+  ClutterActor *actor
+  gint          i, n;
+  gdouble       factor;
+
+  /* Normalise alpha value */
+  factor = (gdouble) alpha_value / CLUTTER_ALPHA_MAX_ALPHA;
+
+  n = clutter_behaviour_get_n_actors (behaviour);
+
+  /* Change clip height of each applied actor. Note usually better to use
+   * clutter_behaviour_actors_foreach () for performance reasons.
+   */
+  for (i = 0; i<n; i++)
+    {
+      int clip_height;
+
+      actor = clutter_behaviour_get_nth_actor (behaviour, i);
+
+      clip_height = clutter_actor_get_height (actor)
+                    - (clutter_actor_get_height (actor) * factor);
+
+      clutter_actor_set_clip (actor,
+                              0,
+                              0,
+                              clutter_actor_get_width (actor),
+                              clip_height);
+   }
+}
+    
+  
+
+  
+  If the new behaviour is meant to set an initial state on the
+  actors to which its applied to, then the ClutterBehaviour::applied
+  signal class handler should be overridden.
+  
+
+
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/clutter/xml/subclassing-ClutterActor.xml clutter-0.7.6/doc/reference/clutter/xml/subclassing-ClutterActor.xml
--- clutter-0.7.4/doc/reference/clutter/xml/subclassing-ClutterActor.xml	1970-01-01 01:00:00.000000000 +0100
+++ clutter-0.7.6/doc/reference/clutter/xml/subclassing-ClutterActor.xml	2008-06-27 21:32:04.000000000 +0100
@@ -0,0 +1,631 @@
+
+  
+    
+      Emmanuele
+      Bassi
+      
+        

+          ebassiopenedhand.com
+        

+      
+    
+  
+
+  Implementing a new actor
+
+  In order to implement a new ClutterActor subclass the usual
+  machinery for subclassing a GObject should be used:
+
+  
+    
+#define FOO_TYPE_ACTOR            (foo_actor_get_type ())
+#define FOO_ACTOR(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), FOO_TYPE_ACTOR, FooActor))
+#define FOO_IS_ACTOR(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), FOO_TYPE_ACTOR))
+#define FOO_ACTOR_CLASS(klass)    (G_TYPE_CHECK_CLASS_CAST ((klass), FOO_TYPE_ACTOR, FooActorClass))
+#define FOO_IS_ACTOR_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), FOO_TYPE_ACTOR))
+#define FOO_ACTOR_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS ((obj), FOO_TYPE_ACTOR, FooActorClass))
+
+typedef struct _FooActor
+{
+  ClutterActor parent_instance;
+} FooActor;
+
+typedef struct _FooActorClass
+{
+  ClutterActorClass parent_class;
+} FooActorClass;
+
+G_DEFINE_TYPE (FooActor, foo_actor, CLUTTER_TYPE_ACTOR);
+
+static void
+foo_actor_class_init (FooActorClass *klass)
+{
+
+}
+
+static void
+foo_actor_init (FooActor *actor)
+{
+
+}
+    
+  
+
+  The implementation of an actor roughly depends on what kind
+  of actor the class should display.
+
+  The implementation process can be broken down into sections:
+
+    
+      
+        size requisition
+        used by containers to know how much space
+        an actor requires for itself and its eventual
+        children.
+      
+
+      
+        size allocation
+        used by containers to define how much space
+        an actor should have for itself and its eventual
+        children.
+      
+
+      
+        painting and picking
+        the actual actor painting and the "picking"
+        done to determine the actors that received events
+      
+
+    
+
+  
+
+  Container actors should also implement the ClutterContainer
+  interface to provide a consistent API for adding, removing and iterating
+  over their children.
+
+  
+    Size requisition
+
+    Actors should usually implement the size requisition virtual
+    functions unless they depend on explicit sizing by the developer,
+    using the clutter_actor_set_width() and clutter_actor_set_height()
+    functions and their wrappers.
+
+    For instance, an actor that depends on the explicit
+    sizing is the ClutterRectangle actor.
+
+    The size requisition is split into two different phases: width
+    requisition and height requisition.
+
+    The ClutterActor::get_preferred_width() and
+    ClutterActor::get_preferred_height() methods of a
+    ClutterActor are invoked when clutter_actor_get_preferred_width() and 
+    clutter_actor_get_preferred_height() are respectively called on an instance
+    of that actor class. They are used to return the preferred size of the 
+    actor. Container actors, or composite actors with internal children, 
+    should call clutter_actor_get_preferred_width() and 
+    clutter_actor_get_preferred_height() on each visible child inside
+    their implementation of the get_preferred_width() and get_preferred_height()
+    virtual functions.
+
+    The get_preferred_width() and get_preferred_height() virtual
+    functions return both the minimum size of the actor and its natural
+    size. The minimum size is defined as the amount of space an actor
+    must occupy to be useful; the natural size is defined as the amount
+    of space an actor would occupy if nothing would constrain it.
+
+    The natural size must always be greater than, or equal
+    to the minimum size. ClutterActor will warn in case this assumption
+    is not respected by an implementation.
+
+    The height request may be computed for a specific width, which
+    is passed to the implementation, thus allowing height-for-width
+    geometry management. Similarly, the width request may be computed
+    for a specific height, allowing width-for-height geometry management.
+    By default, every ClutterActor uses the height-for-width geometry
+    management, but the setting can be changed by using the
+    "request-mode" property.
+
+    The clutter_actor_get_preferred_size() function will
+    automatically check the geometry management preferred by the actor
+    and return its preferred size depending on the value of the request-mode
+    property and on the natural size of the actor.
+
+    The size requisition starts from the ClutterStage and it is
+    performed on every child of the stage following down the hierarchy
+    of the scene graph.
+
+    The size requisition should not take into account the
+    actor's scale, rotation or anchor point unless an actor is performing
+    layout management depending on those properties.
+
+    All the sizes are expressed using ClutterUnits, the
+    internal high-precision unit type, which guarantees sub-pixel precision.
+    ClutterUnit currently has the same limitations that ClutterFixed has,
+    see the fixed point page.
+    
+
+    
+      Width requisition implementation of a container
+
+      This example shows how an actor class should override the
+      get_preferred_width() virtual function of ClutterActor. In this case,
+      the returned widths are the union of the extents of all the
+      FooActor children.
+
+      The get_preferred_height() implementation would be similar to the
+      get_preferred_width() implementation, so it is omitted.
+
+      
+static void
+foo_actor_get_preferred_width (ClutterActor *actor,
+                               ClutterUnit   for_height,
+                               ClutterUnit  *min_width_p,
+                               ClutterUnit  *natural_width_p)
+{
+  GList *l;
+  ClutterUnit min_left, min_right;
+  ClutterUnit natural_left, natural_right;
+
+  min_left = 0;
+  min_right = 0;
+  natural_left = 0;
+  natural_right = 0;
+
+  for (l = children; l != NULL; l = l->next)
+    {
+      ClutterActor *child = l->data;
+      ClutterUnit child_x, child_min, child_natural;
+
+      child_x = clutter_actor_get_xu (child);
+
+      clutter_actor_get_preferred_width (child, for_height,
+                                         &child_min,
+                                         &child_natural);
+
+      if (l == children)
+        {
+          /* First child */
+          min_left = child_x;
+          natural_left = child_x;
+          min_right = min_left + child_min;
+          natural_right = natural_left + child_natural;
+        }
+      else
+        {
+          if (child_x < min_left)
+            min_left = child_x;
+
+          if (child_x < natural_left)
+            natural_left = child_x;
+
+          if (child_x + child_min > min_right)
+            min_right = child_x + child_min;
+
+          if (child_x + child_natural > natural_right)
+            natural_right = child_x + child_natural;
+        }
+    }
+
+  /* The request is defined as the width and height we want starting from 
+   * our origin, since our allocation will set the origin; so we now need 
+   * to remove any part of the request that is to the left of the origin.
+   */
+  if (min_left < 0)
+    min_left = 0;
+
+  if (natural_left < 0)
+    natural_left = 0;
+
+  if (min_right < 0)
+    min_right = 0;
+
+  if (natural_right < 0)
+    natural_right = 0;
+
+  g_assert (min_right >= min_left);
+  g_assert (natural_right >= natural_left);
+
+  if (min_width_p)
+    *min_width_p = min_right - min_left;
+
+  if (natural_width_p)
+    *natural_width_p = natural_right - min_left;
+}
+      
+    
+
+   
+
+  
+    Size allocation
+
+    The ClutterActor::allocate() method of a
+    ClutterActor is invoked when clutter_actor_allocate() is called on an
+    instance of that actor class. It is used by a parent actor to set the 
+    coordinates of the bounding box for its children actors. Hence, 
+    container actors, or composite actors with internal children, should 
+    override the allocate() virtual function and call clutter_actor_allocate()
+    on each visible child.
+
+    Each actor can know from their allocation box whether they
+    have been moved with respect to their parent actor. Each child will
+    also be able to tell whether their parent has been moved with respect
+    to the stage.
+
+    The allocate() virtual function implementation will be
+    notified whether the actor has been moved, while clutter_actor_allocate()
+    will usually be invoked with a boolean flag meaning that the parent
+    has been moved.
+
+    
+      Allocation of a container
+      In this example, FooActor acts like a
+      horizontal box with overflowing, like a toolbar which will display
+      more children as it expands. The children falling outside of the
+      allocated area will fade out; the children falling inside the
+      same area will fade in.
+      
+static void
+foo_actor_allocate (ClutterActor          *actor,
+                    const ClutterActorBox *box,
+                    gboolean               absolute_origin_changed)
+{
+  FooActor *foo_actor = FOO_ACTOR (actor);
+  ClutterUnit current_width;
+  GList *l;
+
+  /* chain up to set the allocation of the actor */
+  CLUTTER_ACTOR_CLASS (foo_actor_parent_class)->allocate (actor, box, absolute_origin_changed);
+
+  current_width = foo_actor->padding;
+
+  for (l = foo_actor->children;
+       l != NULL;
+       l = l->next)
+    {
+      FooActorChild *child = l->data;
+      ClutterUnit natural_width, natural_height;
+      ClutterActorBox child_box = { 0, };
+
+      /* each child will get as much space as they require */
+      clutter_actor_get_preferred_size (CLUTTER_ACTOR (child),
+                                        NULL, NULL,
+                                        &natural_width, &natural_height);
+
+      /* if the child is overflowing, we just fade it out */
+      if (current_width + natual_width > box->x2 - box->x1)
+        foo_actor_fade_child (foo_actor, child, 0);
+      else
+        {
+          current_width += natural_width + priv->padding;
+
+          child_box.x1 = current_width;
+          child_box.y1 = 0;
+          child_box.x2 = child_box.x1 + natural_width;
+          child_box.y2 = child_box.y1 + natural_height;
+
+          /* update the allocation */
+          clutter_actor_allocate (CLUTTER_ACTOR (child),
+                                  &child_box,
+                                  absolute_origin_changed);
+
+          /* fade the child in if it wasn't visible */
+          foo_actor_fade_child (foo_actor, child, 255);
+        }
+    }
+}
+      
+    
+
+    The allocation is also the "paint area", that is the area where
+    the paint operations should be performed.
+
+   
+
+  
+    Painting and picking
+
+    The ClutterActor::paint() method should be
+    overridden if the actor needs to control its drawing process, either by
+    using the Clutter GL and GLES abstraction library (COGL) or by directly
+    using the GL or GLES API.
+
+    Actors performing transformations should push the GL matrix
+    first and then pop the GL matrix before returning.
+  
+    
+      Paint implementation of a simple actor
+      In this example, the FooActor
+      implementation of the paint() virtual function is drawing a rectangle
+      with rounded corners with a custom color. The COGL API is used, to
+      allow portability between GL and GLES platforms.
+      
+static void
+foo_actor_paint (ClutterActor *actor)
+{
+  FooActor *foo_actor = FOO_ACTOR (actor);
+  ClutterColor color = { 0, };
+  ClutterUnit w, h, r;
+
+  cogl_push_matrix ();
+
+  /* FooActor has a specific background color */
+  color.red   = foo_actor->bg_color.red;
+  color.green = foo_actor->bg_color.green;
+  color.blue  = foo_actor->bg_color.blue;
+
+  /* the alpha component must take into account the absolute
+   * opacity of the actor on the screen at this point in the
+   * scenegraph; this value is obtained by calling
+   * clutter_actor_get_paint_opacity().
+   */
+  color.alpha = clutter_actor_get_paint_opacity (actor);
+
+  /* set the color of the pen */
+  cogl_color (&color);
+
+  /* get the size of the actor with sub-pixel precision */
+  w = CLUTTER_UNITS_TO_FIXED (clutter_actor_get_widthu (actor));
+  h = CLUTTER_UNITS_TO_FIXED (clutter_actor_get_heightu (actor));
+
+  /* this is the arc radius for the rounded rectangle corners */
+  r = CLUTTER_UNITS_TO_FIXED (foo_actor->radius);
+
+  /* paint a rounded rectangle using GL primitives; the area of
+   * paint is (0, 0) - (width, height), which means the whole
+   * allocation or, if the actor has a fixed size, the size that
+   * has been set.
+   */
+  cogl_round_rectangle (0, 0, w, h, r, 5);
+
+  /* and fill it with the current color */
+  cogl_fill ();
+
+  cogl_pop_matrix ();
+}
+      
+    
+
+    When inside the ClutterActor::paint()
+    method the actor is already positioned at the coordinates specified by
+    its parent; all the paint operations should take place from the (0, 0)
+    coordinates.
+
+    Container actors or composite actors with internal children should
+    also override the paint method, and call clutter_actor_paint() on every
+    visible child:
+
+    
+      Paint implementation of a container
+      In this example, FooActor is a simple
+      container invoking clutter_actor_paint() on every visible child. To
+      allow transformations on itself to affect the children, the GL modelview
+      matrix is pushed at the beginning of the paint sequence, and the popped
+      at the end.
+      
+static void
+foo_actor_paint (ClutterActor *actor)
+{
+  FooActor *foo_actor = FOO_ACTOR (actor);
+  GList *child;
+
+  cogl_push_matrix ();
+
+  for (child = foo_actor->children;
+       child != NULL;
+       child = child->next)
+    {
+      ClutterActor *child_actor = child->data;
+
+      /* paint only visible children */
+      if (CLUTTER_ACTOR_IS_VISIBLE (child_actor))
+        clutter_actor_paint (child_actor);
+    }
+
+  cogl_pop_matrix ();
+}
+      
+    
+
+    If the actor has a non-rectangular shape, or it has internal
+    children that need to be distinguished by the events delivery mechanism,
+    the ClutterActor::pick() method should also be
+    overridden. The pick() method works exactly like the paint() method, but
+    the actor should paint just its shape with the passed colour:
+
+    
+      Pick implementation of a simple actor
+      In this example, FooActor overrides the
+      pick() virtual function default implementation to paint itself with a
+      shaped silhouette, to allow events only on the actual shape of the actor
+      instead of the whole paint area.
+      
+static void
+foo_actor_pick (ClutterActor       *actor,
+                const ClutterColor *pick_color)
+{
+  FooActor *foo_actor = FOO_ACTOR (actor);
+  ClutterUnit w, h, r;
+
+  /* it is possible to avoid a costly paint by checking whether the
+   * actor should really be painted in pick mode
+   */
+  if (!clutter_actor_should_pick_paint (actor))
+    return;
+
+  w = CLUTTER_UNITS_TO_FIXED (clutter_actor_get_widthu (actor));
+  h = CLUTTER_UNITS_TO_FIXED (clutter_actor_get_heightu (actor));
+
+  /* this is the arc radius for the rounded rectangle corners */
+  r = CLUTTER_UNITS_TO_FIXED (foo_actor->radius);
+
+  cogl_push_matrix ();
+
+  /* use the passed color to paint ourselves */
+  cogl_color (pick_color);
+
+  /* paint a round rectangle */
+  cogl_round_rectangle (0, 0, w, h, r, 5);
+
+  /* and fill it with the current color */
+  cogl_fill ();
+
+  cogl_pop_matrix ();
+}
+      
+    
+
+    Containers should simply chain up to the parent class'
+    pick() implementation to get their silhouette painted and then
+    paint their children:
+
+    
+      Pick implementation of a container
+      In this example, FooActor allows the
+      picking of each child it contains, as well as itself.
+      
+static void
+foo_actor_pick (ClutterActor       *actor,
+                const ClutterColor *pick_color)
+{
+  FooActor *foo_actor = FOO_ACTOR (actor);
+
+  /* this will paint a silhouette corresponding to the paint box */
+  CLUTTER_ACTOR_CLASS (foo_actor_parent_class)->pick (actor, pick_color);
+
+  /* clutter_actor_paint() is context-sensitive, and will perform
+   * a pick paint if the scene graph is in pick mode
+   */
+  if (CLUTTER_ACTOR_IS_VISIBLE (foo_actor->child))
+    clutter_actor_paint (foo_actor->child);
+}
+      
+    
+
+   
+
+  
+    Implementing Containers
+
+    
+    The ClutterContainer interface should be implemented by subclasses
+    of ClutterActor who wants to provide a general API for adding child
+    actors.
+    
+
+    
+    If the ClutterActor subclass only handles internal children, or it's
+    not suitable for having generic actors added to it, it should not
+    implement the ClutterContainer interface, but simply use
+    clutter_actor_set_parent():
+    
+
+    
+      Parenting an actor
+      In this example, FooActor has an internal
+      child of type BazActor which is assigned using a
+      specific function called foo_actor_add_baz(). The
+      FooActor instance takes ownership of the
+      BazActor instance and sets the parent-child
+      relationship using clutter_actor_set_parent().
+      
+void
+foo_actor_add_baz (FooActor *foo_actor,
+                   BazActor *baz_actor)
+{
+  g_return_if_fail (FOO_IS_ACTOR (foo_actor));
+  g_return_if_fail (BAZ_IS_ACTOR (baz_actor));
+
+  /* unparent the previous BazActor; this will automatically call
+   * g_object_unref() on the actor
+   */
+  if (foo_actor->baz)
+    clutter_actor_unparent (foo_actor->baz);
+
+  foo_actor->baz = baz_actor;
+
+  /* this will cause the initial floating reference of ClutterActor to
+   * disappear, and add a new reference on baz_actor. foo_actor has now
+   * taken ownership of baz_actor, so that:
+   *
+   *   foo_actor_add_baz (foo_actor, baz_actor_new ());
+   *
+   * is a safe statement (no reference is leaked).
+   */
+  clutter_actor_set_parent (CLUTTER_ACTOR (baz_actor),
+                            CLUTTER_ACTOR (foo_actor));
+
+  /* a container should queue a change in the layout */
+  clutter_actor_queue_relayout (CLUTTER_ACTOR (foo_actor));
+
+  /* emit a signal and notification */
+  g_signal_emit (foo_actor, foo_actor_signals[BAZ_CHANGED], 0, baz_actor);
+  g_object_notify (G_OBJECT (foo_actor), "baz");
+}
+      
+    
+
+    
+    In order to implement the ClutterContainer interface, these virtual
+    functions must be defined:
+
+      
+        
+          ClutterContainer::add
+          
+            The container actor should hold a pointer to the passed
+            ClutterActor, call clutter_actor_set_parent() on it and then
+            emit the "actor-added" signal to notify
+            handlers of the newly added actor.
+          
+        
+        
+          ClutterContainer::remove
+          
+            The container actor should increase the reference count
+            of the passed ClutterActor, remove the pointer held on the
+            child and call clutter_actor_unparent() on it; then, emit the
+            "actor-removed" signal and decrease the
+            reference count.
+          
+        
+        
+          ClutterContainer::foreach
+          
+            The container should invoke the callback on every
+            child it is holding.
+          
+        
+        
+          ClutterContainer::raise
+          
+            The container should move the passed child on top
+            of the given sibling, or on top of the paint stack in
+            case the sibling is NULL.
+          
+        
+        
+          ClutterContainer::lower
+          
+            The container should move the passed child below
+            the given sibling, or on the bottom of the paint stack
+            in case the sibling is NULL.
+          
+        
+        
+          ClutterContainer::sort_depth_order
+          
+            The container should sort the paint stack depending
+            on the relative depths of each child.
+          
+        
+      
+
+    
+
+   
+
+
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/cogl/html/ch01.html clutter-0.7.6/doc/reference/cogl/html/ch01.html
--- clutter-0.7.4/doc/reference/cogl/html/ch01.html	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/cogl/html/ch01.html	2008-06-27 21:32:04.000000000 +0100
@@ -4,9 +4,9 @@
 
 COGL - GL Abstraction API
 
-
-
-
+
+
+
 
 
 
@@ -17,13 +17,13 @@
 Prev
  
 Home
-COGL 0.7.4
+COGL 0.7.6
  Reference Manual
 Next
 
 

 

-COGL - GL Abstraction API

+COGL - GL Abstraction API

 

 
About COGL

 

diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/cogl/html/cogl-General-API.html clutter-0.7.6/doc/reference/cogl/html/cogl-General-API.html
--- clutter-0.7.4/doc/reference/cogl/html/cogl-General-API.html	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/cogl/html/cogl-General-API.html	2008-06-27 21:32:04.000000000 +0100
@@ -4,7 +4,7 @@
 
 General API
 
-
+
 
 
 
@@ -18,7 +18,7 @@
 Prev
 Up
 Home
-COGL 0.7.4
+COGL 0.7.6
  Reference Manual
 Next
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/cogl/html/cogl-Offscreen-Buffers.html clutter-0.7.6/doc/reference/cogl/html/cogl-Offscreen-Buffers.html
--- clutter-0.7.4/doc/reference/cogl/html/cogl-Offscreen-Buffers.html	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/cogl/html/cogl-Offscreen-Buffers.html	2008-06-27 21:32:04.000000000 +0100
@@ -4,7 +4,7 @@
 
 Offscreen Buffers
 
-
+
 
 
 
@@ -17,7 +17,7 @@
 Prev
 Up
 Home
-COGL 0.7.4
+COGL 0.7.6
  Reference Manual
  
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/cogl/html/cogl-Primitives.html clutter-0.7.6/doc/reference/cogl/html/cogl-Primitives.html
--- clutter-0.7.4/doc/reference/cogl/html/cogl-Primitives.html	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/cogl/html/cogl-Primitives.html	2008-06-27 21:32:04.000000000 +0100
@@ -4,7 +4,7 @@
 
 Primitives
 
-
+
 
 
 
@@ -18,7 +18,7 @@
 Prev
 Up
 Home
-COGL 0.7.4
+COGL 0.7.6
  Reference Manual
 Next
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/cogl/html/cogl-Shaders-and-Programmable-Pipeline.html clutter-0.7.6/doc/reference/cogl/html/cogl-Shaders-and-Programmable-Pipeline.html
--- clutter-0.7.4/doc/reference/cogl/html/cogl-Shaders-and-Programmable-Pipeline.html	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/cogl/html/cogl-Shaders-and-Programmable-Pipeline.html	2008-06-27 21:32:04.000000000 +0100
@@ -4,7 +4,7 @@
 
 Shaders and Programmable Pipeline
 
-
+
 
 
 
@@ -18,7 +18,7 @@
 Prev
 Up
 Home
-COGL 0.7.4
+COGL 0.7.6
  Reference Manual
 Next
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/cogl/html/cogl-Textures.html clutter-0.7.6/doc/reference/cogl/html/cogl-Textures.html
--- clutter-0.7.4/doc/reference/cogl/html/cogl-Textures.html	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/cogl/html/cogl-Textures.html	2008-06-27 21:32:04.000000000 +0100
@@ -4,7 +4,7 @@
 
 Textures
 
-
+
 
 
 
@@ -18,7 +18,7 @@
 Prev
 Up
 Home
-COGL 0.7.4
+COGL 0.7.6
  Reference Manual
 Next
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/cogl/html/cogl-Utility-API.html clutter-0.7.6/doc/reference/cogl/html/cogl-Utility-API.html
--- clutter-0.7.4/doc/reference/cogl/html/cogl-Utility-API.html	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/cogl/html/cogl-Utility-API.html	2008-06-27 21:32:04.000000000 +0100
@@ -4,7 +4,7 @@
 
 Utility API
 
-
+
 
 
 
@@ -18,7 +18,7 @@
 Prev
 Up
 Home
-COGL 0.7.4
+COGL 0.7.6
  Reference Manual
 Next
 
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/cogl/html/cogl.devhelp clutter-0.7.6/doc/reference/cogl/html/cogl.devhelp
--- clutter-0.7.4/doc/reference/cogl/html/cogl.devhelp	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/cogl/html/cogl.devhelp	2008-06-27 21:32:04.000000000 +0100
@@ -1,6 +1,6 @@
 
 
-
+
   
     
       
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/cogl/html/cogl.devhelp2 clutter-0.7.6/doc/reference/cogl/html/cogl.devhelp2
--- clutter-0.7.4/doc/reference/cogl/html/cogl.devhelp2	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/cogl/html/cogl.devhelp2	2008-06-27 21:32:04.000000000 +0100
@@ -1,6 +1,6 @@
 
 
-
+
   
     
       
diff -Nru -x '*.gmo' -x '*.mo' --speed-large-files --minimal clutter-0.7.4/doc/reference/cogl/html/index.html clutter-0.7.6/doc/reference/cogl/html/index.html
--- clutter-0.7.4/doc/reference/cogl/html/index.html	2008-06-25 17:58:29.000000000 +0100
+++ clutter-0.7.6/doc/reference/cogl/html/index.html	2008-06-27 21:32:04.000000000 +0100
@@ -2,9 +2,9 @@
 
 
 
-COGL 0.7.4 Reference Manual
+COGL 0.7.6 Reference Manual
 
-
+
 
 
 
@@ -14,13 +14,13 @@
 

 

 

-