home *** CD-ROM | disk | FTP | other *** search
/ PC Format Collection 7 / PCFORMAT07.iso / MAPIT / README.TXT < prev    next >
Text File  |  1994-04-14  |  23KB  |  537 lines
  1. (readme.txt)
  2.                                MAPIT (v 1.4)
  3.                              Allison Software
  4.                               166 Shady Lane
  5.                           Apollo, PA  15613  USA
  6.                   412-727-2198           CompuServe 72600,1200
  7.     
  8.  
  9. Product Description:
  10.     
  11.                 MAPIT  -  Your Graphics Notepad on the World
  12.  
  13.     MAPIT is an integrated world-wide mapping system of amazing detail
  14.     which helps you create customized maps for work, school, or fun.
  15.  
  16.     Use MAPIT to
  17.  
  18.         * print detailed, publication-quality, customized maps,
  19.  
  20.         * merge maps with word processing documents,
  21.  
  22.         * record and plot live GPS data,
  23.  
  24.         * add your own customized detail with 100' precision,
  25.  
  26.         * zoom to any level and navigate around the world,
  27.  
  28.         * show day and time anywhere in the world,
  29.  
  30.         * measure distances, calculate azimuth angles, and plot great
  31.           circles and range curves and calculate associated areas.
  32.  
  33.     A powerful reference tool, MAPIT contains a wealth of information and
  34.     is just plain fun to use.
  35.  
  36.     Import your own data.  Mark locations with figures (simple line
  37.     drawings).  Document with stroked and hidden text.
  38.  
  39.     Record real-time Global Positioning System (GPS) data from your car,
  40.     boat, or plane on your laptop and use MAPIT's sophisticated GPS
  41.     Utilities Package to import and view your exact track.
  42.  
  43.     School age children will amaze teachers and friends with accurate,
  44.     detailed maps of foreign countries and states. And your little ones will
  45.     love to color-fill the oceans, lakes, islands, and countries imported
  46.     into their favorite paint brush program.
  47.  
  48.     More serious users have a choice of exporting data in the colorful .PCX
  49.     screen dump file format or in the ultra-detailed HP-GL/2 graphics
  50.     plotting language format accepted by many laser printers and pen
  51.     plotters.  They can even merge this data into publication-quality
  52.     compound (text and graphics) documents supported by modern word
  53.     processors.
  54.  
  55.     MAPIT displays a true Mercator projection, the choice of navigators.
  56.     Layout great circle tracks between multiple points totaling their
  57.     distances.  Dynamically plot range curves measuring the enclosed area as
  58.     you go.
  59.  
  60.     MAPIT includes almost 6000 international cities and 19,000 US cities
  61.     with their 1990 populations. The underlying vector-based geographic
  62.     database consists of over 5 million points organized by coastlines,
  63.     lakes, rivers, canals, reefs, salt flats, national boundaries, and US
  64.     and Canadian state and provincial boundaries.  Believe me, you'll find
  65.     places in this database you never imagined existed.
  66.  
  67.     MAPIT comes network-ready for multi-user installations.  The large
  68.     read-only main database can be located on a shared disk for more
  69.     efficient operations.
  70.  
  71.     If you are looking for more than just a pretty picture -- or perhaps
  72.     need many different pretty pictures, let MAPIT be the end of your
  73.     graphical quest.  Home, school, lab, or office, MAPIT can do the job!
  74.     MAPIT, your electronic notepad on the world.
  75.  
  76.  
  77. Install MAPIT:
  78.  
  79.     The shareware version of MAPIT is distributed as a one, two, or
  80.     three disk set.  The installation process copies MAPIT to your hard
  81.     drive.
  82.  
  83.     Insert the first MAPIT diskette into floppy drive A: (or B:) and
  84.     enter
  85.  
  86.          C:> A:INSTALL
  87.  
  88.     The install program will ask where you want the MAPIT data stored
  89.     (C:\MAPIT) and complete the installation for you.
  90.  
  91.     The Install program normally runs MAPIT for you the first time.
  92.  
  93.     MAPIT REQUIRES A MOUSE.  Unless you have a mouse physically attached
  94.     to your computer AND have installed its driver, you will be unable
  95.     to operate MAPIT.  You can exit MAPIT from the keyboard by entering
  96.     <CTRL>Q.
  97.  
  98.     If you see a cursor when you run MAPIT, everything is okay.  SKIP
  99.     THE NEXT SECTION.
  100.  
  101.  
  102. How to Install a Mouse:
  103.  
  104.     Install the mouse driver by issuing the following command at the
  105.     command prompt.
  106.  
  107.         C:> "path"\MOUSE             (e.g. C:\WINDOWS\MOUSE)
  108.  
  109.     where "path" is the path to the directory containing the mouse
  110.     driver.
  111.  
  112.     Place this command in your AUTOEXEC.BAT so MOUSE is always available.
  113.  
  114.     Caution:  Windows is smart and will show a mouse cursor without the
  115.     mouse driver's being installed.  If the cursor doesn't appear when
  116.     you run MAPIT, <CTRL>Q out and try to edit a file with the standard
  117.     DOS editor from the DOS prompt (EDIT VENDINFO.DIZ).  If you don't
  118.     have a mouse cursor in the editor, the driver isn't loaded.  Try
  119.     loading it from the DOS prompt as above, and if that works, add the
  120.     same command near the end of your AUTOEXEC.BAT but before any call
  121.     to WINdows.
  122.  
  123.  
  124. How to Run MAPIT:
  125.  
  126.     Run MAPIT with the shareware data by entering
  127.  
  128.         C:> MAPIT      (or MAPIT DEMO)
  129.  
  130.     Each time MAPIT runs, it looks for the private database
  131.     EXTENDED.MP3. If not found, it creates a zero length EXTENDED.MP3.
  132.  
  133.     To run MAPIT with the Columbus demo, copy COLUMBUS.MP3 over
  134.     EXTENDED.MP3 before runing MAPIT.
  135.  
  136.         C:> COPY  COLUMBUS.MP3  EXTENDED.MP3
  137.         C:> MAPIT
  138.  
  139.     You may also wish to print the text file COLUMBUS.TXT to have a
  140.     hardcopy in front of you as you run the demo.
  141.  
  142.     Follow the instructions in Hidden Text 1 (Press Left Mouse button in
  143.     triangle 1) to follow the Columbus demo and learn to use MAPIT. When
  144.     you are finished with the Columbus demo, delete EXTENDED.MP3.
  145.  
  146.  
  147. Establishing your Time Zone:
  148.  
  149.     MAPIT dynamically displays a calculated day and time for any place
  150.     in the world based on your computer's clock and the value you assign
  151.     the environmental variable TZ which you can set in your AUTOEXEC.BAT
  152.     file.  Use the following syntax to establish TZ:
  153.  
  154.          set  TZ=tzn[+|-]hh[:mm[:ss]]dzn
  155.  
  156.     where
  157.          tzn      - three-character standard time zone name.
  158.          hh:mm:ss - offset from GMT in hours and optionally minutes
  159.                     and seconds.  Use positive for west, neg for east.
  160.          dzn      - three-character savings time zone name.
  161.  
  162.     example:
  163.          C:> SET  TZ=EST5EDT     // Eastern Std/Daylight Time with a
  164.                                  // 5 hour offset west of Greenwich.
  165.  
  166.     If you fail to set TZ, your time zone defaults to "PST8PDT", Pacific
  167.     Standard and Daylight Time, next best thing to visiting California!
  168.  
  169.  
  170. For More Information:
  171.  
  172.     After installing MAPIT, see MAPIT.TXT and GPS_UTIL.TXT for
  173.     documentation covering the operation of the programs provided with
  174.     Shareware MAPIT.
  175.  
  176.     See VENDINFO.DIZ for information about your MAPIT Shareware License,
  177.     Warranty, and right to duplicate.
  178.  
  179.  
  180. More MAPIT Particulars:
  181.  
  182.     In general, MAPIT is started from the command line by entering
  183.  
  184.      > MAPIT  [main_mp3_data]  [/extended=mp3_data_file]
  185.               [/figure=figure_file]  [/font=font_file]  [/save=save_file]
  186.               [/delete]
  187.  
  188.     where
  189.  
  190.         main_mp3_data -
  191.             The primary .mp3 format data file opened read-only. 
  192.             Defaults to WORLD.MP3 if not specified.
  193.  
  194.     MAPIT looks for four other files at startup time:
  195.  
  196.         /extended=mp3_data_file -  
  197.             A private .mp3 format data file opened for update with user 
  198.             data or changes. If none exists, a zero length file is created.  
  199.             Defaults to EXTENDED.MP3 if not specified.
  200.  
  201.         /figure=figure_file - 
  202.             The standard figures file. Normally this file is 
  203.             user-created by FIGEDIT and contains the user's custom figures. 
  204.             Without it, figures won't be displayed.  Defaults to STD.FIG if 
  205.             not specified.
  206.  
  207.         /font=font_file - 
  208.             The standard font file. Without it, stroked text 
  209.             doesn't work.  Defaults to STD.FNT if not specified.
  210.  
  211.         /save=save_file - 
  212.             The file holding MAPIT's final state.  Defaults to 
  213.             MAPIT.SAV if not specified.
  214.  
  215.         /delete - 
  216.             Allows the MAPIT menu selection EDIT/Copy & Delete to work by 
  217.             opening main_mp3_data for update.
  218.  
  219.     Enter MAPIT /? from the command line for a listing if you forget 
  220.     these options.
  221.  
  222.     You can abbreviate command line switches short of the point of 
  223.     ambiguity.  /fig=x is the same as /figure=x, but /f=x will induce an 
  224.     error message listing the ambiguous possibilities as /figure and 
  225.     /font.  
  226.     
  227.     Entering just a / is a sly way of forcing MAPIT to list all 
  228.     its command line switches.
  229.  
  230.   Using the Mouse
  231.  
  232.     There are two distinct ways to use the mouse.
  233.  
  234.     DRAGGING - Some selections (eg. Zoom by Corners) require depressing 
  235.     the left button to establish the starting corner or position and, WITH 
  236.     THE BUTTON STILL DEPRESSED, dragging the cursor to the second corner 
  237.     or position to be measured BEFORE RELEASING THE BUTTON.  If you press 
  238.     and release at the same point when a drag is required, nothing happens.
  239.  
  240.     POINT & CLICK - Other activities, notably those requiring 
  241.     one-at-a-time point selections, look for the depression and release of 
  242.     the left mouse button without any intervening movement.  Sometimes use 
  243.     of the RIGHT mouse button is required to signal the end of multiple 
  244.     point entry.
  245.  
  246.  
  247.   Tuning Your System.
  248.  
  249.     MAPIT requires a properly tuned high performance computer.  The most 
  250.     significant performance boost you can give is by using disk cache such 
  251.     as SMARTDRV which comes with DOS and WINDOWS. 
  252.  
  253.     The disk cache must be of adequate size, at least 500K, if it is to be 
  254.     of any use.  If when redrawing a portion of the world, you notice a 
  255.     lot of disk activity, your system will perform better with a larger 
  256.     disk cache.  
  257.     
  258.     MAPIT's .mp3 data files are LARGE, but they are efficiently designed 
  259.     and already compact.  Data compaction drivers such as DOUBLESPACE will 
  260.     NOT gain you appreciable space and may SLOW your disk system (by as 
  261.     much as one half).  Do NOT place MAPIT's data files on compressed 
  262.     drives without first verify performance loss versus space savings for 
  263.     your hardware/software combination.
  264.  
  265.     MAPIT is designed to display graphics adequately without a math 
  266.     coprocessor.  Stroked text, however, which can be oriented at any 
  267.     angle, is compute intensive and will respond positively to the addition 
  268.     of a math chip.
  269.  
  270.  
  271. Making Maps
  272.  
  273.     MAPIT supports a variety of methods of producing output which differ 
  274.     in quality and complexity.
  275.  
  276.   Direct Output
  277.  
  278.     The simplest method of generating output is to direct hard copy 
  279.     directly from the screen to your printer. GRAPHICS, a TSR (Terminate 
  280.     and Stay Resident program) at the DOS command level, outputs a 
  281.     graphics screen when you press the Shift+Print Screen key 
  282.     combination. (You cannot be running under Windows when you do this.) 
  283.     If you have a laser printer, the results from within MAPIT can be 
  284.     quite good. Entering
  285.  
  286.          > GRAPHICS LASERJETII
  287.  
  288.     after bootup loads the TSR GRAPHICS and readies it for an HP LaserJet 
  289.     II or III. Check your DOS manual for a complete list of supported 
  290.     printers.
  291.  
  292.   Screen Capture
  293.  
  294.     A number of stand-alone programs, word processors, or TSR's can 
  295.     capture the screen image produced by MAPIT. If, for instance, you run 
  296.     MAPIT within a Windows' DOS box, you can capture a screen with the 
  297.     Print Screen key, switch back to Windows (ALT-TAB), and Shift/Insert 
  298.     the image into Paintbrush, a standard Windows appli cation. If your 
  299.     intent is create line images for import into a word processor, use 
  300.     Paintbrush's PICK/Inverse option to change the black background to 
  301.     white (and other colors to their compliments). Typically you might 
  302.     want to select a part or all of the image for direct insertion into 
  303.     your compound document.
  304.  
  305.   .PCX Files
  306.  
  307.     A more controlled way of capturing screen images from MAPIT is to 
  308.     select the TOOLS/.PCX menu items and save the images to files. The 
  309.     .PCX command allows you to invert MAPIT's black background to white 
  310.     first, if you so desire.  The entire screen including the menu 
  311.     heading and footer, just the mapping area, or a selected rectangle 
  312.     from within the mapping area can be saved to a file whose name you 
  313.     choose.  Later you can import these files from within Paintbrush by 
  314.     selecting File/Open with List Files of Type: set to PCX files.  Then 
  315.     print the output to your output device.
  316.  
  317.   HP-GL/2 Output
  318.  
  319.     Hewlett Packard's Graphics Language/2 provides the most detailed 
  320.     output possible.  Unlike the .PCX format which is limited to the 
  321.     resolution of your screen, HP-GL/2 is a vector format output which is 
  322.     limited by the resolution of MAPIT's underlying database and the 
  323.     resolution of your laser printer or pen plotting device. MAPIT 
  324.     directs this output to either your printer/plotter attached to the 
  325.     PRN port or to a .HGL file.  If, for instance, you want to import 
  326.     HP-GL/2 input into a Microsoft Word for Windows document, first 
  327.     produce the file from within MAPIT, then, from within Word, select 
  328.     Insert/Picture setting the List Files of Type: option to HP Graphics 
  329.     Language (*.hgl).  (In this example you must be using Word for 
  330.     Windows version 2.0c or later.  Other word processors may or may not 
  331.     support .HGL format or compound documents.)
  332.  
  333.  
  334. Working from within Windows
  335.  
  336.     Working between MAPIT and paint or word processing programs can be 
  337.     facilitated by running MAPIT from within a Windows DOS box. This 
  338.     allows you to switch between MAPIT and your other program(s) by using 
  339.     the ALT-TAB task switching sequence.  (Hold the ALT key down while 
  340.     clicking the TAB key until the desired program's banner comes up.) 
  341.     You needn't quit MAPIT each time you want to switch to the another 
  342.     program.  The down side of this example of power computing is its 
  343.     demands on computer resources: you should have at least 4MB of RAM to 
  344.     insure adequate response and MAPIT will be slowed by approximately 
  345.     30%. Be certain that your DOSPROMPT's PIF is set for High Graphics, 
  346.     Full Screen, Background, and that Advanced Options include Uses High 
  347.     Memory Area, High Graphics, Emulate Text Mode, and Retain Video 
  348.     Memory.
  349.  
  350.  
  351. Fun with Maps:
  352.  
  353.     If, as a child, you enjoyed paint-by-numbers, you'll understand why
  354.     young children will love to create .PCX bitmapped maps in MAPIT,
  355.     import them into paint programs (such as Paintbrush provided in 
  356.     Windows), and color them with flood fill.  In Paintbrush, File/Open
  357.     looking for *.PCX (see scroll box "List Files of Type"), open a map
  358.     file, set the color to light blue and the tool to the paint roller, and
  359.     begin color filling away.  The files AFRICA.PCX and MID_EAST.PCX are
  360.     provided for you as examples.  If color bleeds across national 
  361.     boundaries, choose the paint command Zoom and add missing pixels to
  362.     shore up the dike.  (Note, you can't unflood dithered colors.)
  363.  
  364.     Students will find the ability to print maps of foreign countries 
  365.     invaluable in their shool work and helpful in visualizing the 
  366.     places where world events are unfolding.
  367.  
  368.  
  369. MAPIT Explained:
  370.  
  371.     MAPIT is a professional-level mapping application which includes a 
  372.     detailed database of the world and programs to interact with and 
  373.     supplement that database.  You have the shareware version of MAPIT, a 
  374.     data-truncated version designed to give you the feel of MAPIT's full 
  375.     capabilities in an affordable format.  
  376.  
  377.     Registered versions of MAPIT come in a range of mapping detail to fit a 
  378.     variety of users' mapping needs, hard disk limitations, and 
  379.     pocketbooks.  The full MAPIT requires upwards of 28 MB of disk storage 
  380.     and is shipped on 24 1.44 MB 3.5" floppies.
  381.  
  382.     The different detail options of MAPIT's database can most easily be 
  383.     explained in terms of zoom factor.  The initial MAPIT display including 
  384.     the whole earth is defined as zoom factor 1 (shown in the lower left 
  385.     corner of the screen).  Zooming in to half that distance changes the 
  386.     zoom factor to 2.  Zooming in on the US so it fills the whole screen, 
  387.     for instance, requires a zoom factor of approximately 5.  
  388.     
  389.     The world database included with shareware MAPIT holds resolution to a 
  390.     zoom factor of approximately 6.  Zoom much closer than that and you 
  391.     begin to notice the jaggies - a decided compromise in object detail.  
  392.     
  393.     The island of Cuba, just south of the United States off the coast of 
  394.     Florida, is supplied in its full detail as an example of that available 
  395.     elsewhere in the registered data.  You should be able to zoom in to a 
  396.     factor of 750 or so before detail becomes an issue.  At Cuba's 
  397.     latitude, this means the entire screen width covers a distance of 31 
  398.     miles (as opposed to 24,857 miles at zoom factor 1).  As noted above, 
  399.     to provide this level of detail everywhere in the world requires a 
  400.     significant amount of disk space.  
  401.     
  402.     Not everyone needs or wants to devote resources to supporting the 
  403.     maximum available detail world-wide.  MAPIT's World Base Data level 
  404.     supports a global zoom level of 24 and requires more than 3 MB of disk 
  405.     space.  Those wanting maximum detail are free to order from the six 
  406.     Detail packages, divided roughly by continent.  See REGISTER.DOC for 
  407.     particulars.
  408.  
  409.  
  410. Included Programs:
  411.  
  412.   MAPIT
  413.  
  414.     The central display program for working with the voluminous MAPIT 
  415.     database.  Detailed instructions are beyond the scope of this file.  
  416.     Turing the system with the Columbus Demo is the best way to learn its 
  417.     capabilities.  (See Run MAPIT above.)
  418.  
  419.     Anytime you enter data into MAPIT, the data is stored in the private 
  420.     file EXTENDED.MP3.  Copy or rename EXTENDED.MP3 to an unused filename 
  421.     to save the data permanently.
  422.  
  423.         > COPY  (or REN) EXTENDED.MP3  myfile.MP3
  424.  
  425.     Copy makes an additional copy of EXTENDED.MP3 while rename effectively 
  426.     deletes the original so that you'll start out with a fresh zero-length 
  427.     EXTENDED.MP3 the next time you run MAPIT
  428.  
  429.     Alternately you can run MAPIT with a command line argument specifying
  430.     an alternate name for your private data file.
  431.     
  432.         > MAPIT  /EXTENDED=myfile
  433.     
  434.     Enter MAPIT /? at the command line for a complete list of arguments.
  435.     
  436.     You can combine several of your private files with the binary copy 
  437.     command.
  438.  
  439.         > COPY  /B FILE_1.MP3+FILE_2.MP3+...  BIG.MP3
  440.             or
  441.         > COPY  /B FILE*.MP3  BIG.MP3
  442.  
  443.     Remember that once files are combined, they can't be separated. Don't 
  444.     delete the orginals until you are sure.
  445.  
  446.  
  447.     MAPIT TIPS
  448.  
  449.     MAPIT is busy scanning the databases when the cursor disappears 
  450.     between repaints. When it becomes visible again, MAPIT is ready to 
  451.     accept command input again. Remember, you can cut short each database 
  452.     scan by pressing the Esc key _ once for the main database and again, 
  453.     if necessary, for your private database. (Usually the main database 
  454.     scan is much longer.)
  455.  
  456.     Use the cross hairs displayed by POSITION/Center for more accurate 
  457.     lat/long display in the status line while measuring positions of 
  458.     objects. Cancel when finished with the right mouse button.
  459.  
  460.     Use DOS's NUL file name if you need an empty file to read from or a 
  461.     bit bucket to write to.  For example, if you wish to view or operate 
  462.     on the private database file EXTENDED.MP3 file by itself without 
  463.     possible interference from the data in the main database WORLD.MP3, 
  464.     open MAPIT using the NUL file as the main database name:
  465.  
  466.          > MAPIT  NUL
  467.  
  468.  
  469.   FIGEDIT
  470.  
  471.     The figure creation/editing program.  This program operates on files 
  472.     ending in the extension .FIG.  
  473.  
  474.     There is a limit of 100 entities per figure.
  475.  
  476.     The key is to KEEP FIGURES SIMPLE.  Detail which looks good at full 
  477.     screen is clutter at 10%.
  478.  
  479.     .FIG files can be concatinated with the binary copy just as .MP3 files.
  480.  
  481.   MP1TOMP3
  482.  
  483.     A conversion utility designed to convert straight text files 
  484.     containing strings of latitutde/longitude pairs as might be generated 
  485.     from a CAD system or digitizer into .MP3 file format. .MP3 files 
  486.     require only about 1/3 the disk storage of their .MP1 counterparts.
  487.     
  488.     The .mp1 file format is a simple ASCII listing of latitudes and 
  489.     longitudes representing strings of connected points. String 
  490.     termination is marked by separator records.  
  491.     
  492.   MP3TOMP1
  493.  
  494.     A conversion utility which converts line data from MAPIT's .MP3
  495.     binary format to .MP1 ASCII format.  Layer, id, and min and max
  496.     zoom information carried in the MAPIT format are lost.
  497.  
  498.  
  499. Enhancements:
  500.  
  501.     Many obvious and some not-so-obvious enhancements are in planning.  
  502.     Register your copy of MAPIT and let me know what YOU'D like to see.  
  503.     The best ideas come from users.  This is your chance to influence the 
  504.     direction of product growth.
  505.  
  506.  
  507. Contents of Disks:
  508.     
  509.     The shareware distribution disks contain the following files:
  510.     
  511.  
  512.     install.exe       installation program
  513.     installx.fil      installation scripts
  514.     vendinfo.diz      distributor legal information & product descriptions
  515.     mapit?.pak        packed archive files
  516.  
  517.       *.pcx             example screen dumps for color fill and ad material 
  518.       readme.txt        general information and instructions
  519.       register.txt      shareware registration form
  520.       columbus.mp3      Columbus demo instruction database
  521.       columbus.txt      text from the Columbus demo
  522.       demo.mp3          Shareware MAPIT's main data file
  523.       mapit.txt         (older) MAPIT User's Manual
  524.       mapit.exe         main map display program       
  525.       figedit.exe       figures creation program
  526.       std.fig           example figures file
  527.       std.fnt           stroked font file
  528.       gps_util.txt      GPS Utilities Manual
  529.       gpstonme.exe      GPS data capture utility
  530.       nmetomp1.exe      raw GPS NMEA to .mp1 data conversion utility.
  531.       mp1tomp3.exe      ASCII to .mp3 data converter
  532.       mp3tomp1.exe      .mp3 line data to ASCII converter
  533.       apoloop.nme       actual GPS NMEA data generated by gpstonme.exe
  534.       track.mp1         small example GPS data in .mp1 format
  535.     
  536.  
  537.