Adding upstream version 4.22.0.upstream/4.22.0

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 231 insertions, 0 deletions

diff --git a/upstream/mageia-cauldron/man1/fiascotopnm.1 b/upstream/mageia-cauldron/man1/fiascotopnm.1
new file mode 100644
index 00000000..e57945c6
--- /dev/null
+++ b/upstream/mageia-cauldron/man1/fiascotopnm.1
@@ -0,0 +1,231 @@
+\
+.\" 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-r\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--framerate=\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 ressource 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--help\fP
+Print 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" (1)\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