1RMAP(1)                     General Commands Manual                    RMAP(1)
2
3
4

NNAAMMEE

6       rmap - Map portions of the earth from long/lat info
7

SSYYNNOOPPSSIISS

9         rmap --cities --zoom=20 --category=all --yrot=-120
10              --xrot 35 --continent=all --outfile=south_california.gif
11
12

DDEESSCCRRIIPPTTIIOONN

14       This manual page documents the utility rmap.  rmap is a small utility
15       that goes against a custom format of the CIA's world data bank II
16       global vector information to generate images of the earth from either a
17       distance fairly zoomed in.  There are a variety of options to control
18       the display of the image.  The format of the image depends on the
19       version of libgd that you have.  Older versions generate gifs, but due
20       to copyright issues, the newer ones generate png or jpegs.
21

OOPPTTIIOONNSS

23       --zoom number
24            Zoom level of the earth.  Deafault is 1 which is the whole earth.
25
26       --xrot number
27            Rotate the earth around the x-axis (Latitude) in degrees.
28
29       --yrot number
30            Rotate the earth around the y-axis (Longitude) in degrees.
31
32       --zrot number
33            Rotate the earth around the z-axis in degrees.
34
35       --colorfile filename
36            The path to the colorfile which defines the colors various things
37            will be displayed in, or if they will be displayed at all.  If the
38            value is not specified, the file ~/.rmaprc will be checked, and
39            then the default file (rmap.colors).  The location of this file is
40            specified at compile time based on the either the --prefix or
41            --datadir options to configure.
42
43       --datafile filename
44            The path to the datafile.  The default location of this file is
45            specified at compile time based on the either the --prefix or
46            --datadir options to configure.
47
48       --outfile filename
49            The path of the image to be generated.  If none is specified, then
50            EarthImage will be generated in the current working directory.
51
52       --continent list
53            Either the word `aallll' or a list of comma seperated numbers where
54            1=Africa, 2=Asia, 3=Europe, 4=N. America, 5=S. America.  If no
55            option is specified then `aallll' is assumed.
56
57       --category list
58            Either the word `aallll' or a list of comma seperated numbers where
59            1=US State Boundaries, 2=Rivers, 3=International Boundaries,
60            4=Coasts, Islands, Lakes.  If no option is specified then `aallll' is
61            assumed.
62
63       --height number
64            The height of the image to generate, in pixles.
65
66       --width number
67            The width of the image to generate, in pixles.
68
69       --nogridlines
70            Do not display gridlines ontop of the earth.  By default they are
71            drawn in red, spaced at 15 degrees.
72
73       --cities
74            Overlay all applicable city names (from the file city.h) on top of
75            the image.
76
77       -h   Display a brief help page, then terminate.
78
79       -v   Display the version of code.
80

AAUUTTHHOORR

82       Reza Naima <reza@reza.net>
83

BBUUGGSS

85       This is the first released version, so there are bound to be bugs.
86       Also, as always, beware of buffer overflow attacks if you use this in a
87       web-based application.
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
1143rd Berkeley Distribution                                              RMAP(1)
Impressum