GPSMap-OS version 1.61 - 15 January 2010
========================================

Overview
--------
GPSMap-OS is a simple PocketPC application designed to read input from NMEA-
compatible GPS receivers and plot current and historical position over British 
Orndance Survey format map images.
Custom map reference points can be entered, and there's a realtime National Grid 
Reference and cursor range/bearing display. For full details and usage 
instructions see the product web page at http://www.craporola.com/GPSMap.html

Licence
-------
This program is free software licensed under the terms of the GNU General
Public License (GPL). See LICENSE.txt for full details.
You may use, copy and distribute this software as permitted under the
terms of this license but note that the author accepts no liability
whatsoever for its use, or for damages that may result to any party as a
cause, either directly or indirectly, of using this software. No warranty
of any kind is offered.

Installation
------------
Just copy GPSMap.exe to a folder on your PocketPC/Windows Mobile device. A good 
place is \Windows\Start Menu\Programs, from where it will be visible on the 
Start menu.

Version Information
-------------------
This release has been tested on a variety of PocketPCs running Windows PocketPC 
2002, 2003, 2003SE and Windows Mobile 5 and 6. It may however still have some 
problems you can help me fix. Contact me at the email address at the bottom of 
this file with bug reports and feature suggestions.

Thanks to users who have sent me reports from the wild, operation has been 
confirmed so far many devices, including the following equipment:

- iPAQ 214 Windows Mobile 6.0 with Bluetooth GPS receiver.
- iPAQ 2210 PocketPC 2003 with TomTom Bluetooth GPS receiver.
- iPAQ 3715 PocketPC 2003 with GlobalSat Bluetooth GPS Receiver BT-308.
- Acer n35 (built in GPS).
- Mitac Mio 168 (Digi Walker) with built in flip up GPS.
- Mitac Mio 350
- iPAQ 3950 PocketPC 2002.
- Dell Axim X5 PPC 2002 with Rikaline X6 Compact Flash GPS Receiver.
- iPAQ 2210 PocketPC 2003 with Globalsat BT338 and BT359.
- O2 Xda IIi running Windows Mobile 2003SE with TomTom Bluetooth GPS MkII.
- T-Mobile MDA Compact II (HTC Charmer) running Windows Mobile 5.0 with a Holux 
GR-230 GPS.
- Viewsonic v35 upgraded to PPC2003 with Rikaline e13 wired GPS.
- iPAQ 3715 PocketPC 2003 with Fortuna GPSmartBT.
- ViewSonic V37
- Yakumo 300
- iPAQ 5450
- Navman PiN 570
- O2 Xda Orbit smartphone
- Orange SPV M700
- iPAQ Rx5935
- iPAQ Hx4700
- O2 Xda Mini S
- HTC 3300 and HTC X7500
- Dell Axim X50

GPSMap-OS has also been found to be compatible with the popular GPSGate utility 
(see http://franson.com/gpsgate), which allows you to share a GPS feed with 
several programs at the same time.

I'd welcome reports of success with any other units.

Note: GPSMap is not designed to run on WinCE devices (such as some popular all-
in-one car navigation systems), though some people have reported some success in 
doing so (with a few workarounds). Check the Craporola forum for more 
information.

ChangeLog
---------
v1.61 (15/01/10)
- Added display of range/bearing to selection on GPS Info dialog.
- Added new "cross" map point symbol.
- Fix to avoid wasting time drawing OS gridlines at large view scales.

v1.6 (14/10/09)
- New GPS info dialog to show position, course and speed in nice friendly big 
letters.
- Export and import of map points to .pts file and Google KML placemarks.
- Option to display of OS gridlines and graticules to check map calibration and 
also to help working when no map loaded.
- Multi-select delete on map points list.
- Added exit confirmation dialog.
- Auto-load of previous map at startup (can be disabled on Map->Settings 
dialog).
- Added option to keep device powered on while connected to the GPS (some 
devices already do this anyway). See GPS->Settings 'Connection' tab.

v1.51 11/10/07
- Bugfix: Trail files (.trl) were getting saved as KML format.

v1.5 28/09/07
- Added "Use GPS Position" button onto coordinate entry dialog. Makes map 
calibration and point update based on your current position easier to perform.
- Map points can now be exported as Placemarks in a Google Earth/Maps KML file.
- Map trails can bow be saved as Paths in a Google Earth/Maps KML file.
- Default folder for loading map images is now "GPSMap Maps" (avoids very long 
listing times).
- COM port number now freely editable to allow for using "virtual" COM ports, 
for example via GPSGate.
- Minor bugfixes.

v1.4 11/03/07
- Finally finished code allowing entry of coordinates in WGS84 lat/long format.
- Added display of GPS altitude when available (from GGA sentence).
- GPS trails can now be saved and reloaded at any time.
- New GPS->Track menu option controls whether the trail is updated or not. 
Allows you to follow a previous trail without overwriting it for example.
- GPS trails can now have breaks in them.
- Update to fix issues of options not being saved.
- Various other minor bugfixes.

v1.3 27/07/06
- Added decode of RMC and GSA NMEA sentences to allow the few receivers that 
don't send GGAs to work.
- Satellite count is now displayed even if no position fix is available.
- Removed some redundant redraws that caused extra trail display flicker.
- Precision display now shows "100%+" when HDOP value indicates an over-
determined solution.

v1.2 17/03/06
- Added precision display based on HDOP (Horizontal Dilution of Precision) value 
from GPS receiver.
- Directional hardware buttons can now be used to pan the map.
- New dynamic WGS84 lat/long readout when entering OSGB grid refs (a future 
release will allow entry). 

- Point reduction algorithm to improve GPS trail drawing performance at low zoom 
levels.
- Minor maths optimisations in coordinate conversion routines.
- Usable GPS position and trail display without having a map loaded.
- Revised COM port handling code, added Windows Mobile 5.0 SetCommState 
workaround.
- Completely rejigged NMEA sentence parser for a more robust solution.

v1.1 13/07/05
- Improved performance of GPS data reader task, should now run OK on even the 
slowest PDAs.
- Better handling of COM port errors.
- Visual feedback when GPS position unavailable or data in error.
- Maximum screen update rate made configurable (maximum actual rate is still 
governed by the GPS feed).
- Creation of new map points made easier: now names with timestamp and selects 
default symbol.
- Reduced memory requirements for image loading.
- Better handling of image loading errors. (Note PPC2002 version still has some 
problems, see Bugs/Limitations below).
- Removed dependency on VOImage library.
- Internal logger support added to allow better diagnosis of bugs and problems.

v1.0 03/04/05
- New button bar allows quick access to common functions including map zoom 
level, centre on GPS etc.
- Operates as a full PocketPC application, meaning the Ok button no longer exits 
the program (though File->Exit does) and it will stay running in the background.
- Menus now have working indicators.
- GPS trail display can be toggled on/off.
- Almost all display settings are saved at exit.
- PocketPC 2002 version available.

v0.91 15/11/04
- Memory leak on opening new images resolved. Traced to a problem with the 
VOImage class destructor, software I didn't write I hasten to add.
- Selectable display of label text added to all map points.

Known Bugs/Limitations
----------------------
This release has the following known problems/limitations which will hopefully 
be addressed in future versions:

1. The size of the map image that can be loaded is limited by available memory. 
When there is insufficient memory the "Failed to load map image" error dialog 
will be shown. The PocketPC 2002 release of the program can sometimes fail to 
free the memory that was allocated however, meaning that subsequent images that 
loaded before may also start failing. The workaround for this is to shutdown the 
application (using File->Exit) and restart it.

Author and Contact Information
------------------------------
Dr. Matt Voysey
email: shanks@callnetuk.com
Product homepage: http://www.craporola.com/GPSMap.html
Craporola Software Forum: http://craporola.freeforums.org
