dwww Home | Manual pages | Find package

Fiascotopnm User Manual(1)  General Commands Manual Fiascotopnm User Manual(1)

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 writ-
       ten --outp or --ou. For all options an one letter short option is  pro-
       vided. 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,  de-
       pending 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  FI-
              ASCO_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 but-
              tons work in the usual way.

       -m N, --magnify=N
              Set magnification of the decompressed image. Positive values en-
              large 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  FI-
              ASCO 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  fiasco-
              topnm.   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 Se-
       lected Areas In Communications, January 1998 Ullrich Hafner.  Low  Bit-
       Rate  Image  and Video Coding with Weighted Finite Automata, Ph.D. the-
       sis, 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)

Generated by dwww version 1.15 on Sat Jun 29 02:21:34 CEST 2024.