gsfply(3g) — AIX PS/2 1.2.1



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



-------------------------------------------------------------------------------
gsfply



PURPOSE

Draws a filled polygon.

C SYNTAX

int gsfply_ (number, x, y)

int *number, *x, *y;

FORTRAN SYNTAX

INTEGER function gsfply (number, x, y)

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

PASCAL SYNTAX

FUNCTION gsfply_ (

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

DESCRIPTION

The gsfply subroutine fills an area that is described by the points defined in
the number and x, y parameters, with the color determined by the last call to
the gsfatt subroutine.

The relevant attributes are:

  o Color map
  o Plane mask
  o Fill color index
  o Fill pattern index
  o Logical operation.

Parameters

number   Defines the number of points in the coordinate arrays.  This value
         must be 3 or more.

x, y     Define, as coordinate arrays, the points surrounding the polygon to
         fill.



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



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




The edges are treated as part of the area to be filled.

The gsfply subroutine fills a closed polygon with a pattern, generated by
creating an edge between the first and the last points.  The first and the last
points described by the parameters may be equal, but it is not required and is
actually less efficient.

For Pascal, the application must declare the arrays passed as being fixed
length and declare the routine as accepting arrays of that length; that is, 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_NMEM  Insufficient resources.
GS_INAC  Virtual terminal inactive.




































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

Museum