This directory contains software development documentation for 
the Windows PC platform, "PCsdk.doc". This is in MSWord 95 format.

There is also a text file, "OGLsetup.txt", which gives instructions
on how to configure your computer system's graphics driver to enable 
OpenGL stereo buffering support.

Finally, four sample programs are included. These four 
programs use stereo OpenGL buffering, which work with stereo-ready 
graphics cards under Windows NT 4.0 and later.


1) Redblue.exe, Redblue.zip (source code):

   This is an extremely simple program. It puts up a blue rectangle
   to one eye, and puts up a red rectangle to the other eye.

   Uses plain OpenGL and Microsoft Foundation Classes.

   This program illustrates the following:
     - Testing for stereo display capabilities
     - Enabling a stereoscopic display window
     - Stereoscopic buffering
   
   The executable can also be useful for testing whether stereo works
   on a particular system, without requiring actual stereo glasses: 
   If stereo display is working, the overlap region between the two
   rectangles will appear (without stereo glasses) to be violet.
 

2) OGLplane.exe, OGLplane.zip (source code):

   A classic, greatly improved. It draws a spinning wireframe "paper
   airplane". 

   Uses plain OpenGL and Microsoft Foundation Classes.

   This program illustrates the following:
     - Testing for stereo display capabilities
     - Enabling a stereoscopic display window
     - Stereoscopic buffering
     - Asymmetric frustum stereo perspective projections
     - Appropriate calculation of stereo display parameters
     - Functionally independent user adjustments of stereo settings
   
   The stereo adjustment capabilities also make the executable useful 
   for demonstrating simple stereoscopy concepts, such as positive
   and negative parallax, and the distinction between the strength of
   the stereo effect and the stereoscopic parallax balance.


3) Morph.exe, Morph.zip (source code "StereoSample.c"):
 
   A modified version of Elsa's "StereoSample" example program. This
   program renders a shaded geometric object, which rotates, bounces, 
   and morphs. 

   This is useful as yet a sample program that does OpenGL stereo 
   shaded rendering using standard OpenGL. The diagnostic screen that
   appears at the start of the program may be useful as well.

   User interface: 
     - Mouse buttons affect stereo settings (left button: camera sep,
         right button: parallax balance
     - <enter> restores stereo setting defaults
     - <space> bar stops motion and morphing
     - <escape> quits

   Note that this program runs even if the current configuration 
   does not support stereo. See the diagnostic screen at the start 
   of the program to see if stereo is actually supported.


4) Newquad.exe, Newquad.zip (source code):

   A stereo adaptation of a Microsoft sample program, "Tquad". It 
   draws a 3D cylinder, and then allows various keyboard-driven 
   alterations. 

   Uses a variation of the Glaux library (which partially encapsulates
   OpenGL), that was modified by Diamond Multimedia to support their
   boards.

   This program fixes several annoying problems with what had been,
   for about the past year, SGC's flagship OpenGL sample application.
   Thus, programmers who are working with Glaux, programming 
   specifically for Diamond boards, or who are already acquainted with
   earlier versions of "Tquad", might find this program useful.
   
   Though this program is less than ideal as a sample OpenGL stereo 
   application, it may be useful as an example of a stereo 
   implementation that uses something other than standard OpenGL for
   stereo initialization. 


-Bob Akka
akka@crystaleye.com