When options Z or GZ are selected with IGZSET, HIGZ
intercepts all calls to the graphics package and stores them into the
current picture in memory. Each picture is a ZEBRA data structure. Several
pictures can coexist at the same time in memory as a ZEBRA linear chain of
banks. If a program using pictures receive the message
'Not enough space in memory' some pictures must be deleted or the
size of the PAWC common block can also be increased.
With IZPICT and option C one picture becomes the current picture.
New primitives can be added and existing structures can be edited with the
graphics editor IZGED.
Pictures are identified by a unique name PNAME. Pictures in
memory can be saved into ZEBRA/RZ direct access files for later
manipulation. Tools exist to transport such files across different
computers. HIGZ metafiles are extremely compact compared to GKS metafiles.
One can, for example, generate a HIGZ/RZ metafile at CERN using the
HIGZ/GKS-GRAL system, transport these files using BITNET to FNAL and
interpret/edit the pictures using the HIGZ/DI3000 system. HIGZ metafiles
can be opened/closed several times and new pictures added or modified.
Many cycles (versions) of a picture can be stored.
Note that when the HPLOT package is used, pictures are automatically
generated by calling HPLOPT('ZFL ',1) and have names
PICT1, PICT2, etc. . If a HPLOPT('ZFL1',1) only
the last created picture is kept in memory with the name PICT00.
Operation mode control
+--------------------+
|CALL IGZSET (CHOPT) |
+--------------------+
Action: Routine IGZSET sets an internal flag, which determines whether the
HIGZ output should be directed to the workstation, to ZEBRA or to both.
Parameter Description:
- CHOPT
- Character variable specifying the option
- 'G'
- Graphics mode only (default).
- 'Z'
- ZEBRA mode only.
- 'GZ'
- Both.
Note that when a picture is created with the routine 'Z' mode
is automatically turned on.
Pictures manipulation
+----------------------------+
|CALL IZPICT (*PNAME*,CHOPT) |
+----------------------------+
Action: This routine allows an HIGZ user to manipulate HIGZ pictures in
memory.
Parameter Description:
- *PNAME*
- CHARACTER variable containing the
picture's name.
- CHOPT
- CHARACTER variable specifying the
option(s) desired:
- 'M'
- Create a new picture in memory with name
PNAME. An empty structure is created in memory and becomes the
current picture. If PNAME = ' ', the picture is automatically
named "PICTnnn" with the starting value for nnn either
0 (default), or the value defined by a previous call to IGSET
with parameter PICT.
- 'D'
- Display picture PNAME in memory.
- 'S'
- Scratch picture PNAME from memory. If
PNAME=' ' the current picture is deleted.
- 'N'
- The Next picture in memory (i.e. the one
following the current one) becomes the current picture. If the current
picture is the last one in memory, the first picture in memory becomes the
current picture.
- 'L'
- List the pictures in memory, following the
sequence of their storage in memory.
- 'F'
- The First picture in memory becomes the current
picture.
- 'P'
- Print the picture data structure. Useful to
debug programs.
- 'C'
- Sets the Current picture. All calls to HIGZ
graphic functions are stored in the current structure according to the
option selected by IGZSET.
- 'R'
- Retrieve the name of what will be the current
picture after the call to IZPICT. The name of the current picture is
returned in PNAME.
- 'G'
- Returns in PNAME the name of the
displayed picture.
A call to IZPICT with one of the options 'M', 'N',
'F' or 'C' automatically sets option 'Z' of
IGZSET. In this case the picture following the current one (in the linear
chain of pictures in memory) becomes the current picture and is displayed.