diff options
Diffstat (limited to 'upstream/opensuse-leap-15-6/man1/ppm3d.1')
-rw-r--r-- | upstream/opensuse-leap-15-6/man1/ppm3d.1 | 128 |
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 |