home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: OtherApp / OtherApp.zip / hl_news.zip / temp / NVSN.DOC < prev    next >
Text File  |  1998-07-22  |  13KB  |  329 lines
  1.  
  2.                             N i g h t   V i s i o n
  3.  
  4.                                   Version 2.2
  5.  
  6.                        Copyright (C) B. Simpson 1996-1998
  7.  
  8.                              OS/2 Astronomy Program
  9.  
  10.  
  11.  
  12.   Night Vision is a "planetarium" program for OS/2, and will display the
  13.   heavens from any location on earth.  Viewing options allow the user to
  14.   control which sky objects to display, which font to use, and manipulation
  15.   of various star parameters.  Time may be set to run at multiple speeds,
  16.   including backwards.  Star charts may be printed.
  17.  
  18.                        * *   New with version 2.2   * *
  19.  
  20.       -> Mouse zooming 
  21.  
  22.       -> Objects may be centered in window with left mouse click 
  23.  
  24.       -> Menu options accessible via right mouse click 
  25.  
  26.       -> Star names 
  27.  
  28.       -> Object find for constellations, stars, deep sky objects,
  29.          and solar system objects 
  30.  
  31.       -> Altitude range extended to -90 degrees 
  32.  
  33.       -> Previous printer printed to is remembered.
  34.  
  35.   Note:  Registered users of previous versions are entitled to a free Email
  36.          upgrade to the 2.2 registered version.  Just Email the author at:
  37.  
  38.          nightvision@bmtmicro.com
  39.  
  40.  
  41.   --- Visit the Night Vision home page ---------------------------------------
  42.  
  43.   Night Vision has a home page on the Internet at:
  44.  
  45.       http://home.att.net/~bsimpson/nvsn.html
  46.                      - and -
  47.       http://www.bmtmicro.com/catalog/nightv/
  48.  
  49.  
  50.   --- Shareware and Registered versions --------------------------------------
  51.  
  52.   Night Vision has two versions, the shareware version and the registered
  53.   version, which are nearly identical except that the shareware version has
  54.   tags indicating that it is unregistered.
  55.  
  56.   The shareware version may be freely copied and distributed provided that the
  57.   program in all of its components (program file, help file, database files,
  58.   install file, and documentation) are kept together and all remain
  59.   unmodified.
  60.  
  61.   You are free to use the shareware version for an evaluation period.  Please
  62.   do not continue usage without registering as considerable effort has gone
  63.   into the making of this program.  You may register with:
  64.  
  65.     BMT Micro
  66.     PO Box 15016
  67.     Wilmington, NC  28408
  68.     U.S.A.
  69.     (Use the order form supplied in the file ORDER.FRM,
  70.     or contact them via the internet at http://www.bmtmicro.com)
  71.  
  72.   or
  73.  
  74.     Brian Simpson
  75.     PO Box 773
  76.     Niwot, CO  80544
  77.     U.S.A.
  78.  
  79.   Registration is $25.  Upon registration you will receive the registered
  80.   version, which can be Emailed to you at no extra charge.  Those who require
  81.   a diskette please see the file ORDER.FRM.
  82.  
  83.   The registered version is of course for personal use only and may not be
  84.   distributed.
  85.  
  86.  
  87.   --- Disclaimer -------------------------------------------------------------
  88.  
  89.   Night Vision is provided "as is" without warranty of any kind.  No warranty
  90.   is made, expressed, or implied, that this documentation or accompanying
  91.   software is free of error, or is consistent with any particular standard of
  92.   performance, quality, or merchantability, or that it will meet your
  93.   requirements for any particular application.  It should not be relied on for
  94.   solving a problem whose incorrect solution could result in injury to a
  95.   person or loss of property.  If you do use this software in such a manner,
  96.   it is at your own risk.  The author and distributors disclaim all liability
  97.   for direct, incidental, or consequential damages resulting from your use of
  98.   this software.  Your use of this program constitutes total agreement and
  99.   acceptance of this disclaimer.
  100.  
  101.  
  102.   --- Requirements -----------------------------------------------------------
  103.  
  104.   Night Vision requires OS/2 version 2.1 or later.  (Untested on 2.0)
  105.  
  106.   Night Vision should run on any X86 - based processor that runs OS/2.
  107.   Because of the computationally intensive nature of this program, a math
  108.   coprocessor is strongly recommended.  (A math coprocessor is already built
  109.   into 486DX, Pentium, and later processors, but is a separate chip on some
  110.   other systems.)
  111.  
  112.  
  113.   --- Installation -----------------------------------------------------------
  114.  
  115.   Since you are reading this documentation, you have likely already unzipped
  116.   the .ZIP archive into its component files.  Place all files into a directory
  117.   on your hard drive and issue the following command from an OS/2 command
  118.   prompt in that directory:
  119.  
  120.     INSTALL
  121.  
  122.   A program icon will be installed onto your OS/2 desktop.  Just double click
  123.   on the icon to start Night Vision.  Alternately you can invoke the program
  124.   by issuing the following command from the same directory:
  125.  
  126.     NVSN
  127.  
  128.  
  129.   --- Your first view --------------------------------------------------------
  130.  
  131.   Night Vision opens with a view of the heavens looking straight up from the
  132.   user's preferred location.  (Or, until a preferred location has been
  133.   selected, a default location of Niwot, Colorado, the author's favorite small
  134.   town.)
  135.  
  136.   Two scroll bars control the direction of view:
  137.  
  138.     Moving the vertical scroll bar (right side of window) controls the
  139.     altitude, or the angle from the horizon to the center of the view
  140.     (center of window).  With the scroll at the top the view is straight up
  141.     (the zenith).  Moving the scroll to the middle shows the view along the
  142.     horizon, and moving it to the bottom shows the view through the earth
  143.     (the nadir).  Tinting will indicate where the earth blocks the view.
  144.     (This horizon indication can be turned off.)
  145.  
  146.     Moving the horizontal scroll bar (bottom of window) controls the
  147.     azimuth, or direction along the horizon.  With the scroll in the center,
  148.     the view towards the horizon is to the south.  Moving the scroll to the
  149.     right moves the view to the west, then the north.  Moving the scroll to
  150.     the left moves the view to the east, then the north.  Thus north can be
  151.     achieved by moving the scroll either to the far right or the far left.
  152.  
  153.     Altitude and azimuth are indicated in the information window at the top.
  154.     Interpret altitude as follows:
  155.  
  156.       Alt          View
  157.       ---------------------------------
  158.       0            Along the horizon
  159.       90           Straight up (zenith)
  160.       -90          Straight down (nadir)
  161.  
  162.     Interpret azimuth as follows:
  163.  
  164.       Az           View
  165.       ---------------------------------
  166.       0 and 360    North
  167.       90           East
  168.       180          South
  169.       270          West
  170.  
  171.   Magnification is controlled as follows:
  172.  
  173.     Pressing 'z' will "zoom in" to magnify the view.
  174.  
  175.     Pressing 'Shift-z' will "zoom out" to de-magnify the view.  By pressing
  176.     'Shift-z' and/or enlarging the window an entire 180° view can be seen.
  177.     (I.e. 90° in all directions from center of window.)
  178.  
  179.     'CapsLock' is ignored.
  180.  
  181.   Night Vision is mouse aware.  For example, to move an object to the center
  182.   of the window, left click on that object.  To zoom into an object draw a
  183.   rectangle around that object by pressing the left mouse button and then
  184.   dragging the mouse.  When the button is released the center of the rectangle
  185.   is moved to the center of the window at a zoom level based on the area of
  186.   the rectangle.  Press 'p' to return to the previous view.
  187.  
  188.   The right mouse button invokes a pop-up menu.  This is of particular use
  189.   during full screen mode when the main menu is not visible.
  190.  
  191.  
  192.   --- Setup ------------------------------------------------------------------
  193.  
  194.   Night Vision can be set up for any location.  Begin by going to the "Set
  195.   location" window (via the "Set" pull down menu).  Select the city closest
  196.   to your location, select/deselect "Daylight savings time", and press "OK
  197.   City".  Or enter your longitude, latitude, and time zone, select/deselect
  198.   "Daylight savings time", and press "OK Coordinates".  If your new location
  199.   is in a different time zone, then your local time (as displayed in the
  200.   information line above the star window) will have changed, and you must
  201.   reset the time.  To do so, go to the "Set local date/time" window (via the
  202.   "Time" pull down menu) and then press "Set to computer date/time".  You are
  203.   now re-sync'd to your computer time.
  204.  
  205.   Be sure to save this location information if you would like Night Vision to
  206.   always start at this position.  Go to the "File" pull down menu and select
  207.   "Save location".
  208.  
  209.   You may also save your viewing preferences (objects, font, and star
  210.   parameters) by selecting "Save preferences" from the "File" pull down menu.
  211.  
  212.   Note:  The city database used in the "Set location" window may be edited to
  213.   suit the user's preferences.  Follow the directions at the top of NVSN.CTY.
  214.  
  215.  
  216.   --- List of files ----------------------------------------------------------
  217.  
  218.   Night Vision contains the following files:
  219.  
  220.     File           Description
  221.     -------------------------------------------------------
  222.  
  223.     NVSN.EXE       The executable (program file) for
  224.                    Night Vision
  225.  
  226.     NVSN.HLP       The help file
  227.  
  228.     NVSN.DB        Sky database
  229.  
  230.     NVSN.CTY       City database - May be modified, but
  231.                    please distribute only the original
  232.  
  233.     NVSN.DOC       Documentation - This file
  234.  
  235.     NVSN.INI       Initialization file - Created by program
  236.                    - Should not be distributed with other
  237.                    files
  238.  
  239.     INSTALL.CMD    Installs program object onto desktop
  240.  
  241.                    The shareware version adds the following two files:
  242.  
  243.     FILE_ID.DIZ    Program description
  244.  
  245.     ORDER.FRM      BMT Micro registration form
  246.  
  247.  
  248.   --- Misc. notes ------------------------------------------------------------
  249.  
  250.   Night Vision is written in C++ and uses the IBM Open Class Library.  The
  251.   program utilizes two threads of execution.  The first manages the user
  252.   interface, while the second manages drawing on the main window.  A third
  253.   thread is introduced for printing.
  254.  
  255.   The star database is derived from the "Yale Catalogue of Bright Stars", a
  256.   public domain listing of over 9,000 stars.  Their placement is for
  257.   Epoch 2000.0 (i.e. the beginning of the year 2000AD).  No adjustment for
  258.   precession is made, which is the reason for limiting the dates between 1900
  259.   and 2099.
  260.  
  261.  
  262.   --- Bugs -------------------------------------------------------------------
  263.  
  264.   There appears to an OS/2 bug that affects Night Vision after the OS/2
  265.   Lockup feature has been invoked.  After releasing OS/2 Lockup (i.e. typing
  266.   your password), the star window may not be as responsive to dragging the
  267.   scroll bar (or using the arrow keys). This problem only affects some systems
  268.   and may not affect yours.  It appears that thread priorities are changed
  269.   after OS/2 Lockup has been invoked.  (Other programs have encountered
  270.   similar problems.)
  271.  
  272.   Bugs in printer drivers can affect the quality of the star charts produced,
  273.   and in turn make Night Vision look buggy.  (A printer driver is the software
  274.   that OS/2 uses to build an image and send it to a printer).  No printing
  275.   should occur outside of the square that encloses the chart, and only the
  276.   program name, date and time, location, and alt/az information should appear
  277.   in the boxes that appear in the four corners of the square.  See "Printing
  278.   issues" in the online help for further information.
  279.  
  280.   Please report any Night Vision bugs to the PO Box 773 address given above,
  281.   or Email the author at:  nightvision@bmtmicro.com
  282.  
  283.   Comments and suggestions also welcome.
  284.  
  285.  
  286.   --- Future updates ---------------------------------------------------------
  287.  
  288.   Night Vision will be updated in the future.  Future updates may include:
  289.  
  290.     -  Precession
  291.  
  292.     -  Greek star designations (alpha, ...)
  293.  
  294.     -  Object identification via right mouse click
  295.  
  296.     -  User selectable fonts per object
  297.  
  298.     -  User modifiable information line
  299.  
  300.     -  Constellation boundaries
  301.  
  302.     -  Labels for grids
  303.  
  304.     -  Milky way
  305.  
  306.     -  Comets
  307.  
  308.     -  ...
  309.  
  310.  
  311.   --- History ----------------------------------------------------------------
  312.  
  313.   2.2  -  See beginning of this file.
  314.  
  315.   2.1  -  Star window continuously updates as scroll bars are dragged by
  316.           mouse.  Addition of full screen mode, altitude/azimuth grid, and
  317.           user selectable colors.  Increased number of cities in database,
  318.           with maximum allowable set at 10000.
  319.  
  320.   2.0  -  Addition of printing, compass directions along horizon, and enhanced
  321.           responsiveness of interface.  Introduction of shareware and
  322.           registered versions.
  323.  
  324.   1.0  -  Initial release
  325.  
  326.  
  327.   ----------------------------------------------------------------------------
  328.  
  329.