gspoly(3g) — AIX PS/2 1.2.1



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



-------------------------------------------------------------------------------
gspoly



PURPOSE

Draws a polyline, a set of lines that connects a sequence of points.

C SYNTAX

int gspoly_ (number, x, y)

int *number, *x, *y;

FORTRAN SYNTAX

INTEGER function gspoly (number, x, y)

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

PASCAL SYNTAX

FUNCTION gspoly_ (

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

DESCRIPTION

The gspoly subroutine draws lines, as defined by the current relevant
attributes, between each 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 => 2.

x, y              Defines the points for line drawing.

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.



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



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




RETURN VALUE

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
















































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

Museum