Python-Clutter development notes

ModRana? will in the future use Clutter as an alternative to the current non-accelerated GTK GUI. Unfortunately, the documentation to the Python bindings for Clutter is in a sad state. This page serves as a compilation of various Clutter & Python related development notes, with the hope to piece together some sort of documentation for the most needed elements :)

NOTE: all of this information concerns Python bindings for Clutter 1.0

Gathered resources

documentation from various sources

official incomplete documentation, taken from Debian PyClutter package:
​http://www.modrana.org/pyclutter for the package.

official documentation improved by Paolo Marti, from ​his GitHub page:
​http://www.modrana.org/pyclutter_marti

PyClutter tutorial, also by Paolo Marti:
​http://www.modrana.org/pyclutter_tutorial

complete examples for the above mentioned tutorial:
​http://www.modrana.org/pyclutter_tutorial/examples

a short PyClutter tutorial by TuxRadar:
​http://www.tuxradar.com/content/code-project-monitor-proc-python-and-clutter

a small PyClutter recipe:
​http://otherwiseingle.blogspot.com/2010/02/pyclutter-recipes.html

rounded rectangle actor in Python:
​http://www.themacaque.com/?p=565

rounded rectangle actor in Python using Gobject introspection:
​http://www.themacaque.com/?p=847

rounded rectangle actor in Python - wiki version:
​http://www.themacaque.com/wiki/doku.php?id=clutter:rounded_rectangle

working with images in Python-Clutter:
​http://www.themacaque.com/?p=549

creating Clutter texture from Pixbuf:
​http://www.themacaque.com/wiki/doku.php?id=clutter:texture_from_pixbuf

creating a floating layout using Python and Clutter:
​http://www.themacaque.com/?p=587

custom Clutter Actor using Python:
​http://www.eurion.net/python-snippets/snippet/Clutter%20Custom%20Actor.html

Issues

actors not getting motion notify events

Call set_reactive(True) on the actor and it will start receiving motion notify events. Clutter does this probably as an optimization, eq. it has to handle the motion notify event only for actors that request it.

compiling more recent clutter version

Raw compilation notes

available methods

summary of available methods