home *** CD-ROM | disk | FTP | other *** search
/ World of Shareware - Software Farm 2 / wosw_2.zip / wosw_2 / GENERAL / MAPIT10A.ZIP / README.DOC < prev    next >
Text File  |  1992-09-11  |  16KB  |  422 lines
  1. (readme.doc)
  2.  
  3.             MAPIT - Your Graphics Notepad on the World
  4.     
  5.  
  6.     MAPIT is a user-extensible world map of the detail normally found 
  7.     only in mainframe databases.  Scientist or salesman, MAPIT enables 
  8.     you to investigate, analyze, organize, record, track, reproduce, and 
  9.     communicate your graphical and textual data and concepts in pictures 
  10.     as well as words.  A powerful vector-based reference tool, MAPIT 
  11.     contains a wealth of information and is just plain fun to use.  
  12.  
  13.     Create private databases to distribute your own graphic and textual 
  14.     data to co-workers and friends with lines and figures inserted to 
  15.     within 200 feet ANYWHERE IN THE WORLD.  Seven scalable Stroked Text 
  16.     faces, map or screen relative, and Hidden Text collapsing to small 
  17.     markers support your text needs.
  18.  
  19.     The World Database, which includes coastlines, lakes, rivers, canals, 
  20.     reefs, saltflats, national boundaries, and US state and Canadian 
  21.     provincial borders, supports zooms of 750 or more without degradation.  
  22.     Also included are 6,000 international cities as well as 20,000 US 
  23.     cities with 1990 census population figures.
  24.     
  25.  
  26. Quick Start:
  27.     
  28.     MAPIT, as a compute and disk-intensive application requires, an IBM 
  29.     386SX (or more powerful) compatible computer, 512KB RAM, an EGA or 
  30.     VGA display, and a MOUSE.
  31.     
  32.     Install a Mouse.
  33.  
  34.     MAPIT REQUIRES A MOUSE.  Unless you have a mouse physically 
  35.     attached to your computer AND have installed its driver, you
  36.     will be unable to operate MAPIT and will have to reboot your
  37.     computer if you try.
  38.  
  39.     Install the mouse driver by issuing the following command
  40.     at the command prompt.
  41.  
  42.         > "path"\MOUSE
  43.  
  44.     where "path" is the path to the directory containing the mouse
  45.     driver.
  46.  
  47.     Place this command in your AUTOEXEC.BAT so MOUSE is always 
  48.     available.
  49.     
  50.  
  51.     The shareware version of MAPIT is distributed as a two disk set.  Both
  52.     disks must be loaded onto your hard drive before beginning.
  53.  
  54.     Prepare MAPIT Directory.  (Optional)
  55.  
  56.     You probably want to create a directory on your hard drive to
  57.     hold MAPIT's programs and data.
  58.  
  59.         > mkdir  MAPIT
  60.         > cd      MAPIT
  61.  
  62.     Load the Data.
  63.  
  64.     From the destination directory of your hard drive and with
  65.     MAPIT Disk 1 in your floppy drive, issue one of the following
  66.     two commands.
  67.  
  68.         > A:install            (Assumes floppy drive A:)
  69.              or
  70.         > X:install  X:   (Uses floppy drive X:)
  71.  
  72.     The install program will copy MAPIT to your hard drive, 
  73.     prepare the data files, and, unless you Control-C when given 
  74.     the opportunity at the end, will execute MAPIT for you.
  75.  
  76.  
  77.     Running MAPIT.
  78.  
  79.     MAPIT will run this shareware package by entering 
  80.     
  81.         > MAPIT  DEMO
  82.  
  83.     Ing general, MAPIT is started from the command line by entering
  84.  
  85.         > MAPIT  data_file_name
  86.  
  87.  
  88.       where
  89.         data_file_name  -  the name of any .mp3 format data file,
  90.                    eg: demo.mp3
  91.  
  92.     MAPIT looks for three other files at startup time.
  93.  
  94.         std.fnt  -  The standard font file.  Without it, stroked
  95.                 text doesn't work.
  96.  
  97.         std.fig  -  The standard figures file.  Normally this file
  98.                 is user-created by EDITFIG and contains the
  99.                 user's custom figures.  Without it, figures
  100.                 won't be displayed.
  101.  
  102.         extended.mp3      -  The user's private database.  If none
  103.                  exists, a zero length file is created.
  104.                 Adding lines, figures, and text expands it.
  105.  
  106.     Using the Mouse
  107.  
  108.     Some, may at first be confused by the two distinct ways the 
  109.     mouse is used.
  110.  
  111.     DRAGGING  -  Some selections (eg. Zoom by Corners) require 
  112.     depressing the left button to establish the starting corner or
  113.     position and, WITH THE BUTTON STILL DEPRESSED, dragging the
  114.     cursor to the second corner or position to be measured BEFORE
  115.     RELEASING THE BUTTON.     If you press and release at the same
  116.     point when a drag is required, nothing happens.
  117.  
  118.     POINT & CLICK     -  Other activities, notably those requiring 
  119.     one-at-a-time point selections, look for the depression and 
  120.     release of the left mouse button without any intervening 
  121.     movement.  Sometimes use of the RIGHT mouse button is required
  122.     to signal the end of multiple point entry.
  123.  
  124.  
  125.     Tuning Your System.
  126.  
  127.     MAPIT requires a properly tuned high performance computer.  The
  128.     most significant performance boost you can give is by using disk 
  129.     cache software such as SMARTDRV which comes with DOS 5 and WINDOWS. 
  130.     There are other good disk caches out there, too.
  131.  
  132.     The disk cache must be of adequate size, at least 500K, if it is
  133.     to be of any use.  With a disk cache, you can reduce the buffers=
  134.     statement in your CONFIG.SYS to a low as 3, some say.
  135.     
  136.     MAPIT's .mp3 data files are LARGE, but they are efficiently
  137.     designed and already compact.     Data compaction drivers such as 
  138.     STACKER will NOT gain you appreciable space and will SLOW your
  139.     disk system (to about one half).  Do NOT place MAPIT's data files 
  140.     on compacted drives without first verify performance loss versus 
  141.     space savings for your hardware/software combination.
  142.  
  143.     MAPIT is designed to display graphics adequately without a math
  144.     coprocessor.  Stroked text, however, which can be oriented at any 
  145.     angle, is compute intensive and will respond positively to the 
  146.     addition of a math chip.
  147.  
  148.  
  149. MAPIT Explained:
  150.  
  151.     MAPIT is a professional-level mapping application which includes a 
  152.     detailed database of the world and programs to interact with and 
  153.     supplement that database.  You have the shareware version of MAPIT, 
  154.     a truncated version designed to give you the feel of MAPIT's full 
  155.     capabilities in an affordable format.  
  156.  
  157.     Registered versions of MAPIT come in a range of mapping detail to
  158.     fit a variety of users' mapping needs, hard disk limitations, and 
  159.     pocketbooks.  The full MAPIT requires upwards of 30 MB of disk 
  160.     storage and is shipped on multiple 1.44 MB 3.5" floppies.
  161.  
  162.     The different detail options of MAPIT's database can most easily
  163.     be explained in terms of zoom factor.  The initial MAPIT display
  164.     including the whole earth is defined as zoom factor 1 (shown in
  165.     the lower left corner of the screen).  Zooming in to half that 
  166.     distance changes the zoom factor to 2.  Zooming in on the US so it
  167.     fills the whole screen, for instance, requires a zoom factor of
  168.     approximately 5.  
  169.     
  170.     The world database included with shareware MAPIT holds resolution
  171.     to a zoom factor of approximately 6.  Zoom much closer than that
  172.     and you begin to notice the jaggies - a decided compromise in 
  173.     object detail.  The one area of the globe which has been supplied 
  174.     as an example of full detail is the island of Cuba, just south of
  175.     the United States off the coast of Florida.  You should be able
  176.     to zoom in to a factor of 750 or so before lack of detail becomes
  177.     an issue.  At Cuba's latitude, this means the entire screen width 
  178.     covers a distance of 31 miles (as opposed to 24,857 miles at zoom
  179.     factor 1).    As noted above, to provide this level of detail every-
  180.     where in the world requires a significant amount of disk space.  
  181.  
  182.     Not everyone needs or wants to devote resources to supporting the
  183.     maximum available detail world-wide.  MAPIT's Base World Data level 
  184.     supports a global zoom level of 24 and requires more than 3 MB of disk 
  185.     space.  Those wanting maximum detail are free to order from the six 
  186.     Detail packages, divided roughly by continent.  See REGISTER.DOC
  187.     for particulars.
  188.  
  189.  
  190. Included Programs:
  191.  
  192.     MAPIT
  193.  
  194.     The central display program for working with the voluminous 
  195.     MAPIT database.  Detailed instructions are beyond the scope of
  196.     this file.  Turing the system with the MAPIT Demo is the best way
  197.     of learning its capabilities.
  198.  
  199.         > copy  MAPITDEM.MP3      EXTENDED.MP3
  200.         > MAPIT  DEMO
  201.  
  202.     The copy step should have been done by the install batch file,
  203.     but the preceding example shows that EXTENDED.MP3 can be reloaded
  204.     fresh with the MAPIT Instructional Demo if need be.  Run MAPIT
  205.     with the shareware database DEMO.MP3 and follow the instructions
  206.     in Hidden Text 1 (Press Left Mouse button in triangle 1).
  207.  
  208.     MAPIT's binary .mp3 data files can be combined together with the
  209.     binary copy command:
  210.  
  211.         > copy /b FILE_1.MP3+FILE_2.MP3...  BIG.MP3
  212.             or
  213.         > copy /b FILE*.MP3  BIG.MP3
  214.  
  215.     FIGEDIT
  216.  
  217.     The figure creation/editing program.  This program operates on
  218.     files ending in the extension .FIG.  It is in rather rough shape,
  219.     without documentation, and offered with an apology.  Fool around
  220.     with it and you'll figure out how to make and store figures.
  221.     The menu items along the top row are really there - just click
  222.     on them to make them reappear.
  223.  
  224.     There is a limit of 100 entities per figure (the count is on
  225.     the bottom status line) with no way to delete bad entities!
  226.  
  227.     The key is to KEEP FIGURES SIMPLE.  Detail which looks good at
  228.     full screen is clutter at 10%.  Here's where artistic talent is
  229.     invaluable.
  230.  
  231.     .FIG files can be concatinated with the binary copy just as 
  232.     .MP3 files.
  233.  
  234.     MP1TOMP3
  235.  
  236.     A conversion utility designed to convert straight text files 
  237.     containing strings of latitutde/longitude pairs as might be 
  238.     generated from a CAD system or digitizer into .MP3 file format.
  239.     .MP3 files appear to be about 1/3 the size of their .MP1 counter-
  240.     parts.
  241.     
  242.     Usage:
  243.         MP1TOMP3  data_file  [/options]
  244.  
  245.     where
  246.         data_file  -      the name of a .mp1 file to be converted
  247.                  to .mp3 format.  A .mp3 file of the same
  248.                  name is created.
  249.     options:
  250.         /id           -  Region Id stored in the region header.     
  251.  
  252.         /layer     -      Layer assignment stored in entity header.
  253.                  Defaults to layer 0.
  254.  
  255.         /minzoom   -      Min zoom factor stored in entity header.
  256.                  Defaults to 0.
  257.  
  258.         /maxzoom   -      Max zoom factor stored in entity header.
  259.                  Defaults to 0.
  260.  
  261.     The .mp1 file format is a simple ASCII listing of latitudes and 
  262.     longitudes representing strings of connected points. String 
  263.     termination is marked by separator records.  
  264.  
  265.     .MP1 File Format:  variable length ASCII records:
  266.                (latitude and longitude with comments)
  267.  
  268.         Data Records
  269.         field
  270.           1        latitude        floating point number
  271.  
  272.           2        blank        field separator
  273.  
  274.           3        longitude        floating point number
  275.  
  276.          [4]        optional        begining with a blank
  277.                comment
  278.  
  279.           5        line feed        end of record (LF - 10)
  280.  
  281.        Separator Records
  282.         field
  283.          [1]        optional blanks[s]
  284.  
  285.           2        line feed        end of record (LF - 10)
  286.  
  287. Known Bugs:
  288.  
  289.     Deadlines dictate that MAPIT be shipped with known bugs.
  290.  
  291.     There are large cities and capitals missing from the DEMO.MP3
  292.     database.  These problems will be addressed in the full database.
  293.  
  294.     The MAPIT command EDIT/Copy works slowly.  Don't use with a large 
  295.     database, or you may grow old waiting.  It also misses copying 
  296.     Hidden Text whose triangle markers are not visible.
  297.  
  298.     EDIT/Assign to Layer also works VERY slowly and incorrectly.
  299.     It changes the layers of objects other than those which you select.
  300.     Avoid this command.
  301.  
  302.  
  303. Enhancements:
  304.  
  305.     Many obvious and some not-so-obvious enhancements are in 
  306.     planning.  Register your copy of MAPIT and let me know what
  307.     YOU'D like to see.  The best ideas come from users.  This is 
  308.     your chance to influence the direction of product growth.
  309.  
  310.  
  311. Pretty Pictures:
  312.  
  313.     Those who have need for colorful output and pretty pictures can
  314.     run MAPIT within a Windows DOS shell, capture a screen with
  315.     the Print Screen key, switch back to Windows, and Shift/Insert 
  316.     the image into the Paint program.  There use the Invert Option
  317.     to change all the ugly black to white and fill the oceans with
  318.     lovely blue.  Turn off the Grid while in MAPIT to make area
  319.     fills easier.
  320.  
  321.  
  322. Contents of Disks:
  323.     
  324.     The shareware distribution disks contain the following files:
  325.     
  326.     MAPIT Disk 1:
  327.  
  328.     readme.doc      general information and instructions
  329.     register.doc      shareware registration form
  330.     vendor.doc      distributor information & product description
  331.     install.bat      installation batch file
  332.     installx.bat      auxillary installation batch file
  333.     demo_a.mp3      demo database, part 1
  334.     mapitdem.mp3      Mapit demo instruction database
  335.     mapit.exe      main program         
  336.        *mp1tomp3.exe    ASCII to .mp3 data converter
  337.     std.fig  example figure file
  338.     std.fnt  stroked font file
  339.  
  340.     * distributed with BBS version.
  341.  
  342.     MAPIT Disk 2:
  343.  
  344.     demo_b.mp3      demo database, part 2
  345.     figedit.exe      figures creation program
  346.  
  347.     
  348. Legal Considerations:
  349.     
  350. Copyright:
  351.     
  352.     The collection of software described in this file and contained on 
  353.     this disk is the Shareware Version of MAPIT (the Software) and is 
  354.     Copyright 1992 John B. Allison.
  355.  
  356. Ownership:
  357.     
  358.     You have purchased or otherwise obtained media containing a copy of 
  359.     the Shareware Version of MAPIT.  The Software contained on the media 
  360.     and all rights pertaining thereto remain the sole property of 
  361.     John B. Allison.  By continuing to use the Software, you indicate 
  362.     your acceptance of the terms and conditions outlined below.
  363.     
  364. Shareware License: 
  365.     
  366.     You are permitted to use the Software for an evaluation period of 
  367.     THREE WEEKS.  After the evaluation period, you must either remove all 
  368.     copies of the Software from your computer system(s) and refrain from 
  369.     all additional use, or register your copy of the Software with
  370.      
  371.                 Allison Software
  372.                  166 Shady Lane
  373.                   Apollo, PA 15613 USA
  374.     
  375.                  (412) 727-2198
  376.                  CompuServe 72600,1200
  377.     
  378.     (See the file REGISTER.DOC on the distribution disk for registration 
  379.     instructions.)
  380.  
  381. Shareware Distribution:
  382.     
  383.     You may give copies of the Software IN ITS UNMODIFIED ENTIRETY to
  384.     friends or to other parties.
  385.  
  386.     You may distribute copies of the Software IN ITS UNMODIFIED ENTIRETY
  387.     on a commercial basis for a fee not to exceed SIX DOLLARS per diskette, 
  388.     or you may post the Software on electronic bulletin boards if you package 
  389.     the Software so that each diskette must be downloaded IN ITS UNMODIFIED 
  390.     ENTIRETY.  
  391.  
  392.     If you post it, you must compress or otherwise package the Software 
  393.     in either a combined file named "MAPIT10.ext" or as two separate files 
  394.     named "MAPIT10A.ext" and "MAPIT10B.ext" where ".ext" reflects the type 
  395.     of compression or packaging used.
  396.  
  397.     You may not list the Software in advertisements, catalogs, or other
  398.     literature as "FREE SOFTWARE".  Shareware is "Try-Before-You-Buy"
  399.     software, not free.
  400.     
  401.     
  402. Liability:    
  403.  
  404.     SINCE YOU ARE NOT PAYING ANY MONEY FOR THIS TRIAL USE VERSION, YOU 
  405.     RECEIVE IT ENTIRELY "AS IS", AND WE SHALL NOT BE LIABLE TO YOU FOR 
  406.     ANY DAMAGES OF ANY KIND WHATSOEVER.
  407.  
  408.  
  409. ASP Member:
  410.  
  411.  
  412.     This program is produced by a member of the Association of Shareware 
  413.     Professionals (ASP).  ASP wants to make sure that the shareware 
  414.     principle works for you. If you are unable to resolve a shareware-
  415.     related problem with an ASP member by contacting the member directly, 
  416.     ASP may be able to help. The ASP Ombudsman can help you resolve a 
  417.     dispute or problem with an ASP member, but does not provide technical 
  418.     support for members' products. Please write to the ASP Ombudsman at 
  419.     545 Grover Road, Muskegon, MI 49442-9427 or send a Compuserve message 
  420.     via CompuServe Mail to ASP Ombudsman 70007,3536
  421.  
  422.