Debian Codegraph @

upstream/fedora-44/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" 0 "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-r\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--framerate=\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--help\fP
135 Print help, then exit.
136
137
138
139
140 .UN examples
141 .SH EXAMPLES
142
143 .nf
144 fiascotopnm foo.wfa >foo.ppm
145
146 .fi
147 .PP
148 Decompress the FIASCO file "foo.wfa" and store it as
149 "foo.ppm".
150
151 .nf
152 fiascotopnm -o foo1.wfa foo2.wfa
153
154 .fi
155 .PP
156 Decompress the FIASCO files "foo1.wfa" and
157 "foo2.wfa" and write the frames to the image files
158 "foo1.wfa.ppm" and "foo2.wfa.ppm".
159
160 .nf
161 fiascotopnm -oimage foo1.wfa
162
163 .fi
164 .PP
165 Decompress the FIASCO file "foo1.wfa" and write all 15
166 frames to the image files "image.00.ppm", ... ,
167 "image.14.ppm".
168
169 .nf
170 fiascotopnm --fast --magnify=-1 --double video.wfa >stream.ppm
171
172 .fi
173 .PP
174 Decompress the FIASCO file "video.wfa". The
175 decompression speed is as fast as possible: the image is decompressed
176 (in 4:2:0 format) at a quarter of its original size; then the image is
177 enlarged again by pixel doubling.
178
179 .UN files
180 .SH FILES
181
182
183 .TP
184 \fB/etc/system.fiascorc\fP
185 The systemwide initialization file.
186
187 .TP
188 $HOME\fB/.fiascorc\fP
189 The personal initialization file.
190
191
192
193 .UN environment
194 .SH ENVIRONMENT
195
196
197 .TP
198 \fBFIASCO_IMAGES\fP
199 Save path for image files. Default is "./".
200
201 .TP
202 \fBFIASCO_DATA\fP
203 Search path for FIASCO files. Default is "./".
204
205
206
207
208 .UN seealso
209 .SH SEE ALSO
210 .BR "pnmtofiasco" (1)\c
211 \&,
212 .BR "pnm" (1)\c
213 \&
214 .PP
215 Ullrich Hafner, Juergen Albert, Stefan Frank, and Michael Unger.
216 \fBWeighted Finite Automata for Video Compression\fP, IEEE Journal on
217 Selected Areas In Communications, January 1998
218 Ullrich Hafner. \fBLow Bit-Rate Image and Video Coding with Weighted
219 Finite Automata\fP, Ph.D. thesis, Mensch & Buch Verlag, ISBN
220 3-89820-002-7, October 1999.
221
222 .UN author
223 .SH AUTHOR
224
225 Ullrich Hafner <\[email protected]\fP>
226 .SH DOCUMENT SOURCE
227 This manual page was generated by the Netpbm tool 'makeman' from HTML
228 source. The master documentation is at
229 .IP
230 .B http://netpbm.sourceforge.net/doc/fiascotopnm.html
231 .PP