1Ppm3d User Manual(0) Ppm3d User Manual(0)
2
6 ppm3d - convert two PPM images into an anaglyph (red/blue 3d glasses)
7 PPM
8
11 ppm3d [-color] [-offset=horizontal_offset] leftppmfile rightppmfile
12 Deprecated optional 3rd argument: horizontal_offset
14
17 This program is part of Netpbm(1).
18 ppm3d reads two PPM images as input and produces a PPM as output, with
20 the images overlapping by the specified number of pixels in blue-
21 green/red format. The idea is that if you look at the image with 3-D
22 glasses (glasses that admit only red through one eye and only green or
23 blue through the other), you see an image with depth. This is called
24 an anaglyph stereogram.
25 ppm3d can produce either of two kinds of anaglyph stereogram: mono‐
27 chrome or color. Use the -color option to choose.
28 In the monochrome version, ppm3d ignores any color (actually, chromi‐
30 nance) in the input images and produces a result which is monochrome.
31 Viewed through red-green glasses it is yellow, but without any other
32 color in the field, your brain tends to see it as grayscale.
33 In the color version, ppm3d generates a result which is close to the
35 color of the original. It's not great, though, because each eye neces‐
36 sarily cannot see the entire spectrum. Red and cyan don't work well,
37 but most other colors -- especially when heavily saturated -- come out
38 quite well.
39 To view a color anaglyph stereogram, you need glasses with a left lens
41 that admits only red light and a right lens that admits only blue and
42 green light. (The right lens may be called a cyan lens because that is
43 its pigment in white light; don't be misled into thinking that cyan is
44 the only color that gets through it). Your brain is wired so that even
45 though the components of light are coming in through different eyes,
46 they mix in your brain to form the same sensation as if you were look‐
47 ing at the combined light with both eyes.
48 The input PPMs must be the same dimensions.
50 To make a different kind of stereogram, use pamstereogram. That makes
52 a stereogram that you view without special glasses, just by letting
53 your eyes unfocus so that each eye sees different parts of the image.
54
57 The mandatory arguments are file names of the left and right input
58 images.
59 An optional third argument specifies the same thing as the value of the
61 -offset argument, but is deprecated because -offset is easier to use
62 and read. Before Netpbm 10.38 (March 2007), this third argument is the
63 only way to specify the offset.
64
67 In addition to the options common to all programs based on libnetpbm
68 (most notably -quiet, see
69 Common Options ⟨index.html#commonoptions⟩ ), ppm3d recognizes the fol‐
70 lowing command line options:
71 -offset=horizontal_offset
76 This option indicates the amount, in pixels, by which the left
77 and image is offset to the right of the right image in the out‐
78 put.
79 The effect of this option is to move the entire image forward
81 (positive numbers) or backward (negative numbers). With a zero
82 offset, the main subject of the picture appears in the plane of
83 the picture (i.e. if the image is projected on a screen, the
84 location of the screen). The main subject is the subject at the
85 location where the line of sight of the left camera intersects
86 the line of sight of the right camera -- the main subject
87 appears at the same location in both the left and right images.
88 Default is zero.
90 This option was new in Netpbm 10.38 (March 2007). Before that,
92 use the third argument instead. Also, before Netpbm 10.38 the
93 default is +30 pixels.
94 -color This option causes ppm3d to generate a color anaglyph stere‐
97 ogram. By default, it generates monochrome.
98 This option was new in Netpbm 10.38 (March 2007).
100
105 pamstereogram(1) ppm(1)
106
109 Copyright (C) 1993 by David K. Drum.
110
112 This manual page was generated by the Netpbm tool 'makeman' from HTML
113 source. The master documentation is at
114 http://netpbm.sourceforge.net/doc/ppm3d.html
116netpbm documentation 20 February 2007 Ppm3d User Manual(0)