/PICTURE

Creation and manipulation of HIGZ pictures.

/PICTURE/FILE lun fname [ lrecl chopt ]

LUN I Logical unit number R=1:128
FNAME C File name
LRECL I Record length in words D=1024
CHOPT C Options D=' '

CHOPT:

'' '' Existing file is opened.
'N' A new file is opened.
'U' Existing file is modified.
'A' Automatic saving.

Open a HIGZ direct access picture file. If CHOPT='AU' or 'AN', pictures will be automatically saved on the direct access file. This automatic saving facility can be switched off using SET AURZ 0.

/PICTURE/LIST

List all the HIGZ pictures currently stored in memory.

/PICTURE/CREATE pname

PNAME C Picture name Loop

Create a new picture, named PNAME, in memory. Note that all commands which start a new picture (clear workstation) automatically create pictures named PICT1, PICT2, etc. if the command OPTION ZFL or OPTION ZFL1 has been executed.

/PICTURE/DELETE pname

PNAME C Picture name D=' ' Loop

Delete the picture PNAME from memory. PNAME='*' means all pictures.

/PICTURE/SCRATCH pname [ icycle ]

PNAME C Picture name D=' ' Loop
ICYCLE I Cycle number D=9999

Delete the picture PNAME from current directory on disk.

/PICTURE/PLOT [ pname ]

PNAME C Picture name D=' ' Loop

Plot the picture PNAME. PNAME=' ' means the current picture. PNAME='*' means all pictures.

/PICTURE/MODIFY [ pname chopt ]

PNAME C Picture name D=' '
CHOPT C Options D=' '

CHOPT:

'S' Software characters are used for the text in menus.
'A' The option shadow is used.

Edit the picture PNAME. PNAME=' ' means the current picture. This command is only available on workstations.

/PICTURE/MERGE pname [ x y scale chopt ]

PNAME C Picture name
X R X coordinates (NDC) where to draw PNAME D=0
Y R Y coordinates (NDC) where to draw PNAME D=0
SCALE R Scale factor D=1.
CHOPT C Options D=' '

CHOPT:

'' '' Merge the picture PNAME with the current picture.
'D' Picture PNAME is displayed during merging.

Add the picture PNAME to the current picture.

/PICTURE/COPY pname1 pname2

PNAME1 C Picture name
PNAME2 C New picture name Loop

Copy a picture.

/PICTURE/RENAME pname1 pname2

PNAME1 C Old picture name
PNAME2 C New picture name

Rename a picture.

/PICTURE/PRINT [ file width height ]

FILE C File name D=' '
WIDTH I Image width (in pixels) D=0
HEIGHT I Image height (in pixels) D=0

Print the current picture. The current picture is transformed into a printable file. The file type is defined according to the extension of the file name i.e.

FILE = filename.ps A PostScript file is generated (-111) FILE = filename.eps A Encapsulated PostScript file is generated (-113) FILE = filename.tex A LaTex file is generated (-778) FILE = filename.gif A gif file is generated

Do HELP META for details about the metafile types. Note that a new picture is automatically created for each new plot if the OPTION ZFL1 is on.

For gif files, the picture in memory is not used. The gif file is a direct "hardcopy" of the window number 1 content. The WIDTH and HEIGHT parameters allow to scale the gif output file.

If FILE=HIGZPRINTER or FILE=' ' the PostScript file paw.ps (-111) is generated and the operating system command defined by the environment variable HIGZPRINTER is executed.

The environment variable HIGZPRINTER should be defined as follow:

On UNIX sytems:

setenv HIGZPRINTER 'lp -dprinter_name paw.ps'

or

export HIGZPRINTER='lp -dprinter_name paw.ps'

On VAX/VMS sytems:

HIGZPRINTER == 'XPRINT paw.ps /PRINTER=printer_name'

Note that if the environment variable HIGZPRINTER is not defined the file paw.ps is created but not printed.

/PICTURE/LOAD x y file [ wkid ]

X R X position D=0.
Y R Y position D=0.
FILE C File name D=' '
WKID I Workstation identifier D=1

Load the picture named FILE at the position X,Y in the current normalisation transformation. X,Y is the top left corner of the picture (like in X11). FILE should be a GIF file.

/PICTURE/IZOUT [ pname ]

PNAME C Picture name D=' ' Loop

Write the picture PNAME to a direct access picture file (see command PICTURE/FILE). PNAME=' ' means the current picture. PNAME='*' means all pictures.

/PICTURE/IZIN pname [ icycle ]

PNAME C Picture name Loop
ICYCLE I Cycle number D=9999

Read picture into memory from a direct access picture file. (see command PICTURE/FILE). PNAME='*' means all pictures.

/PICTURE/IZPICT pname [ chopt ]

PNAME C Picture name
CHOPT C Options D='M'

CHOPT:

'M' Make 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 as PICTnnn, where the starting value of nnn is either 0 (default), or the value assigned by SET to the parameter PICT.
'D' Display the picture PNAME in memory.
'S' Scratch the picture PNAME from memory. If PNAME = ' ' the current picture is scratched.
'N' The picture following the current picture in memory becomes the current picture. If the current picture is the last one in memory, the first picture in memory becomes the current picture.
'L' Give the list of 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' Set Current picture. All calls to HIGZ graphic functions are stored in the current structure according to the option selected be IGZSET.

Perform various operations on a picture. PNAME=' ' means the current picture. PNAME='*' means all pictures.

/PICTURE/SWITCH [ chopt ]

CHOPT C Options D='G'

CHOPT:

'G' graphics output only.
'Z' Graphics primitives stored in ZEBRA memory only.

Set the graphics switch to control plotting output to terminal (G) and/or picture in memory (Z).

/PICTURE/IGSET [ chatt value ]

CHATT C Attribute name D='SHOW'
VALUE R Attribute value D=0.

Set a HIGZ attribute. If CHATT='SHOW' print default and current values for all attributes. If CHATT='*' restore default values for all attributes.

Note that command SET is also calling IGSET so SET can be used instead of IGSET.

+-----------------------------------------------------------------------------+ | IGSET : Current values in use | +-------------+---------------+---------------+-------------------------------+ | Parameter | Current value | Default value | Explanation | +-------------+---------------+---------------+-------------------------------+ | FAIS | 0 | 0 | Fill area interior style | | FASI | 1 | 1 | Fill area style index | | LTYP | 1 | 1 | Line type | | BASL | 0.150 | 0.010 | Basic segment length (NDC) | | LWID | 1.000 | 1.000 | Line width | | MTYP | 1 | 1 | Marker type | | MSCF | 1.000 | 1.000 | Marker scale factor | | PLCI | 1 | 1 | Polyline color index | | PMCI | 1 | 1 | Polymarker color index | | FACI | 1 | 1 | Fill area color index | | TXCI | 1 | 1 | Text color index | | TXAL | 0 0 | 0 0 | Text alignment | | CHHE | 0.280 | 0.280 | Character height | | TANG | 0.000 | 0.000 | Text angle | | TXFP | 0 2 | 0 2 | Text font and precision | | PICT | 1 | 1 | Current automatic number | | BORD | 0 | 0 | Border flag | | PASS | 1 | 1 | Number of pass in IGTEXT | | CSHI | 0.030 | 0.020 | IGTEXT shift | | LASI | 0.018 | 0.018 | Label axis size | | LAOF | 0.013 | 0.013 | Label axis offset | | TMSI | 0.019 | 0.019 | Tick marks size | | AWLN | 0.000 | 0.000 | Axis wire lenght | | BARO | 0.250 | 0.250 | Offset of IGHIST (IGRAPH) bars| | BARW | 0.500 | 0.500 | Width of IGHIST (IGRAPH) bars | | NCOL | 8 | 8 | Number of COLors | | CLIP | 1 | 1 | Clipping mode | | NLIN | 40 | 40 | Number of line for 3D shapes | | AURZ | 0 | 0 | Automatic saving flag | | DIME | 2 | 2 | Dimension used (2D or 3D) | | ZBUF | 0 | 0 | Z-Buffer (1=on or 0=off) | +-------------+---------------+---------------+-------------------------------+