Penguin
Recent Changes
Blame: pnmtofiasco(1)
EditPageHistoryDiffInfoLikePages
Annotated edit history of pnmtofiasco(1) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 pnmmtofiasco
2 !!!pnmmtofiasco
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 EXAMPLES
8 FILES
9 ENVIRONMENT
10 SEE ALSO
11 AUTHOR
12 ----
13 !!NAME
14
15
16 pnmtofiasco - Convert PNM file to FIASCO compressed file
17 !!SYNOPSIS
18
19
20 __pnmtofiasco__ [[''option'']...
21 [[''filename'']...
22 !!DESCRIPTION
23
24
25 __pnmtofiasco__ compresses the named pbm, pgm, or ppm
26 image files, or Standard Input if no file is named, and
27 produces a FIASCO file on Standard Output.
28 !!OPTIONS
29
30
31 All option names may be abbreviated; for example, --optimize
32 may be written --optim or --opt. For most options a one
33 letter short option is provided. Mandatory or optional
34 arguments to long options are mandatory or optional for
35 short options, too. Both short and long options are case
36 sensitive.
37
38
39 The basic options are:
40
41
42 __-i__ ''name'',
43 __--input-name=__''name''
44
45
46 Compress the named images, not Standard Input. If
47 ''name'' is __-__, read Standard Input. ''name''
48 has to be either an image filename or a template of the
49 form:
50 prefix[[start-end{+,-}step]suffix
51 Templates are useful when compressing video streams:
52 e.g., if you specify the template __img0[[12-01-2].pgm__,
53 then __pnmtofiasco__ compresses the images img012.pgm,
54 img010.pgm, ..., img002.pgm.
55 If ''name'' is a relative path, __pnmtofiasco__
56 searches for the image files in the current directory and in
57 the (colon-separated) list of directories given by the
58 environment variable __FIASCO_IMAGES__.
59
60
61 __-o__ ''output-file'', __--output-name=__''name''
62
63
64 Write FIASCO output to the named file, not to Standard
65 Output.
66
67
68 If ''name'' is a relative path and the environment
69 variable __FIASCO_DATA__ is a (colon-separated) list of
70 directories, then __pnmtofiasco__ writes the output file
71 to the first (writable) directory of this list. Otherwise,
72 __pnmtofiasco__ write it to the current
73 directory.
74
75
76 __-q__ ''N'', __--quality=__''N''
77
78
79 Set quality of compression to ''N''. Quality is 1 (worst)
80 to 100 (best); default is 20.
81
82
83 __-v__, __--version__
84
85
86 Print __pnmtofiasco__ version number, then
87 exit.
88
89
90 __-V__ ''N'', __--verbose__ ''N''
91
92
93 Set level of verbosity to ''N''. Level is 0 (no output at
94 all), 1 (show progress meter), or 2 (show detailed
95 compression statistics); default is 1.
96
97
98 __-B__ ''N'', __--progress-meter__
99 ''N''
100
101
102 Set type of progress-meter to ''N''. The following types
103 are available; default is 1:
104
105
106 __0__: no progress meter
107
108
109 __1__: RPM style progress bar using 50 hash
110 marks
111
112
113 __2__: percentage meter
114
115
116 __-f__ ''name'',
117 __--config=__''name''
118
119
120 Load parameter file ''name'' to initialize the options of
121 __pnmtofiasco__. See file __system.fiascorc__ for an
122 example of the syntax. Options of __pnmtofiasco__ are set
123 by any of the following methods (in the specified
124 order):
125
126
127 1) Global ressource file
128 __/etc/system.fiascorc__
129
130
131 2) $HOME/.fiascorc
132
133
134 3) command line
135
136
137 4) --config=''name''
138
139
140 __-h__, __--info__
141
142
143 Print brief help, then exit.
144
145
146 __-H__, __--help__
147
148
149 Print detailed help, then exit.
150
151
152 The options for advanced users are:
153
154
155 __-b__ ''name'',
156 __--basis-name=__''name''
157
158
159 Preload compression basis ''name'' into FIASCO. The basis
160 ''name'' provides the initial compression dictionary.
161 Either use one of the files
162 ''pnmtofiasco__ or create a new ASCII basis
163 file.
164
165
166 __-z__ ''N'', __--optimize=__''N'' __Set
167 optimization level to__
168
169
170 ''N''. Level is 0 (fastes) to 3 (slowest); default is 1.
171 Be warned, the encoding time dramatically increased when
172 ''N''=__2__ or ''N''=__3__ while the compression
173 performance only slightly improves.
174
175
176 __-P__, __--prediction__
177
178
179 Use additional predictive coding. If this optimization is
180 enabled then the image is compressed in two steps. In the
181 first step, a coarse approximation of the image is computed
182 using large unichrome blocks. Finally, the delta image is
183 computed and the prediction error is approximated using the
184 standard FIASCO algorithm.
185
186
187 __-D__ ''N'',
188 __--dictionary-size=__''N''
189
190
191 Set size of dictionary that is used when coding the
192 luminance band to ''N''; default is 10000, i.e., the
193 dictionary is not restricted.
194
195
196 __-C__ ''N'',
197 __--chroma-dictionary=__''N''
198
199
200 Set size of dictionary that is used when coding chroma bands
201 to ''N''; default is 40.
202
203
204 __-Q__ ''N'',
205 __--chroma-qfactor=__''N''
206
207
208 Reduce the quality of chroma band compression ''N''-times
209 with respect to the user defined quality ''q'' of the
210 luminance band compression (__--quality__=''q'');
211 default is 2.
212
213
214 __-t__ ''N'',
215 __--tiling-exponent=__''N''
216
217
218 Subdivide the image into 2^''N'' tiles prior coding;
219 default is 4, i.e. the image is subdivided into 16 tiles.
220 The processing order of the individual tiles is defined by
221 the option
222 __--tiling-method=__''name''__.__
223
224
225 __-T__ ''name''__,
226 --tiling-method=__''name''
227
228
229 Order the individual image tiles (the image is subdivided
230 into; see option __--tiling-exponent=__''N'') by
231 method ''name''; default is
232 ''
233
234
235 __desc-variance__: Tiles with small variances are
236 processed first.
237
238
239 __asc-variance__: Tiles with large variances are
240 processed first.
241
242
243 __desc-spiral__: Tiles are process in spiral order
244 starting in the middle.
245
246
247 __asc-spiral__: Tiles are process in spiral order
248 starting at the border.
249
250
251 __--rpf-mantissa=__''N''
252
253
254 Use ''N'' mantissa bits for quantized
255 coefficients.
256
257
258 __--dc-rpf-mantissa=__''N''
259
260
261 Use ''N'' mantissa bits for quantized DC
262 coefficients.
263
264
265 __--rpf-range=__''N''
266
267
268 Coefficients outside the quantization interval
269 [[-''N'',+''N''] are set to zero.
270
271
272 __--dc-rpf-range=__''N''
273
274
275 DC coefficients outside the quantization interval
276 [[-''N'',+''N''] are set to zero.
277
278
279 Additional options for video compression are:
280
281
282 __-s__ ''N'', __--smooth=__''N''
283
284
285 Smooth decompressed reference frames along the partitioning
286 borders by the given amount ''N''. ''N'' is 0 (no
287 smoothing) to 100; default is 70. This factor is stored in
288 the FIASCO file.
289
290
291 __-m__ ''N'', __--min-level=__''N''
292
293
294 Start prediction (motion compensated prediction or
295 additional prediction) on block level ''N''; default is
296 level 6. I.e., motion compensation is applied to all image
297 blocks of at least 8x8 pixels (binary tree level
298 ''N''=6), 16x8 (''N''=7), 16x16 (''N''=8),
299 etc.
300
301
302 __-M__ ''N'', __--max-level=__''N''
303
304
305 Stop prediction (motion compensated prediction or additional
306 prediction) on block level ''N''; default is level 10.
307 I.e., motion compensation is applied to all image blocks of
308 at most 16x16 pixels (''N''=8), 32x16 (''N''=9), 32x32
309 (''N''=10), etc.
310
311
312 __-2__, __--half-pixel__
313
314
315 Use half pixel precise motion compensation.
316
317
318 __-F__ ''N'', __--fps=__''N''
319
320
321 Set number of frames per second to ''N''. This value is
322 stored in the FIASCO output file and is used in the decoder
323 dfiasco(1) to control the framerate.
324
325
326 __-p__ ''type'',
327 __--pattern=__''type''
328
329
330 Defines the type of inter frame compression which should be
331 applied to individual frames of a video stream. ''type''
332 is a sequence of characters; default is
333 ''N__ defines the type of
334 predicting which should be used for frame __N__; the
335 frame type pattern is periodically extended. Valid
336 characters are:
337
338
339 __I__: intra frame, i.e., no motion compensated
340 prediction is used at all.
341
342
343 __P__: predicted frame, i.e., a previously encoded frame
344 is used for prediction (forward prediction).
345
346
347 __B__: bidirectional predicted frame, i.e., not only a
348 previously shown frame but also a frame of the future is
349 used for prediction (forward, backward or interpolated
350 prediction).
351
352
353 __--cross-B-search__
354
355
356 Instead of using exhaustive search the
357
358
359 __--B-as-past-ref__
360
361
362 Also use previously encoded B-frames when prediction the
363 current frame. If this option is not set, only I- and
364 P-frames are used to predict the current frame.
365 !!EXAMPLES
366
367
368 pnmtofiasco
369
370
371 Compress the still image
372
373
374 pnmtofiasco -2 -p
375
376
377 Compress the video frames
378 !!FILES
379
380
381 __/etc/system.fiascorc__
382
383
384 The systemwide initialization file.
385
386
387 $HOME__/.fiascorc__
388
389
390 The personal initialization file.
391 !!ENVIRONMENT
392
393
394 __FIASCO_IMAGES__
395
396
397 Search path for image files. Default is
398
399
400 __FIASCO_DATA__
401
402
403 Search and save path for FIASCO files. Default is
404 !!SEE ALSO
405
406
407 fiascotopnm(1), ppmtojpeg(1),
408 pnmtojbig(1), ppmtogif(1),
409 pnm(5)
410
411
412 Ullrich Hafner, Juergen Albert, Stefan Frank, and Michael
413 Unger. __Weighted Finite Automata for Video
414 Compression__, IEEE Journal on Selected Areas In
415 Communications, January 1998
416 Ullrich Hafner. __Low Bit-Rate Image and Video Coding with
417 Weighted Finite Automata__, Ph.D. thesis, Mensch
418 __
419 !!AUTHOR
420
421
422 Ullrich Hafner
423 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.