Debian Codegraph @

upstream/debian-unstable/man1/fiascotopnm.1

raw
1 \
2 .\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
3 .\" Do not hand-hack it! If you have bug fixes or improvements, please find
4 .\" the corresponding HTML page on the Netpbm website, generate a patch
5 .\" against that, and send it to the Netpbm maintainer.
6 .TH "Fiascotopnm User Manual" 1 "12 July 2000" "netpbm documentation"
7
8 .SH NAME
9 fiascotopnm - Convert compressed FIASCO image to PGM, or PPM
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBfiascotopnm \fP
15 [\fIoption\fP]...
16 [\fIfilename\fP]...
17 .PP
18 All option names may be abbreviated; for example, --output may be
19 written --outp or --ou. For all options an one letter short option
20 is provided. Mandatory or optional arguments to long options are
21 mandatory or optional for short options, too. Both short and long
22 options are case sensitive.
23
24
25 .UN description
26 .SH DESCRIPTION
27 .PP
28 This program is part of
29 .BR "Netpbm" (1)\c
30 \&.
31 .PP
32 \fBfiascotopnm\fP decompresses the named FIASCO files, or the
33 Standard Input if no file is named, and writes the images as PGM, or
34 PPM files, depending on whether the FIASCO image is black and white or
35 color.
36
37 .UN options
38 .SH OPTIONS
39 .PP
40 In addition to the options common to all programs based on libnetpbm
41 (most notably \fB-quiet\fP, see
42 .UR index.html#commonoptions
43 Common Options
44 .UE
45 \&), \fBfiascotopnm\fP recognizes the following
46 command line options:
47
48
49 .TP
50 \fB-o\fP[\fIname\fP], \fB--output=\fP[\fIname\fP]
51 Write decompressed image to the file \fIname\fP.ppm (if PPM) or
52 \fIname\fP.pgm (if PGM). If \fIname\fP is \fB-\fP, then produce
53 the image file on the standard output. The optional argument
54 \fIname\fP can be omitted, then the input filename is used as
55 basename with the suffix .ppm or .pgm. In case of video streams, the
56 frames are stored in the files \fIname\fP.\fBN\fP.ppm where \fBN\fP
57 is the frame number (of the form 00..0 - 99..9); output on the
58 standard output is not possible with video streams.
59 .sp
60 If \fIname\fP is a relative path and the environment variable
61 \fBFIASCO_IMAGES\fP is a (colon-separated) list of directories, then
62 the output file(s) are written to the first (writable) directory of
63 this list. Otherwise, the current directory is used to store the
64 output file(s).
65
66 .TP
67 \fB-z\fP, \fB--fast\fP
68 Decompress images in the 4:2:0 format; i.e., each chroma channel is
69 decompressed to an image of halved width and height. Use this option
70 on slow machines when the desired frame rate is not achieved; the
71 output quality is only slightly decreased.
72
73 .TP
74 \fB-d\fP, \fB--double\fP
75 Double the size of the X11 window both in width and height; no pixel
76 interpolation is used, each pixel is just replaced by four identical
77 pixels.
78
79 .TP
80 \fB-p\fP, \fB--panel\fP
81 Show a panel with play, stop, pause, record and exit buttons to
82 control the display of videos. When pressing the record button, all
83 frames are decompressed and stored in memory. The other buttons work
84 in the usual way.
85
86 .TP
87 \fB-m\fP \fIN\fP, \fB--magnify=\fP\fIN\fP
88 Set magnification of the decompressed image. Positive values enlarge
89 and negative values reduce the image width and height by a factor of
90 2^|\fIN\fP|.
91
92 .TP
93 \fB-s\fP \fIN\fP, \fB--smoothing=\fP\fIN\fP
94 Smooth decompressed image(s) along the partitioning borders by the
95 given amount \fIN\fP. \fIN\fP is 1 (minimum) to 100 (maximum); default
96 is 70. When \fIN\fP=0, then the smoothing amount specified in the
97 FIASCO file is used (defined by the FIASCO coder).
98
99 .TP
100 \fB-F\fP \fIN\fP, \fB--fps=\fP\fIN\fP
101 Set number of frames per second to \fIN\fP. When using this option,
102 the frame rate specified in the FIASCO file is overridden.
103
104 .TP
105 \fB--verbose=\fP\fIN\fP
106 Set verbose of \fBfiascotopnm\fP to \fIN\fP.
107
108 .TP
109 \fB-v\fP, \fB--version\fP
110 Print \fBfiascotopnm\fP version number, then exit.
111
112 .TP
113 \fB-f\fP \fIname\fP, \fB--config=\fP\fIname\fP
114 Load parameter file \fIname\fP to initialize the options of
115 \fBfiascotopnm\fP. See file \fBsystem.fiascorc\fP for an example of
116 the syntax. Options of \fBfiascotopnm \fP are set by any of the
117 following methods (in the specified order):
118
119
120 .IP \(bu
121 Global resource file \fB/etc/system.fiascorc\fP
122
123 .IP \(bu
124 $HOME\fB/.fiascorc\fP
125
126 .IP \(bu
127 command line
128
129 .IP \(bu
130 --config=\fIname\fP
131
132
133 .TP
134 \fB-h\fP, \fB--info\fP
135 Print brief help, then exit.
136
137 .TP
138 \fB-H\fP, \fB--help\fP
139 Print detailed help, then exit.
140
141
142
143
144 .UN examples
145 .SH EXAMPLES
146
147 .nf
148 fiascotopnm foo.wfa >foo.ppm
149
150 .fi
151 .PP
152 Decompress the FIASCO file "foo.wfa" and store it as
153 "foo.ppm".
154
155 .nf
156 fiascotopnm -o foo1.wfa foo2.wfa
157
158 .fi
159 .PP
160 Decompress the FIASCO files "foo1.wfa" and
161 "foo2.wfa" and write the frames to the image files
162 "foo1.wfa.ppm" and "foo2.wfa.ppm".
163
164 .nf
165 fiascotopnm -oimage foo1.wfa
166
167 .fi
168 .PP
169 Decompress the FIASCO file "foo1.wfa" and write all 15
170 frames to the image files "image.00.ppm", ... ,
171 "image.14.ppm".
172
173 .nf
174 fiascotopnm --fast --magnify=-1 --double video.wfa >stream.ppm
175
176 .fi
177 .PP
178 Decompress the FIASCO file "video.wfa". The
179 decompression speed is as fast as possible: the image is decompressed
180 (in 4:2:0 format) at a quarter of its original size; then the image is
181 enlarged again by pixel doubling.
182
183 .UN files
184 .SH FILES
185
186
187 .TP
188 \fB/etc/system.fiascorc\fP
189 The systemwide initialization file.
190
191 .TP
192 $HOME\fB/.fiascorc\fP
193 The personal initialization file.
194
195
196
197 .UN environment
198 .SH ENVIRONMENT
199
200
201 .TP
202 \fBFIASCO_IMAGES\fP
203 Save path for image files. Default is "./".
204
205 .TP
206 \fBFIASCO_DATA\fP
207 Search path for FIASCO files. Default is "./".
208
209
210
211
212 .UN seealso
213 .SH SEE ALSO
214 .BR "pnmtofiasco" (1)\c
215 \&,
216 .BR "pnm" (1)\c
217 \&
218 .PP
219 Ullrich Hafner, Juergen Albert, Stefan Frank, and Michael Unger.
220 \fBWeighted Finite Automata for Video Compression\fP, IEEE Journal on
221 Selected Areas In Communications, January 1998
222 Ullrich Hafner. \fBLow Bit-Rate Image and Video Coding with Weighted
223 Finite Automata\fP, Ph.D. thesis, Mensch & Buch Verlag, ISBN
224 3-89820-002-7, October 1999.
225
226 .UN author
227 .SH AUTHOR
228
229 Ullrich Hafner <\[email protected]\fP>
230 .SH DOCUMENT SOURCE
231 This manual page was generated by the Netpbm tool 'makeman' from HTML
232 source. The master documentation is at
233 .IP
234 .B http://netpbm.sourceforge.net/doc/fiascotopnm.html
235 .PP