NAME

Clutter - Simple GL-based canvas library

SYNOPSIS

  use Clutter qw( :init );
  
  # create the main stage
  my $stage = Clutter::Stage->get_default();
  $stage->set_color(Clutter::Color->parse('DarkSlateGray'));
  $stage->signal_connect('key-press-event' => sub { Clutter->main_quit() });
  $stage->set_size(800, 600);
  
  # add an actor and place it right in the middle
  my $label = Clutter::Label->new("Sans 30", "Hello, Clutter!");
  $label->set_color(Clutter::Color->new(0xff, 0xcc, 0xcc, 0xdd));
  $label->set_anchor_point($label->get_width() / 2,
                           $label->get_height() / 2);
  $label->set_position($stage->get_width() / 2, $stage->get_height() / 2);
  $stage->add($label);

  $stage->show_all();
  
  Clutter->main();
  
  0;

DESCRIPTION

Clutter is a GObject based library for creating fast, visually rich graphical user interfaces. It is intended for creating single window heavily stylised applications such as media box ui's, presentations or kiosk style programs in preference to regular 'desktop' style applications.

Clutter's underlying graphics rendering is OpenGL (version 1.2+) based. The clutter API is intended to be easy to use, attempting to hide many of the GL complexities. It targets mainly 2D based graphics and is definetly not intended to be a general interface for all OpenGL functionality.

As well as OpenGL Clutter depends on and uses Glib, Glib::Object, Gtk2::Pango, Gtk2::Gdk::Pixbuf and GStreamer.

For more informations about Clutter, visit:

  http://www.clutter-project.org

You can also subscribe to the Clutter mailing list by sending a blank message <clutter+subscribe AT o-hand.com>, then follow the instructions in resulting reply.

DIFFERENCES FROM C API

In order to feel more Perl-ish, the Clutter API has been slightly changed for the Perl bindings.

ClutterCloneTexture => Clutter::Texture::Clone

The ClutterCloneTexture has been moved under the Clutter::Texture package name, to reinforce the inheritance.

ClutterCairo => Clutter::Texture::Cairo

As above, the name has been changed to reinforce the inheritance.

GtkClutter => Gtk2::ClutterEmbed

The widget for embedding a Clutter::Stage into a GTK+ application has been moved into the Gtk2 namespace and use the ClutterEmbed name similar to the MozEmbed widget for embedding Gecko.

AUTHOR

Emmanuele Bassi <ebassi (AT) openedhand (DOT) com>

COPYRIGHT AND LICENSE

Copyright (C) 2006 OpenedHand Ltd.

This module is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, version 2.1; or, at your option, under the terms of The Artistic License.

This module 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.

You should have received a copy of the GNU Library General Public License along with this module; if not, see http://www.gnu.org/licenses/.

For the terms of The Artistic License, see perlartistic.