.rn '' }`
''' $RCSfile$$Revision$$Date$
'''
''' $Log$
'''
.de Sh
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp
.if t .sp .5v
.if n .sp
..
.de Ip
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.de Vb
.ft CW
.nf
.ne \\$1
..
.de Ve
.ft R

.fi
..
'''
'''
'''     Set up \*(-- to give an unbreakable dash;
'''     string Tr holds user defined translation string.
'''     Bell System Logo is used as a dummy character.
'''
.tr \(*W-|\(bv\*(Tr
.ie n \{\
.ds -- \(*W-
.ds PI pi
.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
.ds L" ""
.ds R" ""
'''   \*(M", \*(S", \*(N" and \*(T" are the equivalent of
'''   \*(L" and \*(R", except that they are used on ".xx" lines,
'''   such as .IP and .SH, which do another additional levels of
'''   double-quote interpretation
.ds M" """
.ds S" """
.ds N" """""
.ds T" """""
.ds L' '
.ds R' '
.ds M' '
.ds S' '
.ds N' '
.ds T' '
'br\}
.el\{\
.ds -- \(em\|
.tr \*(Tr
.ds L" ``
.ds R" ''
.ds M" ``
.ds S" ''
.ds N" ``
.ds T" ''
.ds L' `
.ds R' '
.ds M' `
.ds S' '
.ds N' `
.ds T' '
.ds PI \(*p
'br\}
.\"	If the F register is turned on, we'll generate
.\"	index entries out stderr for the following things:
.\"		TH	Title 
.\"		SH	Header
.\"		Sh	Subsection 
.\"		Ip	Item
.\"		X<>	Xref  (embedded
.\"	Of course, you have to process the output yourself
.\"	in some meaninful fashion.
.if \nF \{
.de IX
.tm Index:\\$1\t\\n%\t"\\$2"
..
.nr % 0
.rr F
.\}
.TH RMAP 1 
.UC
.if n .hy 0
.if n .na
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.de CQ          \" put $1 in typewriter font
.ft CW
'if n "\c
'if t \\&\\$1\c
'if n \\&\\$1\c
'if n \&"
\\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
'.ft R
..
.\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
.	\" AM - accent mark definitions
.bd B 3
.	\" fudge factors for nroff and troff
.if n \{\
.	ds #H 0
.	ds #V .8m
.	ds #F .3m
.	ds #[ \f1
.	ds #] \fP
.\}
.if t \{\
.	ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.	ds #V .6m
.	ds #F 0
.	ds #[ \&
.	ds #] \&
.\}
.	\" simple accents for nroff and troff
.if n \{\
.	ds ' \&
.	ds ` \&
.	ds ^ \&
.	ds , \&
.	ds ~ ~
.	ds ? ?
.	ds ! !
.	ds /
.	ds q
.\}
.if t \{\
.	ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.	ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.	ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.	ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.	ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.	ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
.	ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
.	ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.	ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
.\}
.	\" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
.ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
.ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
.ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.ds oe o\h'-(\w'o'u*4/10)'e
.ds Oe O\h'-(\w'O'u*4/10)'E
.	\" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.	\" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.	ds : e
.	ds 8 ss
.	ds v \h'-1'\o'\(aa\(ga'
.	ds _ \h'-1'^
.	ds . \h'-1'.
.	ds 3 3
.	ds o a
.	ds d- d\h'-1'\(ga
.	ds D- D\h'-1'\(hy
.	ds th \o'bp'
.	ds Th \o'LP'
.	ds ae ae
.	ds Ae AE
.	ds oe oe
.	ds Oe OE
.\}
.rm #[ #] #H #V #F C
.SH "NAME"
rmap \- Map portions of the earth from long/lat info
.SH "SYNOPSIS"
.PP
.Vb 2
\&  rmap --cities --zoom=20 --category=all --yrot=-120 
\&       --xrot 35 --continent=all --outfile=south_california.gif
.Ve
.SH "DESCRIPTION"
This manual page documents the utility rmap.  rmap is a small utility that goes against a 
custom format of the CIA's world data bank II global vector information to generate 
images of the earth from either a distance fairly zoomed in.  There are a variety of options
to control the display of the image.  The format of the image depends on the version of libgd
that you have.  Older versions generate gifs, but due to copyright issues, the newer ones
generate png or jpegs.
.SH "OPTIONS"
.Ip "--zoom \fInumber\fR" 5
Zoom level of the earth.  Deafault is 1 which is the whole earth.
.Ip "--xrot \fInumber\fR    " 5
Rotate the earth around the x-axis (Latitude) in degrees.
.Ip "--yrot \fInumber\fR " 5
Rotate the earth around the y-axis (Longitude) in degrees.
.Ip "--zrot \fInumber\fR" 5
Rotate the earth around the z-axis in degrees.
.Ip "--colorfile \fIfilename\fR" 5
The path to the colorfile which defines the colors various things will
be displayed in, or if they will be displayed at all.  If the value is
not specified, the file \fI~/.rmaprc\fR will be checked, and then the 
default file (\fIrmap.colors\fR).  The location of this file is specified at 
compile time based on the either the --prefix or --datadir options to configure.  
.Ip "--datafile \fIfilename\fR " 5
The path to the datafile.  The default location of this file is specified at 
compile time based on the either the --prefix or --datadir options to configure.
.Ip "--outfile \fIfilename\fR " 5
The path of the image to be generated.  If none is specified, then 
\fIEarthImage\fR will be generated in the current working directory. 
.Ip "--continent \fIlist\fR" 5
Either the word `\fBall\fR\*(R' or a list of comma seperated numbers where
1=Africa, 2=Asia, 3=Europe, 4=N. America, 5=S. America.  If no option is 
specified then `\fBall\fR\*(R' is assumed.
.Ip "--category \fIlist\fR" 5
Either the word `\fBall\fR\*(R' or a list of comma seperated numbers where
1=\s-1US\s0 State Boundaries, 2=Rivers, 3=International Boundaries, 4=Coasts, Islands, Lakes.
If no option is specified then `\fBall\fR\*(R' is assumed.
.Ip "--height \fInumber\fR" 5
The height of the image to generate, in pixles.
.Ip "--width \fInumber\fR" 5
The width of the image to generate, in pixles.
.Ip "--nogridlines " 5
Do not display gridlines ontop of the earth.  By default they are drawn in 
red, spaced at 15 degrees.
.Ip "--cities" 5
Overlay all applicable city names (from the file \fIcity.h\fR) on top of the image.
.Ip "-h" 5
Display a brief help page, then terminate.
.Ip "-v" 5
Display the version of code.
.SH "AUTHOR"
Reza Naima <reza@reza.net>
.SH "BUGS"
This is the first released version, so there are bound to be bugs. 
Also, as always, beware of buffer overflow attacks if you use this in a web-based application.

.rn }` ''
.IX Title "RMAP 1"
.IX Name "rmap - Map portions of the earth from long/lat info"

.IX Header "NAME"

.IX Header "SYNOPSIS"

.IX Header "DESCRIPTION"

.IX Header "OPTIONS"

.IX Item "--zoom \fInumber\fR"

.IX Item "--xrot \fInumber\fR    "

.IX Item "--yrot \fInumber\fR "

.IX Item "--zrot \fInumber\fR"

.IX Item "--colorfile \fIfilename\fR"

.IX Item "--datafile \fIfilename\fR "

.IX Item "--outfile \fIfilename\fR "

.IX Item "--continent \fIlist\fR"

.IX Item "--category \fIlist\fR"

.IX Item "--height \fInumber\fR"

.IX Item "--width \fInumber\fR"

.IX Item "--nogridlines "

.IX Item "--cities"

.IX Item "-h"

.IX Item "-v"

.IX Header "AUTHOR"

.IX Header "BUGS"