home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_progs / educ / drawmap.lha / DrawMap4.1.doc < prev    next >
Text File  |  1992-08-20  |  7KB  |  170 lines
  1.                                   Drawmap
  2.                                       
  3.                                 Version 4.1
  4.  
  5.        A program for drawing representations of the Earth's surface.
  6.  
  7.                                      by
  8.  
  9.                                 Bryan Brown
  10.  
  11.                                   07/03/92
  12.  
  13.  
  14. I.  Abstract
  15.  
  16. This program, an update to release 4.1, gives the user the ability to
  17. generate several additional projections of the Earth's surface, using the
  18. full Micro World Data Bank files.  All map projections may now be centered
  19. at a user-specified point on the Earth's surface, and box views may now span
  20. the international date line.  Versions for PAL systems are also provided.  
  21. This release uses the same map and configuration files as release 4.1.
  22.  
  23. II.  Disclaimer
  24.  
  25. As with version 4.1, no guarantee is made as to the accuracy of the national
  26. boundaries represented by this product.  Recent political events have made
  27. the map file out of date.
  28.  
  29.  
  30. III.  Distribution
  31.  
  32. As with earlier releases, this program is released into the public domain
  33. (FREEWARE), and is freely distributable as long as this document file,
  34. source code, header files, binary files, IFF file and text files are
  35. included in their entirety.  The source may be modified for personal use,
  36. but is NOT for commercial use.  The modifications resulting in version 4.1
  37. were compiled with Aztec C version 5.2a.
  38.  
  39. Files included:
  40.  
  41.      drawmap4.1                  - executable code
  42.      drawmap4.1.info             - icon file for workbench users
  43.      drawmap4.1.020              - executable code requiring at least a
  44.                                    68020 CPU and 68881 FPU
  45.      drawmap4.1.020.info         - icon file for workbench users
  46.      drawmap4.1.PAL              - executable code for PAL systems
  47.      drawmap4.1.PAL.info         - icon file for workbench users
  48.      drawmap4.1.020.PAL          - executable code requiring at least a 68020
  49.                                    CPU and 68881 FPU, for PAL systems
  50.      drawmap4.1.020.PAL.info     - icon file for workbench users
  51.      drawmap4.1.doc              - documentation file
  52.      drawmap4.1.doc.info         - icon file for workbench users
  53.      drawmap.c                   - source code
  54.      drawmap.h                   - general header file
  55.      drawmap-help.h              - header file for help option
  56.      drawmap-menu.h              - header file for menu selections
  57.      drawmap-proto.h             - header file with function prototypes
  58.      drawmap-req.h               - header file for string requester
  59.      map.flat.pic.PAL            - initial map for PAL systems
  60.      reqglue.asm                 - glue file for accessing req.library
  61.                                    (from Fish disk 419, where the object
  62.                                    file is named areqglue.o)
  63.      reqbase.h                   - header file for accessing req.library
  64.                                    (from Fish disk 419)
  65.      ILBM_lib.h                  - header file for accessing ilbm.library
  66.                                    (from Fish disk 463)
  67.      IlbmInterface.asm           - interface file for accessing ilbm.library
  68.                                    (from Fish disk 463)
  69.      drawmap.help                - simple text file containing help
  70.                                    information for each menu item
  71.      make4.1                     - simple batch file for building the
  72.                                    executable code
  73.  
  74. IV.  Differences from version 4.0
  75.  
  76.     o Still requires 1.5 megabytes of memory (not really a difference,
  77.       just a reminder).
  78.  
  79.     o Additional map projections:
  80.  
  81.          Lambert cylindrical
  82.          Gall stereographic
  83.          Hammer-Aitoff polyconic
  84.          Simple polyconic
  85.          Aitoff-Wagner polyconic
  86.          Mollweide pseudo-cylindrical
  87.          Sanson-Flamsteed pseudo-cylindrical
  88.  
  89.     o User may select the point on the Earth's surface to be at the center
  90.       of the maps.
  91.  
  92.     o User may "slide" the center point of the projections along the
  93.       equator, thereby giving an exact equatorial projection.
  94.  
  95.     o Box views may now cross the international date line, thereby allowing
  96.       the user to see the entire south Pacific Ocean, for example.  To 
  97.       accomplish this, first select the initial box near the date line, and 
  98.       then expand the box to cross the date line.
  99.  
  100.       
  101.  
  102. V.  Notes:
  103.  
  104.     o To build the program from source, the user will first have to assemble
  105.       the files reqglue.asm and ILBMInterface.asm to generate areqglue.o and
  106.       ilbminterface.o, respectively.  The batch file "make4.1" may then be
  107.       executed to build the actual executable program.  (The reqglue object
  108.       file is named "areqglue.o" instead of "reqglue.o" to signify that the
  109.       file is for Aztec C, and not SAS (Lattice) C.  On Fish disk 463 the SAS
  110.       (Lattice) object file is named "lreqglue.o".)
  111.  
  112.     o This release uses the exact same map and configuration files as does
  113.       release 4.0.  To save space in the distribution of this release, the
  114.       following files are NOT provided with this release:
  115.  
  116.           coast.pnt
  117.           country.pnt
  118.           island.pnt
  119.           lake.pnt
  120.           map.config
  121.           map.flat.pic
  122.           map.limits.bin
  123.           river.pnt
  124.           state.pnt
  125.  
  126.       and, for the user's LIBS: drawer,
  127.  
  128.           req.library
  129.           ilbm.library
  130.  
  131.       The user must obtain the above files from the distribution copy of
  132.       release 4.0.
  133.  
  134.     o The Help file provided with this release contains information on each
  135.       of the menu selections provided with this release.  As with release
  136.       4.0, the contents of each help entry may be modified using any normal
  137.       text editor.  The same provisos stated for release 4.0 apply to this
  138.       release also.
  139.  
  140. VI.  Limitations
  141.  
  142.     o Because of limitations in the req.library and ilbm.library, the mouse
  143.       pointers in the file requester, palette and Help item display windows
  144.       revert to the user's own mouse pointer image rather than the arrowhead
  145.       used in drawmap.  It would be beneficial if the programmer were able
  146.       to specify to req.library and ilbm.library the imagery to use for the
  147.       mouse pointer.
  148.  
  149. VII.  Suggestions for further improvements (any volunteers?)
  150.  
  151.     o More kinds of maps (naturally).
  152.  
  153.     o Modify the source code to execute from multiple floppy disk drives
  154.       instead of only from a hard disk.  I have no way to test this since I
  155.       have only one floppy disk drive.
  156.  
  157.     o For users with small amounts of RAM, do not preload the map files into
  158.       memory.  Read each map file a point at a time as necessary.  This
  159.       would result in slower execution than the current method, but at least
  160.       the program would be usable by more Amiga users.
  161.  
  162.  
  163. VIII.  Correspondence
  164.  
  165. This release was developed by:
  166.  
  167. Bryan Brown
  168. 13129 Collingwood Terrace
  169. Silver Spring, MD 20904, USA
  170.