| 1 |
\ |
| 2 |
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source. |
| 3 |
.\" Do not hand-hack it! If you have bug fixes or improvements, please find |
| 4 |
.\" the corresponding HTML page on the Netpbm website, generate a patch |
| 5 |
.\" against that, and send it to the Netpbm maintainer. |
| 6 |
.TH "Ppm3d User Manual" 1 "20 February 2007" "netpbm documentation" |
| 7 |
|
| 8 |
.SH NAME |
| 9 |
ppm3d - convert two PPM images into an anaglyph (red/blue 3d glasses) PPM |
| 10 |
|
| 11 |
.UN synopsis |
| 12 |
.SH SYNOPSIS |
| 13 |
|
| 14 |
\fBppm3d\fP |
| 15 |
[\fB-color\fP] |
| 16 |
[\fB-offset=\fP\fIhorizontal_offset\fP] |
| 17 |
\fIleftppmfile\fP |
| 18 |
\fIrightppmfile\fP |
| 19 |
.PP |
| 20 |
Deprecated optional 3rd argument: \fIhorizontal_offset\fP |
| 21 |
|
| 22 |
.UN description |
| 23 |
.SH DESCRIPTION |
| 24 |
.PP |
| 25 |
This program is part of |
| 26 |
.BR "Netpbm" (1)\c |
| 27 |
\&. |
| 28 |
.PP |
| 29 |
\fBppm3d\fP reads two PPM images as input and produces a PPM as |
| 30 |
output, with the images overlapping by the specified number of pixels |
| 31 |
in blue-green/red format. The idea is that if you look at the image with |
| 32 |
3-D glasses (glasses that admit only red through one eye and only |
| 33 |
green or blue through the other), you see an image with depth. This |
| 34 |
is called an anaglyph stereogram. |
| 35 |
.PP |
| 36 |
\fBppm3d\fP can produce either of two kinds of anaglyph stereogram: |
| 37 |
monochrome or color. Use the \fB-color\fP option to choose. |
| 38 |
.PP |
| 39 |
In the monochrome version, \fBppm3d\fP ignores any color |
| 40 |
(actually, chrominance) in the input images and produces a result |
| 41 |
which is monochrome. Viewed through red-green glasses it is yellow, |
| 42 |
but without any other color in the field, your brain tends to see it |
| 43 |
as grayscale. |
| 44 |
.PP |
| 45 |
In the color version, \fBppm3d\fP generates a result which is close to the |
| 46 |
color of the original. It's not great, though, because each eye necessarily |
| 47 |
cannot see the entire spectrum. Red and cyan don't work well, but most other |
| 48 |
colors -- especially when heavily saturated -- come out quite well. |
| 49 |
.PP |
| 50 |
To view a color anaglyph stereogram, you need glasses with a left |
| 51 |
lens that admits only red light and a right lens that admits only blue |
| 52 |
and green light. (The right lens may be called a cyan lens because |
| 53 |
that is its pigment in white light; don't be misled into thinking that |
| 54 |
cyan is the only color that gets through it). Your brain is wired so |
| 55 |
that even though the components of light are coming in through |
| 56 |
different eyes, they mix in your brain to form the same sensation as |
| 57 |
if you were looking at the combined light with both eyes. |
| 58 |
.PP |
| 59 |
The input PPMs must be the same dimensions. |
| 60 |
.PP |
| 61 |
To make a different kind of stereogram, use \fBpamstereogram\fP. |
| 62 |
That makes a stereogram that you view without special glasses, just by |
| 63 |
letting your eyes unfocus so that each eye sees different parts of the |
| 64 |
image. |
| 65 |
|
| 66 |
.UN arguments |
| 67 |
.SH ARGUMENTS |
| 68 |
.PP |
| 69 |
The mandatory arguments are file names of the left and right input |
| 70 |
images. |
| 71 |
.PP |
| 72 |
An optional third argument specifies the same thing as the value of |
| 73 |
the \fB-offset\fP argument, but is deprecated because -offset is easier |
| 74 |
to use and read. Before Netpbm 10.38 (March 2007), this third argument |
| 75 |
is the only way to specify the offset. |
| 76 |
|
| 77 |
.UN options |
| 78 |
.SH OPTIONS |
| 79 |
.PP |
| 80 |
In addition to the options common to all programs based on libnetpbm |
| 81 |
(most notably \fB-quiet\fP, see |
| 82 |
.UR index.html#commonoptions |
| 83 |
Common Options |
| 84 |
.UE |
| 85 |
\&), \fBppm3d\fP recognizes the following |
| 86 |
command line options: |
| 87 |
|
| 88 |
|
| 89 |
|
| 90 |
.TP |
| 91 |
\fB-offset=\fP\fIhorizontal_offset\fP |
| 92 |
This option indicates the amount, in pixels, by which the left and |
| 93 |
image is offset to the right of the right image in the output. |
| 94 |
.sp |
| 95 |
The effect of this option is to move the entire image forward |
| 96 |
(positive numbers) or backward (negative numbers). With a zero |
| 97 |
offset, the main subject of the picture appears in the plane of the |
| 98 |
picture (i.e. if the image is projected on a screen, the location of |
| 99 |
the screen). The main subject is the subject at the location where |
| 100 |
the line of sight of the left camera intersects the line of sight of |
| 101 |
the right camera -- the main subject appears at the same location in |
| 102 |
both the left and right images. |
| 103 |
.sp |
| 104 |
Default is zero. |
| 105 |
.sp |
| 106 |
This option was new in Netpbm 10.38 (March 2007). Before that, use |
| 107 |
the third argument instead. Also, before Netpbm 10.38 the default is |
| 108 |
+30 pixels. |
| 109 |
|
| 110 |
.TP |
| 111 |
\fB-color\fP |
| 112 |
This option causes \fBppm3d\fP to generate a color anaglyph |
| 113 |
stereogram. By default, it generates monochrome. |
| 114 |
.sp |
| 115 |
This option was new in Netpbm 10.38 (March 2007). |
| 116 |
|
| 117 |
|
| 118 |
|
| 119 |
.UN seealso |
| 120 |
.SH SEE ALSO |
| 121 |
.BR "pamstereogram" (1)\c |
| 122 |
\& |
| 123 |
.BR "ppm" (1)\c |
| 124 |
\& |
| 125 |
|
| 126 |
.UN author |
| 127 |
.SH AUTHOR |
| 128 |
|
| 129 |
Copyright (C) 1993 by David K. Drum. |
| 130 |
.SH DOCUMENT SOURCE |
| 131 |
This manual page was generated by the Netpbm tool 'makeman' from HTML |
| 132 |
source. The master documentation is at |
| 133 |
.IP |
| 134 |
.B http://netpbm.sourceforge.net/doc/ppm3d.html |
| 135 |
.PP |