# phpman > man > fiascotopnm(1)

> **TLDR:** Convert a compressed FIASCO file to a PNM image.
>
- Convert a compressed FIASCO file to a PNM file or in the case of video streams multiple PNM files:
  `fiascotopnm {{path/to/file.fiasco}} {{-o|--output}} {{output_file_basename}}`
- Use fast decompression, resulting in a slightly decreased quality of the output file(s):
  `fiascotopnm {{-z|--fast}} {{path/to/file.fiasco}} {{-o|--output}} {{output_file_basename}}`
- Load the options to be used from the specified configuration file:
  `fiascotopnm {{-f|--config}} {{path/to/fiascorc}} {{path/to/file.fiasco}} {{-o|--output}} {{output_file_basename}}`
- Magnify the decompressed image(s) by a factor of 2^n:
  `fiascotopnm {{-m|--magnify}} {{n}} {{path/to/file.fiasco}} {{-o|--output}} {{output_file_basename}}`
- Smooth the decompressed image by the specified amount:
  `fiascotopnm {{-s|--smoothing}} {{n}} {{path/to/file.fiasco}} {{-o|--output}} {{output_file_basename}}`

*Source: tldr-pages*

---

[fiascotopnm(1)](https://www.chedong.com/phpMan.php/man/fiascotopnm/1/markdown)                         General Commands Manual                        [fiascotopnm(1)](https://www.chedong.com/phpMan.php/man/fiascotopnm/1/markdown)



## NAME
       fiascotopnm - Convert compressed FIASCO image to PGM, or PPM


## SYNOPSIS
       **fiascotopnm** [_option_]...  [_filename_]...


## DESCRIPTION
       **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
       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.


### -o --output=
              Write decompressed image to the file _name_.ppm (if  PPM)  or  _name_.pgm  (if  PGM).   If
              _name_=-  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-sep‐
              arated) 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 --magnify=
              Set magnification of the decompressed image. Positive values enlarge and negative val‐
              ues reduce the image width and height by a factor of 2^|_N_|.


### -s --smooth=
              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 --fps=
              Set number of frames per second to _N_. When using this option, the frame rate specified
              in the FIASCO file is overridden.


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


### -f --config=
              Load  parameter  file  _name_  to  initialize the options of **fiascotopnm**.  See file **sys**‐‐
              **tem.fiascorc** for an example of the syntax. Options of **fiascotopnm** are set  by  any  of
              the following methods (in the specified order):

              1) Global ressource file **/etc/system.fiascorc**

              2) $HOME**/.fiascorc**

              3) command line

              4) --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 im‐
              age 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  "im‐
              age.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 possi‐
              ble: 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)](https://www.chedong.com/phpMan.php/man/pnmtofiasco/1/markdown), [**pnm**(5)](https://www.chedong.com/phpMan.php/man/pnm/5/markdown)

       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. the‐
       sis, Mensch & Buch Verlag, ISBN 3-89820-002-7, October 1999.


## AUTHOR
       Ullrich Hafner <<hafner@bigfoot.de>>



                                            July 12, 2000                             [fiascotopnm(1)](https://www.chedong.com/phpMan.php/man/fiascotopnm/1/markdown)
