Integration of EPak Widgets
		      ---------------------------

This directory contains the files required to integrate the EPak
3.0 widget set into WorkShop Visual 6.0.

The Integration Distribution
-----------------------------

Files contained in this directory are as follows:

	README                 - These notes.

	EPak.README            - A description of EPak, and where to get it.

	Makefile               - creates visu binary with EPak
				 widgets integrated.

	EPak.xdc               - visu_config configuration file
				 for EPak 3.0 widgets.
	EPak30.xdc             - visu_config configuration file
				 for EPak 3.0 widgets.
	Epak25.xdc             - visu_config configuration file
				 for EPak 2.5 widgets
	Epak30to25.xdc         - visu_config configuration file
				 for EPak 3.0 but for strict
				 compatability with EPak 2.5.

			 These all contain
			 EPak/GraphPak/EditTable/ChartObject/View3D.

	EPak_stubs.c           - additional code for the EPak
				 widget integration.

	Converters.c           - Type converter code for the
				 integration and application code
				 should the need arise.

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

	make_templates         - directory containing makefile
				 templates for building generated
				 designs containing EPak widgets

	app-defaults/visu - Resources for integration.

	Configure              - a shell script for building and
				 configuring everything


Integrating EPak widgets
------------------------

0.  Decide which integration you wish to perform: pick one of the
EPak, EPak30, EPak25, EPak30to25 configuration files.

1.  Start visu_config and use the File/Open menu option to load
the EPak.xdc file.  The following families of widgets should be
listed:

	EPak
	GraphPak
	EditTable
	View3D
	ChartObject

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 EPak_config.c file.  Repeat this procedure for
the 'Code file' menu option to generate EPak_code.c.

3.  Either check that the Makefile has appropriate settings and
pathnames for your system.  Be sure to check both the default rules
at the top, and the per-system rules further on, or run the
Configure shell script, described in section 4 below, with
appropriate arguments.

Ensure that you have EPAK_DIR pointing to the root of your
installed Epak distribution.  Similarly, if using View3D, ensure
GL_DIR points to the root of your GL distribution.  Comment out all
the GL_ definitions otherwise.

Ensure that EPAK_CFLAGS has the right setting for the widgets you
are integrating.  You will need to concatenate from the following:

	-DINTEGRATE_EPAK            # Using the EPak basic widgets
	-DINTEGRATE_GRAPHPAK        # Using the EPak graph components
	-DINTEGRATE_EDITTABLE       # Using the INT EditTable
	-DINTEGRATE_VIEW3D          # Using the INT View3D widget
				    #  - requires GL support
	-DINTEGRATE_CHARTOBJECT     # Using the INT Chart objects

For EPak 2.X, add the following if integrating the INT components:
	-DXintVERSION=2

For EPak 3.X, add the following if integrating the INT components:
	-DXintVERSION=3

Build the WorkShop Visual binary using the following command:

      make

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

Note: this integration is a little noisy in the build: you can
expect quite a few "warning: macro redefined" and "warning:
initialization type mismatch" messages, or similar.

4.  Check that the motif and mfc makefile templates in
makefile_templates directory have correct values for building EPak
with the chosen integrated widget groups.  The variables in these
templates will be the same as those in the Makefile to build
WorkShop Visual.  Again, ensure that both the default rules and
per-system specifications are checked.

Alternatively, run the Configure shell script to configure both the
Makefile and makefile templates for your required system.  The
Configure script takes the following arguments:

	-graph:   Integrate the EPak graph widgets
	-epak:    Integrate the EPak basic widgets
	-table:   Integrate the EPak INT EditTable widgets
	-view:    Integrate the EPak INT View3D widgets
	-chart:   Integrate the EPak INT ChartObject widgets
	-ics25:   Configure for Epak version 2.5 [default is 3.0]
	-int2:    Configure for INT version 2 [default is 3]
	-mesagl:  Configure for Mesa GL [default is -lGL -lGLU]
	-build:   Build WorkShop Visual once the Makefiles are configured

The default behaviour (no arguments) will assume you are
integrating against EPak 3.0 using all the widgets sets available,
and will construct a Makefile and make templates accordingly.

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

6.  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).

WARNING: The ChartObject Data object classes must never be managed.
This breaks all previous versions of WorkShop Visual.
Do not attempt to instantiate these Data objects inside WorkShop Visual
unless you have WorkShop Visual 6.0.