Debian Codegraph @

upstream/debian-unstable/man1/ppmglobe.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 "Ppmglobe User Manual" 1 "23 February 2006" "netpbm documentation"
7
8 .SH NAME
9 ppmglobe - generate strips to glue onto a sphere
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBppmglobe\fP
15 [\fB-background=\fP\fIcolorname\fP]
16 [\fB-closeok\fP]
17 \fIstripcount\fP
18 [\fIfilename\fP]
19 .PP
20 Minimum unique abbreviation of option is acceptable. You may use double
21 hyphens instead of single hyphen to denote options. You may use white
22 space in place of the equals sign to separate an option name from its value.
23
24
25 .UN description
26 .SH DESCRIPTION
27 .PP
28 This program is part of
29 .BR "Netpbm" (1)\c
30 \&.
31 .PP
32 \fBppmglobe\fP does the inverse of a cylindrical projection of a
33 sphere. Starting with a cylindrical projection, it produces an image
34 you can cut up and glue onto a sphere to obtain the spherical image of
35 which it is the cylindrical projection.
36 .PP
37 What is a cylindrical projection? Imagine a map of the Earth on flat
38 paper. There are lots of different ways cartographers show the three
39 dimensional information in such a two dimensional map. The cylindrical
40 projection is one. You could make a cylindrical projection by tracing as
41 follows: wrap a rectangular sheet of paper around the globe, touching the globe
42 at the Equator. For each point of color on the globe, run a horizontal line
43 from the axis of the globe through that point and out to the paper. Mark the
44 same color on the paper there. Lay the paper out flat and you have a
45 cylindrical projection.
46 .PP
47 Here's where \fBppmglobe\fP comes in: Pass the image on that paper
48 through \fBppmglobe\fP and what comes out the other side looks something
49 like this:
50 .PP
51 .B Example of map of the earth run through ppmglobe
52 .IMG -C globe.jpg
53 .PP
54 You could cut out the strips and glue it onto a sphere and you'd
55 have a copy of the original globe.
56 .PP
57 Note that cylindrical projections are not what you normally see as
58 maps of the Earth. You're more likely to see a Mercator projection.
59 In the Mercator projection, the Earth gets stretched North-South as
60 well as East-West as you move away from the Equator. It was invented
61 for use in navigation, because you can draw straight compass courses
62 on it, but is used today because it is pretty.
63 .PP
64 You can find maps of planets at
65 .UR http://space.jpl.nasa.gov
66 space.jpl.nasa.gov
67 .UE
68 \&.
69
70 .UN parameters
71 .SH PARAMETERS
72 .PP
73 \fIstripcount\fP is the number of strips \fBppmglobe\fP is to
74 generate in the output. More strips makes it easier to fit onto a
75 sphere (less stretching, tearing, and crumpling of paper), but makes
76 you do more cutting out of the strips.
77 .PP
78 The strips are all the same width. If the number of columns of
79 pixels in the image doesn't evenly divide by the number of strips,
80 \fBppmglobe\fP truncates the image on the right to create nothing but
81 whole strips. In the pathological case that there are fewer columns
82 of pixels than the number of strips you asked for, \fBppmglobe\fP
83 fails.
84 .PP
85 Before Netpbm 10.32 (February 2006), instead of truncating the image
86 on the right, \fBppmglobe\fP produces a fractional strip on the right.
87 .PP
88 \fIfilename\fP is the name of the input file. If you don't
89 specify this, \fBppmglobe\fP reads the image from Standard Input.
90
91
92 .UN options
93 .SH OPTIONS
94 .PP
95 In addition to the options common to all programs based on libnetpbm
96 (most notably \fB-quiet\fP, see
97 .UR index.html#commonoptions
98 Common Options
99 .UE
100 \&), \fBppmglobe\fP recognizes the following
101 command line options:
102
103
104
105 .TP
106 \fB-background=\fP\fIcolorname\fP
107 This specifies the color that goes between the strips.
108 .sp
109 Specify the color (\fIcolor\fP) as described for the
110 .UR libnetpbm_image.html#colorname
111 argument of the \fBpnm_parsecolor()\fP library routine
112 .UE
113 \&.
114 .sp
115 The default is black.
116 .sp
117 This option was new in Netpbm 10.31 (December 2005). Before that,
118 the background is always black.
119
120 .TP
121 \fB-closeok\fP
122 This means it is OK if the background isn't exactly the color you specify.
123 Sometimes, it is impossible to represent a named color exactly because of the
124 precision (i.e. maxval) of the image's color space. If you specify
125 \fB-closeok\fP and \fBppmglobe\fP can't represent the color you name
126 exactly, it will use instead the closest color to it that is possible.
127 If you don't specify \fBcloseok\fP, \fBppmglobe\fP fails in that
128 situation.
129 .sp
130 This option was new in Netpbm 10.31 (December 2005).
131
132
133
134 .UN seealso
135 .SH SEE ALSO
136 .BR "ppm" (1)\c
137 \&
138 .BR "pnmmercator" (1)\c
139 \&
140
141 .UN history
142 .SH HISTORY
143 .PP
144 \fBppmglobe\fP was new in Netpbm 10.16 (June 2003).
145 .PP
146 It is derived from Max Gensthaler's \fBppmglobemap\fP.
147
148 .UN authors
149 .SH AUTHORS
150 .PP
151 \fIMax Gensthaler\fP
152 wrote a program he called
153 \fBppmglobemap\fP in June 2003 and suggested it for inclusion in
154 Netpbm. Bryan Henderson modified the code slightly and included it in
155 Netpbm as \fBppmglobe\fP.
156 .SH DOCUMENT SOURCE
157 This manual page was generated by the Netpbm tool 'makeman' from HTML
158 source. The master documentation is at
159 .IP
160 .B http://netpbm.sourceforge.net/doc/ppmglobe.html
161 .PP