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 ), 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 resource 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

netpbm documentation                              12 July 2000                        Fiascotopnm User Manual(1)