1Ppmglobe User Manual(0) Ppmglobe User Manual(0)
2
6 ppmglobe - generate strips to glue onto a sphere
7
10 ppmglobe [-background=colorname] [-closeok] stripcount [filename]
11 Minimum unique abbreviation of option is acceptable. You may use dou‐
13 ble hyphens instead of single hyphen to denote options. You may use
14 white space in place of the equals sign to separate an option name from
15 its value.
16
20 This program is part of Netpbm(1).
21 ppmglobe does the inverse of a cylindrical projection of a sphere.
23 Starting with a cylindrical projection, it produces an image you can
24 cut up and glue onto a sphere to obtain the spherical image of which it
25 is the cylindrical projection.
26 What is a cylindrical projection? Imagine a map of the Earth on flat
28 paper. There are lots of different ways cartographers show the three
29 dimensional information in such a two dimensional map. The cylindrical
30 projection is one. You could make a cylindrical projection by tracing
31 as folows: wrap a rectangular sheet of paper around the globe, touching
32 the globe at the Equator. For each point of color on the globe, run a
33 horizontal line from the axis of the globe through that point and out
34 to the paper. Mark the same color on the paper there. Lay the paper
35 out flat and you have a cylindrical projection.
36 Here's where ppmglobe comes in: Pass the image on that paper through
38 ppmglobe and what comes out the other side looks something like this:
39 Example of map of the earth run through ppmglobe
41 You could cut out the strips and glue it onto a sphere and you'd have a
43 copy of the original globe.
44 Note that cylindrical projections are not what you normally see as maps
46 of the Earth. You're more likely to see a Mercator projection. In the
47 Mercator projection, the Earth gets stretched North-South as well as
48 East-West as you move away from the Equator. It was invented for use
49 in navigation, because you can draw straight compass courses on it, but
50 is used today because it is pretty.
51 You can find maps of planets at maps.jpl.nasa.gov
53 ⟨http://maps.jpl.nasa.gov⟩ .
54
57 stripcount is the number of strips ppmglobe is to generate in the out‐
58 put. More strips makes it easier to fit onto a sphere (less stretch‐
59 ing, tearing, and crumpling of paper), but makes you do more cutting
60 out of the strips.
61 The strips are all the same width. If the number of columns of pixels
63 in the image doesn't evenly divide by the number of strips, ppmglobe
64 truncates the image on the right to create nothing but whole strips.
65 In the pathological case that there are fewer columns of pixels than
66 the number of strips you asked for, ppmglobe fails.
67 Before Netpbm 10.32 (February 2006), instead of truncating the image on
69 the right, ppmglobe produces a fractional strip on the right.
70 filename is the name of the input file. If you don't specify this,
72 ppmglobe reads the image from Standard Input.
73
77 In addition to the options common to all programs based on libnetpbm
78 (most notably -quiet, see
79 Common Options ⟨index.html#commonoptions⟩ ), ppmglobe recognizes the
80 following command line options:
81 -background=colorname
86 This specifies the color that goes between the strips.
87 Specify the color (color) as described for the argument of the
89 pnm_parsecolor() library routine
90 ⟨libnetpbm_image.html#colorname⟩ .
91 The default is black.
93 This option was new in Netpbm 10.31 (December 2005). Before
95 that, the background is always black.
96 -closeok
99 This means it is OK if the background isn't exactly the color
100 you specify. Sometimes, it is impossible to represent a named
101 color exactly because of the precision (i.e. maxval) of the
102 image's color space. If you specify -closeok and ppmglobe can't
103 represent the color you name exactly, it will use instead the
104 closest color to it that is possible. If you don't specify
105 closeok, ppmglobe fails in that situation.
106 This option was new in Netpbm 10.31 (December 2005).
108
113 ppm(1) pnmmercator(1)
114
117 ppmglobe was new in Netpbm 10.16 (June 2003).
118 It is derived from Max Gensthaler's ppmglobemap.
120
123 Max Gensthaler wrote a program he called ppmglobemap in June 2003 and
124 suggested it for inclusion in Netpbm. Bryan Henderson modified the
125 code slightly and included it in Netpbm as ppmglobe.
126
128 This manual page was generated by the Netpbm tool 'makeman' from HTML
129 source. The master documentation is at
130 http://netpbm.sourceforge.net/doc/ppmglobe.html
132netpbm documentation 23 February 2006 Ppmglobe User Manual(0)