PyClutter
=========

This archive contains the Python modules that allow you to use the
Clutter toolkit in Python programs.

If you have any enhancements of bug reports, please file them in
OpenedHand Bugzilla at:

  http://bugzilla.o-hand.com/enter_bug.cgi?product=Clutter

Requirements
------------
  * GLib 2.14.0 or higher
  * GTK+ 2.10.0 or higher
  * Clutter 0.8.2 or higher
  * PyCairo
  * PyGObject 2.12.1 or higher
  * Python 2.4.0 or higher

In order to build the bindings for clutter-gst you will also need:
  * GStreamer >= 0.10
  * PyGStreamer

In order to build the bindings for clutter-gtk you will also need:
  * GTK+ >= 2.10
  * PyGTK

This release is supporting the following Clutter releases:

        clutter-core    0.8.2
        clutter-gst     0.8.0
        clutter-gtk     0.8.2
        clutter-cairo   0.8.0

Installation
------------

In order to install this module type the following:

  $ ./configure
  $ make
  # make install

To avoid installing to a system directory you can change the installation
prefix at configure time with

  ./configure --prefix=/some/other/place

Release notes for PyClutter 0.8.2
---------------------------------

The units-based API for clutter.Actor now accepts only floating point
values to express the same sub-pixel precision that the C core library
implements using the ClutterUnit type.

This change will unfortunately break every Python application using the
units-based API and currently passing values using the Pytho bindings
for the conversion to and from units.

Release notes for PyClutter 0.8.0
---------------------------------

The cluttercairo, cluttergst and cluttergtk submodules of clutter have
been moved into their own modules. In order to import them, the import
directive must be changed from:

        from clutter import cluttercairo
        from clutter import cluttergst
        from clutter import cluttergtk

to:

        import cluttercairo
        import cluttergst
        import cluttergtk

The order of the import directives is also relevant, because of the
required initialization process of the underlying C libraries. The
correct order for importing the clutter and related modules is:

        first ↑
              | import cluttergtk
              | import cluttergst
              | import clutter
              | import cluttercairo
         last ↓

If you are importing the gst module, you must import it after the
cluttergst module.

If you are importing the gtk module, you must import it after the
cluttergtk module.

Copyright and License
---------------------

Copyright (C) 2006      OpenedHand Ltd
Copyright (C) 2008      Intel Corporation

This library is free software; you can redistribute it and/or modify it under
the terms of the GNU Library General Public License as published by the Free
Software Foundation; either version 2.1 of the License, or (at your option)
any later version

This library is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE.  See the GNU Library General Public License for more
details.

You should have received a copy of the GNU Library General Public License along
with this library; if not, write to the Free Software Foundation, Inc., 59
Temple Place - Suite 330, Boston, MA  02111-1307  USA.
