home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 1 / ARM_CLUB_CD.iso / contents / education / n / sunclock / !Sunclock / !Help next >
Text File  |  1992-11-24  |  3KB  |  85 lines
  1.  
  2.  
  3.           Sunclock - A 'daylight display' program
  4.           =======================================
  5.                       v.1.00              
  6.                       ======
  7.  
  8.                 © Steve Loft 1992
  9.  
  10. ------------------------------------------------------------------------
  11.  
  12.    This application may be freely distributed providing
  13.  
  14.     (a) All files, including this !help file, are included
  15.     (b) No charge is made other than to cover the cost of media
  16.  
  17.    This application may not be distributed by any profit-making
  18.    organisation, including public domain software libraries,
  19.    without my express permission. 
  20.  
  21. ------------------------------------------------------------------------
  22.  
  23. Sunclock is a desktop application which displays a map of the Earth,
  24. showing the portion which is currently illuminated by the Sun.  It 
  25. will update the display periodically in real time, or time can be
  26. 'speeded up', or run backwards. 
  27.  
  28. Sunclock is based on a program by John Walker, originally written for
  29. (appropriately!) a Sun Workstation.  All of the routines to do the 
  30. calculation of the Sun's position are John's (hell, I don't even
  31. understand them!), and all of the RISC OS code is mine (actually, it's
  32. based on the supplied examples in Acorn C, but I have to take *some* 
  33. of the credit/blame, don't I?).
  34.  
  35. When run, Sunclock installs on the icon bar.  Clicking on the icon opens
  36. the display window.  This window has a menu with the following selections:
  37.  
  38.    Forward
  39.    -------
  40.    Backward
  41.    -------- 
  42.        These two selections have effect when in 'animate' mode (see below),
  43.        and determine the direction of time travel. 
  44.   
  45.    Period
  46.    ------
  47.        This leads to a submenu with selections for 'hour', 'day', 'week',
  48.        'month', and 'year', which set the amount by which the time will
  49.        be incremented or decremented on each update when in 'animate' mode.
  50.  
  51.    Animate
  52.    -------
  53.    Real Time
  54.    ---------
  55.        These selections switch between real-time display, and 'animate' mode.
  56.  
  57.    Interval
  58.    --------
  59.        This selection leads to a writeable icon which allows the time between
  60.        each recalculation of the display to be specified.
  61.  
  62.  
  63. See the file 'Doc' for John Walker's explanation of how the calculations are
  64. made.
  65.  
  66.  
  67. The screen display works by redirecting output to a sprite and then 
  68. displaying the sprite using 'sprite_put_scaled'.  If anyone can tell me how
  69. to get the redraw done faster than this, please let me know!  Also, I use 
  70. 'win_settitle' to update the clock on the title bar; is there a way to do 
  71. this without getting  the flicker? 
  72.  
  73.  
  74. I can be contacted via:
  75.  
  76. Arcade BBS:  user #415, "Steve Loft" (Fido 2:254/27)
  77. E-mail:      steve@klaatu.demon.co.uk
  78. Fax:         (0302) 371378
  79.  
  80.  
  81.  
  82. Steve Loft
  83. November 1992
  84. -------------------------------
  85.