# qpeGPS

qpegps is a program for displaying a map centered at the current position as read from a gps receiver.

It uses the NMEA output of the GPS receiver (connected to the serial port /dev/ttyS0).

## Map

A cross marks your position on the map (always in center).
The color of the cross (and the text) indicates the gps status: black=ok, yellow=not fixed.

The green line indicates your current heading.

The red line indicates the direction to the next waypoint (bearing).
If the waypoint reaches a position on the map, it is marked by a small rectangle.

Altitude, heading, speed, bearing, distance to the waypoint
and the time to the next waypoint are given as text info on the map.

## Info

This tab is for checking the available maps.
Just select one map and click on a position with a known latitude and longitude and compare it with the displayed postion on the bottom of the map.

## Config

Here you can select the unit/format for altitude, speed, distance and position.
You can also choose which information will be displayed on the map.
'Return' causes a changed 'gpsdArgument' to be taken.
The colors inside the map display can be selected, too.
After selecting a different path to the maps, qpeGPS must be restarted to take the changes.

## Fetch

Not implemented.
Please edit maps.txt (in $QPEDIR/maps/) to add your scanned or downloaded maps.

Map projections and their entries in maps.txt:
LINEAR mapName scale longitude1 latitude1 x1 y1 longitude2 latitude2 x2 y2
LAMBERT mapName scale longitude1 latitude1 x1 y1 longitude2 latitude2 x2 y2 stdLatitude1 stdLatitude2 refLongitude refLatitude
FRITZ mapName scale center_latitude center_longitude

LINEAR is just a linear interpolation of pixel positions and your position on earth. It works fine for maps of small areas (city maps...). ('mapName' is the name of the image which contains the map, 'scale' is the scale of the map, 'longitude, latitude,x,y' are used to specify two points at the map.
LAMBERT is for maps in the „lambert conformal conic projection with 2 standard parallels“. The additional parameters stdLatitude1/2 are mostly noted on your map. 'refLongitude' and 'refLatitude' are mostly the center of the whole map.
For downloaded maps please use FRITZ. I named it this way, because the original code for calculating positions on this maps is from Fritz Ganter who wrote the gpsdrive program.

You can download maps from mapblast.com:
(e.g. with wget)
wget -nd -O mapname.gif http://www.mapblast.com/gif?&CT=LATITUDE:LONGITUDE:SCALE&IC=48.0:18.0:10:&W=1280&H=1024&FAM=myblast&DU=KM&LB=
where LATITUDE, LONGITUDE and SCALE has to be replaced by the corresponding values.
See copyright information of www.mapblast.com if you are using their maps!

## Route

Currently the routing information is got from the GPS.

Planned: implementation of waypoints and routes in qpegps.

## ToDo

A lot. Please enter bugs and feature requests at www.sourceforge.net/projects/qpegps

Copyright (C) 2002 Ralf Haselmeier <rhaselme@users.sourceforge.net>

This program is free software; you can redistribute it and/or modify

it under the terms of the GNU General Public License as published by

the Free Software Foundation; either version 2 of the License, or

(at your option) any later version.

This program is distributed in the hope that it will be useful,

but WITHOUT ANY WARRANTY; without even the implied warranty of

MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

GNU General Public License for more details.

License