Introdution
-----------

ogltrace - An OpenGL tracing utility library.

Files
-----

dll.c		- Contains main shared library entry point which
                  checks environment variables and allocates memory
                  when DLL or DSO is loaded by an application.
                  Tracing behaviour controlled by environment
                  variables outlined below.

ogltrace.c     - Functions which trace OpenGL calls.

state.c        - Functions which handle tracing of state information.

wgltrace.c     - Functions which trace WGL calls.

xgltrace.c     - Functions which trace GLX calls.

Setup
-----

NT

Building makefile creates opengl32.dll.  Put this DLL in the
applications directory or into another directory in the LIB
path ahead of the directory which containts the system opengl32.dll.

IRIX:

Building makefile creates libogltrace.so.  Use this DSO
by setting the following environment variable.

set _RLDN32_LIST directory/libogltrace.so:DEFAULT

This directs the runtime linker to resolve the OpenGL, and
GLX symbols in this DSO before resolving them in libGL.so.

LINUX:

Building makefile create libGL.so.1.  Set then environment
variable LD_LIBRARY_PATH to the directory which contains this
DSO.  When the application executes, the run-time loader will
resolve the OpenGL and GLX symbols using this DSO.  Use the
ldd command to verify that the application is find the
correct libGL.so.

Usage
-----

Behaviour is controlled by a set of environment variables.  Use
the environment variables to control the output from the tracing
utility.

OGL_ONSWAP : If set, statistics refresh on each swapbuffer call. 
             If not set, default is to refresh on each glClear call.

OGL_TRACE  : If set, OpenGL trace information output to file
             ogldebug.txt.  ***Need to change to ogltrace.txt***

  OGL_NODATA : If set, data no put in output file inorder to reduce
               the size of the resulting file.

OGL_STATI  : If set, OpenGL trace information output to console window.

  OGL_STATMAT : If set, output stats on glMaterial calls.

  OGL_STATABLE : If set, output stats on glEnable/glDisable calls.

  OGL_STATPRIM : If set, output stats on OpenGL primtive calls.

OGL_STATRECORD : If set, output per frame trace of the primitive 
                 statistics in the file statrecord.txt 


