FORMAT FOR RAP/AWPG/CIDD/RVIEW/RDI ASCII MAP FILES
02/06/92 - Original by J Caron - HTML'ized and updated
by F. Hage April 2001.
Maps are stored as 'flat' ascii files. They can be named however you
wish, although our convention is 'something_descriptive.map' CIDD can load
its maps via a HTTP server, so it is often convieneint to store everyone's
maps in a central place,
served by a Web (HTTP) Server, to avoid duplication and obsolescence.
CIDD will search a comma delimited set of directories or URL's for maps.
Additionally, CIDD will also check the directory its parameter file is stored in
before looking in the other directories/(web sites) listed in the param file.
This makes a good place to put one-off or modified maps, while still
making use of the common map site for all other maps.
These are the allowable types of lines within a ASCII RAP MAP file:
- Comment lines, which have the character "#" in column 1
- Keyword lines, begining with a keyword, followed by parameters,
such as the number of data points which follow or offsets for text.
- Data Lines - contain polyline or icon definition data
Keyword lines: -
Note the MAP_NAME, TRANSFORM and PROJECTION lines are optional
- MAP_NAME name desc (OPTIONAL)
This should be the first line of any map file. The name is restricted to
64 characters, and must not have whitespace in it. The description is restricted
to 64 chars. A list of available map names (and desc) may be passed to client
programs; typically it is displayed for the user to select from. CIDD Does not use this
- TRANSFORM tranformation_matrix (OPTIONAL)
Optional line used by digitizing program. CIDD Does not use this
- PROJECTION type parameters (OPTIONAL)
Optional line used by digitizing program. type = PJG_XXXX; see PJG.h for
description of the projection parameters. -Note CIDD Does not use this
- ICONDEF icon_name npts
x y
x y
x y
...
This defines an icon with name 'icon_name'. It consists of npts number
of points, which immediately follow, one point per line. The 'x y' are
in units of pixels, and the line '32767 32767' indicates a pen up. The
pen goes down at the next 'x y' point. Note ICONDEF defines an icon,
but does not draw it. Use one or more ICON lines to have the Icon drawn
at the indicated lat, lon.
- ICON icon_name lat lon text_x text_y text
This Keyword indicates the icon 'icon_name' should be drawn, with the
origin (0,0) at 'lat lon'. If 'text_x text_y' is not equal to "32767
32767", then also draw the text 'text', with the lower left corner of
the text at 'text_x text_y' pixels relative to the origin. An ICON line
must refer to an icon_name that is already defined by a ICONDEF in the
same map file. An ICON stays the about same size as the user zooms.
- POLYLINE name npts
lat lon
lat lon
...
-1000 -1000
lat lon
lat lon
...
This defines an object called 'name', which is simply a polyline of
npts segments, specified in world (lat, lon) coordinates. Penup =
-1000, -1000. The pen is place down at the next lat, lon point
- SIMPLELABEL lat lon text
lat lon = lower left corner of the Text Location
text = text to display
See Some Examples Here: