1Ppmglobe User Manual(0)                                Ppmglobe User Manual(0)
2
3
4

NAME

6       ppmglobe - generate strips to glue onto a sphere
7
8

SYNOPSIS

10       ppmglobe [-background=colorname] [-closeok] stripcount [filename]
11
12       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
17
18

DESCRIPTION

20       This program is part of Netpbm(1).
21
22       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
27       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
37       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
40       Example of map of the earth run through ppmglobe
41
42       You could cut out the strips and glue it onto a sphere and you'd have a
43       copy of the original globe.
44
45       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
52       You    can    find    maps    of    planets    at     maps.jpl.nasa.gov
53http://maps.jpl.nasa.gov⟩ .
54
55

PARAMETERS

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
62       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
68       Before Netpbm 10.32 (February 2006), instead of truncating the image on
69       the right, ppmglobe produces a fractional strip on the right.
70
71       filename  is  the  name  of the input file.  If you don't specify this,
72       ppmglobe reads the image from Standard Input.
73
74
75

OPTIONS

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
82
83
84
85       -background=colorname
86              This specifies the color that goes between the strips.
87
88              Specify the color (color) as described for the argument  of  the
89              pnm_parsecolor()                 library                 routine
90              ⟨libnetpbm_image.html#colorname⟩ .
91
92              The default is black.
93
94              This option was new in Netpbm  10.31  (December  2005).   Before
95              that, the background is always black.
96
97
98       -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
107              This option was new in Netpbm 10.31 (December 2005).
108
109
110
111

SEE ALSO

113       ppm(1) pnmmercator(1)
114
115

HISTORY

117       ppmglobe was new in Netpbm 10.16 (June 2003).
118
119       It is derived from Max Gensthaler's ppmglobemap.
120
121

AUTHORS

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

DOCUMENT SOURCE

128       This  manual  page was generated by the Netpbm tool 'makeman' from HTML
129       source.  The master documentation is at
130
131              http://netpbm.sourceforge.net/doc/ppmglobe.html
132
133netpbm documentation           23 February 2006        Ppmglobe User Manual(0)
Impressum