


UNFLICK(1)                                             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 con-
       tains 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 dig-
       its 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  ter-
       minates 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.



                         11 February 1997                       1





UNFLICK(1)                                             UNFLICK(1)


       -m     Write the images in mapped FBM format.   Then  they
              can  be  converted to other formats with the utili-
              ties 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 com-
              pressed 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'.



                         11 February 1997                       2





UNFLICK(1)                                             UNFLICK(1)


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

AUTHORS
       Klaus Ehrenfried  (ehrenfri@hobo.pi.tu-berlin.de).   Copy-
       right  (C)  1996,1997  by  Klaus  Ehrenfried.   Release of
       February 1997.

       Permission to use, copy, modify, and distribute this soft-
       ware  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.










































                         11 February 1997                       3


