home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Science / Science.zip / SKYCHART.ZIP / SKYCHART.DOC < prev    next >
Text File  |  1990-10-08  |  6KB  |  144 lines
  1. SKYCHART sky planetarium ...
  2. ----------------------------
  3.  
  4. This program is a demo of a PC planetarium under OS/2 (1.1 and up).
  5.  
  6. Registration for the DOS version.
  7. ---------------------------------
  8.  
  9. There is also a DOS version available when you register for $30. Then you get
  10. a solar and lunar eclipse program too (range from 1100 AD to 2700 AD).
  11. The DOS version requires DOS 3.00 or higher, 384 KB of RAM and an EGA, VGA or
  12. Hercules card. 800x600 VGA mode is also supported. CGA is only supported in a
  13. limited way (because of the too low vertical resolution). This version also
  14. runs fine under any 386 DOS multitasker, including OS/2 2.0. The planet
  15. calculation and zoom functions are much faster when a math coprocessor is
  16. installed. The functionality of the DOS version is exactly the same, and also
  17. consists of pop-ups menus and help. The DOS version is much faster because of
  18. the large overhead for plotting dots under OS/2. (When run in a window of
  19. DesqView/386 or OS/2 2.0 the performance is slow, because of the video
  20. virtualization, but most users don't use this.)
  21. Even on an 8 MHz XT the performance of the running sky is adequate. A planet
  22. phenomena program and routines to calculate high planetary and lunar
  23. positions is under development now.
  24.  
  25. How it works.
  26. -------------
  27.  
  28. The program shows half the visible sky at a time as a 'dome'. Any direction 
  29. can be the middle. When South is in the middle, the program shows the sky 
  30. from east to west through the South and until the zenith. Animation (a 
  31. running sky as in a planetarium) is also possible. For fast loading, all the 
  32. star and planet data is hardcoded in the EXE file rather than in separate 
  33. files.
  34.  
  35. This program is a true OS/2 program, so it does not run under DOS or the DOS 
  36. compatibility box. Requirements: OS/2 version 1.1 or higher (including the 
  37. 2.0 beta release), IOPL=YES (or IOPL=SKYCHART) in CONFIG.SYS (or CONFIG.OS2).
  38. Note on palettes:
  39. The last requirement because of the fact that palette modification is not
  40. supported by the current versions of PM, so I included an IOPL routine for
  41. modifying the palette registers directly. This works only with (super-) VGA
  42. and when the -c switch is set. When skychart is the active window, some
  43. colors of other windows can be changed. When Alt-Esc or Ctrl-Esc is pressed 
  44. or another window is selected by the mouse, the default PM palette is 
  45. restored. I use the palette modification for smooth and fast color change of 
  46. the sky background when it gets dark and of change the color of the setting 
  47. Sun or Moon.
  48.  
  49. Range:
  50. - Date from 1700 to 2100.
  51. - Location anywhere on Earth between 89 degrees latitude North and South.
  52. - Precession and proper motion between 9800 BC and 13800 AD (no planets).
  53.  
  54. Accuracy:
  55.  
  56. This is not a high accuracy program. The accuracy is sacrified for the speed
  57. to animate a planetarium. But high accuracy moon and planet calculation
  58. routines are under construction now.
  59.  
  60. - Rise and set one minute (for the Moon sometimes a few minutes).
  61. - Moon phases one minute.
  62. - Star/planet positions: 1/4 degree (can be worse when the date is close to 
  63.   1700 or 2100 or when the latitude is close to 89 degrees.) When zoomed out, 
  64.   the accuracy is much better with sacrifice of speed when no coprocessor is 
  65.   present.
  66.  
  67. Command line switches:
  68.  
  69. SKYCHART nnn <switches>
  70.  
  71. nnn is the location code. This three letter location code can be found in
  72. LOCATION.DAT.
  73.  
  74. -c:    Enable color palette changes for sky background color change and color 
  75.        change for low Sun and Moon (VGA and Super VGA only).
  76. -w:    Start up SKYCHART in a window rather than in full screen (maximized).
  77.  
  78. -thh mm
  79.        Time difference of your computer's real time clock and GMT. When your 
  80.        time is behind GMT (as in the U.S.) add 24 hours. E.g. for PST specify 
  81.        -t16, for PDT -t17.
  82.  
  83. In the program the F10 key toggles the title bar+menu bar on and off.
  84.  
  85. Help is available by pressing F1, and item specific help is available by 
  86. highlighting a menu (by pressing Alt and moving the arrow keys) item and
  87. then pressing F1.
  88.  
  89. When the sky is dark enough, a cross is displayed when the mouse pointer 
  90. within the sky dome. Pressing Enter or the Left mouse button searches the 
  91. nearest object (not Sun and Moon) and displays some information about this 
  92. object (planet or star) in a message box.
  93.  
  94. Note: The Esc, F or F10 options stated in the Zoom help text do not apply to 
  95. this version. When the mouse pointer is inside the sky dome, the 'Z' key or 
  96. th right mouse button zooms a part of the sky around the mouse pointer and 
  97. shows all stars until magnitude 7.0.
  98.  
  99. The REAL sky is even more beautiful.
  100. ------------------------------------
  101.  
  102. When it's dark outside and the sky is clear (especially when you are far from 
  103. big cities), please go outside and watch the output of this program in the
  104. real sky rather than on this computer screen. This program does NOT match the
  105. beauty of the night sky and is just a tool for cloudy nights (of which there
  106. are many here in Holland...).
  107.  
  108. LOCATION.DAT
  109. ------------
  110. This text file can be edited by any ASCII text editor to put your own custom 
  111. locations in the file. On the top of the file is stated how to do that. This 
  112. file should be in the same directory as SKYCHART.EXE.
  113.  
  114. Known problems.
  115. ---------------
  116.  
  117. When the sky is running in animation mode and a task switch is performed
  118. (e.g. Ctrl-ESC or Alt-ESC) the program sometimes first overwrites other
  119. windows with stars and then clears them.
  120.  
  121. Authors:
  122.  
  123. Hans Bloemendaal
  124. Klaas van Ditzhuyzen
  125.  
  126. Corona Borealis Public Observatory
  127. Hogestraat 12
  128. Dieren Holland.
  129.  
  130. or leave a message for Klaas (via /839) on Gilmore BBS
  131. (805) 581-1275
  132.  
  133. Acknowledgements:
  134. -----------------
  135.  
  136. YALE star catalog (epoch converted from 1875.0 to 2000.0)
  137. Jean Meeus: Astronomical Formulae for Calculators (1982)
  138. Jean Meeus: Tables for Sun and Moon (1961)
  139. Microsoft C Compiler Version 6.00
  140. Microsoft OS/2 Programmer's Toolkit Version 1.2
  141. NuMega Technologies Soft-ICE 2.5 (for the DOS version)
  142. NuMega Technologies MagicCV 3.00 (for the DOS version)
  143. Tandon 386/16 PC and Compaq Systempro 386/33.
  144.