UNFLICK(1)

NAME
unflick - extract images from a FLI/FLC file

SYNOPSIS
unflick [ -a | -m ] [ -b begin ] [ -n max ] [ -v ] [ -f filter ] 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 call an external filter program to convert the output in another file format. 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.

-f filter
    Postprocess the output with the specified filter. The writing is done using the popen subroutine. This can be used to store the images in other file formats than PPM of FBM, or to write directly compressed files.

EXAMPLES
For example we want to extract all images from the FLI-animation `nicefilm.fli'. And we want that the images are written in PPM-ascii format. In this case we give the command:

	% unflick -a nicefilm.fli picture

The output files have the names

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

In the second example we assume that the utility ppmtogif of the PBMPLUS package is available. We extract all images and write them in GIF format using the command line

	% unflick -fppmtogif nicefilm.fli pic gif

The names of the images are

	pic001.gif, pic002.gif, pic003.gif, ...

If we have the FBM package instead of PBMPLUS, we can use the fbcat utility. This filter reads FBM and can write several formats. To extract images in GIF format we type

	% unflick -m -f "fbcat -G" nicefilm.fli pic gif

In the last example we are interested only in the 10th image of the FLI-animation. We wish the output image in gzipped PPM-raw format. To do this we type the command:

	% unflick -b 10 -n 1 -fgzip nicefilm.fli pic ppm.gz

The output file has the name `pic010.ppm.gz'.

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

AUTHORS
Klaus Ehrenfried (klaus.ehrenfried@tu-berlin.de). Release of January 2002.

http://vento.pi.tu-berlin.de/fli.html