The basic output primitives

In HIGZ there are four basic output primitives: the polyline ( IPL), the fill area ( IFA), the polymarker ( IPM) and the text ( ITX). In all routines described in this section the coordinates are given in the world coordinates system.

Polyline

                           +------------------+
                           | CALL  IPL (N,X,Y) |
                           +------------------+
                                  
Action: This routine draws a polyline on the currently active workstations (there must be at least one). The polyline connects N points (N>=2) by means of N-1 line segments. The X and Y coordinates of the points are in two N-dimensional arrays. The appearance of a polyline is controlled by the current ``polyline colour index'' (see routine ISPLCI section ), the current ``line type'' (see routine ISLN section ) and the current ``line width'' (see routine ISLWSC section [more info]). Parameter Description:
N
Number of points.
X
Array of dimension N containing the x coordinates in WC space.
Y
Array of dimension N containing the y coordinates in WC space.

Multiline

                           +------------------+
                           | CALL  IML (N,X,Y) |
                           +------------------+

                                  
Action: This routine draws a multiline on the currently active workstations (there must be at least one). The multiline connects N points (N>=2) two by two. The X and Y coordinates of the points are in two N-dimensional arrays. The appearance of a multiline is controlled by the current ``polyline colour index'' (see routine ISPLCI section ), the current ``line type'' (see routine ISLN section ) and the current ``line width'' (see routine ISLWSC section [more info]). Parameter Description:
N
Number of points.
X
Array of dimension N containing the x coordinates in WC space.
Y
Array of dimension N containing the y coordinates in WC space.

Polymarker

                           +------------------+
                           | CALL  IPM (N,X,Y) |
                           +------------------+
                                  
Action: This routine draws a polymarker on the currently active workstations (there must be at least one). Markers are placed at N points (N>=1), whose x and y coordinates are given in two N-dimensional arrays. The appearance of a polymarker is controlled by the current ``polymarker colour index'' (see routine ISPMCI section ), the current ``marker type'' (see routine ISMK section [more info]) and the current ``marker scale factor'' (see routine ISMKSC section [more info]). Parameter Description:
N
Number of points.
X
Array of dimension N containing the x coordinates in WC space.
Y
Array of dimension N containing the y coordinates in WC space.

Fill area

                           +------------------+
                           | CALL  IFA (N,X,Y) |
                           +------------------+
                                  
Action: This routine draws a filled area on the currently active workstations (there must be at least one). The ``perimeter'' of the filled area has N points (N>=3) whose x and y coordinates are given in two N-dimensional arrays. The appearance of a filled area is controlled by the current ``filled area colour index'' (see routine ISFACI section [more info]), the current ``filled area interior style'' (see routine ISFAIS section [more info]) and the current ``filled area style index'' (see routine ISFASI section [more info]). Parameter Description:
N
Number of points.
X
Array of dimension N containing the x coordinates in WC space.
Y
Array of dimension N containing the y coordinates in WC space.

Text

                         +----------------------+
                         | CALL  ITX (X,Y,CHARS) |
                         +----------------------+

                                  
Action: This routine draws a text string on the currently active workstations (there must be at least one). The appearance of the text is controlled by attributes set by the current ``text colour index'' (see routine ISTXCI section ), the current ``character height'' (see routine ISCHH section ), the current ``text orientation'' (see routine ISCHUP section and the option TANG of the routine IGSET section ), the current ``text alignment'' (see routine ISTXAL section [more info]) and the current ``text font and precision'' (see routine ISTXFP section [more info]). Parameter Description:
X
X coordinate in WC space.
Y
Y coordinate in WC space.
CHARS
CHARACTER variable containing the text to be displayed. Only the following characters are allowed to appear in CHARS:
     !"#$%&'()*+,-./0123456789:;<=>?
     @ABCDEFGHIJKLMNOPQRSTUVWXYZ[-]^_
     abcdefghijklmnopqrstuvwxyz{|}~
     and the space.
Software characters (i.e. drawn with lines and not provided by the hardware) can be produced with routine IGTEXT.