Seeing graphics output on a terminal

Graphics output from interactive Garfield runs is, by default, displayed on the terminal. Terminal output from batch jobs is not foreseen.

Requesting terminal output at startup

You can explicitely request terminal output, or suppress it, at startup time with command line arguments:

garfield -terminal
garfield -noterminal

The option -terminal has several sub-options:

type model: Where model must be chosen from a list that depends on the GKS version for which Garfield has been compiled. The list for HIGZ is shown below.
GKS_identifier gksid: If you use another GKS than the one for which Garfield has been compiled, you have to specify the terminal model via the GKS identifier. You will find a list of such identifiers in the manual of the GKS system that you are using.
connection_identifier conid: The connection identifier of a terminal contains information as to the channel via which the display can be reached. The keyword conid is, for most versions of GKS, a integer number. This keyword is ignored by HIGZ.

Example:

garfield -terminal type 2

Changing terminal output during the run

You can open and close a terminal graphics window during a Garfield run. This is accomplished with graphics control statements described in the on-line help file, under the heading "graphics".

Opening a terminal window can be done as follows:

!add term type model
!open term
!activate term

To close it, you would type:

!deactivate term
!close term
!del term

In this example, term represents a string that you may choose, while model must be chosen from a list that depends on the GKS version for which Garfield has been compiled. The list for HIGZ is shown below.

List of terminal models with HIGZ

At CERN, Garfield is currently compiled assuming HIGZ as graphics system.

model Description

inquire Inquire during startup, default

1 HIGZ window 1

2 HIGZ window 2

3 HIGZ window 3

4 HIGZ window 4

5 HIGZ window 5

6 HIGZ window 6

7 HIGZ window 7

8 HIGZ window 8

9 HIGZ window 9

7878 Falco graphics terminal

7879 X-terminal

`model`	Description
`inquire`	Inquire during startup, default
`1`	HIGZ window 1
`2`	HIGZ window 2
`3`	HIGZ window 3
`4`	HIGZ window 4
`5`	HIGZ window 5
`6`	HIGZ window 6
`7`	HIGZ window 7
`8`	HIGZ window 8
`9`	HIGZ window 9
`7878`	Falco graphics terminal
`7879`	X-terminal

HIGZ will display a prompt if you chose inquire, like in PAW. Refer to the HIGZ manual for details on what to type in response. The simplest way to proceed is setting the DISPLAY environment variable before starting Garfield, and hitting return in response to the prompt.

If you select 1, 2, 3, 4, 5, 6, 7, 8 or 9, then HIGZ will look in a file called higz_windows.dat for window specifications. This file, if it exists, always contains window dimensions, but can also contain an X-windows address to which output will be sent, overriding the setting of the DISPLAY environment variable. If the file does not contain an X-windows address for the selected window, then you must either ensure that DISPLAY has been set, or include it in the response to the prompt.

In these pages, text set in olive green Courier should be typed as-is. Text set in orange Courier should be replaced by a value of a type which is usually specified.

Last updated on 25/3/00.