1Pnmtofiasco User Manual(0) Pnmtofiasco User Manual(0)
2
6 pnmtofiasco - Convert PNM file to FIASCO compressed file
7
10 pnmtofiasco [option]... [filename]...
11
14 This program is part of Netpbm(1).
15 pnmtofiasco compresses the named pbm, pgm, or ppm image files, or Stan‐
17 dard Input if no file is named, and produces a FIASCO file on Standard
18 Output.
19
22 In addition to the options common to all programs based on libnetpbm
23 (most notably -quiet, see
24 Common Options ⟨index.html#commonoptions⟩ ), pnmtofiasco recognizes
25 the following command line options:
26 All option names may be abbreviated; for example, --optimize may be
28 written --optim or --opt. For most options a one letter short option is
29 provided. Mandatory or optional arguments to long options are manda‐
30 tory or optional for short options, too. Both short and long options
31 are case sensitive.
32 Basic Options
35 -i name, --input-name=name
36 Compress the named images, not Standard Input. If name is -,
37 read Standard Input. name has to be either an image filename or
38 a template of the form:
39 prefix[start-end{+,-}step]suffix
41 Templates are useful when compressing video streams: e.g., if
44 you specify the template img0[12-01-2].pgm, then pnmtofiasco
45 compresses the images img012.pgm, img010.pgm, ..., img002.pgm.
46 If name is a relative path, pnmtofiasco searches for the image
48 files in the current directory and in the (colon-separated) list
49 of directories given by the environment variable FIASCO_IMAGES.
50 -o output-file, --output-name=name
53 Write FIASCO output to the named file, not to Standard Output.
54 If name is a relative path and the environment variable FI‐
56 ASCO_DATA is a (colon-separated) list of directories, then pn‐
57 mtofiasco writes the output file to the first (writable) direc‐
58 tory of this list. Otherwise, pnmtofiasco write it to the cur‐
59 rent directory.
60 -q N, --quality=N
63 Set quality of compression to N. Quality is 1 (worst) to 100
64 (best); default is 20.
65 -v, --version
68 Print pnmtofiasco version number, then exit.
69 -V N, --verbose N
72 Set level of verbosity to N. Level is 0 (no output at all), 1
73 (show progress meter), or 2 (show detailed compression statis‐
74 tics); default is 1.
75 -B N, --progress-meter N
78 Set type of progress-meter to N. The following types are avail‐
79 able; default is 1:
80 0 no progress meter
84 1 RPM style progress bar using 50 hash marks
87 2 percentage meter
90 -f name, --config=name
95 Load parameter file name to initialize the options of pnmtofi‐
96 asco. See file system.fiascorc for an example of the syntax.
97 Options of pnmtofiasco are set by any of the following methods
98 (in the specified order):
99 • Global resource file /etc/system.fiascorc
103 • $HOME/.fiascorc
105 • command line
107 • --config=name
109 -h, --info
113 Print brief help, then exit.
114 -H, --help
117 Print detailed help, then exit.
118 Options for Advanced Users
123 -b name, --basis-name=name
124 Preload compression basis name into FIASCO. The basis name pro‐
125 vides the initial compression dictionary. Either use one of the
126 files "small.fco", "medium.fco", or "large.fco" that come with
127 pnmtofiasco or create a new ASCII basis file.
128 -z N, --optimize=N
131 Set optimization level to N. Level is 0 (fastest) to 3 (slow‐
132 est); default is 1. Be warned, the encoding time dramatically
133 increased when N=2 or N=3 while the compression performance only
134 slightly improves.
135 -P, --prediction
138 Use additional predictive coding. If this optimization is en‐
139 abled then the image is compressed in two steps. In the first
140 step, a coarse approximation of the image is computed using
141 large unichrome blocks. Finally, the delta image is computed
142 and the prediction error is approximated using the standard FI‐
143 ASCO algorithm.
144 -D N, --dictionary-size=N
147 Set size of dictionary that is used when coding the luminance
148 band to N; default is 10000, i.e., the dictionary is not re‐
149 stricted.
150 -C N, --chroma-dictionary=N
153 Set size of dictionary that is used when coding chroma bands to
154 N; default is 40.
155 -Q N, --chroma-qfactor=N
158 Reduce the quality of chroma band compression N-times with re‐
159 spect to the user defined quality q of the luminance band com‐
160 pression (--quality=q); default is 2.
161 -t N, --tiling-exponent=N
164 Subdivide the image into 2^N tiles prior coding; default is 4,
165 i.e. the image is subdivided into 16 tiles. The processing order
166 of the individual tiles is defined by the option --tiling-
167 method=name.
168 -T name, --tiling-method=name
171 Order the individual image tiles (the image is subdivided into;
172 see option --tiling-exponent=N) by method name; default is desc-
173 variance.
174 desc-variance
178 Tiles with small variances are processed first.
179 asc-variance
182 Tiles with large variances are processed first.
183 desc-spiral
186 Tiles are process in spiral order starting in the middle.
187 asc-spiral
190 Tiles are process in spiral order starting at the border.
191 --rpf-mantissa=N
196 Use N mantissa bits for quantized coefficients.
197 --dc-rpf-mantissa=N
200 Use N mantissa bits for quantized DC coefficients.
201 --rpf-range=N
204 Coefficients outside the quantization interval [-N,+N] are set
205 to zero.
206 --dc-rpf-range=N
209 DC coefficients outside the quantization interval [-N,+N] are
210 set to zero.
211 Additional Options for Video Compression
216 -s N, --smooth=N
217 Smooth decompressed reference frames along the partitioning bor‐
218 ders by the given amount N. N is 0 (no smoothing) to 100; de‐
219 fault is 70. This factor is stored in the FIASCO file.
220 -m N, --min-level=N
223 Start prediction (motion compensated prediction or additional
224 prediction) on block level N; default is level 6. I.e., motion
225 compensation is applied to all image blocks of at least 8x8 pix‐
226 els (binary tree level N=6), 16x8 (N=7), 16x16 (N=8), etc.
227 -M N, --max-level=N
230 Stop prediction (motion compensated prediction or additional
231 prediction) on block level N; default is level 10. I.e., motion
232 compensation is applied to all image blocks of at most 16x16
233 pixels (N=8), 32x16 (N=9), 32x32 (N=10), etc.
234 -2, --half-pixel
237 Use half pixel precise motion compensation.
238 -F N, --fps=N
241 Set number of frames per second to N. This value is stored in
242 the FIASCO output file and is used in the decoder fiascotopnm(1)
243 to control the framerate.
244 -p type, --pattern=type
247 Defines the type of inter frame compression which should be ap‐
248 plied to individual frames of a video stream. type is a se‐
249 quence of characters; default is "IPPPPPPPPP". Element N de‐
250 fines the type of predicting which should be used for frame N;
251 the frame type pattern is periodically extended. Valid charac‐
252 ters are:
253 I intra frame, i.e., no motion compensated prediction is used at
257 all.
258 P predicted frame, i.e., a previously encoded frame is used for
261 prediction (forward prediction).
262 B bidirectional predicted frame, i.e., not only a previously shown
265 frame but also a frame of the future is used for prediction
266 (forward, backward or interpolated prediction).
267 --cross-B-search
272 Instead of using exhaustive search the "Cross-B-Search" algo‐
273 rithm is used to find the best interpolated prediction of B-
274 frames.
275 --B-as-past-ref
278 Also use previously encoded B-frames when prediction the current
279 frame. If this option is not set, only I- and P-frames are used
280 to predict the current frame.
281
287 Compress the still image "foo.ppm" to the FIASCO file "foo.wfa" using
288 the default options:
289 pnmtofiasco < foo.ppm >foo.wfa
291 Compress the video frames "foo0*.ppm" to the FIASCO file "video.wfa"
294 using half pixel precise motion compensation at a frame rate of 15
295 frames per second. Intra frame 1 is used to predict P-frame 4, frames
296 1 and 4 are used to predict B-frames 2 and 3, and so on. Frame 10 is
297 again an intra-frame.
298 pnmtofiasco -2 -p "IBBPBBPBB" -fps 15 -o video.wfa foo0*.ppm
300
304 /etc/system.fiascorc
305 The systemwide initialization file.
306 $HOME/.fiascorc
309 The personal initialization file.
310
315 FIASCO_IMAGES
316 Search path for image files. Default is "./".
317 FIASCO_DATA
320 Search and save path for FIASCO files. Default is "./".
321
326 fiascotopnm(1), pnmtojpeg(1), pnmtojbig(1), pamtogif(1), pnm(1)
327 Ullrich Hafner, Juergen Albert, Stefan Frank, and Michael Unger.
329 Weighted Finite Automata for Video Compression, IEEE Journal on Se‐
330 lected Areas In Communications, January 1998
331 Ullrich Hafner. Low Bit-Rate Image and Video Coding with Weighted Fi‐
333 nite Automata, Ph.D. thesis, Mensch & Buch Verlag, ISBN 3-89820-002-7,
334 October 1999.
335 FIASCO: An Open-Source Fractal Image and Sequence Codec, Linux Journal,
337 January 2001.
338
341 Ullrich Hafner <hafner@bigfoot.de>
342
344 This manual page was generated by the Netpbm tool 'makeman' from HTML
345 source. The master documentation is at
346 http://netpbm.sourceforge.net/doc/pnmtofiasco.html
348netpbm documentation 12 July 2000 Pnmtofiasco User Manual(0)