1Fiascotopnm User Manual(0)                          Fiascotopnm User Manual(0)
2
3
4

NAME

6       fiascotopnm - Convert compressed FIASCO image to PGM, or PPM
7
8

SYNOPSIS

10       fiascotopnm [option]...  [filename]...
11
12

DESCRIPTION

14       This program is part of Netpbm(1).
15
16       fiascotopnm  decompresses the named FIASCO files, or the Standard Input
17       if no file is named, and writes  the  images  as  PGM,  or  PPM  files,
18       depending on whether the FIASCO image is black and white or color.
19
20

OPTIONS

22       All option names may be abbreviated; for example, --output may be writ‐
23       ten --outp or --ou. For all options an one letter short option is  pro‐
24       vided. Mandatory or optional arguments to long options are mandatory or
25       optional for short options, too. Both short and long options  are  case
26       sensitive.
27
28
29
30       -o[name], --output=[name]
31               Write  decompressed  image  to  the  file  name.ppm (if PPM) or
32              name.pgm (if PGM).  If name is -, then produce the image file on
33              the  standard output. The optional argument name can be omitted,
34              then the input filename is used as basename with the suffix .ppm
35              or  .pgm. In case of video streams, the frames are stored in the
36              files name.N.ppm where N is the frame number (of the form  00..0
37              -  99..9);  output  on  the standard output is not possible with
38              video streams.
39
40               If name  is  a  relative  path  and  the  environment  variable
41              FIASCO_IMAGES  is  a (colon-separated) list of directories, then
42              the output file(s) are written to the first (writable) directory
43              of  this list. Otherwise, the current directory is used to store
44              the output file(s).
45
46
47       -z, --fast
48              Decompress images in the 4:2:0 format; i.e., each chroma channel
49              is decompressed to an image of halved width and height. Use this
50              option on slow machines when  the  desired  frame  rate  is  not
51              achieved; the output quality is only slightly decreased.
52
53
54       -d, --double
55              Double  the  size of the X11 window both in width and height; no
56              pixel interpolation is used, each pixel is just replaced by four
57              identical pixels.
58
59
60       -p, --panel
61              Show  a panel with play, stop, pause, record and exit buttons to
62              control the display of videos. When pressing the record  button,
63              all frames are decompressed and stored in memory. The other but‐
64              tons work in the usual way.
65
66
67       -m N, --magnify=N
68              Set magnification of the  decompressed  image.  Positive  values
69              enlarge and negative values reduce the image width and height by
70              a factor of 2^|N|.
71
72
73       -s N, --smooth=N
74              Smooth decompressed image(s) along the partitioning  borders  by
75              the  given  amount N. N is 1 (minimum) to 100 (maximum); default
76              is 70. When N=0, then the  smoothing  amount  specified  in  the
77              FIASCO file is used (defined by the FIASCO coder).
78
79
80       -F N, --fps=N
81              Set  number  of  frames per second to N. When using this option,
82              the frame rate specified in the FIASCO file is overridden.
83
84
85       -v, --version
86              Print fiascotopnm version number, then exit.
87
88
89       -f name, --config=name
90              Load parameter file name to initialize the  options  of  fiasco‐
91              topnm.   See  file system.fiascorc for an example of the syntax.
92              Options of fiascotopnm  are set by any of the following  methods
93              (in the specified order):
94
95
96
97       ·      Global ressource file /etc/system.fiascorc
98
99
100       ·      $HOME/.fiascorc
101
102
103       ·      command line
104
105
106       ·      --config=name
107
108
109
110       -h, --info
111              Print brief help, then exit.
112
113
114       -H, --help
115              Print detailed help, then exit.
116
117
118
119
120

EXAMPLES

122       fiascotopnm foo.wfa >foo.ppm
123
124       Decompress the FIASCO file 'foo.wfa' and store it as 'foo.ppm'.
125
126       fiascotopnm -o foo1.wfa foo2.wfa
127
128       Decompress  the  FIASCO  files  'foo1.wfa' and 'foo2.wfa' and write the
129       frames to the image files 'foo1.wfa.ppm' and 'foo2.wfa.ppm'.
130
131       fiascotopnm -oimage foo1.wfa
132
133       Decompress the FIASCO file 'foo1.wfa' and write all 15  frames  to  the
134       image files 'image.00.ppm', ... , 'image.14.ppm'.
135
136       fiascotopnm --fast --magnify=-1 --double video.wfa >stream.ppm
137
138       Decompress  the FIASCO file 'video.wfa'.  The decompression speed is as
139       fast as possible: the image is decompressed  (in  4:2:0  format)  at  a
140       quarter of its original size; then the image is enlarged again by pixel
141       doubling.
142
143

FILES

145       /etc/system.fiascorc
146              The systemwide initialization file.
147
148
149       $HOME/.fiascorc
150              The personal initialization file.
151
152
153
154

ENVIRONMENT

156       FIASCO_IMAGES
157              Save path for image files. Default is './'.
158
159
160       FIASCO_DATA
161              Search path for FIASCO files. Default is './'.
162
163
164
165
166

SEE ALSO

168       pnmtofiasco(1), pnm(1)
169
170       Ullrich Hafner,  Juergen  Albert,  Stefan  Frank,  and  Michael  Unger.
171       Weighted  Finite  Automata  for  Video  Compression,  IEEE  Journal  on
172       Selected Areas In Communications, January 1998 Ullrich Hafner. Low Bit-
173       Rate  Image  and Video Coding with Weighted Finite Automata, Ph.D. the‐
174       sis, Mensch & Buch Verlag, ISBN 3-89820-002-7, October 1999.
175
176

AUTHOR

178       Ullrich Hafner <hafner@bigfoot.de>
179
180
181
182netpbm documentation             12 July 2000       Fiascotopnm User Manual(0)
Impressum