Installation
Maps
Screen
shots
Download
Todo
Help
needed!
RmapView was started as a simple script which is “able to display large maps”. Later it gained some extra features like switching between maps, remembering map locations. Then I bought a GPS card. So I wrote proj.4 wrapper for Tcl for true map projection support and a simple NMEA parser. Now rmapview has even more features:
distance measurement
track recording (with stand-alone application)
online track display
shows saved locations on a map with different icons
displays multiple recorded tracks with different colors
displays track point information (shows speed, altitude and exact co-ordinates)
Major part of RMapView is Tcl/Tk code, so it's rather portable. Current version should work on any UN*X-like system which has Tcl/Tk interpeter. Although scripts don't require any compilation, you'll have to compile some support code. You may find some binary packages in the download section (for linux/i386 and linux/arm at the moment).
|
Name |
Where to get |
Debian package |
Comments |
|
Tcl/Tk version 8.4 |
http://www.tcl.tk/ |
tk8.4 (8.4.4) |
This is a must have. |
|
libproj.4 |
http://proj.maptools.org/ |
proj (4.4.5) |
Required for cartographic projection support. |
|
tclimg |
http://sourceforge.net/projects/tkimg/ |
libtk-img (1.3) |
You'll need this to be able to use maps in PNG or JPEG format. |
Use build_binaries.sh script to build tracklgr executable and tclproj.so library.
Unpack the archive, then link main script to some bin directory.
Example:
cd /usr/local/lib
tar xvzf
/tmp/rmapview-arm-0.1b.tar.gz
cd ../bin
ln -s
../lib/rmapview-arm-0.1b/rmview.tcl rmview
If required, fix path to interpreter (wish) in the script.
Run rmview.tcl script. First time it prompts for directory where in can find it's components (tracks.tcl and others).
Map in RMapView is a directory containing set of image files (tiles). Image files are named X-Y.EXT. EXT is image type (gif, png, jpeg). X and Y are co-ordinates of upper left corner of the map fragment starting from 0-0 pixels. All the tiles normally have the same size, although right and bottom edge images may be smaller to match the actual map size.
Optionally, directory can contain projection description (proj.txt).
First line of proj.txt describes the way you specify projection.
pj – projection is defined via proj.4 library
ll – simple internal lattitude-longitude scaling
Second line specifies projection parameters. General format is name1 value1 name2 value2 ...
libproj projections
|
Parameter name |
Description |
|---|---|
|
proj |
Set of libproj parameters in double quotes. See libproj's documentation. |
|
x0 |
x-coordinate of the upper left corner of the map (usually in meters) |
|
y0 |
y-coordinate of the upper left corner of the map (usually in meters) |
|
xscale |
Horizontal map scale pixel/meter |
|
yscale |
Vertical map scale pixel/meter |
lat-lon projections
NOTE that this “projection” is very rough approximation. If you now can guess actual projection of the map, libproj is the way to go.
|
Parameter name |
Description |
|---|---|
|
lat0 |
Latitude of the upper left corner of the map in degrees prefixed with N or S. |
|
lon0 |
Longitude of the upper left corner of the map in degrees prefixed with N or S. |
|
latsc |
Latitude scale (pixel/degree) |
|
lonsc |
Longitude scale (pixel/degree) |
|
rotate |
Rotation angle in radians. |
You can find sample descriptions in the “examples” directory.
I'll be happy if someone
help me to write the manual.
Please, post any feedback and feature
requests at the SF project page.