Running CurvedSpaces-Simple

This file explains how to use the compiled version of the
CurvedSpaces-Simple sample code accompanying the article

    "Real-time rendering in curved spaces",
    IEEE Computer Graphics and Applications, Nov-Dec 2002.

Please see the article itself for an explanation of the underlying
mathematics, and the source code for implementation details.

(1)  Start the program.
     D3D Version:  If you have DirectX 7 or newer you'll get a window
          with a menu bar and some spinning polyhedra and you can proceed
          to Step 2 below.  Otherwise you'll get a cryptic error message
          complaining that Windows can't find the library DDRAW.DLL
          and/or the function DirectDrawCreateEx, in which case
          you'll need to go to Microsoft's DirectX download page
          (http://www.microsoft.com/directx/homeuser/downloads/default.asp)
          to download a free copy of DirectX 7 or newer.
     OpenGL version:  All you need is OpenGL (not GLU or GLUT), which
          comes with Windows95 and up, and a graphics card that supports it.

(2)  Hit the up-arrow key a few times to get yourself moving.
     To control your speed
     
        up arrow    = faster
        down arrow  = slower
        space bar   = stop
     
     Make your speed negative if you want to go backwards.
     
(3)  Click on the scene.  The cursor will disappear, and your mouse will
     shift into steering mode.  To regulate
     
        pitch     move the mouse forwards or backwards
        yaw       move the mouse left or right
        roll      move the mouse left or right with the control key down.
     
     You can pitch, yaw, and roll even when your speed is zero,
     for example after pressing the space bar.

(4)  Right click to recover the standard cursor.

(5)  Use the Space menu to change to a spherical, flat or hyperbolic space.

(6)  Select spherical space, and hit the down-arrow key a few times to get
     yourself moving backwards.  Can you predict what you will see as you
     pass through the point diametrically opposite the octahedron, and then
     the point opposite the cube?

Note:  CurvedSpaces-Simple is intended as the simplest starting point
for programmers learning about curved space graphics.
CurvedSpaces-Complete is more fun to use.

Questions?  Contact Jeff Weeks at the address
                weeks <at> geometrygames <dot> org