ANIMATION(1)

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

SYNOPSIS
  use Tk::Animation
  my $img = $widget->Animation('-format' => 'gif', -file => 'somefile.gif');
  $img->start_animation($period);
  $img->stop_animation;
  $img->add_frames(@images);

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.

`start_animation($period)' then initiates a `repeat' with specified $period to sequence through these images.

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

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 `Photo's and should all be the same size.

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.