unflick \- extract images from a FLI/FLC file


SYNOPSIS

unflick [-a|-m] [-b "begin"] [-n "max"] [-v] [-z] [-zz] animation base [extension]


DESCRIPTION

The program unflick extracts single images or a series of images from a
given FLI-animation. The extracted images are stored in separated files.
The formats PPM (raw and ascii) and FBM (mapped 8bpp) are available.
Additionally unflick can perform an automatic compression of the output
files using the 'compress' or the 'gzip' utility. The file 'animation'
contains the input FLI-animation. The output file names are controlled
by the parameters 'base' and 'extension'.

If the parameter 'extension' is omitted, the names of the generated
files are composed of the given 'base' followed by a dot and a number
field:

base.001,
base.002,
base.003,
etc.

The number indicates the position at which the image appears in the
FLI-animation. Note that when the input animation has more than 999
frames automatically more digits are used in the number field of the
file names. 

In the case of a given 'extension', the file names consist of the
'base', directly followed by the number field, plus a dot and the given
extension:

base001.extension ,
base002.extension ,
base003.extension ,
etc.

Before a image is written to disk, the program tests if a file with the
designated name already exists. In this case the old file is not
overwritten and the program terminates with an error.


OPTIONS

-a

Write the images in PPM ascii format instead of PPM raw. Note that this
needs much more disk space.

-b "begin"

Only the images with the number 'begin' or higher are extracted. By
default the extraction starts with the first image.

-m

Write the images in mapped FBM format. Then they can be converted to
other formats with the utilities of the FBM package.

-n "max"

Extract not more than 'max' images. By default all images from the given
beginning up to the end are extracted. With this option it is possible
to extract only a part of the images. 

-v

Write some information about the processed FLI-file to stdout .

-z

Postprocess the output files with the 'compress' utility.

-zz

Postprocess the output files with the 'gzip' utility.


EXAMPLES

For example we want to extract all images from the FLI-animation
`nicefilm.fli'. We choose the names

	picture.001, picture.002, picture.003, ...

for the output files. And we want that the images are written in
PPM-ascii format. In this case we give the command:

	unflick -a nicefilm.fli picture

In the next example we are interested only in the 10th image of the
FLI-animation. We want the output image in compressed PPM-raw format. As
output name we wish `picture010.ppm.Z'. To do this we type the command:

	unflick -b 10 -n 1 -z nicefilm.fli picture ppm

This only works when no old file with the name `picture010.ppm' exists,
because at first the image is written to this file and then compressed.
At the end this temporary file is removed by the 'compress' command.
Note that 'unflick' does not test the existence of the compressed file
`picture010.ppm.Z'. This is done by 'compress'. If such a file already
exists 'compress' usually asks to overwrite it. When the answer is
negative the compression is not performed and the temporary file
`picture010.ppm' is not removed.

SEE ALSO

ppm2fli (1)
fbm (1)
and
ppm (5)


AUTHORS

Klaus Ehrenfried (klaus@es.go.dlr.de).

Copyright (C) 1996 by Klaus Ehrenfried.
Release of January 1996.

Permission to use, copy, modify, and distribute this software is hereby
granted, provided that the above copyright notice appears in all copies
and that the software is available to all free of charge. The author
disclaims all warranties with regard to this software, including all
implied warranties of merchant-ability and fitness. The code is simply
distributed as it is.
