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 im
age 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 let
ter short option is provided. Mandatory or optional argu
ments to long options are mandatory or optional for short
options, too. Both short and long options are case sensi
tive.
-o[name], --output=[name]
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 file
name 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 de
creased.
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 ex
it buttons to control the display of videos. When
pressing the record button, all frames are decom
pressed and stored in memory. The other buttons
work in the usual way.
-m N, --magnify=N
Set magnification of the decompressed image. Posi
tive values enlarge and negative values reduce the
image width and height by a factor of 2^|N|.
-s N, --smooth=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.
-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 speci
fied order):
1) Global ressource file /etc/system.fiascorc
2) $HOME/.fiascorc
3) command line
4) --config=name
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 decom
pression 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(5)
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 Ver
lag, ISBN 3-89820-002-7, October 1999.
AUTHOR
Ullrich Hafner <hafner@bigfoot.de>
Man(1) output converted with
man2html