Integration of OpenGL Widget
		----------------------------

This directory contains the files required to integrate the OpenGL
widget into WorkShop Visual.

Files contained in this directory are as follows:

	README           - This file.

	Makefile         - creates visu binary with GL widgets
			   integrated.

	OpenGL.xdc       - visu_config configuration file for OpenGL widget.

	builtin_bitmaps/ - bitmap file to represent GL widget
	OpenGL.bm          on WorkShop Visual widget palette
	
	bitmaps/         - Xpm file to represent GL widget
	OpenGL.xpm         on WorkShop Visual widget palette

	OpenGL_stubs.c   - additional code for widget integration.

	app-defaults/    - Resources for integration.
	visu

OpenGL Prerequisites
--------------------

OpenGL may require specialised hardware to run correctly (or at
all).  The following are known hardware/software requirements.  For
other systems consult the system administrator or the OpenGL
documentation that accompanies the system.

Silicon Graphics/Irix:

    OpenGL is supported natively on these systems.

SPARC/solaris 2:

    The hardware must be an Ultra 1 or Ultra 2 system with a
    Creator 3D frame buffer.  Operating system must be Solaris 2.5
    HW 1/96 or higher.

Integrating with WorkShop Visual
---------------------------

1.  Start visu_config and open the OpenGL.xdc file.

2.  Use the generate menu to create the OpenGL_code.c code file and
the Open_GLconfig.c config file.

3.  Check that the Makefile has appropriate settings and pathnames
for your system.  Build the WorkShop Visual binary using the following
command:

      make

After the build has successfully completed a 'visu.bin'
executable incorporating the openGL widget will have been created
in the current directory.

4.  This binary may be invoked by setting the environment variable
USER_WIDGETS to the name of this directory (i.e. USER_WIDGETS=OpenGL)
and invoking WorkShop Visual as normal.

5.  This widget integration can be made the default for your site
by moving or copying this directory to 'local' (including any
bitmap and app-defaults sub-directories).