GPSDRIVE (c) 2001 Fritz Ganter <ganter@ganter.at>
-------------------------------------------------

Website: www.kraftvoll.at/software

Disclaimer: Please do not use for navigation. 

    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.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

    *********************************************************************

======================================================================
Attention!
Since version 0.27 there are no parameters -s -g -f anymore. Gpsd or
GARMIN mode are autodetected, if none is found GpsDrive will start in
"Simulation mode".
======================================================================


********************************************************************
Please read the gpsdrive man page. To do so, install the program and
type 

man gpsdrive

into a terminal window. With KDE Konqueror you can also see it with
the URL: 

man:gpsdrive

Most information is now in the man page!
********************************************************************




How to install the program:
----------------------

Source File:

Extract it with tar -xvzf gpsdrive*tar.gz
cd gpsdrive
./configure --with-pentiumpro
make

As root you should to a 
make install


After compiling and installing (install is needed for localisation)
read the manpage of gpsdrive or start the program if you are to lazy
to read manuals. ;-)

You can also download the RPM file and install it:

rpm -Uvh gpsdrive*.rpm

Uninstall:
---------

If you installed using the tarball:

cd into the gpsdrive directory (not the src), then

make uninstall

If you used the rpm package:

rpm -e gpsdrive


If there is no directory ".gpsdrive" in your home directory, GpsDrive
will creates it for you. In this directory a file map_koord.txt is
created which holds the maps list. 

You can let the program download the maps. There is also a script
"gpsfetchmap" to download the maps.

Once gpsd is running (only if you use NMEA mode) you can start the
program with

gpsdrive


For GARMIN mode you must not start gpsd.

If you don't have a link /dev/gps to your serial device, or you use
another port than ttyS0 start
GpsDrive with

./gpsdrive  -t /dev/ttyS1 

for your second serial port.

You see your position on the map and some infos in the statusline. You
can zoom in and out. If you are moving outside your map, the next map
is selected if one is available for your position.

The first time you should download a map with the "Download" button.

Help is provided with "gpsdrive -h".

Comqaq iPaq users:
-----------------
Gpsdrive will detect the smaller display and make smaller menues.

It is also recommend to use the language xx, that means to start GpsDrive with:

LANGUAGE=xx gpsdrive



If you have no GPS receiver connected:
-------------------------------------
There is a build in simulator. It is automatically used if no GPS
receiver is found.

If you have created a waypoint file and have the right maps, you can
click on "goto" to select a waypoint. The marker will move to this waypoint.

I'm to lazy to go out of my bed, how can I test with my GARMIN GPS III?
----------------------------------------------------------------------

Your GARMIN has a built in simulator. Start it on the "satellite
screen", the go to setup and enter a speed in the simulator menu. Then
"goto" a stored waypoint and look how fine GpsDrive work.
Don't forget to download your maps first.



************************************************************************

How to get own maps?
-------------------

EASY USE:
You can do it with the "download map" button in the program.
 
Below is the background of the file organization.

There must be a file called "map_koord.txt" in your ~/.gpsdrive
directory. Here is a sample:

map_stmk.gif          47.08    15.45    300000
map_austria.gif       48.0     14.0    1000000
map_bruck-m-umgeb.gif 47.44    15.29    100000

The first row is the filename, then comes the latitude, the longitude
and the scale of the map. The scale of 10000000 is good for Europe,
and 100000 is for a town like Vienna.

To get a map you may go to a URL like this:
http://www.mapblast.com/gif?&CT=51.0:10.0:2500000&IC=&W=1280&H=1024&FAM=mblast&LB=

This is the latitude -----------^^^^
This is the longitude ---------------^^^^
This is the scale -----------------------^^^^^^^^

Take the lat., long. and scale values from your URL and put it into
the map_koord.txt file together with the name of the file.

GpsDrive selects the map with the best scale for your position. So get
a map i.e for Europe, Austria and Vienna if you want to drive in
Vienna.

It is also important to leave the size 1280x1024 points like in the
URL above!

For easy use, I provide the script "gpsfetchmap" to get the map from
the internet and make the entry in the map_koord.txt file.
Usage: 

gpsfetchmap filename latitude longitude scale

The filename should have the extension .gif.

ATTENTION: Mapblast.com maps with a scale greater then 1:2 millions
seems to be have another projection system, GpsDrive shows here a
INCORRECT position! Has anyone information about this?

*****************************************************
Please read the copyright notice of www.mapblast.com!
*****************************************************

File formats:

The decimal points in way.txt must always be a dot ('.'), in
map_koord.txt '.' or ',' are possible. If you download maps from
within the program, GpsDrive writes the map_koord.txt respecting your
LC_NUMERIC setting.

Can I use other maps?
--------------------

You can also use your own (self drawn, scanned...) maps. The maps must
be gif, jpeg, png or other common file formats (the format must be
recognized by the gdk-pixbuf library).  The lat/long coordinates you
write into the "map_koord.txt" file must be the center of the map. The
map must have a size of 1280x1024 pixels! 

Important! The maps must now be named map_* for streetmaps
and top_* for topographical maps. If not, gpsdrive won't
display the maps.

There is an "import assistent" build in. Use this to import your maps.

Importing waypoints:
-------------------

The easiest way is to use the script "wpget" which does all for you.

Be sure to have "wpget", "wpcvt" and "garble" in your path. This is
fullfilled, if you did install the program as root and /usr/local/bin
is in your path.

The manual way:

You should also create a file "way.txt" in your ~/.gpsdrive directory
which looks like:

DEFAULT  47.0792  15.4524
KLGNFR   46.6315  14.3152
MCDONA   47.0555  15.4488

The waypoint named "DEFAULT" is the start position of the program,
important if you start it in simulation mode. So not everybody in the
world need to start at my house in Austria! ;-)
It is also ok if the waypoint is named DEFAUL because my GARMIN GPS
III stores only 6 charakters for a waypoint.

The rows are: label latitude longitude.

If the file doesn't exist or doesn't contain valid data, there is no
"Goto" button available.

You can use the program "garble" (included in the package) to read
out your waypoints from the Garmin GPS (Transfer mode must set to
GARMIN here, while GpsDrive needs NMEA!).


Some comments to fonts:
----------------------

GpsDrive is useing the font 
"-monotype-arial-bold-r-normal-*-*-360-*-*-p-*-iso8859-15"
for the big letters. If this font is not found, it uses 
"-adobe-helvetica-bold-r-normal-*-*-240-*-*-p-*-iso8859-15"
which should be available on a XFree86 installation.

If you want to change the font, find the define "FONT1" in the source
code and replace the font string. 


Mailing list:

The address for the mailing list is gpsdrive@warbase.selwerd.nl

Subscribing can be done by sending a mail containing "subscribe
gpsdrive" to majordomo@warbase.selwerd.nl


=======================================================================

Suggestions and bug reports welcome!


Have a lot of fun!

Fritz Ganter <ganter@ganter.at>
http://www.kraftvoll.at

