home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / e / earthmap / !EarthMap / Docs / Guide next >
Encoding:
Text File  |  1997-03-31  |  8.7 KB  |  241 lines
  1.  
  2. ___________________
  3.  
  4. EarthMap user guide
  5. ___________________
  6.  
  7.  
  8. User, please note
  9. =================
  10.  
  11. EarthMap is Freeware, i.e. it is free software.
  12.  
  13. Copyright notice
  14. ================
  15.  
  16. The copyright (c) of this program belongs to John Kortink. All rights are
  17. reserved.
  18.  
  19. You may not change this program (except for documented configuration
  20. changes). You may not use any part of this program in any other program or
  21. product without my written approval. You may spread this program freely, but
  22. only in complete and unchanged form, and only against bare distribution costs
  23. (if any). This program is provided 'as is'. No fitness of this program for
  24. any particular purpose is implied. Using this program is entirely at your own
  25. risk.
  26.  
  27.  
  28. //
  29. //
  30. // Introduction
  31. //
  32. //
  33.  
  34. EarthMap is an electronic globe. It draws on a huge database consisting of
  35. 5,719,617 line segments, describing coordinates and shape of a number of
  36. natural and man-made features on Earth. This includes coastlines, country
  37. borders, rivers, lakes, canals, glaciers, etc..
  38.  
  39. EarthMap provides an extensive array of viewing facilities, including pan,
  40. zoom and coordinate entry. In addition, any view may be saved as a Draw file.
  41. EarthMap is also very fast. Special care has been taken to make view updates
  42. as fast as possible.
  43.  
  44. The database used by EarthMap is the 'CIA World Data Bank II'. This database
  45. originally consisted of 130Mb of COBOL records. It was compressed from COBOL
  46. records to a more compact representation (leaving around 13Mb of data) by
  47. Brian Reid. The database itself has been put in the public domain by the
  48. government of the USA.
  49.  
  50. You probably received EarthMap without the database files. The easiest way to
  51. obtain them is from Internet. For example, from ftp.digital.com, directory
  52. /pub/graphics/data/cia-wdb, subdirectories africa, asia, europe, namer and
  53. samer. The empty files in the !EarthMap.Maps directory should be replaced by
  54. the appropriate database files. Incidentally, the database files can also be
  55. found on the CD-ROM supplied with RISC PC StrongARM processor cards,
  56. directory 'SOFTWARE.EARTHMAP', archive files AFRICA, ASIA, EUROPE, NAMER and
  57. SAMER.
  58.  
  59. EarthMap can work with any subset of the database files. If a particular
  60. database file is absent or is found to have invalid contents, the part of the
  61. globe corresponding to the database file will simply be missing.
  62.  
  63.  
  64. //
  65. //
  66. // Using EarthMap
  67. //
  68. //
  69.  
  70. On EarthMap's iconbar menu the usual 'Info' and 'Quit' icons can be found. In
  71. addition, 'Control', 'Detail', 'Cache' and 'Save' give access to the
  72. 'EarthMap control', 'EarthMap detail', 'EarthMap cache' and Draw file save
  73. windows (click on the menu entry to make the window permanent) and 'Status'
  74. gives access to the 'Status' menu. The 'EarthMap control', 'EarthMap detail',
  75. 'EarthMap cache' and Draw file save windows and the 'Status' menu are
  76. described below.
  77.  
  78. Clicking SELECT or ADJUST on EarthMap's iconbar icon will open the 'EarthMap
  79. view' window (or, if it is already open, redraw it). The 'EarthMap view'
  80. window is described below.
  81.  
  82.  
  83. //
  84. //
  85. // The 'EarthMap view' window
  86. //
  87. //
  88.  
  89. This window (from now on called 'the view' for short) is your window on the
  90. globe. There are several ways to pan and zoom the view :
  91.  
  92. - Double-clicking SELECT or ADJUST inside the view. The view is panned so
  93.   that the globe point clicked on is at the centre of the new view.
  94. - Double-clicking SELECT or ADJUST inside the view, holding down a CTRL,
  95.   SHIFT or ALT key. The view is zoomed (SELECT = zoom in, ADJUST = zoom out).
  96.   The amount of zoom depends on the key held down (ALT = factor 4, SHIFT =
  97.   factor 2, CTRL = factor 1.5). Also, the view is panned so that the globe
  98.   point clicked on is at the centre of the new view.
  99. - Dragging a 'box' around an area of interest inside the view. The view is
  100.   panned and zoomed so that the selected globe section, at its maximum size,
  101.   is entirely visible inside the new view, and that the centre of the
  102.   selected globe section is at the centre of the new view.
  103. - Using the 'EarthMap control' window, 'Coordinates' part. Enter the required
  104.   longitude and latitude coordinates of the new view centre and click on the
  105.   'Go to' button.
  106.  
  107. There are a couple of important things to note about the view window :
  108.  
  109. - The 'world' basically consists of a coordinate rectangle stretching from
  110.   -180 to +180 degrees longitude (horizontal) and from -90 to +90 degrees
  111.   latitude (vertical). The view window shows this world in 'wraparound' mode
  112.   (to simulate a globe), which effectively means that -180 and +180 degrees
  113.   longitude appear as direct neighbors in the view window, as do -90 and +90
  114.   degrees latitude. While the 'longitude wrap' is correct, the 'latitude
  115.   wrap' obviously isn't (the North and South poles are not neighbors !).
  116.   However, this feature allows much more freedom of movement around the
  117.   globe, in addition to having some entertainment value.
  118. - As there is no real 'end' to the globe, the function of the view window's
  119.   scroll bars is slightly unusual. Due to the way the 'wraparound' feature is
  120.   implemented, the view window is actually a view on not a single world, but
  121.   on a large array of identical worlds, stacked together in both vertical and
  122.   horizontal directions. But a maximum of only a single world is visible in
  123.   the view window. This makes dragging the scroll bars somewhat useless for
  124.   panning around the globe (resulting movements are too coarse). However,
  125.   clicking the scroll bar 'arrows' is still quite useful.
  126.  
  127.  
  128. //
  129. //
  130. // The 'EarthMap control' window
  131. //
  132. //
  133.  
  134. In this window, you will find two parts, called 'Coordinates' and 'Draw
  135. file'.
  136.  
  137. The 'Coordinates' part provides a longitude/latitude coordinate display.
  138. Setting the display to a coordinate and then clicking 'Go to' will pan the
  139. view window so that the coordinate specified is at the new view centre.
  140. Clicking 'Get' will set the display to the coordinates of the current view
  141. centre.
  142.  
  143. The 'Draw file' part allows you to set the page size that is specified in any
  144. saved Draw files. The default of 8.27 x 11.69 inches is standard A4 size.
  145.  
  146.  
  147. //
  148. //
  149. // The 'EarthMap detail' window
  150. //
  151. //
  152.  
  153. This window enables detail manipulation.
  154.  
  155. The database contains information on several different Earth feature types
  156. (each type is called a 'detail' in EarthMap). Each detail belongs to a detail
  157. group. Each detail group ('Boundary', 'Coast, islands & lakes', 'Rivers' and
  158. 'USA state lines') is stored in a seperate database file (the files ending in
  159. 'bdy', 'cil', 'riv' and 'pby' respectively).
  160.  
  161. Every detail has an on/off flag. If a detail is 'on', it is displayed in the
  162. view and saved in Draw files. If a detail is 'off', it is ignored (as if it
  163. were not present in the database). The 'All on' and 'All off' buttons may be
  164. used to switch on/off all the details in a detail group.
  165.  
  166. Every detail has a colour. This is the colour used to render the detail in
  167. the view and in Draw files. Under RISC OS 3.5 and later the colours may be
  168. edited by clicking on the colour box, which will pop up a standard 'colour
  169. picker' window. Under RISC OS versions before 3.5 the colours cannot be
  170. edited.
  171.  
  172.  
  173. //
  174. //
  175. // The 'EarthMap cache' window
  176. //
  177. //
  178.  
  179. This window enables cache manipulation.
  180.  
  181. Every database file has a cache on/off flag. If a cache flag is 'on', the
  182. database file is cached. If a cache flag is 'off', the database file is not
  183. cached. The 'All on' and 'All off' buttons may be used to switch on/off all
  184. the cache flags.
  185.  
  186. EarthMap needs continuous access to the database files, so the speed at which
  187. these can be accessed is quite important. If a database file is cached, it
  188. can be accessed much quicker, at the expense of some of your available
  189. memory. If you have the memory to spare, it is a good idea to cache all the
  190. database files.
  191.  
  192.  
  193. //
  194. //
  195. // The Draw file save window
  196. //
  197. //
  198.  
  199. This window enables you to save the current view as a Draw file.
  200.  
  201. The page size specified in the Draw file may be set in the 'EarthMap control'
  202. window, 'Draw file' part.
  203.  
  204.  
  205. //
  206. //
  207. // The 'Status' menu
  208. //
  209. //
  210.  
  211. In this menu you can manipulate EarthMap's 'status', which consists of a
  212. number of configuration settings.
  213.  
  214. - 'Save' will save the current status.
  215. - 'Load' will load the saved status.
  216. - 'Default' will load the default status.
  217. - 'Kill' will remove the saved status.
  218.  
  219. When EarthMap starts up it loads the saved status, or the default status if
  220. there is no saved status.
  221.  
  222. The status consists of the detail flags and colours ('EarthMap detail'
  223. window), the cache flags ('EarthMap cache' window) and the Draw file page
  224. size ('EarthMap control' window).
  225.  
  226.  
  227. //
  228. //
  229. // Epilogue
  230. //
  231. //
  232.  
  233. Updates of EarthMap will be made available by (in order of preference) :
  234.  
  235. - World Wide Web, on www.inter.nl.net/users/J.Kortink.
  236. - Electronic mail, to kortink@inter.nl.net.
  237. - Snail mail, to : John Kortink, Nutterbrink 31, 7544 WJ Enschede, The
  238.   Netherlands. Include a DD or HD floppy, return envelope and one
  239.   International Reply Coupon (IRC).
  240.  
  241.