home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / worldmap / swivel.arc / SWIVEL.DOC < prev    next >
Encoding:
Text File  |  1988-05-12  |  6.6 KB  |  124 lines
  1.                      SWIVEL USER'S GUIDE (VERSION 1.0)
  2.  
  3. Ken Van Camp
  4. P.O Box 784
  5. Stroudsburg, PA 18360
  6.  
  7.     SWIVEL stands for "Simple World Interactive Viewing Enhanced Library",
  8. and is an interactive program to allow viewing of "The World Digitized",
  9. Copyright (C) John B. Alison.  It will "let your fingers do the walking"
  10. across the world on your computer. While SWIVEL is placed in the public domain
  11. and is freely distributable, the data for the The World Digitized is not.
  12. Read Mr. Alison's documentation (READ.ME) for details on payment.  I highly
  13. recommend that anyone that uses SWIVEL send Mr. Alison the $20 donation he
  14. requests -- this database represents an awful lot of work!
  15.     SWIVEL is, as its name says, simple.  It represents only about level
  16. III in the suggested program by Mr. Alison.  SWIVEL runs on IBM PC-compatible
  17. computers WITH AN EGA-COMPATIBLE GRAPHICS ADAPTER.  SWIVEL must have an
  18. EGA to work; it will probably hang a computer with the standard CGA or
  19. Hercules type card.
  20.     Using SWIVEL is simple.  You start it up by just typing 'SWIVEL'; no 
  21. command-line parameters are allowed.  (In fact, if you do put any parameters 
  22. on the command line you will get a single-screen summary of SWIVEL's features.
  23. So typing something like 'SWIVEL HELP' will remind you of the important 
  24. features.)  SWIVEL will immediately clear the screen and plot a grid.  Grid
  25. lines in SWIVEL are always plotted in 20-degree increments.  The grid is
  26. plotted in white, and the equator and international dateline are in yellow.
  27. There is also a yellow box around the normal usable area, from -180 to +180 
  28. degrees longitude, and from -90 to +90 degrees latitude.  The limits of the
  29. screen are somewhat larger when you first start up SWIVEL (-246 to +246
  30. degrees longitude, and -142 to +142 degrees latitude), so not all of the 
  31. screen is actually used.
  32.     There are currently eight one-letter commands accepted by SWIVEL, and
  33. I will now describe each in turn:
  34.  
  35. A  -  ALL
  36.     This command plots all the data files in the world database.  In fact,
  37. SWIVEL does not know all of the file names; it reads the names from a file
  38. named ALLFILES.DAT, which is a simple text file that you may modify to
  39. your liking.  It contains one line per file to be plotted, and each line
  40. starting with a number (the color # to plot the file in) followed by a
  41. space, followed by the file name.  The file ends with the number 0 alone
  42. on a line.  For a list of available color numbers (1-15), just use the
  43. Color command in SWIVEL or see the beginning of the SWIVEL.PAS source 
  44. listing.  The file names can be either absolute (like B:\AF0.MP1) or
  45. relative (like AFRICA\AF0.MP1).  All data files for SWIVEL end in a .MP1
  46. extension.  For colors, I have set the default in ALLFILES.DAT to draw
  47. all coastlands in red, islands in magenta, lakes in blue, and political
  48. boundaries in dark grey.  Feel free to edit this file to your liking.
  49.     You can abort this command, incidentally, by hitting the Escape key.
  50. SWIVEL only checks for a keypress after each file is finished plotting,
  51. so don't expect an immediate response.  This command takes a while!
  52.  
  53. V  -  VIEW
  54.     This command allows you to specify a single file for viewing.  You
  55. will probably want to use the D command before you use this one, to
  56. first set a default directory to look in.  For example, to view the
  57. African coastlands, use D to set the directory to 'AFRICA' and then use
  58. V to specify the name 'AF0'.  For the view command, don't add the .MP1
  59. extension; it's appended automatically by SWIVEL.  If you have already
  60. set a directory name (and you are using the standard SWIVEL directories), 
  61. you will be prompted with the names of all possible files.
  62.     The screen does not clear before each View command, so you can use
  63. this command to put several files up on the screen at one time.
  64.  
  65. C  -  COLOR
  66.     This command sets the color for all subsequent plotting by the V
  67. command.  The default when the program is started is red.
  68.  
  69. R  -  RESCALE
  70.     This command allows you to change the area plotted by SWIVEL, to zoom
  71. in on areas of the globe.  You will be informed of the current plotting
  72. limits, and asked to enter new numbers.  You will have to enter four
  73. numbers (separated only by a space -- no commas!), which are the degrees
  74. west longitude, south latitude, east longitude, and north latitude.
  75. Alternatively, you can think of it as Xmin, Ymin, Xmax and Ymax.  For
  76. instance, you could zoom in on the area from -100 to -20 longitude and
  77. -50 to 0 latitude by typing:
  78.   -100 -50 -20 0
  79. However, the scale you enter will probably not be the actual scale SWIVEL
  80. uses.  That is because SWIVEL automatically adjusts the scaling to keep
  81. the true X-Y proportions on the screen.  Either the X or Y scaling will
  82. be adjusted (but never both), in such a way that your intended viewing
  83. area is always on the screen (and then some).
  84.  
  85. M  -  MERCATOR
  86.     By default, SWIVEL does its plotting with a Mercator projection.
  87. This command toggles the use of Mercator projection; hitting it a first
  88. time turns off the Mercator projection; hitting it again turns it back
  89. on, and so on.  The screen doesn't clear when this is changed, so you
  90. can plot the same file twice (in two different colors) to see the
  91. difference between using Mercator projections and not.
  92.  
  93. D  -  DIRECTORY
  94.     This command sets the directory for all subsequent V commands (until
  95. another D command).
  96.  
  97. E  -  ERASE
  98.     This command just erases the Command prompt, so you can print the
  99. screen without having the text at the top of the printout.  Hitting E
  100. again puts the prompt back up there (although all commands still function
  101. even when the prompt is gone).  Don't ask me how you're going to print
  102. the screen, however.  SWIVEL doesn't provide that capability itself, so
  103. you'll have to have your own memory-resident screendump command.  My
  104. personal preference is for a utility called Inset, by Inset Systems.
  105.  
  106. Q  -  QUIT
  107.     This quits out of SWIVEL.
  108.  
  109.  
  110.  
  111.     Some closing words.  First, if you find something wrong with SWIVEL,
  112. try to fix it yourself.  All the source for SWIVEL (as well as an excellent
  113. multi-windowing graphics package for the EGA) is provided.  Sorry, but
  114. it only compiles under Turbo Pascal 3.01A (and probably earlier versions);
  115. it doesn't compile under TP 4.0.  I'm calling this version 1.0, but I
  116. really have no intention of enhancing the program since I'm happy with it
  117. the way it is.  But if you find a bug you can't fix, let me know and I'll
  118. try to track it down.
  119.     I am, however, working a version for the Commodore Amiga (written in
  120. Aztec C).  If you want that, drop me a line for a status report.
  121.  
  122. ..Ken Van Camp  <kvancamp@ARDEC.ARPA>
  123.  
  124.