                                                          March 12,1996


  Integration of XRT/graph, XRT/3d, XRT/table, XRT/field, and XRT/gear
  --------------------------------------------------------------------
                            into WorkShop Visual 2.0
        		    ------------------------

This directory contains the files required to integrate the KL Group
XRT/graph 2.4.0, XRT/3d 2.1.0, XRT/table 2.2.0, XRT/field 1.0.0 and
XRT/gear 1.0.0 widgets into WorkShop Visual version 2.0.

Files contained in this directory are as follows:

        README          - These notes.

        Configure       - Shell script which creates a customized
                          Makefile for your architecture based on the
                          templates in the config directory and creates
                          a new visu executable using that Makefile.

        Makefile        - creates visu binary with XRT widgets
                          integrated (this Makefile is generated by
                          running the configure script)

        XRTfamily.xdc   - visu_config configuration file for XRT widgets

        XRT_iface.c     - additional interface code for XRT integrations.

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

	builtin_bitmaps/      - contains bitmap files used to represent the XRT
			        widgets on WorkShop Visual's widget palette.

	bitmaps/   	      - contains pixmap files used to represent the 
				XRT/gear widgets on WorkShop Visual's widget palette.

Integrating XRT/graph, XRT/3d, XRT/table, and/or XRT/field with WorkShop Visual
-------------------------------------------------------------------------

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

        XRT/family - contains XRT/graph, XRT/3d, XRT/table, and XRT/field
                     widgets.

        XRT/graph  - contains XRT/graph widget class only.

        XRT/3d     - contains XRT/3d widget class (includes XRT/3d text
                     objects)

        XRT/table  - contains XRT/table widget class (includes label widget).

        XRT/field  - contains XRT/field widgets (including the ComboBox
                     and SpinBox widgets)

        XRT/gear  - contains XRT/gear widgets
														   
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 xrtconfig.c file. Repeat this procedure for the 'Code file' menu
option to generate xrtcode.c.

3. Build the visu binary using the Configure script.  Ensure that
environment variables XRTHOME and VISUROOT and set to the XRT home directory
and WorkShop Visual install directories respectively. Type

        ./Configure    (OR  /bin/sh ./Configure)

This will create a Makefile for your particular architecture and
configured for any XRT products which you have installed. If you do
not wish to configure all of your installed XRT products you can use
one or more of the following options to skip an installed XRT product:

        -nograph                do not configure with XRT/graph

        -no3d                   do not configure with XRT/3d

        -notable                do not configure with XRT/table

        -nofield                do not configure with XRT/field

        -nogear                do not configure with XRT/gear


For example, the command

        ./Configure -notable

will ignore XRT/table but will include XRT/graph, XRT3d, XRT/field or XRT/gear
if they are installed. You can type:

        ./Configure -help

for a complete list of options.


NOTE: Configure will include a product even if it has not yet been
enabled. It will also include older releases (eg XRT/graph 2.3). These
cases should be skipped using the appropriate option.

If the process fails, you may need to edit the Makefile for your
particular environment.  If you have edited the Makefile do not rerun
Configure as it will write over the Makefile.  In this case just
typing make will work.

After the build has successfully completed an 'visu' executable
incorporating the required XRT 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=XRT)
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).
 

Displaying graphs inside WorkShop Visual
-----------------------------------

Many resource changes made to an XRT/graph or XRT/3d widget from within
WorkShop Visual are not visible unless the widget is displaying a graph.  
A graph can be displayed from within WorkShop Visual by specifying the path
name to a suitable data file in the XRT/graph xrtData and xrtData2 or 
XRT/3d xrt3dSurfaceData resource fields. A number of sample data files
are provided with the XRT software.


Release Notes:

XRT/field (PATCH REQUIRED for ComboBox and SpinBox Widgets!!!)
------------------------------------------------------------------

User's integrating XRT/field 1.0.0 with WorkShop Visual require a patch to the
widget in order to use ComboBoxes and SpinBoxes successfully.  Without this
patch, the widget creates memory problems within WorkShop Visual that may cause it
to crash.  The patch number is 4-100-06 and is available by anonymous ftp
from ftp.klg.com in the directory ftp/patches.  User's using the XrtFloatField
widget may also require patch 4-100-07 as the converter for resources of
type double causes a core dump on some architectures.

Using XRT/field's ComboBox or SpinBox needs some explanation.  After selecting
one from the palette (let's say SpinBox), WorkShop Visual will create a SpinBox
with a XRT/field widget of type String.  The widget tree will show a SpinBox
but no XRT/field widget will appear as a child.  To get at the resources of
the XRT/field widget that is a child of the SpinBox or to change to a different
type of field widget, set the xrtSpinFieldType to None.  This removes the
field widget from the SpinBox.  Now with the SpinBox selected, select the
type of XRT/field widget desired from the palette (you can also add more
XRT/field widgets to the SpinBox in this fashion).  You can now select the
XRT/field widget and edit the resources as normal.

XRT/gear
---------
To use XmNxrtGearPageWidget constraint resource of TabManager first create 
pages.  After pages are created create tabs associated with them.
Then you can change order of association by specifying page widget for tab 
widget.
