DragonFly On-Line Manual Pages

UNFLICK(1)             DragonFly General Commands Manual            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

                                11 January 2002                     UNFLICK(1)