1-MAR-1994
This is the Alpha-AXP version of GPLOT for DECGKS.  It has been tested with
the DEC GKS field test version 5.3 as well as earlier versions.  DEC GKS 5.x
is needed for full compatibility.  

GPLOT is a library of high-level subroutines for use with DEC GKS graphics. You
will need DEC GKS full-function software to develop programs using this
library.  GPLOT has been modified to be compatible with DEC GKS 5.3, but most
options are compatible with older versions. The current version has also been
converted to run on Ultrix machines with DEC GKS.  Most changes necessary for
Ultrix or Alpha-AXP were put back in the VMS version. The routines GSTART,
GMENU, and GSTOP will not work properly with Ultrix. Direct device calls should
be used for Ultrix applications.  The format of the GDINIT.DAT file has changed
to align the variables on quadword boundaries, so if you are using an old
version of GPLOT you may have to copy GPLOT_SRC:GDINIT.DAT to SYS$LOGIN: and
use EDIT_GMENU to modify it for your particular devices. 

New features added to GPLOT with this release include a new color setup
routine and a print screen routine for use with the Motif workstation.
There is also support for Workstation type 233 (Motif Widget).  To use
workstation type 233 you need to create a Motif widget and define the
logical "MYWIDGET" to point to that widget ID number. See DEFCONID.FOR and
VMSLIB.FOR for information on using these logicals.  DEFCONID is a new
routine for setting the output device.  In previous versions of GPLOT the
GKS$CONID logical name was defined after selecting the workstation type. 
In DEC GKS 5.0A you cannot use this logical name if you are going to open
more than one workstation since GKS$CONID is interpreted when GKS is
opened.  A GKS escape function is now used to set the workstation
connection. Executables developed with this GPLOT library can only be run on
systems with DEC GKS 5.0A or later full development or run-time licenses. 

GKSPOST is a postprocessor for plotting GKS metfiles.  It has only been 
developed and tested with 2 dimensional metafiles

GPLOT includes the following types of routines:
	Linear and logarithmic axis routines
	routines for drawing curves with/without error bars
	curve interpolation routines
	Legend creation routines
	Enhanced text output routines (superscript, font-switching, etc.)
	contour plot routines
	3D-surface plot routines
	routines for vectors with arrowheads
	bar chart routines
	Device-selection menu routines/automatic printing
	Routine for interpreting GKS metafiles
	
To install GPLOT on a VAX which has VAX GKS 5.0a, 5.2, or 5.3 installed,
restore the GPLOT directory tree to a disk with sufficient space (~12000
blocks), then define the logical name GPLOT_DIR to point to directory
[GPLOT] on that disk, and the logical name GPLOT_SRC to point to the
directory [GPLOT.SRC] on that disk.  Add these logical name definitions
to SYS$MANAGER:SYLOGICALS.COM so the names will not be lost when you
reboot.  You should also add the following symbol definition to
SYLOGIN.COM: 

	$ EDIT_GMENU:==RUN GPLOT_DIR:EDIT_GMENU.EXE

If you need to reduce the amount of disk space used, you can delete all files
in the [GPLOT.EXAMPLES] and [GPLOT.DOC] directories and all files
in the [GPLOT.SRC] directory except GDINIT.DAT.  

Use the EDIT_GMENU routine to customize the graphics device menu for your
site. This version of GPLOT includes information on DEC GKS Workstation
identifiers, so you no longer need to refer to the documentation when
adding new devices.  This version of GPLOT also includes a program to help
in creating a help file.  The program MAKE_HELP_FILE will add entries to
GPLOT.HLP which correspond to the print queues on your system.  This is
most useful if you have defined description qualifiers for all your queues.
After customizing the graphics device menu for your site, edit the file
GPLOT.HLP to enter site-specific device information, then use the command: 

	$ library/help/create sys$help:gplot gplot.hlp

Individual users can create private graphics menus by copying the file
GPLOT_SRC:GDINIT.DAT to SYS$LOGIN: and then using EDIT_GMENU to modify it
as desired.  When GSTART or GMENU are called they will use the menu data
from SYS$LOGIN:GDINIT.DAT if it exists.  Otherwise the version in GPLOT_SRC
will be used. This file should be protected against modification by users
since EDIT_GMENU will operate on this file if there is no GDINIT.DAT in the
SYS$LOGIN directory.  Use EDIT_GMENU from the SYSTEM account to modify the
default version of GDINIT.DAT.

Documentation on GPLOT is given in the [GPLOT.DOC] directory.  It is given
as a postscript printer file.  Example routines are in the directory
[GPLOT.EXAMPLES].  Users can link to GPLOT by including
"GPLOT_DIR:GPLOT/OPT" in their link statements. 

There are some known DEC GKS bugs which affect the operation of GPLOT. One of
the current bugs is that software characters are only two-thirds of the correct
size, but Postscript hardware characters are the correct size. Thus switching
fonts on a postscript printer will result in mismatched character sizes.  

There are also bound to be a number of other bugs in GPLOT which have not yet
been discovered.  Any bugs found in GPLOT should be reported to: 

	Tom Worlton
	Intense Pulsed Neutron Source Division
	Argonne National Laboratory
	Argonne, IL 60439

	WORLTON@ANLPNS 			(BITNET)
	worlton@anlpns.pns.anl.gov	(INTERNET)
	ANLPNS::WORLTON			(HEPNET)
	708-252-8755

ANLPNS   DECnet node number is 	45.785
ANLPNS Internet node number is 	130.202.20.244

GPLOT is the property of the author and Argonne National Laboratory which
is operated by the University of Chicago for the United States Department
of Energy.  Distribution or sale of this software without the express
permission of the author is prohibited.