1
.TH pnmmtofiasco 1 "July 12, 2000"
4
pnmtofiasco - Convert a portable anymap to FIASCO compressed file
13
compresses the named pbm, pgm, or ppm image files, or Standard Input
14
if no file is named, and produces a FIASCO file on Standard Output.
17
All option names may be abbreviated; for example, --optimize may be
18
written --optim or --opt. For most options a one letter short option
19
is provided. Mandatory or optional arguments to long options are
20
mandatory or optional for short options, too. Both short and long
21
options are case sensitive.
23
The basic options are:
26
\fB\-i\fP \fIname\fP, \fB\-\-input-name=\fIname\fP
27
Compress the named images, not Standard Input.
34
has to be either an image filename or a template of the form:
37
prefix[start-end{+,-}step]suffix
39
Templates are useful when compressing video streams: e.g., if you specify
41
.BR "img0[12-01-2].pgm" ,
44
compresses the images img012.pgm, img010.pgm, ..., img002.pgm.
50
searches for the image files in the current directory and in the
51
(colon-separated) list of directories given by the environment
56
\fB\-o\fP \fIoutput-file\fP, \fB\-\-output-name=\fIname\fP
57
Write FIASCO output to the named file, not to Standard Output.
61
is a relative path and the environment variable
63
is a (colon-separated) list of directories, then
65
writes the output file to the first (writable) directory of this
68
write it to the current directory.
71
\fB\-q\fP \fIN\fP, \fB\-\-quality=\fIN\fP
72
Set quality of compression to
74
Quality is 1 (worst) to 100 (best); default is 20.
77
\fB\-v\fP, \fB\-\-version
80
version number, then exit.
83
\fB\-V\fP \fIN\fP, \fB\-\-verbose \fIN\fP
84
Set level of verbosity to
86
Level is 0 (no output at all), 1 (show progress meter), or 2 (show
87
detailed compression statistics); default is 1.
90
\fB\-B\fP \fIN\fP, \fB\-\-progress-meter \fIN\fP
91
Set type of progress-meter to
93
The following types are available; default is 1:
99
RPM style progress bar using 50 hash marks
105
\fB\-f\fP \fIname\fP, \fB\-\-config=\fIname\fP
108
to initialize the options of
112
for an example of the syntax. Options of
114
are set by any of the following methods (in the specified order):
116
1) Global ressource file
117
.B /etc/system.fiascorc
123
4) --config=\fIname\fP
126
\fB\-h\fP, \fB\-\-info
127
Print brief help, then exit.
130
\fB\-H\fP, \fB\-\-help
131
Print detailed help, then exit.
134
The options for advanced users are:
137
\fB\-b\fP \fIname\fP, \fB\-\-basis-name=\fIname\fP
138
Preload compression basis \fIname\fP into FIASCO. The basis \fIname\fP
139
provides the initial compression dictionary. Either use one of the
140
files "small.fco", "medium.fco", or "large.fco" that come with
142
or create a new ASCII basis file.
145
\fB\-z\fP \fIN\fP, \fB\-\-optimize=\fIN\fP Set optimization level to
146
\fIN\fP. Level is 0 (fastes) to 3 (slowest); default is 1. Be warned,
147
the encoding time dramatically increased when \fIN\fP=\fB2\fP or
148
\fIN\fP=\fB3\fP while the compression performance only slightly
152
\fB\-P\fP, \fB\-\-prediction
153
Use additional predictive coding. If this optimization is enabled then
154
the image is compressed in two steps. In the first step, a coarse
155
approximation of the image is computed using large unichrome
156
blocks. Finally, the delta image is computed and the prediction error
157
is approximated using the standard FIASCO algorithm.
160
\fB\-D\fP \fIN\fP, \fB\-\-dictionary-size=\fIN\fP
161
Set size of dictionary that is used when coding the luminance
162
band to \fIN\fP; default is 10000, i.e., the dictionary is not
166
\fB\-C\fP \fIN\fP, \fB\-\-chroma-dictionary=\fIN\fP
167
Set size of dictionary that is used when coding chroma bands to
168
\fIN\fP; default is 40.
171
\fB\-Q\fP \fIN\fP, \fB\-\-chroma-qfactor=\fIN\fP
172
Reduce the quality of chroma band compression \fIN\fP-times with
173
respect to the user defined quality \fIq\fP of the luminance
174
band compression (\fB\-\-quality\fP=\fIq\fP); default is 2.
177
\fB\-t\fP \fIN\fP, \fB\-\-tiling-exponent=\fIN\fP
178
Subdivide the image into 2^\fIN\fP tiles prior coding; default is 4,
179
i.e. the image is subdivided into 16 tiles. The processing order of
180
the individual tiles is defined by the option
181
\fB\-\-tiling-method=\fIname\fP.
184
\fB\-T\fP \fIname\fP, \fB\-\-tiling-method=\fIname\fP
185
Order the individual image tiles (the image is subdivided into; see
186
option \fB\-\-tiling-exponent=\fP\fIN\fP) by method \fIname\fP; default
189
\fBdesc-variance\fP: Tiles with small variances are processed first.
191
\fBasc-variance\fP: Tiles with large variances are processed first.
193
\fBdesc-spiral\fP: Tiles are process in spiral order starting in the
196
\fBasc-spiral\fP: Tiles are process in spiral order starting at the
200
\fB\-\-rpf-mantissa=\fIN\fP
201
Use \fIN\fP mantissa bits for quantized coefficients.
204
\fB\-\-dc-rpf-mantissa=\fIN\fP
205
Use \fIN\fP mantissa bits for quantized DC coefficients.
208
\fB\-\-rpf-range=\fIN\fP
209
Coefficients outside the quantization interval [-\fIN\fP,+\fIN\fP] are
213
\fB\-\-dc-rpf-range=\fIN\fP
214
DC coefficients outside the quantization interval [-\fIN\fP,+\fIN\fP] are
218
Additional options for video compression are:
221
\fB\-s\fP \fIN\fP, \fB\-\-smooth=\fIN\fP
222
Smooth decompressed reference frames along the partitioning borders by
223
the given amount \fIN\fP. \fIN\fP is 0 (no smoothing) to 100; default
224
is 70. This factor is stored in the FIASCO file.
227
\fB\-m\fP \fIN\fP, \fB\-\-min-level=\fIN\fP
228
Start prediction (motion compensated prediction or additional prediction) on
229
block level \fIN\fP; default is level 6. I.e., motion compensation is
230
applied to all image blocks of at least 8x8 pixels (binary tree level
231
\fIN\fP=6), 16x8 (\fIN\fP=7), 16x16 (\fIN\fP=8), etc.
234
\fB\-M\fP \fIN\fP, \fB\-\-max-level=\fIN\fP
235
Stop prediction (motion compensated prediction or additional prediction) on
236
block level \fIN\fP; default is level 10. I.e., motion compensation is
237
applied to all image blocks of at most 16x16 pixels (\fIN\fP=8),
238
32x16 (\fIN\fP=9), 32x32 (\fIN\fP=10), etc.
241
\fB\-2\fP, \fB\-\-half-pixel
242
Use half pixel precise motion compensation.
245
\fB\-F\fP \fIN\fP, \fB\-\-fps=\fIN\fP
246
Set number of frames per second to \fIN\fP. This value is stored in
247
the FIASCO output file and is used in the decoder dfiasco(1) to control the
251
\fB\-p\fP \fItype\fP, \fB\-\-pattern=\fItype\fP
252
Defines the type of inter frame compression which should be applied to
253
individual frames of a video stream. \fItype\fP is a sequence of
254
characters; default is "IPPPPPPPPP". Element \fBN\fP defines the type
255
of predicting which should be used for frame \fBN\fP; the frame type
256
pattern is periodically extended. Valid characters are:
258
\fBI\fP: intra frame, i.e., no motion compensated prediction is used at
261
\fBP\fP: predicted frame, i.e., a previously encoded frame is used for
262
prediction (forward prediction).
264
\fBB\fP: bidirectional predicted frame, i.e., not only a previously
265
shown frame but also a frame of the future is used for prediction
266
(forward, backward or interpolated prediction).
269
\fB\-\-cross-B-search
270
Instead of using exhaustive search the "Cross-B-Search" algorithm
271
is used to find the best interpolated prediction of B-frames.
275
Also use previously encoded B-frames when prediction the current
276
frame. If this option is not set, only I- and P-frames are used to
277
predict the current frame.
281
pnmtofiasco < foo.ppm >foo.wfa
282
Compress the still image "foo.ppm" to the FIASCO file "foo.wfa" using
286
pnmtofiasco -2 -p "IBBPBBPBB" -fps 15 -o video.wfa foo0*.ppm
287
Compress the video frames "foo0*.ppm" to the FIASCO file "video.wfa" using
288
half pixel precise motion compensation at a frame rate of 15 frames
289
per second. Intra frame 1 is used to predict P-frame 4, frames 1 and 4
290
are used to predict B-frames 2 and 3, and so on. Frame 10 is again an
297
.B /etc/system.fiascorc
298
The systemwide initialization file.
301
The personal initialization file.
308
Search path for image files. Default is "./".
311
Search and save path for FIASCO files. Default is "./".
323
Ullrich Hafner, Juergen Albert, Stefan Frank, and Michael Unger.
324
\fBWeighted Finite Automata for Video Compression\fP, IEEE Journal on
325
Selected Areas In Communications, January 1998
327
Ullrich Hafner. \fBLow Bit-Rate Image and Video Coding with Weighted
328
Finite Automata\fP, Ph.D. thesis, Mensch & Buch Verlag, ISBN
329
3-89820-002-7, October 1999.
332
Ullrich Hafner <hafner@bigfoot.de>