1 files changed, 158 insertions, 0 deletions
diff --git a/upstream/mageia-cauldron/man1/ppmfade.1 b/upstream/mageia-cauldron/man1/ppmfade.1
new file mode 100644
index 00000000..70f73f73
--- /dev/null
+++ b/upstream/mageia-cauldron/man1/ppmfade.1
@@ -0,0 +1,158 @@
+\
+.\" 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 "Ppmfade User Manual" 0 "01 April 2000" "netpbm documentation"
+
+.SH NAME
+ppmfade - generate a transition between two image files using special effects
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBppmfade\fP
+[\fB-f\fP \fIfirst.ppm\fP]
+[\fB-l\fP \fIlast.ppm\fP]
+[\fB-mix\fP|\fB-spread\fP|\fB-shift\fP|
+\fB-relief\fP|\fB-oil\fP|\fB-edge\fP|\fB-bentley\fP|\fB-block\fP]
+[\fB-base\fP \fIname\fP]
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBppmfade\fPgenerates a transition between either two input
+images or between one input image and black.  You can use the 30
+intermediate images generated to show a smooth transition between
+segments of a movie.  The input and output images are in the PPM
+format.  If you specify both input images, they should both be the
+same size.  If you want to fade from black to an image, specify only
+the last image.  If you want to fade from an image to black, specify
+only the first image.  \fBppmfade\fP names the resulting image files
+\fIbase\fP\fB.\fP\fInnnn\fP\fB.ppm\fP, where \fInnnn\fP is a
+number varying between 0001 and 0030 and \fIbase\fP is what you
+specify with via the \fB-base\fP option (default \fBfade\fP).
+.PP
+Another way to convert by steps from one image to another is
+morphing.  You can use \fBxmorph\fP to do that.
+
+.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
+\&), \fBppmfade\fP recognizes the following
+command line options:
+
+
+.TP
+\fB-f\fP \fIfirst.ppm\fP
+This is the image file (PPM format) to be used at the beginning of the
+transition.  If you don't specify this, the fade will start from black.
+
+.TP
+\fB-l\fP \fIlast.ppm\fP
+This is the image file (PPM format) to be used at the ending of the
+transition.  If you don't specify this, the fade will end with black.
+
+.TP
+\fB-mix\fP
+The two images are superimposed with the brightness of the first image
+decreasing from full to none and the brightness of the final image
+increasing from none to full.  The transition is quadratic in brightness
+with faster transition in the beginning and slower at the end.
+
+.TP
+\fB-spread\fP
+The pixels in the first image will be moved (spread) further and further
+from their original location and then moved into the proper location in
+the final image.  This is the default transition.
+
+.TP
+\fB-shift\fP
+The pixels in the first image will be shifted further and further horizontally
+from their original location and then moved into the proper location in
+the final image.
+
+.TP
+\fB-relief\fP
+The first image is faded to a Laplacian relief filtered version of the
+first image.  This is then faded to a Laplacian relief filtered version
+of the second image and finally faded to the final image.
+
+.TP
+\fB-oil\fP
+The first image is faded to an "oil transfer" version
+of the first image.  This is then faded to an "oil transfer"
+version of the second image and finally faded to the final image.
+
+.TP
+\fB-edge\fP
+The first image is faded to an edge detected version of the first image.
+This is then faded to an edge detected version of the second image and
+finally faded to the final image.
+
+.TP
+\fB-bentley\fP
+ The first image is faded to a "Bentley Effect" version
+of the first image.  This is then faded to a "Bentley
+Effect" version of the second image and finally faded to the
+final image.
+
+.TP
+\fB-block\fP
+The first image is defocused to small blocks.  The small blocks are converted
+to match a defocused version of the last image.  The block version of the last
+image is then focused to the final image.
+
+.TP
+\fB-base\fP \fIname\fP
+This forms part of the output filenames, as described above.
+
+
+
+.UN examples
+.SH EXAMPLES
+
+\fBppmfade -f teapot.ppm -l pyr.ppm\fP
+.PP
+Fade from teapot.ppm to pyr.ppm generating fade.0001.ppm to fade.0030.ppm using
+the "spread" transition.
+.PP
+\fBppmfade -l teapot.ppm\fP
+.PP
+Fade from black to teapot.ppm generating fade.0001.ppm to fade.0030.ppm.
+.PP
+\fBppmfade -f teapot.ppm -base end\fP
+.PP
+Fade from teapot.ppm to black generating end.0001.ppm to end.0030.ppm.
+
+.UN seealso
+.SH SEE ALSO
+
+\fBtontsc\fP manual,
+\fBsgifade\fP manual,
+\fBsmart_vfr\fP manual,
+\fBxmorph\fP manual,
+.BR "ppm" (1)\c
+\&
+
+.UN author
+.SH AUTHOR
+Bryan Henderson, Olympia WA; April 2000
+.PP
+Inspired by and intended as a replacement for \fBpbmfade\fP (not a
+Netpbm program) by Wesley C. Barris.
+.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/ppmfade.html
+.PP
+\ No newline at end of file