home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Educate / Educate.zip / dsky.zip / DSKY.DOC < prev    next >
Text File  |  1996-09-07  |  8KB  |  225 lines
  1.  
  2.                                 D a r k   S k y
  3.  
  4.                                   Version 1.0
  5.  
  6.                          Copyright (C) B. Simpson 1996
  7.  
  8.                        OS/2 Shareware  Astronomy Program
  9.  
  10.  
  11.  
  12.   Dark Sky is a "planetarium" program for OS/2, and will display the heavens
  13.   from any location on earth.  Viewing options allow the user to control which
  14.   sky objects to display, which font to use, and manipulation of various star
  15.   parameters.  Time may be set to run at multiple speeds, including backwards.
  16.  
  17.  
  18.   --- Shareware --------------------------------------------------------------
  19.  
  20.   Dark Sky is shareware.  It may be freely copied and distributed provided
  21.   that the program in all of its components (program file, help file, database
  22.   files, install file, and documentation) are kept together and all remain
  23.   unmodified.
  24.  
  25.   Considerable effort has gone into the making of this program.  If you find
  26.   it useful please register by contributing $15 to:
  27.  
  28.     Brian Simpson
  29.     P.O. Box 773
  30.     Niwot, CO.  80544
  31.  
  32.   Comments and suggestions are welcome.
  33.  
  34.  
  35.   --- Disclaimer -------------------------------------------------------------
  36.  
  37.   Dark Sky is provided "as is" without warranty of any kind.  No warranty is
  38.   made, expressed, or implied, that this documentation or accompanying
  39.   software is free of error, or is consistent with any particular standard of
  40.   performance, quality, or merchantability, or that it will meet your
  41.   requirements for any particular application.  It should not be relied on for
  42.   solving a problem whose incorrect solution could result in injury to a
  43.   person or loss of property.  If you do use this software in such a manner,
  44.   it is at your own risk.  The author and distributors disclaim all liability
  45.   for direct, incidental, or consequential damages resulting from your use of
  46.   this software.  The use of this program constitutes total agreement and
  47.   acceptance of this disclaimer.
  48.  
  49.  
  50.   --- Requirements -----------------------------------------------------------
  51.  
  52.   Dark Sky requires OS/2 version 2.1 or later.  (Untested on 2.0)
  53.  
  54.   Dark Sky should run on any X86 - based processor that runs OS/2.  Because of
  55.   the computationally intensive nature of this program, a math coprocessor is
  56.   strongly recommended.  (A math coprocessor is already built into 486DX,
  57.   Pentium, and later processors, but is a separate chip on some other
  58.   systems.)
  59.  
  60.  
  61.   --- Installation -----------------------------------------------------------
  62.  
  63.   Since you are reading this documentation, you have likely already unzipped
  64.   DSKY.ZIP into its component files.  Place all files into a directory on your
  65.   hard drive and issue the following command from an OS/2 command prompt in
  66.   that directory:
  67.  
  68.     INSTALL
  69.  
  70.   A program icon will be installed onto your OS/2 desktop.  Just double click
  71.   on the icon to start Dark Sky.  Alternately you can invoke the program by
  72.   issuing the following command from the same directory:
  73.  
  74.     DSKY
  75.  
  76.  
  77.   --- Your first view --------------------------------------------------------
  78.  
  79.   Dark Sky opens with a view of the heavens looking straight up from the
  80.   user's preferred location.  (Or, until a preferred location has been
  81.   selected, a default location of Niwot, Colorado, the author's favorite small
  82.   town.)
  83.  
  84.   Two scroll bars control the direction of view:
  85.  
  86.     Moving the vertical scroll bar (right side of window) controls the
  87.     altitude, or the angle from the horizon to the center of the view
  88.     (center of window).  With the scroll at the top the view is straight up.
  89.     With the scroll at the bottom the view is along the horizon.  Brown
  90.     tinting will indicate where the earth blocks the view.  (This horizon
  91.     indication can be turned off.)
  92.  
  93.     Moving the horizontal scroll bar (bottom of window) controls the
  94.     azimuth, or direction along the horizon.  With the scroll in the center,
  95.     the view towards the horizon is to the south.  Moving the scroll to the
  96.     right moves the view to the west, then the north.  Moving the scroll to
  97.     the left moves the view to the east, then the north.  Thus north can be
  98.     achieved by moving the scroll either to the far right or the far left.
  99.  
  100.     Altitude and azimuth are indicated in the information window at the top.
  101.     Interpret altitude as follows:
  102.  
  103.       Alt          View
  104.       ---------------------------------
  105.       0            Along the horizon
  106.       90           Straight up (zenith)
  107.  
  108.     Interpret azimuth as follows:
  109.  
  110.       Az           View
  111.       ---------------------------------
  112.       0 and 360    North
  113.       90           East
  114.       180          South
  115.       270          West
  116.  
  117.   Magnification is controlled as follows:
  118.  
  119.     Pressing 'z' will "zoom in" to magnify the view.
  120.  
  121.     Pressing 'Z' will "zoom out" to de-magnify the view.  By pressing 'Z'
  122.     and/or enlarging the window an entire 180° view can be seen.  (I.e. 90°
  123.     in all directions from center of window.)
  124.  
  125.     'CapsLock' must be off for 'z' and 'Z' to work.
  126.  
  127.  
  128.   --- Setup ------------------------------------------------------------------
  129.  
  130.   Dark Sky can be set up for any location.  Begin by going to the "Location"
  131.   window (via the "Set" pull down menu).  Select the city closest to your
  132.   location and press "OK City", or enter your longitude, latitude, and
  133.   time zone and press "OK Coordinates".  If your new location is in a
  134.   different time zone, then your local time (as displayed in the information
  135.   line above the star window) will have changed, and you must reset the time.
  136.   To do so, go to the "Set local date/time" window (via the "Time" pull down
  137.   menu), select or deselect "Daylight Savings Time", and then press "Set to
  138.   computer date/time".  You are now re-sync'd to your computer time.
  139.  
  140.   Be sure to save this location information if you would like Dark Sky to
  141.   always start at this position.  Go to the "File" pull down menu and select
  142.   "Save location".
  143.  
  144.   You may also save your viewing preferences (objects, font, and star
  145.   parameters) by selecting "Save preferences" from the "File" pull down menu.
  146.  
  147.   Note:  The city database used in the "Location" window may be edited to suit
  148.   the user's preferences.  Follow the directions at the top of DSKY.CTY.
  149.  
  150.  
  151.   --- List of files ----------------------------------------------------------
  152.  
  153.   Dark Sky contains the following files:
  154.  
  155.     File           Description
  156.     -------------------------------------------------------
  157.  
  158.     DSKY.EXE       The executable (program file) for
  159.                    Dark Sky
  160.  
  161.     DSKY.HLP       The help file
  162.  
  163.     DSKY.DB        Sky database
  164.  
  165.     DSKY.CTY       City database - May be modified, but
  166.                    please distribute only the original
  167.  
  168.     INSTALL.CMD    Installs program object onto desktop
  169.  
  170.     DSKY.DOC       Documentation - This file
  171.  
  172.     DSKY.INI       Initialization file - Created by program
  173.                    - Should not be distributed with other
  174.                    files
  175.  
  176.  
  177.   --- Misc. notes ------------------------------------------------------------
  178.  
  179.   Dark Sky is written in C++ and uses the IBM Open Class Library.  The program
  180.   utilizes two threads of execution.  The first manages the user interface,
  181.   while the second manages drawing on the main window.
  182.  
  183.   The star database is derived from the "Yale Catalogue of Bright Stars", a
  184.   public domain listing of stars.  Their placement is for Epoch 2000.0 (i.e.
  185.   the beginning of the year 2000AD).  No adjustment for precession is made,
  186.   which is the reason for limiting the dates between 1900 and 2099.
  187.  
  188.  
  189.   --- Bugs -------------------------------------------------------------------
  190.  
  191.   Please report any bugs to the registration address given above.  Comments
  192.   and suggestions also welcome.
  193.  
  194.  
  195.   --- Future updates ---------------------------------------------------------
  196.  
  197.  
  198.   Dark Sky will be updated in the future.  Future updates may include:
  199.  
  200.     -  Printing
  201.  
  202.     -  Precession
  203.  
  204.     -  Star identification
  205.  
  206.     -  User selectable colors
  207.  
  208.     -  User selectable fonts per object
  209.  
  210.     -  User modifiable information line
  211.  
  212.     -  Constellation boundaries
  213.  
  214.     -  Altitude/Azimuth grid
  215.  
  216.     -  Labels for grids
  217.  
  218.     -  Comets
  219.  
  220.     -  ...
  221.  
  222.  
  223.   ----------------------------------------------------------------------------
  224.  
  225.