fiascotopnm - Convert compressed FIASCO image to PGM, or PPM - man(1) - [phpMan]

Che Dong

⚡ TLDR: fiascotopnm (tldr-pages)

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}}

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 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 val‐
ues 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 sys‐
tem.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 "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 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 "./".

man > fiascotopnm(1)