Nick Ing-Simmons (PAUSE Custodial Account) > Tk-800.024 > Tk::Animation

Download:
Tk-800.024.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  33
Open  56
Stalled  15
View/Report Bugs
Module Version: 3.020   Source   Latest Release: Tk-804.033

NAME ^

Tk::Animation - Display sequence of Tk::Photo images

SYNOPSIS ^

  use Tk::Animation
  my $img = $widget->Animation('-format' => 'gif', -file => 'somefile.gif');

  $img->add_frames(@images);

  $img->start_animation($period);
  $img->stop_animation;

DESCRIPTION ^

In the simple case when Animation is passed a GIF89 style GIF with multiple 'frames', it will build an internal array of Photo images.

The add_frames method adds images to the sequence. It is provided to allow animations to be constructed from separate images. All images must be Photos and should all be the same size.

start_animation($period) then initiates a repeat with specified $period to sequence through these images. As for raw repeat $period is in milli-seconds, for a 50Hz monitor it should be at least 20mS.

stop_animation cancels the repeat and resets the image to the first image in the sequence.

BUGS ^

The 'period' should probably be a property of the Animation object rather than specified at 'start' time. It may even be embedded in the GIF.

syntax highlighting: