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 sur-
rounding the polygon to fill.
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.
The fill pattern does not meet the border of the filled
area on printers and plotters.
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.