                            WorkShop Visual 2.0
                            --------------
            	Integration of Athena 3D Widget Set
            	-----------------------------------

This directory contains the files required to integrate the Athena public domain 3D 
widget set into WorkShop Visual 2.0.  

The configuration was checked against Athena 3D release 0.6B of 17th Feb 1993.

Files contained in this directory are as follows:

        README             - These notes.

        Makefile           - creates visu binary with the chosen Athena widgets
                            integrated.

        Athena3D.xdc       - visu_config configuration file for Athena 3D widgets.

        Athena3d_extras.c  - additional code for the Athena 3D integration.

        app-defaults/      - Resources for widgets in WorkShop Visual integration.

        bitmaps/*.bm       - bitmap files to represent Athena 3D on the WorkShop Visual
			     widget palette.


	Acquiring the Athena3D Widgets
	------------------------------

Xaw3d may be found on export.lcs.mit.edu (18.24.0.12) in the file:

	~ftp/contrib/Xaw3d/R5/Xaw3d-0.6B.tar.Z


	Integrating the Athena 3D widgets with WorkShop Visual
	-------------------------------------------------

1.  Start visu_config and use the File/Open menu option to load the
Athena.xdc file.  Three families will be listed:

        Athena/family   - contains Composites and Primitives

        Composites      - contains Composite Manager widget classes only.

        Primitives      - contains Athena 3D non-manager Widget classes only.


2. Select the 'Config file' option from the Generate menu. 

	The Generate dialog contains a toggle button for each family. 

	Select one or more of these families depending on the combination 
	of widgets that are to be integrated into WorkShop Visual. 
	
	Click on OK to generate the Athena3D_config.c file. 

	Repeat this procedure for the 'Code file' menu option to generate Athena3D_code.c.

	Simplest is just to click on Composites and Primitives.

3. Check that the Makefile is configured for your system and that
pathnames are correct. Build the WorkShop Visual binary using the following
command:

	make

After the build has successfully completed a 'visu.bin' executable
incorporating the required Athena 3D widgets will have been created in the
local directory.

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

	For this to work, you should install this directory as Athena3D 
	into the user_widgets sub-directory of your WorkShop Visual distribution.

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) within the WorkShop Visual distribution.
