Prima::Image::AnimateGIF - animate gif files
The module provides high-level access to GIF animation sequences.
use Prima qw(Application Image::AnimateGIF); my $x = Prima::Image::AnimateGIF->load($ARGV[0]); die $@ unless $x; my ( $X, $Y) = ( 0, 100); my $background = $::application-> get_image( $X, $Y, $x-> size); $::application-> begin_paint; while ( my $info = $x-> next) { my $frame = $background-> dup; $frame-> begin_paint; $x-> draw( $frame, 0, 0); $::application-> put_image( $X, $Y, $frame); $::application-> sync; select(undef, undef, undef, $info-> {delay}); } $::application-> put_image( $X, $Y, $g);
Creates an empty animation container. If $OPTIONS{images} is given, it is expected to be an array of images, best if loaded from gif files with loadExtras and iconUnmask parameters set ( see Prima::image-load for details).
$OPTIONS{images}
loadExtras
iconUnmask
Loads GIF animation sequence from file or stream $SOURCE. Options are the same as understood by Prima::Image::load, and are passed down to it.
$SOURCE
Prima::Image::load
Appends an image frame to the container.
Return the background color specified by the GIF sequence as the preferred background color to use when there is no specific background to superimpose the animation to.
Return index of the current frame
Draws the current composite frame on $CANVAS at the given coordinates.
$CANVAS
Returns height of the composite frame.
Creates and returns an icon object off the current composite frame.
Creates and returns an image object off the current composite frame. The transparent pixels on the image are replaced with the preferred background color.
Returns true if the animation sequence was stopped, false otherwise. If the sequence was stopped, the only way to restart it is to call reset.
reset
Returns total animation length (without repeats) in seconds.
Sets and returns number of loops left, undef for indefinite.
Return the AND and XOR masks, that can be used to display the current composite frame.
Advances one animation frame. The step triggers changes to the internally kept AND and XOR masks that create effect of transparency, if needed. The method return a hash, where the following field are initialized:
Coordinates of the changed area since the last frame was updated.
Time ins seconds how long the frame is expected to be displayed.
Resets the animation sequence. This call is necessary either when image sequence was altered, or when sequence display restart is needed.
Returns width and height of the composite frame.
Return number fo frames
Returns width of the composite frame.
Prima::image-load, http://www.the-labs.com/GIFMerge/
Dmitry Karasik, <dmitry@karasik.eu.org>.
To install Prima, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Prima
CPAN shell
perl -MCPAN -e shell install Prima
For more information on module installation, please visit the detailed CPAN module installation guide.