diff options
Diffstat (limited to 'upstream/opensuse-tumbleweed/man1/fiascotopnm.1')
| -rw-r--r-- | upstream/opensuse-tumbleweed/man1/fiascotopnm.1 | 235 |
1 files changed, 235 insertions, 0 deletions
diff --git a/upstream/opensuse-tumbleweed/man1/fiascotopnm.1 b/upstream/opensuse-tumbleweed/man1/fiascotopnm.1 new file mode 100644 index 00000000..bfae99a8 --- /dev/null +++ b/upstream/opensuse-tumbleweed/man1/fiascotopnm.1 @@ -0,0 +1,235 @@ +\ +.\" This man page was generated by the Netpbm tool 'makeman' from HTML source. +.\" Do not hand-hack it! If you have bug fixes or improvements, please find +.\" the corresponding HTML page on the Netpbm website, generate a patch +.\" against that, and send it to the Netpbm maintainer. +.TH "Fiascotopnm User Manual" 0 "12 July 2000" "netpbm documentation" + +.SH NAME +fiascotopnm - Convert compressed FIASCO image to PGM, or PPM + +.UN synopsis +.SH SYNOPSIS + +\fBfiascotopnm \fP +[\fIoption\fP]... +[\fIfilename\fP]... +.PP +All option names may be abbreviated; for example, --output may be +written --outp or --ou. For all options an one letter short option +is provided. Mandatory or optional arguments to long options are +mandatory or optional for short options, too. Both short and long +options are case sensitive. + + +.UN description +.SH DESCRIPTION +.PP +This program is part of +.BR "Netpbm" (1)\c +\&. +.PP +\fBfiascotopnm\fP decompresses the named FIASCO files, or the +Standard Input if no file is named, and writes the images as PGM, or +PPM files, depending on whether the FIASCO image is black and white or +color. + +.UN options +.SH OPTIONS +.PP +In addition to the options common to all programs based on libnetpbm +(most notably \fB-quiet\fP, see +.UR index.html#commonoptions + Common Options +.UE +\&), \fBfiascotopnm\fP recognizes the following +command line options: + + +.TP +\fB-o\fP[\fIname\fP], \fB--output=\fP[\fIname\fP] + Write decompressed image to the file \fIname\fP.ppm (if PPM) or +\fIname\fP.pgm (if PGM). If \fIname\fP is \fB-\fP, then produce +the image file on the standard output. The optional argument +\fIname\fP can be omitted, then the input filename is used as +basename with the suffix .ppm or .pgm. In case of video streams, the +frames are stored in the files \fIname\fP.\fBN\fP.ppm where \fBN\fP +is the frame number (of the form 00..0 - 99..9); output on the +standard output is not possible with video streams. +.sp + If \fIname\fP is a relative path and the environment variable +\fBFIASCO_IMAGES\fP is a (colon-separated) list of directories, then +the output file(s) are written to the first (writable) directory of +this list. Otherwise, the current directory is used to store the +output file(s). + +.TP +\fB-z\fP, \fB--fast\fP +Decompress images in the 4:2:0 format; i.e., each chroma channel is +decompressed to an image of halved width and height. Use this option +on slow machines when the desired frame rate is not achieved; the +output quality is only slightly decreased. + +.TP +\fB-d\fP, \fB--double\fP +Double the size of the X11 window both in width and height; no pixel +interpolation is used, each pixel is just replaced by four identical +pixels. + +.TP +\fB-p\fP, \fB--panel\fP +Show a panel with play, stop, pause, record and exit buttons to +control the display of videos. When pressing the record button, all +frames are decompressed and stored in memory. The other buttons work +in the usual way. + +.TP +\fB-m\fP \fIN\fP, \fB--magnify=\fP\fIN\fP +Set magnification of the decompressed image. Positive values enlarge +and negative values reduce the image width and height by a factor of +2^|\fIN\fP|. + +.TP +\fB-s\fP \fIN\fP, \fB--smoothing=\fP\fIN\fP +Smooth decompressed image(s) along the partitioning borders by the +given amount \fIN\fP. \fIN\fP is 1 (minimum) to 100 (maximum); default +is 70. When \fIN\fP=0, then the smoothing amount specified in the +FIASCO file is used (defined by the FIASCO coder). + +.TP +\fB-F\fP \fIN\fP, \fB--fps=\fP\fIN\fP +Set number of frames per second to \fIN\fP. When using this option, +the frame rate specified in the FIASCO file is overridden. + +.TP +\fB--verbose=\fP\fIN\fP +Set verbose of \fBfiascotopnm\fP to \fIN\fP. + +.TP +\fB-v\fP, \fB--version\fP +Print \fBfiascotopnm\fP version number, then exit. + +.TP +\fB-f\fP \fIname\fP, \fB--config=\fP\fIname\fP +Load parameter file \fIname\fP to initialize the options of +\fBfiascotopnm\fP. See file \fBsystem.fiascorc\fP for an example of +the syntax. Options of \fBfiascotopnm \fP are set by any of the +following methods (in the specified order): + + +.IP \(bu +Global resource file \fB/etc/system.fiascorc\fP + +.IP \(bu +$HOME\fB/.fiascorc\fP + +.IP \(bu +command line + +.IP \(bu +--config=\fIname\fP + + +.TP +\fB-h\fP, \fB--info\fP +Print brief help, then exit. + +.TP +\fB-H\fP, \fB--help\fP +Print detailed help, then exit. + + + + +.UN examples +.SH EXAMPLES + +.nf +fiascotopnm foo.wfa >foo.ppm + +.fi +.PP +Decompress the FIASCO file "foo.wfa" and store it as +"foo.ppm". + +.nf +fiascotopnm -o foo1.wfa foo2.wfa + +.fi +.PP +Decompress the FIASCO files "foo1.wfa" and +"foo2.wfa" and write the frames to the image files +"foo1.wfa.ppm" and "foo2.wfa.ppm". + +.nf +fiascotopnm -oimage foo1.wfa + +.fi +.PP +Decompress the FIASCO file "foo1.wfa" and write all 15 +frames to the image files "image.00.ppm", ... , +"image.14.ppm". + +.nf +fiascotopnm --fast --magnify=-1 --double video.wfa >stream.ppm + +.fi +.PP +Decompress the FIASCO file "video.wfa". The +decompression speed is as fast as possible: the image is decompressed +(in 4:2:0 format) at a quarter of its original size; then the image is +enlarged again by pixel doubling. + +.UN files +.SH FILES + + +.TP +\fB/etc/system.fiascorc\fP +The systemwide initialization file. + +.TP +$HOME\fB/.fiascorc\fP +The personal initialization file. + + + +.UN environment +.SH ENVIRONMENT + + +.TP +\fBFIASCO_IMAGES\fP +Save path for image files. Default is "./". + +.TP +\fBFIASCO_DATA\fP +Search path for FIASCO files. Default is "./". + + + + +.UN seealso +.SH SEE ALSO +.BR "pnmtofiasco" (1)\c +\&, +.BR "pnm" (5)\c +\& +.PP +Ullrich Hafner, Juergen Albert, Stefan Frank, and Michael Unger. +\fBWeighted Finite Automata for Video Compression\fP, IEEE Journal on +Selected Areas In Communications, January 1998 +Ullrich Hafner. \fBLow Bit-Rate Image and Video Coding with Weighted +Finite Automata\fP, Ph.D. thesis, Mensch & Buch Verlag, ISBN +3-89820-002-7, October 1999. + +.UN author +.SH AUTHOR + +Ullrich Hafner <\fIhafner@bigfoot.de\fP> +.SH DOCUMENT SOURCE +This manual page was generated by the Netpbm tool 'makeman' from HTML +source. The master documentation is at +.IP +.B http://netpbm.sourceforge.net/doc/fiascotopnm.html +.PP
\ No newline at end of file |