        #
        | README file for
        |
        | ELSA GLoria-XL Stereo Demo
        |
        | Copyright (c) 1993-98 ELSA AG, Aachen (Germany)
        |
        | ELSA AG                 Internet   : http://www.elsa.de
        | Sonnenweg 11            LocalWeb   : +49-(0)241-938800
        | D-52070 Aachen
        |
        | ELSA Inc.               Internet   : http://www.elsa.com
        | 2231 Calle De Luna
        | Santa Clara, CA 95054
        | USA
        |
        | ELSA Asia Inc.          Internet   : http://www.elsa.com
        | 7F-11, No. 188, Sec. 5
        | Nanking East Road
        | Taipei 105
        | Taiwan, R. O. C.
        |
        | ELSA Japan Inc.         Internet   : http://www.elsa.com
        | Mita Suzuki Building 3F
        | 5-20-14 Shiba, Minato-ku
        | Tokyo 108-0014
        | Japan
        |
        | 05/12/1998, ju



        Requirements:
        -------------

        GLoria-XL with Shutter Glasses connector
        Shutter Glasses (StereoGraphics CrystalEyes or SimulEyes)
        Windows NT 4.0 Display Driver: 5.34.00.327
        OpenGL Driver ELSAOGL:         2.01.13.086

        Stereo.exe and Wavefront object and material files
        (obj, mtl)

        Three button mouse required for eye distance adjustments,
        but not necessary for this demo to show the stereo effect.


        Running the program:
        --------------------

1.      Start a command prompt and change directory
        to the folder with the stereo.exe program.


2.      Run the program with  stereo filename.obj
        where filename is the name of one of the obj-files.

        With CrystalEyes the red LED of the transmitter box should
        turn on, the shutter should flicker as long as the glasses
        are opened and the infrared sensor isn't blocked.
        There is a switch on the right side which turns on the
        glasses as long as they are opened. Close the glasses to
        save batteries while not in use!

        The SimulEyes should flicker while the stereo program
        runs.


3.      Functions in the program:

        Hold down the left mouse button to turn the object.
        If you release the left mouse button, the object will keep
        spinning. Click the middle or right mouse button shortly
        (don't drag) or hit SPACE to stop spinning.

        The program implements the concept of the so called
        "HyperSphere" where the user is able to spin an object
        around an arbitrary axis with a two dimensional input
        device. This is absolutely intuitive and easy to do.
        Imagine you click onto a sphere and roll it into the
        direction you move the mouse.

        For the experienced user:
        Hold down the middle mouse button and drag left and right
        to adjust the eye distance.
        Hold down the right mouse button and drag left and right
        to adjust the parallax.
        Hit RETURN to reset the default settings for eye distance
        and parallax.

        Both functions used in conjunction can change the position
        where the object lies in relation to the screen
        (in front or behind).
        The default setting is chosen in a way that the center of
        the object is lying in the screen plane (points with zero
        parallax setting), so half of the object is in front and
        the other half behind the screen plane.
        Most users are comfortable with this setting and accept
        the visual effect of 3D Stereo easier.

        The KEYS '1' and '2' toggle between single sided and
        double sided drawing. Performance is better with single
        sided drawing. Switch to double sided drawing only if
        faces of an object are missing. This is normally the case
        if the program which generated the object files wasn't
        elaborated enough to keep the triangle winding counter-
        clockwise.

4.      Exit the program with the ESC key, Alt+F4, or click the
        Close Button on the Window title bar.
        (The left eye of the SimulEyes shutter glasses stays
        black shortly, this is normal.)


        Tips and Tricks:
        ----------------

        - Use true color resolutions!
          Additionally to no dithering artefacts, the Windows NT
          driver implemented double buffering with page swapping
          in true color. This results in a dramatic performance
          increase in animations. Only run one demo at a time,
          double buffering cannot page flip with more than one
          double buffered OpenGL application running and defaults
          to a blit then.

        - Use high refresh rates > 100 Hz to get more than 50 Hz
          for each eye.

        - Decrease room lighting to get better contrast and less
          isturbing flickering from the shutter glasses.

        - Avoid green objects, because green has the most ghosting
          (crosstalk between the two images) on the phosphor of
          the monitor screen.

        - Increasing the distance between viewer and screen can
          improve the stereo effect.

        - Avoid crossing the left or right window border with an
          object that should lie in front of the screen as this
          damages the stereo effect. The default view of the demo
          is setup never to let that happen as long as the window
          is wider than high.

        - The most impressive objects are:

        color:   castle.obj
                     al.obj
               dolphins.obj
                    pig.obj

        mono:  triceratops.obj
                       cow.obj
                     shark.obj
                     vette.obj

        - Spin slowly! The best stereo effect is seen with the
          object slowly spinning around the vertical (y-) axis.
          Try this with the triceratops.obj!

        - If you want the object to be popping out of the screen,
          adjust parallax and eye distance so that the farthest point
          of the object is on the same spot on the screen in both
          pictures (watch the ghosting). If you think the settings are
          totally messed up hit RETURN to reset to the defaults.


        License Information:
        --------------------

        Wavefront object file format reader based on SMOOTH example
        sources written by Nate Robins, which can be found on the SGI
        Developer Tools Demo CD August 1997.


        Have fun!

