WorkShop Visual 6.0
			    --------------
		      Integration of INT Widgets
		      --------------------------

This directory contains the files required to integrate
version 3.3 of the INT widget set into WorkShop Visual 6.0.

Files contained in this directory are as follows:

	README          - These notes.

	Makefile        - creates visu binary with INT widgets
			  integrated.

	INT.xdc         - visu_config configuration file for INT widgets.

	INT_stubs.c     - additional code for the INT widget integration.

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

	bitmaps/*.xpm   - bitmap and pixmap files to represent INT widgets on WorkShop Visual widget
			  palette.

	XdIntMap.h      - Header files required to build

Integrating INT widgets with visu
--------------------------------------

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

	View3D        2.0 - View3D and superclasses
	EditTable     3.3 - EditTable, superclasses, Scroll
	Geoscience    3.3 - Contour, Seismic, Segy, WellLog, Axis, Grid, Track, ...
	PlotXY        3.2 - PlotXY and superclasses, Scroll
	GraphicObject 3.2 - Graphic, superclasses, and associated Graphic objects
	DataObject    3.2 - DataGroup, DataGrid, DataSeries, DataTimeLabel, ...
	ChartObject   3.2 - Chart, superclasses, and associated Chart objects
		     
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 INT_config.c file. Repeat this procedure for the 'Code file' menu
option to generate INT_code.c.

3. Check that the Makefile has appropriate settings and pathnames for
your system. 

In particular, you will need the following build flags depending on
the families you have selected. Append the following to INT_CFLAGS:

	View3D:      -DINTEGRATE_VIEW3D
	EditTable:   -DINTEGRATE_EDITTABLE
	GraphObject: -DINTEGRATE_GRAPHICOBJECT 
	Geoscience:  -DINTEGRATE_GEOSCIENCE 
	PlotXY:      -DINTEGRATE_PLOTXY
	DataObject:  -DINTEGRATE_DATAOBJECT
	ChartObject: -DINTEGRATE_CHARTOBJECT

Optionally, you will require -DUSE_MESA for View3D if you are using the Mesa GL
libraries supplied with the INT distribution.

You may also need to configure the requisite libraries for linking. Configure
INT_LIBRARIES according to the following requirements:
	
	View3D:      -lView3D -ltiff -lGL -lGLU (-lMesaGL -lMesaGLU)
	EditTable:   -lINT -lINTCGM
	GraphObject: -lINT -lINTCGM
	Geoscience:  -lINTC -lINT -lINTCGM
	PlotXY:      -lINT -lINTCGM
	DataObject:  -lINT -lINTCGM
	ChartObject: -lINT -lINTCGM

You may also require INT_EXTRA_LIBRARIES configured: the Geoscience
Contour library has a Fortran 77 dependency. The following libraries
are usually located in /opt/SUNWspro/lib:

	Geoscience:  -lF77 -lM77 -lsunmath

Alternatively, there is a Configure script which takes the following arguments:

        -view:   Integrate the INT View3D widgets
        -table:  Integrate the INT EditTable widgets
        -geo:    Integrate the INT Geoscience widgets
        -plot:   Integrate the INT PlotXY widgets
        -graph:  Integrate the INT GraphObject widgets
        -data:   Integrate the INT DataObject widgets
        -chart:  Integrate the INT ChartObject widgets
        -all:    Integrate all INT widgets [The default]
        -mesa:   Configure for Mesa GL [default is -lGL -lGLU]
        -static: Configure for Static INT Libraries
        -build:  Build WorkShop Visual once the Makefiles are configured
	-patch:  _XmDrawShadow is undefined: fix using INT_patch.c

The default is to integrate and build everything. Some tests are performed
internally to check the libraries that your INT distribution supports.

Build the WorkShop Visual binary using the following command:

      make

It is possible for the build to fail due to the unresolved symbol _XmDrawShadow:
The library libINT.a may be referencing now obsolete Motif code.
To fix the problem, you need to compile INT_patch.c with -DOBSOLETE_DRAW_SHADOW.
This file contains a faked up version of _XmDrawShadow which calls _XmDrawShadows.
This in turn will need replacing for Motif 2.x with XmeDrawShadows at some point,
unless the libraries are themselves patched in the interim. The Configure
script also understands the flag -patch, which adds -DOBSOLETE_DRAW_SHADOW to
the compilation rules automatically, and compiles in INT_Patch.c. Run the command 

	make clean

then Configure with -patch added to your previous arguments.

After the build has successfully completed a 'visu.bin' executable
incorporating the INT 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=INT)
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).