Readme for Movemap 3.32 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. 30 Added new PPIO function... 31 Increased the HIGHWAY_MAX from 7000 to 10000 and added more trace points. 3.06 Added return code check on MM_CREATE WinQuerySysValue. 3.08 Reduced simulation default value form 25 msec. to 1000 msec. 12/10/2000. 3.10 Removed Comm Port open when starting in Simulation mode. 12/31/2000. 3.11 Removed FloodFill in map builder to see impact. 1/1/2001. 3.12 Changed FloodFill to fill while on black and added new screen tag routine. 1/1/2001. 3.13 Disabled the sound system thread for travel maps to note impact. 1/4/2001. 3.14 Lowered the priority of the State Machine thread by 10. 1/6/2001. 3.15 Fixed the buffer address error introduced in 3.13. 1/7/2001. 3.16 Added Sound Thread back and put 20 second delay in starting map build. 1/7/2001. 3.17 Moved 20 second build delay to just before and just after floodfile. 1/8/2001. 3.18 Forced 640x480 screen size to test Floodfill problem. 1/10/2001 3.19 Display values returned from QuerySys and work around for Floodfill. 1/11/2001. 3.20 Uped priority of opening song; removed 1.3 multiplier on PS size and lowered sleep to 5 seconds. 1/12/2001. 3.21 Removed the 5 second delays. Fixed bug that had overview always overlaying data. 1/13/2001. 3.22 Moved waypoint display to RMB and fixed problem of redisplayed Lat/Lon 2/4/2001 3.23 Added a remove checkbox to waypoint display dialogue and display the lat/lon on the setup of a new waypoint location. 2/6/2001 3.24 Added a mileage grid for resolutions 4, 5 and 6. 3/18/2001 3.25 #defines for BD and HP header files were limited to 150. Raised to 1000 each. 3/26/2001. 3.26 Increase all map header file maximums to 2000 from 1000. 3/28/2001. 3.27 Added feature to waypoints that will allow displaying as either a red circle (default) or a green diamond (like GNIS places). 4/12/2001. 3.28 Added grid lines for resolutions 1, 2 and 3. 4/15/2001. 3.29 Increase all map header file maximums to 5000 from 2000. 6/8/2001 3.30 Fixed map draw problem uncovered by *.dex consistent naming algorithm. 8/28/2001 3.31 Added Real Time Clock Synch feature. 11/11/2001 3.32 Implemented the new and improved mulitpoint calibration format for .BMP files. Also, added changes to the tag routine. Changed the Sitefile file format. The old format will not work with 3.32 and beyond. Must use the new Mapcalib program. 12/26/01 MOVEMAP is an OS/2 moving map program that is still under development. Your comments and bug reports are welcome (porteralexander@nc.rr.com). 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. Once the bundle is unzipped you should have a new directory (\mapprog) containing all the referenced files. 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 512+ characters 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. Once displayed you can delete the displayed waypoint by putting a check in the checkbox. The next time a map is built the deleted waypoint will no longer be displayed. 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-Grid-On enables horizontal and vertical milage grids for resolutions 4, 5 & 6. Setup-Grid-Off disables the milage grid. (default is off). 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. Setup-RTC Synch option allows you to use the GPS time to set your PC Real Time Clock. Selecting this option opens a dialog screen that displays both the RTC and the GPS clock values. The GPS clock value is approximate since it is obtained from a global variable that is refreshed by the GPS_calc routine that is called every one second. If you select "Synch" from the dialog screen Movemap will reset the RTC in time-critical mode suing the next GGA NEMA sentence. Movemap must be in GPS mode and not in the Simulation state in order to use this Setup option. 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, porteralexander@nc.rr.com