home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d1xx / d180 / geotime.lha / GeoTime / README.FIRST < prev    next >
Text File  |  1989-02-25  |  10KB  |  242 lines
  1.                   Geotime - The "Ultimate" (?) Amiga clock
  2.  
  3.                        Copyright 1988 by Mike Smithwick
  4.  
  5. Like many people, I was getting pretty board with the plethora of rather
  6. dull little workbench clocks (mouse pointer clocks, Boing clocks, etc), I
  7. decided to write Geotime. 
  8.  
  9. Geotime actually consists of two separate programs, Geotime_m depicts a
  10. earth map with day and nite sides shaded. You'll be able to observe the
  11. earth's shadow scroll across the map in real-time based on the system clock.
  12.  
  13. The other program, Geotime_g is a workbench clock, and shows the earth as a
  14. globe with day and nite sides. Like the map, the shadows will progress in
  15. real-time showing the current phase of the earth.
  16.  
  17. And now a word from our sponsor:
  18.  
  19. Geotime is freely distributable, as long as this notice stays intact. 
  20. However, this is, "Shareware" (oh no Mr. Bill, not shareware!). Wait! Don't
  21. go!! I know that the shareware concept is much overused, particularly since
  22. most shareware products aren't worth it. If you do enjoy this program, I
  23. would enjoy, say, $17. This will ensure a free upgrade to version 2.0 which
  24. will not be freely distributable. Please feel free to suggest further
  25. features for the next version. I expect to have higher detailed maps, zoom
  26. in/out, time-zone boarders, etc. (Bug fixes and minor enhancements to this
  27. version will be released however, so please send me any bug reports with
  28. your wish lists).
  29.  
  30. Mail you generous cash contributions to :
  31.  
  32.                 Mike Smithwick
  33.                 25215 La Loma Drive
  34.                 Los Altos Hills, CA   94022
  35.  
  36. This of course assumes that there is enough interest to warrent further
  37. time spent on this.
  38.  
  39. "And we thank you for your support".
  40.  
  41.  
  42. ----------------------------------------------------------------------
  43.  
  44.                                  Geotime_m
  45.  
  46. Geotime_m will display a map of the earth showing the current day and nite
  47. regions. The shadow will scroll across the map in real time.  This program
  48. was inspired by "Geochron", the beautiful, illuminated large wall map that
  49. costs around $4 million bucks (actually, about 2 grand).
  50.  
  51. It is started in the traditional double-click icon method. For those who
  52. despise workbench, it may be started up from CLI by typing 
  53. "geotime_m -f coast2.sm.bin".
  54.  
  55. City and country names are read from the file "gtnames.dat". Each
  56. entry requires 3 lines in the following format :
  57.  
  58.                       name
  59.                       lat long
  60.                       time_zone
  61.  
  62. West longtitude is negative, East is positive. The time-zone is the value
  63. the must be added to your time to equal Universal Time. Most almanacs
  64. should have timezone entries for major cities.
  65.  
  66. Here's a sample entry :
  67.  
  68.                        .San Francisco
  69.                        38 -122
  70.                        7
  71.                        .Seoul
  72.                        37 127
  73.                        -9
  74.                        .London
  75.                        51 0
  76.                        -100
  77.  
  78. Time zones are floating point values since some zones are fractional hours.
  79. (The timezones in the sample file may not be correct due to the
  80. uncertainties of Daylight times around the world).
  81.  
  82. Each name will automatically be followed by a clock showing the time in 24
  83. hour mode. Using a time-zone value of "-100" (as in the London entry) will
  84. prevent the clock from being displayed to avoid excess screen clutter.
  85.  
  86. The period before the name is used to more clearly pinpoint the location.
  87.  
  88. The star-like sprite shows the "sub-solar" point, the point on the Earth
  89. directly under the sun.
  90.  
  91. There are a couple of options you may change by use of the Workbench Icon
  92. "Tooltypes" facilities. These are used to pass startup information on to a
  93. program. Click once on the icon, then select "info" from the workbench
  94. menu. You will now see the "Info" window displaying all sorts of curious
  95. attributes about it's associated file. Near the bottom is the "TOOL TYPES"
  96. string gadget. Click on the arrows, and you see 3 different startup
  97. options.  "GLOBEDATA" tells the program where to get it's map data file.
  98. For Geotime_m there is currently only one file, "coast2.sm.bin", so you
  99. don't need to touch this unless you move the datafile over into another
  100. directory. Next is the "TIMEZONE" argument. This is the timezone for your
  101. location, and is determined the same way as all other timezones. The
  102. program uses this to convert the local time on your system's internal clock
  103. to Universal time. It is currently set up for Pacific time. You may also
  104. change the landmass colors using "LANDCOLOR".  The following 3 numbers are
  105. the red, green and blue components. So if you wanted magenta land you would
  106. type "LANDCOLOR=15,0,15", or all red, no green, all blue.  (The color
  107. values go frome 0 to 15). When done modifying the tooltypes, click on save.
  108. You may want to open the info window one more time to verify that your
  109. numbers were correctly recorded, as I ran in to some problems in this
  110. regard.
  111.  
  112. Geotime_m requires the use of a special font, "flow_thin". In order to
  113. install the font, open a cli window and type "execute gt:font_install".
  114.  
  115. There are a couple of menu options that allow you to toggle on/off the
  116. clocks, names, and a clock in the menubar.
  117.  
  118. ---------------------------------------------------------------
  119.  
  120.                                  geotime_g
  121.  
  122.  
  123. Geotime_g will depict the earth as if you will an astronaut orbiting about
  124. 300 zillion miles up. The earth's shadow will be correct for the date and
  125. time, and will advance as time itself advances.
  126.  
  127. Start this up via the icon, or CLI as mentioned above using 
  128. "geotime_g -f coast2.bin". (Notice that different data files are used for
  129. each program).
  130.  
  131. At startup you are in "orbit" mode, in which the viewpoint in effect
  132. "orbits" around the planet. (otherwise it would be a really boring display.)
  133.  
  134. Geotime will work in both interlace and non-interlaced modes. Although
  135. it looks the niftiest in Hi-res interlace with dropshadow.
  136.  
  137. Since Geotime uses your own workbench colors you may have reset your
  138. preference colors for what looks best on both Geotime and your workbench.
  139. Colors are very important. The water should be dark-blue, land masses
  140. brown/orange or green, sky-black. In order to see the colors I used, 
  141. I've included my own "system-configuration" file on the disk which 
  142. hold my preference data. You may want to substitute this for your own 
  143. in the df0:devs directory.
  144.  
  145. There is just one Tooltype entry for this one, and that is "GLOBEDATA". 
  146. As with the Geotime_m, there is currently only 1 file, "coast2.bin".
  147.  
  148. It may take an update or two for any changes in the settings window
  149. to take affect.
  150.  
  151. If the globe is not circular, your monitor may need some adjustment.
  152.  
  153. Geotime_g has several menu options. . .
  154.  
  155.                              System menu
  156.  
  157. In the systems menu, "settings" will allow you to set some basic
  158. information needed. Timezone is the number of hours which you need to 
  159. add to your local time to arrive at Universal Coordinated Time (the old 
  160. "GMT"). +7 is good for the SF Bay Area.
  161.  
  162. View lat : sets the viewer latitude. Defaults to 0 degrees. (dd.mm format)
  163.      Setting this positive will put you above the equator when looking
  164.      at the globe.
  165.  
  166. View long : sets the viewer longtitude. Defaults to 0 degrees. This advances
  167.      5 degrees each update while in orbit mode.
  168.  
  169. Lat : user's latitude. Put your home's latitude here for the "location"
  170.      highlight option. 
  171.  
  172. Long : user's latitude. Put your home's longtitude here.
  173.  
  174. Save : This will save all of your settings to a file, "geotime.dat".
  175.  
  176. If you make a mistake, the screen will flash a bunch of times and you won't
  177. be able to leave the requestor.
  178.  
  179. The latitudes go from -90 to +90 degrees. Longtitudes go from 180 W to 0 to
  180. 180 E. So for instance, the longtitude for San Francisco, 122:27 degrees 
  181. West, would be entered as "122.27 W".
  182.  
  183.                           Neat Stuff menu
  184.  
  185. Highlights : "Continents" will put an outline on the land masses. 
  186.      "Location" will put a "*" at whatever location you specify in 
  187.      the settings window.
  188.  
  189. Indicators : "Clock" will display the current date and time, while
  190.      "legend" shows how the sunny side is colored vs. the shaded side.
  191.  
  192. Mode : This lets you toggle between the orbit/hover rotational modes. 
  193.      "Orbit", the default, presents the planet to you as if you were
  194.      orbiting around in a very fast spacecraft from West to East. "Hover" 
  195.      puts you above a fixed point specified by the view lat/view long 
  196.      entries in the settings window. Hover is a really dull mode.
  197.  
  198. Shadow : "Shaded", the default, gives you a shadow tint, while "black" will
  199.      completely blacken the shadow to more closely mimic the view from 
  200.      space.
  201.  
  202. ---------------------------------------------------------------------
  203.  
  204.                                      Misc
  205.  
  206. The data used contains about 3000 points culled from a 6000 point database.
  207. (I may release the larger one sometime, it doesn't look that much better on
  208. the globe, but it is quite nice on the map).
  209.  
  210.  
  211. ---------------------------------------------------------------------
  212. (Warning! Warning! The following is an unabashed commercial announcement!)
  213.  
  214. If you do enjoy this program, you may want to take a look at something else
  215. I've done. It's called "Galileo", and is an astronomy simulation. It will
  216. display up to 9100 stars in a fashion more realistic than any other micro-
  217. computer planetarium simulation.
  218.  
  219. Galileo has won an award in the May Consumer Electronics Show for the most
  220. innovative Educational Program of the Year.
  221.  
  222. A recent review in Sky and Telescope magazine called Galileo "powerful and
  223. visually stunning", and many users write in to me saying things like
  224. "at last, a program that justifies my Amiga", or "Wonderful!".
  225.  
  226. Galileo is not meant just for folks with a telescope, but for anyone who
  227. has ever wondered about what's up in the night sky. (As a matter of fact,
  228. only a handful of owners stated they had a telescope. But those who do
  229. love the program).
  230.  
  231. So, when you're tired of exploring fictional universes, give the real
  232. one a shot, I think you'll enjoy it.
  233.  
  234. If you have Galileo and like it, please send in your registration cards
  235. if you haven't already. More data-disks are in preparation at this very
  236. moment, and we need your name and address to inform you when they're ready.
  237.  
  238.  
  239.              (End of the unabashed commercial announcement!)
  240.  
  241.  
  242.