Debian Codegraph @

upstream/debian-unstable/man1/ppm3d.1

raw
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