home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 August / chip_08_2000.iso / software / astro / starcalc / README.TXT < prev    next >
Text File  |  2000-05-28  |  11KB  |  264 lines
  1.  
  2.                                 STARCALC 5.6
  3.  
  4.           Astronomy planetarium and map program for Windows 95/98/NT
  5.  
  6. I.   INTRODUCTION.
  7.  
  8. II.  SYSTEM REQUIREMENTS.
  9.  
  10. III. PROGRAM INSTALLATION.
  11.  
  12. IV.  PROGRAM USAGE.
  13.  
  14.    1. StarCalc start.
  15.  
  16.    2. Working modes and short description of StarCalc possibilities.
  17.  
  18.    3. Plugin's: installation and usage.
  19.  
  20.    4. Full list of the program "hot" keys.
  21.  
  22.  
  23.                                I. INTRODUCTION.
  24.  
  25.    StarCalc is the fastest professional astronomy planetarium & star mapping
  26. program for Windows 95/98/NT. It illustrates star positions of any instance 
  27. of the day observed from any geographic locations on the Earth. The star 
  28. positions can be viewed and presented as images of semispherical whole sky or
  29. any of the user defined sub-areas. These images can be zoomed at different 
  30. scales, rotated, screen-captured and printed. 
  31. Best of all StarCalc is freeware.
  32.  
  33.    Main features of StarCalc:
  34.  
  35. - Extensibility:
  36.   Absolutely all of object types, which can be drawn by this program, work
  37.   through common "Plugin StarCalc interface to catalogs and object groups".
  38.   Any object or object group type (from Horizon to star catalogs) is implemented
  39.   as independent module, which is used by program core for drawing it's objects
  40.   and working with other functions of this interface (object search, etc.).
  41.   With minimal configuration, program has a core + set of 12 standard
  42.   interfaces, linked in one exe-file. Extension of StarCalc functions
  43.   is made on the bases of Plugin files, including replacement of standard
  44.   interfaces.
  45.  
  46.   Plugin files can be implemented by any program development instrument,
  47.   which can create a dll-libraries, therefore I plan to prepare a SDK,
  48.   in order that StarCalc extensions can be made by independent programmers
  49.  
  50. - fast performance:
  51.   In StarCalc, extra efficient algorithm of coordinates transformation was
  52.   implemented, therefore in "Quick view" mode image calculation lasts a fraction
  53.   of a second even on slow computers with 486SX processor (without co-processor!).
  54.   In "Detailed view" mode co-processor is recommended, but not mandatory.
  55.   If computer has 486DX4-100 processor or higher and a video card with
  56.   graphic accelerator, you can see the "sky rotation" effect with constellation
  57.   lines and constellation boundaries. Besides, plugin interfaces allow
  58.   optimal support to any catalogs.
  59.  
  60. - User friendliness technology:
  61.   StarCalc has a simple interface, most operations are implemented by mouse or
  62.   "hot" keys (see item IV.4). The program follows WYSIWYG technology (What You 
  63.   See Is What You Get), what helps you to print a detailed image of any 
  64.   enlarged sky area.
  65.  
  66.  
  67.                          II. SYSTEM REQUIREMENTS.
  68.  
  69.    The program doesn't call for great computer performance and works well on
  70. any computer with installed Windows 95 or Windows NT 4.0 or higher. Of
  71. course, during work with Plugin interfaces to big astronomy catalogs, you
  72. must have enough disk space and RAM at least 16 Mb.
  73.  
  74.  
  75.                         III. PROGRAM INSTALLATION.
  76.  
  77.    To install StarCalc you must copy files from archive sc56en.zip to
  78. a temporary folder and start file setup.exe, however this procedure isn't
  79. mandatory and after files are extracted you can start main program 
  80. (starcalc.exe file) right away. If the installation program overwrite an
  81. old version of StarCalc, it save settings of this, selected previously.
  82.  
  83.  
  84.                             IV. PROGRAM USAGE.
  85.  
  86.                             1. StarCalc start.
  87.  
  88.    After the installation procedures, start of StarCalc is made from "Start"
  89. menu or by file "starcalc.exe". The program initializes available interfaces
  90. (standard and plugin) with an appropriate messages show, then sets the "Quick
  91. view" mode (zoom 100%) and current time. (If other settings were not saved
  92. as "default state" previously.) When these procedures are completed,
  93. StarCalc is ready to use.
  94.  
  95.  
  96.       2. Working modes and short description of StarCalc possibilities.
  97.  
  98.    StarCalc have a two working modes: "Quick view", during zoom between
  99. 50% and 600%, and "Detailed view" with zoom from 601% to 100000%. Each of
  100. available interfaces to object groups can support one of this modes or
  101. both. Change of mode is made automatically during zoom change. Set of object
  102. groups, which must be shown in each of modes, its draw order and parameters
  103. are set in dialog window (menu "Catalogs and object groups"). You may change 
  104. draw order by buttons with arrows, pressing "Shift+Up"/"Shift+Down" keys 
  105. or dragging by mouse over group list.
  106.  
  107.    Image of sky semi-sphere can be rotated under any angle along the azimuth.
  108. For this action you can press "Azimuth rotate" button, press down the left mouse
  109. button and drag mouse over sky image. If you wish to turn the image around by
  110. a certain angle, click the mouse right button and choose a line of a popup menu
  111. accordingly or use "hot" keys (see item IV.4).
  112.  
  113.    For object selection press "Object selection" button and click left
  114. mouse button on the needed object. After double click you will see the window
  115. with a full data about this object. Also, you can select object from selection
  116. list in right mouse button context menu.
  117.  
  118. In the 5.5 Version of StarCalc new "Object locking" mode is added. After
  119. turning on this mode, if you change zoom or time, selected objects are
  120. centered in main program window. With the help of this mode, for example, you 
  121. can comfortably observe eclipses or star occultation processes.
  122.  
  123.    On the fast computer after the input of the required image rotation step
  124. (to be set at the special dialog window) press and hold down '+' or CTRL+F 
  125. ('-' or CTRL+B), or turn "on" autorotation mode, and you will enjoy the effect
  126. of sky rotation even with constellation boundaries preserved. If the step of
  127. rotation is equal to mean solar day or sidereal day you can see how planets,
  128. the Sun, etc. move along the sky sphere.
  129.  
  130.    The program can rotate the sky automatically - forward, backward or in
  131. "real time mode". Duration of rotation step (excluding real time mode) for
  132. autorotatoin mode same as duration of rotation step for "time forward"/
  133. "time back" functions. Other parameters of autorotation mode - image refresh
  134. rate, etc. - are implemeted in special dialog window.
  135.  
  136. In the 5.6 version of StarCalc new "Save state"/"Restore state" functions are
  137. implemented. With help of these functions is possible not only go back to
  138. viewing the necessary events, as well as to set sky image parameters at the
  139. program start. For example, if you want to view required point on sky image,
  140. you must save program state with "Location on sky image" and "Restore at the
  141. program start" options.
  142.  
  143. The image adjustment toolbar can be made "auto hide" in order to save screen
  144. space. For this purposes please select "Auto hide toolbar" in the menu. In
  145. this case the toolbar will appear, if you move the mouse cursor to the bottom
  146. of the main program window.
  147.  
  148. As for the rest of my program, I think, you will understand it yourself without
  149. problem.
  150.  
  151.                   3. Plugins: installation and usage.
  152.  
  153.    After StarCalc installation in it's folder a sub-folder with name "Plugins". 
  154. is created. For usage of a plugin you must copy it's files into this
  155. sub-folder. Also, for each plugin, you can make a sub-folders within "Plugins"
  156. and place files into it.
  157.    During StarCalc start, available plugins are recognized and initialized
  158. automatically. If program has found a new Plugin, it shows a window with
  159. checkboxes for selection modes ("quick" and "detailed"), in which objects of
  160. this plugin will be shown.
  161.    Installed plugin can be setup as well as standard interfaces.
  162.  
  163.  
  164.                 4. Full list of the program "hot" keys.
  165.  
  166. a) Keys that are used to work in the main program window:
  167.  
  168.    '+' or Ctrl+F      -  Time forward
  169.    '-' or Ctrl+B      -  Time back
  170.  
  171.    Ctrl+N             -  Set the current time
  172.  
  173.    Ctrl+L             -  Turn On/Off "Object locking" mode.
  174.    Ctrl+G             -  Turn On/Off "Autorotation" mode.
  175.  
  176.    F2                 -  Save program state
  177.    F3                 -  Restore program state
  178.  
  179.    Ctrl+P             -  Print image
  180.    Ctrl+S             -  Save image as file
  181.  
  182.    PageUp             -  Zoom In
  183.    PageDown           -  Zoom Out
  184.    Home               -  Set Zoom equal to 100% (All sky)
  185.    Keys 1..0          -  Set fixed zoom values:
  186.                          (100%, 150%, 200%, 250%, 350%, 600%, 1000%, 3000%,
  187.                           8000% and 50000%)
  188.    
  189.    F8                 -  Adjustment of object group parameters, which have
  190.                          support of this function
  191.  
  192.    Cursor keys        -  Shift sky image in quick and detailed view modes
  193.  
  194.    Ctrl+I             -  Information about selected objects
  195.  
  196.    Ctrl+H             -  Enable/Disable horizontal coordinate grid
  197.    Ctrl+E             -  Enable/Disable equatorial coordinate grid
  198.  
  199.    F9                 -  Show "Catalogs and object groups" window
  200.  
  201.    Ctrl+D             -  Set date and time
  202.  
  203.    Ctrl+R             -  Set duration of rotation step
  204.  
  205.    Ctrl+T             -  Set autorotation parameters
  206.  
  207.    Ctrl+A             -  Set Azimuth rotation angle
  208.  
  209.    Ctrl+Z             -  Set Zoom
  210.  
  211. b) Keys that are used to work in dialog windows:
  212.  
  213.    For date/time, rotation step, azimuth rotation angle and zoom set windows
  214.    pressing the "Enter" key confirms settings and "Esc" cancels them.
  215.    For example, in order to set duration of rotation step equal to
  216.    mean solar day, it is enough to press the following key combinations:
  217.    "Ctrl+R", "Shift+5", "Enter".
  218.  
  219.    For duration of rotation step window:
  220.  
  221.    Shift+1    -  set the step equal to 1 second
  222.    Shift+2    -  set the step equal to 1 minute
  223.    Shift+3    -  set the step equal to 1 hour
  224.    Shift+4    -  set the step equal to sidereal day
  225.    Shift+5    -  set the step equal to mean solar day
  226.    Shift+6    -  set the step equal to synodic month
  227.  
  228.    For azimuth rotation angle set window:
  229.  
  230.    Shift+1    -  North at the bottom of image
  231.    Shift+2    -  East at the bottom of image
  232.    Shift+3    -  South at the bottom of image
  233.    Shift+4    -  West at the bottom of image
  234.  
  235.    For autorotation parameters set window:
  236.  
  237.    Ctrl+F     -  set direction of rotation to "Forward"
  238.    Ctrl+B     -  set direction of rotation to "Backward"
  239.    Ctrl+R     -  turn On/Off the "Real time mode"
  240.  
  241. c) For information and "visibility period" windows:
  242.  
  243.    "Esc" - exit.
  244.  
  245.  
  246.  
  247.    News, last versions of StarCalc and Plugins for it can be found on
  248. the StarCalc Home page mirrors: 
  249.  
  250. http://www.m31.spb.ru/StarCalc/main1251.htm
  251.  
  252. http://www.relex.ru/~zalex/main.htm
  253.  
  254.    If you want to see new possibilities of StarCalc (may be in the form
  255. of Plugin) or you have other questions or requests, send me e-mail to
  256. following address:
  257.  
  258. zalex@relex.ru
  259.  
  260.  
  261. With best regards,
  262.  
  263. Alexander E. Zavalishin
  264. Voronezh, Russia