Clutter::Score.3pm

Langue: en

Autres versions - même langue

Version: 2010-08-25 (ubuntu - 24/10/10)

Section: 3 (Bibliothèques de fonctions)

NAME

Clutter::Score - Controller for multiple timelines

SYNOPSIS

     my $t1 = Clutter::Timeline->new(200);
     my $t2 = Clutter::Timeline->new(200);
     my $t3 = Clutter::Timeline->new(500);
 
     my $score = Clutter::Score->new();
     $score->append(undef, $t1); # appends t1 to the beginning
     $score->append($t1,   $t2); # appends t2 to t1
     $score->append($t1,   $t3); # appends t3 to t1
 
 

DESCRIPTION

Clutter::Score is a base class for sequencing multiple timelines in order.

Using Clutter::Score it is possible to start multiple timelines at the same time or launch multiple timelines when a particular timeline has emitted the Clutter::Timeline::completed signal.

Each time a Clutter::Timeline is started and completed, a signal will be emitted.

A Clutter::Score takes a reference on the timelines it manages, so scalars referencing timelines can be safely discarded as long as the score remains referenced.

New timelines can be appended to the Clutter::Score using the append() method, and removed using the remove() one.

Timelines can also be appended to a specific marker on the parent timeline, using Clutter::Score::append_at_marker().

The score can be cleared using Clutter::Score::remove_all().

The list of timelines can be retrieved using Clutter::Score::list_timelines().

The score state is controlled using Clutter::Score::start(), Clutter::Score::pause(), Clutter::Score::stop() and Clutter::Score::rewind().

The state can be queried using Clutter::Score::is_playing().

HIERARCHY

   Glib::Object
   +----Clutter::Score
 
 

METHODS

score = Clutter::Score->new

integer = $score->append ($parent, $timeline)

$parent (Clutter::Timeline or undef)
$timeline (Clutter::Timeline)

boolean = $score->is_playing

timelines = $score->list_timelines

boolean = $score->get_loop

$score->set_loop ($loop)

$loop (boolean)

$score->pause

$score->remove ($id)

$id (integer)

$score->remove_all

$score->rewind

$score->start

$score->stop

timeline = $score->get_timeline ($id)

$id (integer)

PROPERTIES

'loop' (boolean : readable / writable / private)
Whether the score should restart once finished

SIGNALS

completed (Clutter::Score)
started (Clutter::Score)
paused (Clutter::Score)
timeline-started (Clutter::Score, Clutter::Timeline)
timeline-completed (Clutter::Score, Clutter::Timeline)

SEE ALSO

Clutter::Timeline Copyright (C) 2006, 2007, 2008 OpenedHand Ltd

Copyright (C) 2009 Intel Corporation

This module is free software; you can redistribute it and/or modify it under the terms of either:

the GNU Lesser General Public Library version 2.1; or
the Artistic License, version 2.0.

See Clutter for the full copyright notice.