VAXstation features

In the PROduction version (3.2) of GKSGRAL the driver for the VAXStation uses the UIS interface. To use the X-Window driver (for VAXStations with DECWindows interface) one has to move to the new version of GKSGRAL (3.4) which is only available on request. The UIS driver allows a single process to open multiple GKS workstations, each corresponding to a new window. To use this feature it is necessary to call GOPWK once to open each workstation with a different value in the series of UIS workstation types. There are also several special features available for users of VAXstations in order to manipulate the windows:

• The logical name GKS_WINDOW set by the system startup procedure GKSSTART.COM can point to any directory which contains a copy of the file WINDOW.DAT. Users can redefine this logical name later as they wish. However, if a private version of the file WINDOW.DAT is found in the current working directory, then this one will be used rather than GKS_WINDOW:WINDOW.DAT.

• The CERN utility routine GCSDWN (Set Display Window) can be used for VAXstations in order to set inside a program the display window size, position and title (used by GOPWK), instead of using the values stored in the file WINDOW.DAT. The function must be called before calling GOPWK. The calling sequence is:

  SUBROUTINE GCSDWN (IWTYPE, RWIN, TITLE)
  INTEGER       IWTYPE
  REAL          RWIN(4)
  CHARACTER*(*) TITLE
  

  Where IWTYPE is the workstation type (8601, 8602, etc...), RWIN is the window size and position, and TITLE contains the name given to the window by the display manager.

• The CERN utility routine GCCDWN (Change Display Window) can be used for VAXstations in order to change interactively inside a program the display window size and position after the window has been created. The calling sequence is:

  SUBROUTINE GCCDWN (WKID, RWIN, CODE)
  INTEGER       WKID
  REAL          RWIN(4)
  INTEGER       CODE
  

  Where WKID is the workstation identifier, RWIN is the window size and position, and CODE takes either the value '1' or '2'. If CODE=1, then any window size can be defined but the workstation viewport is not changed, which may change the aspect ratio. If CODE=2, then there is a restriction placed on the window size that can be chosen to ensure that the aspect ratio of the window contents remains unchanged. The function uses the largest window that can fit into the size the user has chosen and that has the same height/width ratio as the initial window. The workstation viewport is automatically resized and the workstation updated.

RWIN(1) = window size in X in metres
RWIN(2) = window size in Y in metres
RWIN(3) = window position X on screen in metres
RWIN(4) = window position Y on screen in metres