Manual: fiascotopnm

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 written --outp or --ou. For all options an one let‐
       ter short option is provided. Mandatory or optional arguments to long options are mandatory or optional for short op‐
       tions, 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 ), fi‐
       ascotopnm 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 pos‐
	      sible with video streams.

	       If name is a relative path and the environment variable FIASCO_IMAGES is a (colon-separated) list of directo‐
	      ries, then the output file(s) are written to the first (writable) directory of this list. Otherwise, the	cur‐
	      rent 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",	...  ,	"im‐
       age.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 

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)