summaryrefslogtreecommitdiffstats
path: root/upstream/opensuse-leap-15-6/man1/ppm3d.1
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/opensuse-leap-15-6/man1/ppm3d.1')
-rw-r--r--upstream/opensuse-leap-15-6/man1/ppm3d.1128
1 files changed, 128 insertions, 0 deletions
diff --git a/upstream/opensuse-leap-15-6/man1/ppm3d.1 b/upstream/opensuse-leap-15-6/man1/ppm3d.1
new file mode 100644
index 00000000..dbd5eb19
--- /dev/null
+++ b/upstream/opensuse-leap-15-6/man1/ppm3d.1
@@ -0,0 +1,128 @@
+\
+.\" 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
+
+
+
+.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" (5)\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