Adding upstream version 4.22.0.upstream/4.22.0

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

1 files changed, 135 insertions, 0 deletions

diff --git a/upstream/mageia-cauldron/man1/ppm3d.1 b/upstream/mageia-cauldron/man1/ppm3d.1
new file mode 100644
index 00000000..9d1c72fc
--- /dev/null
+++ b/upstream/mageia-cauldron/man1/ppm3d.1
@@ -0,0 +1,135 @@
+\
+.\" 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 "Ppm3d User Manual" 0 "20 February 2007" "netpbm documentation"
+
+.SH NAME
+ppm3d - convert two PPM images into an anaglyph (red/blue 3d glasses) PPM
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBppm3d\fP
+[\fB-color\fP]
+[\fB-offset=\fP\fIhorizontal_offset\fP]
+\fIleftppmfile\fP
+\fIrightppmfile\fP
+.PP
+Deprecated optional 3rd argument: \fIhorizontal_offset\fP
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBppm3d\fP reads two PPM images as input and produces a PPM as
+output, with the images overlapping by the specified number of pixels
+in blue-green/red format.  The idea is that if you look at the image with
+3-D glasses (glasses that admit only red through one eye and only
+green or blue through the other), you see an image with depth.  This
+is called an anaglyph stereogram.
+.PP
+\fBppm3d\fP can produce either of two kinds of anaglyph stereogram:
+monochrome or color.  Use the \fB-color\fP option to choose.
+.PP
+In the monochrome version, \fBppm3d\fP ignores any color
+(actually, chrominance) in the input images and produces a result
+which is monochrome.  Viewed through red-green glasses it is yellow,
+but without any other color in the field, your brain tends to see it
+as grayscale.
+.PP
+In the color version, \fBppm3d\fP generates a result which is close to the
+color of the original.  It's not great, though, because each eye necessarily
+cannot see the entire spectrum.  Red and cyan don't work well, but most other
+colors -- especially when heavily saturated -- come out quite well.
+.PP
+To view a color anaglyph stereogram, you need glasses with a left
+lens that admits only red light and a right lens that admits only blue
+and green light.  (The right lens may be called a cyan lens because
+that is its pigment in white light; don't be misled into thinking that
+cyan is the only color that gets through it).  Your brain is wired so
+that even though the components of light are coming in through
+different eyes, they mix in your brain to form the same sensation as
+if you were looking at the combined light with both eyes.
+.PP
+The input PPMs must be the same dimensions.
+.PP
+To make a different kind of stereogram, use \fBpamstereogram\fP.
+That makes a stereogram that you view without special glasses, just by
+letting your eyes unfocus so that each eye sees different parts of the
+image.
+
+.UN arguments
+.SH ARGUMENTS
+.PP
+The mandatory arguments are file names of the left and right input
+images.
+.PP
+An optional third argument specifies the same thing as the value of
+the \fB-offset\fP argument, but is deprecated because -offset is easier
+to use and read.  Before Netpbm 10.38 (March 2007), this third argument
+is the only way to specify the offset.
+
+.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
+\&), \fBppm3d\fP recognizes the following
+command line options:
+
+
+
+.TP
+\fB-offset=\fP\fIhorizontal_offset\fP
+This option indicates the amount, in pixels, by which the left and
+image is offset to the right of the right image in the output.
+.sp
+The effect of this option is to move the entire image forward
+(positive numbers) or backward (negative numbers).  With a zero
+offset, the main subject of the picture appears in the plane of the
+picture (i.e. if the image is projected on a screen, the location of
+the screen).  The main subject is the subject at the location where
+the line of sight of the left camera intersects the line of sight of
+the right camera -- the main subject appears at the same location in
+both the left and right images.
+.sp
+Default is zero.
+.sp
+This option was new in Netpbm 10.38 (March 2007).  Before that, use
+the third argument instead.  Also, before Netpbm 10.38 the default is
++30 pixels.
+
+.TP
+\fB-color\fP
+This option causes \fBppm3d\fP to generate a color anaglyph
+stereogram.  By default, it generates monochrome.
+.sp
+This option was new in Netpbm 10.38 (March 2007).
+
+
+
+.UN seealso
+.SH SEE ALSO
+.BR "pamstereogram" (1)\c
+\&
+.BR "ppm" (1)\c
+\&
+
+.UN author
+.SH AUTHOR
+
+Copyright (C) 1993 by David K. Drum.
+.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/ppm3d.html
+.PP
\ No newline at end of file