NAME

       fiascotopnm - Convert compressed FIASCO image to PGM, or PPM

SYNOPSIS

       fiascotopnm [option]...  [filename]...

       All  option names may be abbreviated; for example, --output may be written --outp or --ou.
       For all options an one letter short option is provided. Mandatory or optional arguments to
       long options are mandatory or optional for short options, too. Both short and long options
       are case sensitive.

DESCRIPTION

       This program is part of Netpbm(1).

       fiascotopnm decompresses the named FIASCO files, or the  Standard  Input  if  no  file  is
       named,  and  writes the images as PGM, or PPM files, depending on whether the FIASCO image
       is black and white or color.

OPTIONS

       In addition to the options common to all programs based on libnetpbm (most notably -quiet,
       see
        Common Options ⟨index.html#commonoptions⟩ ), fiascotopnm recognizes the following command
       line options:

       -o[name], --output=[name]
               Write decompressed image to the file name.ppm (if PPM) or name.pgm (if  PGM).   If
              name  is  -,  then  produce  the  image  file  on the standard output. The optional
              argument name can be omitted, then the input filename is used as basename with  the
              suffix  .ppm  or .pgm. In case of video streams, the frames are stored in the files
              name.N.ppm where N is the frame number (of the form 00..0 - 99..9); output  on  the
              standard output is not possible with video streams.

               If name is a relative path and the environment variable FIASCO_IMAGES is a (colon-
              separated) list of directories, then the output file(s) are written  to  the  first
              (writable)  directory  of  this  list.  Otherwise, the current directory is used to
              store the output file(s).

       -z, --fast
              Decompress images in the 4:2:0 format; i.e., each chroma channel is decompressed to
              an  image  of  halved  width  and height. Use this option on slow machines when the
              desired frame rate is not achieved; the output quality is only slightly decreased.

       -d, --double
              Double the size of the X11 window both in width and height; no pixel  interpolation
              is used, each pixel is just replaced by four identical pixels.

       -p, --panel
              Show a panel with play, stop, pause, record and exit buttons to control the display
              of videos. When pressing the record button, all frames are decompressed and  stored
              in memory. The other buttons work in the usual way.

       -m N, --magnify=N
              Set  magnification  of the decompressed image. Positive values enlarge and negative
              values reduce the image width and height by a factor of 2^|N|.

       -s N, --smoothing=N
              Smooth decompressed image(s) along the partitioning borders by the given amount  N.
              N  is  1  (minimum)  to  100 (maximum); default is 70. When N=0, then the smoothing
              amount specified in the FIASCO file is used (defined by the FIASCO coder).

       -F N, --fps=N
              Set number of frames per second to N.  When  using  this  option,  the  frame  rate
              specified in the FIASCO file is overridden.

       --verbose=N
              Set verbose of fiascotopnm to N.

       -v, --version
              Print fiascotopnm version number, then exit.

       -f name, --config=name
              Load  parameter  file  name  to  initialize  the  options of fiascotopnm.  See file
              system.fiascorc for an example of the syntax. Options of fiascotopnm   are  set  by
              any of the following methods (in the specified order):

       •      Global ressource file /etc/system.fiascorc

       •      $HOME/.fiascorc

       •      command line

       •      --config=name

       -h, --info
              Print brief help, then exit.

       -H, --help
              Print detailed help, then exit.

EXAMPLES

       fiascotopnm foo.wfa >foo.ppm

       Decompress the FIASCO file "foo.wfa" and store it as "foo.ppm".

       fiascotopnm -o foo1.wfa foo2.wfa

       Decompress  the  FIASCO  files "foo1.wfa" and "foo2.wfa" and write the frames to the image
       files "foo1.wfa.ppm" and "foo2.wfa.ppm".

       fiascotopnm -oimage foo1.wfa

       Decompress the FIASCO file  "foo1.wfa"  and  write  all  15  frames  to  the  image  files
       "image.00.ppm", ... , "image.14.ppm".

       fiascotopnm --fast --magnify=-1 --double video.wfa >stream.ppm

       Decompress  the  FIASCO file "video.wfa".  The decompression speed is as fast as possible:
       the image is decompressed (in 4:2:0 format) at a quarter of its original  size;  then  the
       image is enlarged again by pixel doubling.

FILES

       /etc/system.fiascorc
              The systemwide initialization file.

       $HOME/.fiascorc
              The personal initialization file.

ENVIRONMENT

       FIASCO_IMAGES
              Save path for image files. Default is "./".

       FIASCO_DATA
              Search path for FIASCO files. Default is "./".

SEE ALSO

       pnmtofiasco(1), pnm(1)

       Ullrich Hafner, Juergen Albert, Stefan Frank, and Michael Unger.  Weighted Finite Automata
       for Video Compression, IEEE Journal on Selected  Areas  In  Communications,  January  1998
       Ullrich  Hafner.  Low Bit-Rate Image and Video Coding with Weighted Finite Automata, Ph.D.
       thesis, Mensch & Buch Verlag, ISBN 3-89820-002-7, October 1999.

AUTHOR

       Ullrich Hafner <hafner@bigfoot.de>

DOCUMENT SOURCE

       This manual page was generated by the Netpbm tool 'makeman' from HTML source.  The  master
       documentation is at

              http://netpbm.sourceforge.net/doc/fiascotopnm.html