home *** CD-ROM | disk | FTP | other *** search
/ Gambler 19 / GAMBLERCD19.BIN / UTILS / RIVA128 / Uzytki / ssystem-1.2 / README.TXT < prev    next >
Text File  |  1998-05-02  |  6KB  |  207 lines
  1. OpenGL ssystem 1.2 May-2-1998
  2. -----------------------------
  3.  
  4.  
  5. What is ssystem:
  6. ----------------
  7.  
  8.     ssystem is an OpenGL Solar System simulator. Only the Sun , the nine
  9.   planets and a few major satellites are included. Background stars are also 
  10.   included.
  11.  
  12.     Although ssystem is not 100% accurate I've tried to keep it as close
  13.   to reality as possible. Starting with version 1.1 all planets' data except
  14.   planets' radii, which are scaled up for easier visualization, should be
  15.   correct (within the accuracy limit of the new planet positioning algorithm,
  16.   see positions.c for details).
  17.  
  18.  
  19. System requeriments:
  20. --------------------
  21.  
  22.     -Linux or Windows 95/NT OS
  23.     -OpenGL library (tested with Mesa 2.6 and Microsoft DLLs)
  24.     -GLUT library (tested with 3.6)
  25.     -Voodoo Graphics card (tested with a Monster 3D)
  26.     -Glide library (tested with 2.4b1 in Linux and 2.43 in Windows 95)
  27.     -JPEG library (tested with 6.0.1)
  28.  
  29.  
  30.     JPEG library is not included since most linux distributions install 
  31.   the shared version (see WINDOWS notes).
  32.  
  33.     See Makefile for compile time options.
  34.  
  35.  
  36. Installation notes:
  37. -------------------
  38.  
  39.     LINUX:
  40.         -Get OPENGL/GLU/GLUT compliant libraries.
  41.          (Mesa includes all these and it's easy to compile, get it
  42.           here --> http://www.ssec.wisc.edu/~brianp/Mesa.html)
  43.         
  44.         -Edit the Mesa libs directory in Makefile.
  45.  
  46.         -Run 'make' and hopefully it's done.
  47.  
  48.  
  49.     WINDOWS:
  50.                 -Ensure you got OPENGL32.DLL GLU32.DLL and GLUT32.DLL. If
  51.                  you don't you can download them from ssystem homepage.
  52.          ( http://www1.las.es/~amil/ssystem )
  53.  
  54.         -I've included a Visual C++  Makefile (Makefile.win) in the
  55.          source distribution. It won't work if you try to link
  56.          against compiler OPENGL dafault libs, so once again
  57.          I recommend you getting Mesa. JPEG library binary and
  58.          header files are now included.
  59.  
  60.         3DFX:
  61.                 -DLLs with 3dfx Voodoo Graphics support are availables in
  62.                  ssystem homepage. Unless these DLLs are in the same
  63.                  directory as ssystem.exe or in your search path (first
  64.                  method is preferred) the program will use default OpenGL
  65.                  DLLs (if installed) and framerate will be VERY low.
  66.  
  67.  
  68. Command line options:
  69. ---------------------
  70.  
  71.     -bench    
  72.  
  73.         Aborts program execution after 1000 frames, displaying
  74.         framerate
  75.  
  76.     -slices N
  77.         
  78.         Sets sphere SLICES parameter to N
  79.  
  80.     -stacks N
  81.  
  82.         Sets sphere STACKS parameter to N
  83.  
  84.  
  85.     These two last options (slices and stacks) have a great performace
  86.   impact (see Performance section)
  87.  
  88.  
  89. Performance:
  90. ------------
  91.  
  92.  
  93.     Hardware acceleration is not required, but highly recommended for
  94.   smooth framerates. I get 48fps (running on Linux) with the "-bench" command
  95.   line option in my Pentium 233 (overclocked to 266). The Planets' Sphere 
  96.   detail (SLICES and STACKS) is the key factor in performance, increse them
  97.   if your CPU is powerful enough (I get over 110fps with both set to 2).
  98.  
  99.       Default value for SLICES and STACKS is 12 but you can play with these 
  100.   values in the command line (see Command line options section). Depending on
  101.   your system you may start trying with the following values:
  102.  
  103.  
  104.                     SLICES        STACKS
  105.  
  106.     Pentium 60 and below          8          6
  107.  
  108.     Pentium 100-166             10         10
  109.  
  110.     Pentium 200-266             12         12
  111.  
  112.     Pentium II 233             16         14
  113.  
  114.     Pentium II 300             20         18
  115.  
  116.  
  117. Keyboard bindings:
  118. ------------------
  119.  
  120.     Home/End: Selects previous/next body.
  121.     h : Online help
  122.     f : Flat/Smooth shading model.
  123.     t : Texture on/off.
  124.     l : Lighting on/off.
  125.     s : Stars on/off.
  126.     d : Demo mode on/off.
  127.     n : Moves camera near current planet.
  128.     c : Toggle between free and linked to planet camera modes.
  129.     p : Pause
  130.  
  131.   Hold SHIFT for faster operation in the following key bindings:
  132.  
  133.     +/-: Increase/Decrease time factor.
  134.     Arrow keys: Rotate camera.
  135.     Page Up/Down: Increase/decrease speed.
  136.  
  137.  
  138. Camera movement:
  139. ----------------
  140.  
  141.     Default camera mode is free. In this mode Arrow keys rotates camera, 
  142.   Page Up/Down increase/decrease camera speed.
  143.  
  144.     Linked mode is a bit different, here arrow keys are useless. You can
  145.   move the camera towards the planet by increasing speed. Once you're near
  146.   the planet program sets camera speed to zero.
  147.  
  148.     Camera speed is limited to 10000 Km/iteration (1 iteration = 1 frame), 
  149.   which is light speed at 30 frames/sec.
  150.  
  151.  
  152. Known bugs:
  153. -----------
  154.  
  155.     Outer bodies movement is a bit jerky. Although ssystem uses double
  156.   precision floating point arithmetic, Mesa uses simple precision arithmetic
  157.   internally (faster and precise enough for most aplications). I'm working
  158.   on it.
  159.  
  160.  
  161. ACKNOWLEDGEMENTS:
  162. -----------------
  163.  
  164.  
  165. -Brian Paul (Mesa)
  166.     http://www.ssec.wisc.edu/~brianp/MesQ.html 
  167.  
  168. -Daryll Strauss (Linux Glide)
  169.  
  170.  
  171. -David Bucciarelli (Mesa 3dfx driver)
  172.     http://www-hmw.caribel.pisa.it/fxmesa/index.shtml
  173.  
  174. -Curtis L. Olson (star catalog stuff)
  175.  
  176.  
  177. -This software is based in part on the work of The Independent JPEG Group
  178.  
  179.  
  180. -Galilean and Saturn satellites computed using code extracted with
  181.  permission from XEphem, (c) 1997 Elwood Charles Downey
  182.     http://iraf.noao.edu/~ecdowney/xephem.html
  183.  
  184. -Keith Burnett's planet positioning algorithm used with persmission.
  185.     http://www.xylem.demon.co.uk/kepler/
  186.  
  187. -Nacho (beta testing)
  188.  
  189.  
  190. -And of course, thanks to all of you who help me with suggestions and tips.
  191.  
  192.  
  193. NOTE:
  194. -----
  195.  
  196.     This is my first OpenGL program and it's still in developmental stage,
  197.   so I'd really appreciate your feedback. 
  198.  
  199.     Constructive criticism is always welcome. :-)
  200.  
  201.  
  202.     Check ssytem homepage for updates (http://www1.las.es/~amil/ssystem).
  203.  
  204. Raul Alonso
  205. <amil@las.es>
  206.  
  207.