
Readme for Movemap 2.15
1. Relinked without using Borland Dynamic Library. 5/21/2000
2. Changed to single character reads; scanned all sentences and
	improved simulation capability.  5/29/2000.
3. Added "Data Bits", "Stop Bits" and "Parity" to Comm Config
  	options.  5/31/2000
4. Added some trace points, moved track file save to current
	drive and temporarily disabled GLL and RMB sentences. 6/3/2000
5. Added more trace points, increased trace rate and fixed #define ERROR
            bug (5 -> 10). 6/4/2000
6. Added "ERROR" trace point, added GpiFont error messages, added 
	fTransBreak field to line control. 6/4/2000.
7. Added Times New Roman font to look up in map build. 6/5/2000.
8. Fixed Font loading bug.  Zeroed FontID to enable loading. 6/8/2000
9. Really fixed Font loading bug.  6/10/2000
10. Removed missing map errors for 100K and 2000k maps will allow
	partial maps or no maps to display.  Doubled font structure to
	200 fonts.  Re-enabled GLL sentence.  Added 5 & 6 data bits
	option and 2 stop bits.  Also, put check in for 1.5 stop bits must
	equal 5 data bits and 2 stop bits must not equal 5 data bits.
	6/11/2000
11. Added many more error messages to screen capture routine.  Moved
	storage location of capture files to root directory on default drive.
	Improved usability of capture menu. 6/16/2000
12. Fixed screen capture by adding logic to count available media type
	IO procedure; allocate memory for them; get them and then find
	the right one for .BMP files.  6/17/2000.
13. Fixed screen capture bug on colors > 256.  6/23/2000.
14. Made map presentation space variable and set to 1280x1024.  Added
	a simulation delay choice (1, 2, 4, & 8 seconds). 6/25/2000
15. Removed blue neat lines.  Fixed the aspect ratio so that a larger 
	presentation space does not lead to larger map sizes.  Made
	the memory presentation space size dynamic based on 130%
	of screen definition size.  Changed the dark blue roads to black.
	Moved neat line out 4 pels in each direction. Added highway
	shields for Interstates, Federal and State highways. Added a .25 
	sec. simmulation delay option.  Added Display type (Monitor/TV)
	option and fixed fonts to be automatically selected based on 
	display type. Added feature to allow double clicking on Simm File
	selection 8/6/00.	


MOVEMAP is an OS/2 moving map program that is still under development.  Your
comments and bug reports are welcome (stonewall@ipass.net).

As far as I know there are no other OS/2 based moving map programs.  I've run
MOVEMAP on two desktop machines (70 MH Pentium, 20MB of memory; 300 MH Pentium 
II, 64MB of memory) and my two laptops (Thinkpad 701C, 24MB of memory; Thinkpad 
385XD, 266 MH PII, 32MB of memory) and it runs very well on all of them.  I 
have a Garmin 45 GPS attached through COM ports 1 and 3. A unique feature for a
noncommercial moving map program is the use of Digital Line Graph (DLG) maps 
in addition to bitmapped maps.


PROGRAM OVERVIEW

The program operates using four strings when in GPS mode.  There is a 
time_critical thread that is used to read the COM port to which the GPS is 
attached.  There is a normal thread that is used to convert the GPS data into a
screen coordinate and to move the position indicator along the track.  When
using DLG maps as the position indicator nears the edge of the map a
background thread is kicked off to draw a new map in a memory presentation
space for use when available (usually well before it's needed).  The fourth thread
is used to support CD-ROM hard drive caching.

SETUP 

MOVEMAP can execute from any hard drive.  You need to unzip
the bundle in the root directory of the hard drive.  If you are running with the
CD-ROM present MOVEMAP will need serveral megabytes of hard drive space for
DLG caching.  If not it will look on the hard drive it's on for /2000k and /100k 
directories for DLG map data.


There is one file that needs to be added to the OS2 System Directory.  Add file 
BPMCC.DLL (provided in the bundle) to your \OS2\DLL directory.  The program was
developed with the Borland OS/2 1.5 compiler and uses Borland Controls.  Without 
this file in your OS2\DLL directory the program will not run.  There are several
other files you might be interested in.  They are:

 - BOOKTITL.BMP   This is the opening picture.  You can substitue any .BMP file
    you want with the same name and it'll display during program open.
 - LORENA.WAV  This is the song that plays during the opening sequence.   
    Once again you can substitue any .WAV file (or none) and it'll be played 
    during program open.  I did not include this file to save download time.
 - TR******.TXT  These are trace files. 

 - PLACESFL.TXT  This is the file used to store info added by the user and 
     associated with a particular latitude and longitude on DLG maps,
 - MAPSFILE.CFG  This file holds the calibration data for bitmapped maps.

 - SITEFILE.CFG  This file holds the data associated with BMP and WAV
     files associated with historical sites.
 - CAPTUR**.BMP Screen captures.  


OPERATION

Start the program either through an OS/2 window or put it under an ICON in a 
folder.  I've run it under both WARP 3 and WARP 4 with no problems.  Once the 
program comes up and displays the opening picture you need to configure
your communications support. Select  Setup-Comm from the menu and then
select your comm port, speed and GPS data format.  The defaults are ones I
use so I know they work.  These values will be saved over re-executions of the
program. Note if you use COM port 3 or 4 you need to have a special entry in 
your CONFIG.SYS file to work.  DEVICE=D:\OS2\BOOT\COM.SYS (3,3e8,9) is what
I added to use COM port 3 running OS/2 off my d: drive.  If you get this wrong the
port just doesn't work and there's no way (that I'm aware of) that the software
can tell.  There doesn't seem to be any error generated on either the open or
the read.  Usage is documented in the online documentation that comes with OS/2.
If you search on "COM" you'll find it.

Now you're ready to run.  Turn your GPS on (Garmin's simulation mode works
fine) and select Mode-GPS.  The opening picture will stay displayed until the
GPS readings have been received by the display program and the first map is
built or loaded.  If you don't get a map something is probably wrong with 
the COM port setup or your GPS input.  While debugging this I always had "PULSE" 
running in a small window to see what was going on.  With a multi-threaded 
program this is helpful.  You won't be able to see the time-critical thread 
running but you should see the display thread execute roughly once a second and 
the map build thread whenever it's called.  It takes a lot of CPU and disk 
operation to build the DLG maps so the pulse signature will be obvious.

The program will attempt to build and center the section of map called for by the
GPS reading.  The opening map resolution is set at "3".  There are 6 resolutions
in total.  1,2 & 3 all use the 2000K DLG map set.  The 2000k map set includes
all 50 states.  Resolutions 4,5 & 6 use the 100K DLG map set.  If your GPS position 
is off the map you'll likely see just a grey screen with the moving bulls eye.  
If you want to run from the CD-ROM see below.  The maps are prepared from 
government data available on the internet using a fairly large custom extract and 
build program.  This program, EXTRACT, is available in a separate zip file.

You can change resolutions in two ways.  Select menu item Map-Resolution-n or
press the arrow up key or down key to change resolution one step at a time.  The
program can tolerate changing resolution while map building is going on but I
don't think I've tested for all possible states yet so if you get fancy you might 
break it.  There are plenty of error messages that might be displayed.  Most of them
will only mean something to me so if you're going to send me a bug report please
include all the details (your system setup, configuration, OS/2 release, GPS, and
all error messages displayed).


 ADDITIONAL MENU ITEMS

File-Exit gets you out of the program gracefully.

Mode-Reset will shut down all the GPS threads running and close the COM port.

Setup-Comm will get you a dialogue box that will allow you to select the COM
port, bit rate, NMEA standard, data bits, stop bits and parity for the serial port
on which you connect your GPS.  For my Garmin 45 I use COM1, NMEA0183
2.0, 4800, 8, 1.0 and None respectively.  Your GPS might require different
settings.

Setup-Sound-Off will shut off the opening song if you get sick of hearing the same
tune over and over.  This setting is NOT saved over re-execution.

Sound-On does NOT restart the song playing; it only enables the sound feature.
This feature is in suport of the bitmapped maps.

Setup-Data-On will cause a small window to be dispalyed in the lower right of
the main window that contains the most recent Latitude, Longitude and Speed
readings.

Setup-Data-Off disables the Latitude, etc. display.

Setup-Waypoint-On will display saved location information on your maps.
You cause information to be saved by left clicking the mouse button anywhere
on a displayed map.  This will cause a dialogue window to be opened and will
allow you to enter up to 400+ characthers about the position.  You can redisplay
the entered information by right clicking the mouse botton inside the small red
circle on the map which will be displayed on the map after the next Mode-GPS.

Setup-Waypoint-Off disables the displaying of the saved points on the map but
not the ability to save information.

Setup-Contour-On enables the drawing of contour theme data as part of the DLG
map. The Countour data takes is generally very large and takes significant time to 
build.

Setup-Contour-Off disables the contour theme draw feature.

Setup-Display-TV A larger bold font will be selected for place names
and highway numbers.

Setup-Display-Monitor A smaller regular font will be selected for place names
and highway numbers.

Setup-Clear Cache-MOVEMAP attempts to reuse the existing cache when you
re-execute.  If you want to clear out the cache select Clear Cache before
selecting GPS mode.  Cache mode is automatically enabled when the CD-ROM
map data is available.

Setup-Cache Off-Disables the caching option.  Once disables it takes a restart to
set it back on.  You must select Cache Off before selecting Mode-GPS.

Setup-Places option gaves you some choice about which types of places will
be displayed on your maps.  A check mark enables displaying of information
of the associated type.  This feature is associated with DLG map resolutions 4, 
5 and 6 only.

Instrumentation-Trace-(on/off) will start and stop a trace operation that will save
the latitude and longitude received from the GPS and used to position the track 
indicator.  Speed and time of the reading are also saved.  These values are placed
in a file called TR******.TXT.  Where the ******* values are associated with the
map collection in operation.

Instrumentation-Simmulation-(on/off) will read latitude and longitude values from
a file called TR******.TXT and position the track indicator accordingly.  It runs at
about five times real speed.  When Simmulation-On is selected you will be given a 
choice of TR******.TXT files to use.  You must have your GPS attached and operational
for Simmulation to work.

Instrumentation-Simmulation-Trace Delay-(1/2/4/8) will cause the postion redraw
routine to sleep (1/2/4/8) seconds between redraws in simulation mode.  

Instrumentation-Screen Capture-(Client/Window/Desktop) allows for the capture of
MOVEMAP's client, window or the entire desktop.  MOVEMAP must have the focus
for this feature to work.  Simply press PF12.

Map-Collection menu items are associated with the various maps available.
Travel maps are the DLG collection.  

Map-Collection-(Gettysburg/Antietam/Virginia/Parks/...) menu items will select 
bipmaps of the appropriate areas if they're available.  

Map-Window-Open Window will open a small window in which a low resolution,
low detail map will be displayed.  Only the major highways, railroads and boundaries
will be drawn.  The GPS position on this map is only updated when a new map is
drawn.  It only displays for resolutions 4, 5 and 6.

Map-Window-Close Window closes the small low resolution window.

Map-Fast Draw prevents the graphic flood filling of DLG lakes, ponds, streams, etc.   
Flood filling is a rather slow process on some machines.  Also, selecting this menu
item will prevent blue screens in some map drawing situations.

Map-Normal Draw restores flood filling.

CD-ROM USAGE

If you want to burn a CD-ROM for use with MOVEMAP it needs to contain the /2000K
and /100K directories with all the associated subdirectories and files.  The CD must 
have one of the following Volume Names:

Southern
North_Est
Mid_West
Middle_Atl
Far_West
North_West

When MOVEMAP begins execution it will go look for a CD with one of the Volume
Names above.  If it finds one it will look for both the /2000K and /100K directories
on the CD.  If it finds them and the master files in them it will be happy.  If not it
will give you some warning or error message.  Once you go to State-GPS it will
clean up the hard drive cache and attempt to use what it can and eliminate the
rest.  If you moved postions substantially between using MOVEMAP you'll hear a
lot of disk and CD-ROM activity at this point as all the unneeded *.DEX files and
directories are eliminated and the new directories are built and the files copied
from the CD.

I continue to extract more 100K data.  I've got all of NC, VA, MD, DE, and some of
WV, PA, SC, GA, TN, KY, IL, WI, MN, WA, MO and CA.  If you want me to burn you
a specfic CD instead of doing the extract yourself and you're willing to wait for
it; send me an email I'll probably do it for the cost of the CD media.  

Good traveling and remember it's dangerous to take your eyes off the road while
driving; so be careful how and when you use MOVEMAP.

Tom Danninger, stonewall@ipass.net



