The recommended way of linking GKS is to use the GKS or GRAFLIB parameters
to the CERNLIB command to define the symbol
'LIB$' which provides access to just
the GKS library, or to both GKS and various higher level graphics
packages which use GKS, notably the CERN Program Library packages
GKSPACK (J551), HPLOT (Y251) and HIGZ (Q120).
Further details on what follows may be obtained via the command
HELP CERNLIB.
CERNLIB GKS
or
CERNLIB GKS3D
or
CERNLIB GRAFLIB/GTS2D [or /GTS3D]
The optional parameter '/GTS2D' or '/GTS3D' gives access to the 2D or 3D
versions of the GTS-GRAL package.
In addition, the CERNLIB command provides access to three versions
of the libraries: OLD, PRO (default), and NEW.
For example, to access the previous version of GRAFLIB use the switch
'GRAFLIB/OLD'.
The current default version of GKS is the version from GTS-GRAL,
and so the switch '/GTS2D' may be omitted.
The default situation is to link to shared versions of the libraries. For non-shared versions it is necessary to add the extra switch '/NOSH[AREABLE]'.
The basic commands and tools to use GKS are:
The include files used when compiling graphics programs which define the Workstation Types and GKS Parameters (Enumerated Types) are accessed via the logical names:
INCLUDE 'GKS$GTSDEV'
and
INCLUDE 'GKS$ENUM'
and the example programs listed in the appendix of the
GKS/GKS-3D Primer may be found in:
GKS_ROOT:[DMO]GKSEXn.FOR (n = 1,6)
An alternative method to access the information in the include files would be via the PATCHY utility by using the KEEP sequences of GTSDEV and ENUM stored in the PATCH GKSINCL on the GKSPACK Pam file. On VAX VMS this is stored in:
CERN_ROOT:[PAM]GKSPACK.PAM.