 
                       D E M O   V e r s i o n
 

      "Cosmos, the endless cycle of live and death."

                                          Lao Tzu in Tao Te Ching


            "The COSMOS for OS/2", Version 4.0, Feb.1995
      All Rights Reserved Worldwide by MENSYS (R), Netherlands
             (c) Copyright Piet M. Patings, Netherlands
 
                       D E M O   V e r s i o n
 

>>> Use, duplication or sale of this product, except as described in the
>>> MENSYS(r) License Agreement, is strictly prohibited.

>>> For ordering information see the PRESS040.DOC file.


 **********************************************************************
 *** A number of functions have been disabled in this demo version. 
 *** In addition small databases are included containing only few
 *** stars and deep-sky objects.
 *** Parts of the on-line help have been left out and only few bitmaps
 *** are included.
 **********************************************************************

 If your PC or PS/2 has a mathematical co-processor or a 80486DX processor
 it will be gratefully used and result in about a ten to forty times better
 performance than without. 
 If you don't have a math-co or 80486DX installed this will be emulated.

 COSMOS has been tested on 8513, 8514 and 8514 displays with IBM OS/2 
 Version 2.0, 2.1, 2.11 and Warp 3.0 (VGA, SVGA, XGA-1, XGA-2).
 If your PS or PC runs OS/2 2.x it does not require any special hardware
 other than mentioned above. The hard disk space required to install COSMOS
 is about 5 Mb.

 There is no hardcopy COSMOS User Guide. It's obvious in use and contains
 on-line extended and contextual help implemented by means of the 
 OS/2 IPF Help facility.
 In case the chart print-out is not as it displays on the screen,
 please check if you have the correct printer driver.
 In most cases the OS/2 Warp OMNI printer driver gives excellent results.




 COPYRIGHT NOTICE

  This software program and accompanying on-line documentation and data,
  except for the YALESTAR database (see Help), are proprietary products 
  of MENSYS (r) and are protected by Copyright laws and international treaty.

  Neither the program nor any part of the on-line documentation and data
  may be reproduced, translated, or copied by any means without the express
  written permission of:
  MENSYS, Crayenestersingel 65, 2012 PG Haarlem, Netherlands.


 INSTALLATION

   The COSMOS demo program files are packed in a self-extracting file.
   Create a directory on your hard disk (e.g: "C:MD \COSDEMO)" and 
   copy the COSDEMO.EXE file into it.
   Now make it the current directory (e.g: "C:CD \COSDEMO") and on the
   command line type: COSDEMO  to let it unpack itself.
   
   To run the COSMOS program either define it as an object on your Desktop
   or in any other folder that suits you or run it from the command line
   by typing the program name: "COSMOS.EXE".


 CUSTOMIZATION

   Optionally add your location to the COSMOS.CTY file.
   Also optionally you could copy the COSMOS.HLP file into the OS/2
   Help Manager path, C:\OS2\HELP\ (this may make help somewhat faster).


   ******************************************************************
   *** The following files are not included in this demo version.
   ******************************************************************

   Note that constellation names in the identify window are in Latin
   and US English. Constellation names displayed on the sky chart are
   in Latin by default.
   To add an other language to the identify window and replace
   the skychart names by that language rename or copy one of the 
   CONSTELL.xxx, xxx being the language of choice, files (see list below)
   to COSMOS.CON and it will be used instead.

   If your language is not readily available in the package you could 
   create one yourself.
   See the on-line help on the subject of National Language support.
   Note that the constellations are ordered on IAU number (1-88) which
   is close to, but not equal to, the alphabetical order; Comment lines
   are not allowed in this file.


 GETTING STARTED
 
   When you start COSMOS for the first time on any machine you will be
   prompted for your COSMOS Licence number. Enter the number exactly as 
   it appears on your Installation Diskette.

   o Locate the "COSMOS v4.0 folder on your OS/2 Desktop and open it.

   o Double-click on the COSMOS Telescope Icon to run COSMOS,
     or alternatively type: COSMOS at the OS/2 command line prompt
     from within the COSMOS directory.
     The "COSMOS Product Information" will show up if you run COSMOS
     for the first time. On all subsequent invocations of COSMOS this
     window will behave according to the settings in the OS/2 System 
     folder.

   o If this is the first time you use this version of COSMOS the
     "Observer Time/Place" dialog will automatically come up giving
     you the option to select your location or one close to it
     (for instructions on adding your location see the on-line help).
     You should save your profile on exit from COSMOS or immediately
     by selecting the appropriate "Settings" option.

   o Double click (or select and Apply) your location (or one close to it)
     and Dismiss to select a chart of choice,
     or select Re-plot Chart to start plotting the default Zenith chart.

     - Select "Plot Zenith Chart", "Plot Horizon view region" or
       "Set/Plot Sky Region". In the latter case you will be prompted 
       to supply additional information about the center of the sky region
       and the size of the view field.
       Before doing the latter you may want to change some of the 
       "Options" or "Controls" settings. Be aware that selecting a high
       limiting magnitude, boundary lines etc. may result in minutes of
       processing without a math-coprocessor or 80486DX processor).

   o You can also use the Toolbar smart-icons to plot one of many charts.
     Clicking an icon with Mouse Button 2 will show a short description
     in the Titlebar (clicking it again will restore the Titlebar text).

   o If you are new to this program you will find that the "Quick start"
     Help option offers a convenient way to get acquainted with the basic 
     concepts of visual astronomy, OS/2-IPF and the COSMOS program by
     means of hypertext and hypergraphics.

   o Saving the settings on exit will bring up most of the current 
     settings including the City when you next use COSMOS.

   o On invocation you can let COSMOS automatically start plotting or
     simulating a sky chart or view of choice by ticking the appropriate
     "Settings" or "Controls" option and saving the COSMOS settings.

   o Note that the Mouse Button is used to implement some very powerful
     functions which may work different from what you may be used to in
     DOS or Dos/Windows.
     Please see the on-line help for full details on how to use these.

   For a listing of settings that will be saved in your profile as well
   as a description of all features available, refer to the on-line help.
      
                 
   Following is a list of orbital elements files and coordinate display
   files included in the package. See the on-line help and read the
   comment in these files for details.

   File            Description
   
   ASTEROID.ORB    Ephemeris examples of Asteroids orbital elements.
   COMETS  .ORB    Samples of comets.
   COSMOS  .ORB    Sample of a "Default" orbital elements file.
   PLANETOI.ORB    133 Asteroids orbital elements, as single objects.
                   
   COSMOS  .DTA    Default coordinate sample file.
   HUNTER  .DTA    The mythological hunter Orion used in MYTHOLOG.DTA.
   LINES   .DTA    Demonstrate use of include command (ORION and MAGELLAN).
   MAGELLAN.DTA    Large and Small Magellanic Clouds (LMC and SMC) lines.
   ORION   .DTA    Orion complex lines.
   STARSPM .DTA    Samples of stars with large proper motion.
   UMA     .DTA    Changing (in time) constellation shape.
                   
   ******************************************************************
   *** The following files are not included in this demo version.
   ******************************************************************

   In subdirectory \METEOR you will find DTA files to display all major
   meteor showers:

   00SHOWER.DTA    This file contains imbed files for each month of the year.
   01SHOWER.DTA
   nn .........
   12SHOWER.DTA    Where nn indicates the month, 01 for January,
                   12 for December.
                   Included in these files are imbed files for the
                   important showers for which the peak occurs in that month.
   showername.DTA  The file name is mostly self explaining.
 
   For information about a specific shower use your favorite browser er
   editor to read the comment in the file.
 




  
  Changes in "The COSMOS for OS/2", Version 4.0  (relative to Version 3.0)
  

- Optional is a Toolbar with 18 Smart-Icons, offering a short-cut to
  some of the most used functions and menu options.

  - A dialog window is available to customize the Toolbar.

- The frame controls (menu-bar, title-bar etc.) can now be hidden.
  Clicking Mouse Button-2 will bring op a pop-up menu.

- Simulation of the apparent sky motion and ephemeris of Sun, Moon
  and planets, eclipses, conjunctions, occultations, phases etc.

  "Playing" with the simulation controls and chart types permits you
  to more closely study various phenomena such as eclipses and 
  conjunctions.
  It is also an excellent way to study the effect of nutation,
  aberration, precession etc.

  Simulate:
  - Coordinate grid, Equator, zero meridian of RA and ecliptic.
  - Include names of planets and stars.
  - Constellation names, abbreviations, connecting and boundary lines.
  - Forward or backward in time, in steps of minutes, hours or days.
  - Continuous loop within a small time frame or within the whole range.
  - With or without realistic civil twilight.
  - Refresh or photographic exposure mode.

- Animated zooming at Warp speed can now be performed.

  Animated zooming out of, or into a sky-region will result in an
  even more realistic three-dimensional display of the sky.
  The spectator will seem to move along an apparent path trough the
  sky as though traveling trough space at warp speed.

  - Many options are available including auto-start and demo mode.

- A "Quick start" option is now available from the "Help" menu.
  It offers a convenient way to get acquainted with the basic 
  concepts of visual astronomy, OS/2-IPF and the COSMOS program
  by means of hypertext and hypergraphics.

- A new option has been added to suppress interim screen refreshing.
  The performance gain may be as substantial as up to five times.

- Up-to 5 star databases can now be selected (or excluded) (Ctrl+D).
  You can even add your own.

- The star database layout has been extended to include additional
  information. It was restructured to further improve performance.

- New is the optional SAO database which includes 258,997 stars up-to
  magnitude 11.9.

- Up-to 4 deep-sky object databases can now be selected (Ctrl+D).

- The deep-sky object database layout has been extended to include
  additional information; it was restructured to further improve 
  performance.

  The database includes references to a number of alternative catalogs.
  In addition information like distance, x, y size and position angle
  information is included for a great many objects.

- The MESSIER database has been replaced (and extended) to an NGC
  database.
  It now includes all of the (R)NGC objects and most of the IC 
  objects, totalling 8414 deep-sky objects.
  In addition it includes cross-references to a variety of catalogues.

- Deepsky1 database includes some 1952 deep-sky objects from dozens 
  of different catalogs (in particular dark nebulae).

- Faint limiting magnitude selection has been extended to enable
  selection from 1.0m > 20.0m in steps of 1 (Ctrl+M). 
  The star size assignment has been aligned to this.
  Both limiting magnitudes, stars and deep-sky objects, are now the 
  same.

- To better support the large databases the color assignment for 
  stars with regard to the magnitude has been changed.

- A bright magnitude limit has been introduced to enable magnitude 
  range plotting.

- Object types have been extended and can now be selectively 
  included or excluded from the chart (Ctrl+T).

  New: Dark nebula, Galaxy clusters, Quasars, Diffuse nebula,
       multiple star-systems etc.

- Further improved positional accuracy of planet ephemeris, taking 
  full advantage of OS/2, 80 bit double precision.

- The "Identify" dialog now includes the additional information 
  available in the databases.
  It is also changed to support the enhanced on-line documentation
  facilities (see below).

- A new option, "Identification controls", has been added to enable
  more selective searches, skipping of objects and enforce full
  database scans.

- If the information is available in the databases, deep-sky objects
  will be sized in both the x and y direction and will be projected
  with the appropriate position-angle (the latter only for sky 
  regions smaller than 180 degrees).

- Screen-refresh count has been decreased to show more activity when
  plotting many objects.

- Search function performance (find functions) has been substantially
  improved.

- A new function "Find Planet, Sun, Moon" has been added.
  If not within the visible sky-region, a new chart can be plotted 
  with the object in the center.

  A "Lock on object" option is available to perform animation of the
  selected ephemeres.

- The "Find Star" function now alternatively accepts a SAO or BS 
  number.
  If the star is not within the currently visible sky region a new 
  chart can be plotted with the stars location as the chart center.

- The "Find deep-sky Object" function now alternatively accepts an
  alternative name (built from an index list), NGC number or IC 
  number.
  If the object is not within the currently visible sky region a new 
  chart can be plotted with the objects location as the chart center.

- A function is now available (under the Tools Menu) to copy the 
  current sky-chart to the clipboard.

- A dialog window, to visualize the positions of the four bright
  Jupiter satellites through the course of a day, has been added 
  under the Tools menu.

- Most of the new settings will be saved in the COSMOS profile.

- Using a Mouse button when the main window was resized will now 
  issue a message about this status.

- Deep-sky objects will also be plotted when only partially visible
  in a sky region.

- Minor enhancements have been made to the City list.

- Measuring an angle (by draging MB1) while holding down the Shift key
  will create a file "USER.DTA" in the COSMOS directory and write the
  cross-hair coordinates in RA and Dec to this file.
  If the file does not exist it will be created. If it does already
  exist, data will be appended to it. 
  Writing will continue until MB1 is released.

- The on-line documentation and  help has been updated to reflect the 
  above updates and to refect the latest developments in astronomy.
  Additional help text and cross-references have been introduced.

  The Identify function has been fully integrated with the IPF help 
  facility of OS/2. 

  Personal notes can be added in a number of different ways.
  You can add notes to objects, either Solar system, star or deep-sky
  object or for a specific Constellation, and thus create a fully 
  integrated "private" object notes database.
  The objectname.TXT files are now used for this purpose.
  Processing of these has been enhanced as follows:
  - TXT commentary files can now contain imbeds using the .im tag.
  - TXT commentary files can now contain editorial remarks 
    (to be ignored) using the .* tag.

  In addition you can add your personal notes and comments to the
  on-line documentation and help, using the integrated simple editor 
  or one of preference.

  From within the help, the system editor can be invoked to edit e.g.
  Orbital elements files and coordinate display files.

  - A new dialog is available to specify the preferred editor to edit
    your object notes.
    An "Edit Notes" button has been added to the Identify dialog window
    and "Plot Constellation Region" dialog.

- A substantial number of stars and deep-sky objects now have
  additional information under the "Text" button.

  All of the bright stars upto the second magnitude now have
  explanatory text included.

- Explanatory text has been added for all 110 (well 109) Messier
  objects.

- Explanatory text has been added for all 88 Constellations.

- The above stated also applies to text and notes regarding the 
  Constellations. The "Select Constallation region" for plot has 
  been changed accordingly.

- Include Bayer designation will now also show the Flamsteed number.

- Most of the important (44) meteor showers can now be plotted by 
  means of Positional coordinate files (DTA). Select all showers 
  for the whole year, for a specific month or by name.

- The Bitmap display window will now be sized to the bitmap dimensions
  i.e. accept all mitmap sizes. Bitmaps included are 256 color.

- Full coordinate lines now has three grid scales
  (Added 0.5 Hours RA and 7.5 deg Declination lines).

- The sky-color can now be set to white, stars will be black if
  required, (background color white was added).

- The planet colors can now be inverted thus allowing for obscured 
  objects to become visible as though looking through the planet,
  Sun or Moon.

- The illuminated part of the Moon will now become filled with yellow.
  In case of a solar-eclipse the moon will be colored black while any
  part of it obscures the Sun.

- The print function has been enhanced to support print-queue
  selection and the number of copies to be specified.

  Printing will no longer issue a page-feed.

- The COSMOS main window Menu options have been restructured to
  better serve the new functions and features.

- If this README.TXT file is available in the COSMOS directory,
  a button to display it will be available in the about box.


Package changes
---------------

  Some minor changes have been made to the COSMOS.CTY, City list.
  Because entries have been added it may be required that you reselect
  your location (and save it).

  Most of the .TXT files have become obsolete because the text has now
  been integrated in the Help databases.
  .TXT file can now be used for user notes.

  The existing star and deep-sky objects databases names have changed.
  New databases are included and also database.REF files have been
  introduced.

  During installation, a subdirectory \METEOR will be created in
  the COSMOS directory. This sudirectory contains the meteor-shower
  coordinate display (.DTA) files.

  The DLL files are also new. If the LIBPATH statement in your 
  CONFIG.SYS does not have ";." in it then the COSMOS.DLL should
  be copied or moved into a directory that is included in your 
  LIBPATH statement, probably the C:\OS2\DLL directory.

  NOTE: The COSMOS.INI file format has changed in this version.
        Any existing COSMOS.INI file will not be used and will be
        replaced by the new format.

Notes
-----

  The COSMOS for OS/2 may be invoked in any way you prefer: 
  - OS/2 program object (double-clicking the Icon)
  - OS/2 command line,
  - Look2,
  - eXec,
  - OS/2 3.0 Warp Launch-pad

  Two or more COSMOS's may be invoked at a time, should you want to 
  compare a few different charts side-by-side.



                 End of COSMOS DEMO README.TXT file

