home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / amiga / mapping / drawmap.lha / DrawMap / DrawMap4.0.doc < prev    next >
Encoding:
Text File  |  1992-04-15  |  11.3 KB  |  258 lines
  1.                                   Drawmap
  2.                                       
  3.                                 Version 4.0
  4.  
  5.        A program for drawing representations of the Earth's surface.
  6.  
  7.                                      by
  8.  
  9.                                 Bryan Brown
  10.  
  11.                                   01/18/92
  12.  
  13.  
  14. I.  Abstract
  15.  
  16. This program gives the user the ability to generate representations of the
  17. Earth's surface, using the full Micro World Data Bank files. Representations
  18. such as a Mercator projection, hemispherical views, and orbital views can be
  19. generated.  The user has full control over which items to draw (e.g.,
  20. coastlines, rivers, etc.), as well as the detail level at which to draw the
  21. items.  The user also has full control of the 16-color palette, with user
  22. specified colors for flood fills, line drawing, text, and for the individual
  23. map items.  Screens can be printed or saved to disk as standard IFF files. A
  24. fully user-configurable online help facility is also provided.
  25.  
  26.  
  27. II.  Disclaimer
  28.  
  29. As with version 3.1, no guarantee is made as to the accuracy of the national
  30. boundaries represented by this product.  Recent political events have made
  31. the map file out of date.
  32.  
  33.  
  34. III.  Distribution
  35.  
  36. As with version 1.0 (on Fish disk 229), Version 2.0 (on Fish disk 315),
  37. Version 2.24d (on Fish disk 485), and version 3.1 (on Fish disk 545), this
  38. program is released into the public domain (FREEWARE), and is freely
  39. distributable as long as this document file, source code, header files,
  40. binary files, IFF file and text files are included in their entirety.  The
  41. source may be modified for personal use, but is NOT for commercial use.  The
  42. program was originally developed with Aztec C version 3.6a.  The
  43. enhancements that lead to Version 2.24 were compiled with the SAS (Lattice)
  44. C compiler V5.10.  The modifications resulting in version 3.1 were compiled
  45. with Aztec C version 3.6a.  Version 4.0 was generated with Aztec C version
  46. 5.2a. 
  47.  
  48. Files included:
  49.  
  50.      drawmap4.0                  - executable code
  51.      drawmap4.0.info             - icon file for workbench users
  52.      drawmap4.0.020              - executable code requiring at least a
  53.                                    68020 CPU and 68881 FPU
  54.      drawmap4.0.020.info         - icon file for workbench users
  55.      drawmap4.0.doc              - documentation file
  56.      drawmap4.0.doc.info         - icon file for workbench users
  57.      drawmap.c                   - source code
  58.      drawmap.h                   - general header file
  59.      drawmap-help.h              - header file for help option
  60.      drawmap-menu.h              - header file for menu selections
  61.      drawmap-proto.h             - header file with function prototypes
  62.      drawmap-req.h               - header file for string requester
  63.      reqglue.asm                 - glue file for accessing req.library
  64.                                    (from Fish disk 419, where the object
  65.                                    file is named areqglue.o)
  66.      reqbase.h                   - header file for accessing req.library
  67.                                    (from Fish disk 419)
  68.      ILBM_lib.h                  - header file for accessing ilbm.library
  69.                                    (from Fish disk 463)
  70.      IlbmInterface.asm           - interface file for accessing ilbm.library
  71.                                    (from Fish disk 463)
  72.      coast.pnt                   - map file with coastlines
  73.                                    (74967 points)
  74.      country.pnt                 - map file with country outlines
  75.                                    (22359 points)
  76.      island.pnt                  - map file with island outlines
  77.                                    (35171 points)
  78.      lake.pnt                    - map file with lake outlines
  79.                                    (15118 points)
  80.      river.pnt                   - map file with rivers
  81.                                    (28194 points)
  82.      state.pnt                   - map file with U.S. state outlines
  83.                                    (2259 points)
  84.      map.config                  - configuration file containing user
  85.                                    palette
  86.      map.limits.bin              - auxiliary file containing max and min
  87.                                    values of latitude and longitude for
  88.                                    each arc in map files
  89.      map.flat.pic                - IFF file containing a flat map for
  90.                                    initial display
  91.      drawmap.help                - simple text file containing help
  92.                                    information for each menu item
  93.      req.library                 - library for general requesters
  94.                                    (from Fish disk 419)
  95.      ilbm.library                - library for saving IFF pictures
  96.                                    (from Fish disk 463)
  97.      make4.0                     - simple batch file for building the
  98.                                    executable code
  99.      Reqlibrary.lzh              - compressed version of Reqlibrary
  100.                                    materials from Fish disk 419
  101.      ilbm.lzh                    - compressed version of ILBMLibrary
  102.                                    materials from Fish disk 463
  103.      InstallLibs                 - simple batch file for installing
  104.                                    req.library and ilbm.library into
  105.                                    the user's LIBS: directory
  106.      InstallLibs.info            - icon file for workbench users
  107.  
  108.  
  109. IV.  Differences from version 3.1
  110.  
  111.     o Requires 1.5 megabytes of memory.  All map files are preloaded into
  112.       memory for speed.
  113.  
  114.     o Runs only from a hard disk with at least 1.6 megabytes of space to
  115.       hold the source, executable, and map files.  (Sorry, floppy-disk users,
  116.       but I have only one 3.5" floppy disk drive, with no way to check any
  117.       other configuration.)
  118.  
  119.     o Uses the full Micro World Data Bank data files, with separate files
  120.       for the coastlines, countries, islands, lakes, rivers and U.S. states.
  121.  
  122.     o User selection of items to be included, the detail level and the color
  123.       in which to draw each item.  Coastlines, rivers, etc., can be
  124.       different colors to more easily distinguish between the items.
  125.  
  126.     o Trig files have been removed to reduce the memory requirements.  Trig
  127.       functions are now computed instead of being retrieved from a pre-built
  128.       buffer.
  129.  
  130.     o Source now uses a "point" data structure instead of merely indexing
  131.       into a contiguous buffer, making the source easier to read.
  132.  
  133.     o Fixed a bug in the box-selection and text-movement functions, in which
  134.       the rubber-banded boxes did not appear when running under AmigaDos
  135.       2.04.
  136.  
  137.     o Compiled with Aztec C version 5.2a.
  138.       
  139.  
  140. V.  Notes:
  141.  
  142.     o To run the program, your LIBS: directory must contain the files
  143.       req.library and ilbm.library mentioned above.  The simple batch file
  144.       InstallLibs provided will copy these files into your LIBS: directory.
  145.  
  146.     o To actually run drawmap4.0 or drawmap4.0.020, all the following files
  147.       must reside in the same directory:
  148.  
  149.       drawmap4.0      (or drawmap4.0.020)
  150.       drawmap4.0.info (or drawmap4.0.020.info)
  151.       coast.pnt
  152.       country.pnt
  153.       island.pnt
  154.       lake.pnt
  155.       river.pnt
  156.       state.pnt
  157.       map.config
  158.       map.limits.bin
  159.       map.flat.pic
  160.       drawmap.help
  161.  
  162.     o The online Help facility contains a somewhat detailed description of
  163.       each menu selection.
  164.  
  165.     o To build the program from source, the user will first have to assemble
  166.       the files reqglue.asm and ILBMInterface.asm to generate areqglue.o and
  167.       ilbminterface.o, respectively.  The batch file "make4.0" may then be
  168.       executed to build the actual executable program.  (The reqglue object
  169.       file is named "areqglue.o" instead of "reqglue.o" to signify that the
  170.       file is for Aztec C, and not SAS (Lattice) C.  On Fish disk 463 the SAS
  171.       (Lattice) object file is named "lreqglue.o".)
  172.  
  173.     o For those users (including myself) who prefer pop-up menus to the
  174.       standard Amiga menus, try the pop-up menu system on Fish disk 422. 
  175.       This background program (apparently) works with any normal program that
  176.       uses standard Amiga menus.
  177.  
  178.     o The sheer size of the new map files unavoidably results in slower
  179.       drawing of the maps.  Even the auxiliary file (with suffix "trig.bin")
  180.       in previous releases had to be discarded to reduce the memory
  181.       requirements.  As with version 3.1, the national boundaries in the map
  182.       file "country.pnt" do NOT reflect the current changing political
  183.       situation.
  184.  
  185.     o Unlike in version 3.1, no attempt was made to fill in any gaps in the
  186.       item boundaries.  The map files were obtained on five MS-DOS disks
  187.       from The Software Labs in Intel (low/high byte order) and converted to
  188.       Motorola format (high/low byte order) for use on the Amiga.  This is
  189.       the only modification made to the map files.
  190.  
  191.     o The text for each help entry may be modified by the user using any
  192.       normal text editor.  Note that the Help entries MUST remain in the
  193.       original order, or else the help text will not match the Help gadget
  194.       name.  Each entry in the help file MUST remain delimited by a form feed
  195.       character (12 hexadecimal).  At program startup the program reads the
  196.       help file into memory and looks for the formfeed character,
  197.       replacing it with 0 hexadecimal (the normal end-of-string character in
  198.       C).  The help display option needs this end-of-string character to
  199.       function properly.
  200.  
  201.     o The file "map.limits.bin" (which is used to speed up drawing the
  202.       spherical and box views) contains upper and lower bounds on the
  203.       information in each of the 1263 arcs in the map files.  If this file
  204.       cannot be found at program startup, it is built from scratch, and an
  205.       attempt is made to save the file to disk.  Whether or not the save is
  206.       successful, the program continues.
  207.  
  208.  
  209. VI.  Limitations
  210.  
  211.     o Because of limitations in the req.library and ilbm.library, the mouse
  212.       pointers in the file requester, palette and Help item display windows
  213.       revert to the user's own mouse pointer image rather than the arrowhead
  214.       used in drawmap.  It would be beneficial if the programmer were able
  215.       to specify to req.library and ilbm.library the imagery to use for the
  216.       mouse pointer.
  217.  
  218.  
  219. VII.  Suggestions for further improvements (any volunteers?)
  220.  
  221.     o More kinds of maps (naturally).
  222.  
  223.     o Modify the source code to execute from multiple floppy disk drives
  224.       instead of only from a hard disk.
  225.  
  226.     o For users with small amounts of RAM, do not preload the map files into
  227.       memory.  Read each map file a point at a time as necessary.  This
  228.       would result in slower execution than the current method, but at least
  229.       the program would be usable by more Amiga users.
  230.  
  231.  
  232. VIII.  Acknowledgments
  233.  
  234. As stated earlier, these map files were obtained on five MS-DOS disks from
  235. The Software Labs (3767 Overland Avenue #112, Los Angeles, CA 90034).  These
  236. files were put into the public domain by Fred Pospeschil and Antonio
  237. Riveria, based on original coordinate data generated by the Central
  238. Intelligence Agency.
  239.  
  240.  
  241. IX.  Correspondence
  242.  
  243. This program was originally developed by:
  244.  
  245. Bryan Brown
  246. 13129 Collingwood Terrace
  247. Silver Spring, MD 20904, USA
  248.  
  249.  
  250. Enhancements for version 2.4 were written by:
  251.  
  252. Ulrich Denker
  253. Nienort 46
  254. 4500 Osnabrⁿck, GERMANY
  255.  
  256.  
  257. Modifications for versions 3.1 and 4.0 were written by Bryan Brown.
  258.