GSMULT(3g,L)                AIX Technical Reference                GSMULT(3g,L)



-------------------------------------------------------------------------------
gsmult



PURPOSE

Draws a multiline, a set of lines that connect alternate pairs of points in a
sequence.

C SYNTAX

int gsmult_ (number, x, y)

int *number, *x, *y;

FORTRAN SYNTAX

INTEGER function gsmult (number, x, y)

INTEGER number, x (*), y (*)

PASCAL SYNTAX

FUNCTION gsmult_ (

VAR number: INTEGER;
VAR x, y: ARRAY [1..k] of INTEGER
): INTEGER [PUBLIC];

DESCRIPTION

The gsmult subroutine draws lines, as defined by the current relevant
attributes, between alternate pair of points defined by the parameters.

The relevant attributes are:

  o Color map
  o Plane mask
  o Line color index
  o Line style
  o Logical operation.

Parameters

number            Defines the number of points in the coordinate arrays.  It
                  must be a multiple of 2, with 2 as the minimum value.

x, y              Define the points for line drawing.






Processed November 7, 1990       GSMULT(3g,L)                                 1






GSMULT(3g,L)                AIX Technical Reference                GSMULT(3g,L)



For Pascal, the application must declare the arrays passed as being fixed
length and declare the routine as accepting arrays of that length.  The k in
the routine declaration must be a constant.

RETURN VALUE

GS_SUCC  Successful.
GS_CORD  Invalid coordinate.
GS_NCOR  Invalid number of coordinates.
GS_INAC  Virtual terminal inactive.













































Processed November 7, 1990       GSMULT(3g,L)                                 2