GrNewPolygonRegion()

Name

GrNewPolygonRegion() -- Create a polygon region

Synopsis

GR_REGION_ID GrNewPolygonRegion ( int mode , GR_COUNT count , GR_POINT * points );

Description

This function creates a new region and returns its ID. The new region is created by connecting the points in the specified GR_POINT array.

Parameters

TypeNameDescription
intmodeThe method for handling overlapping sections of the polygon. See the mode description table below.
GR_COUNTcountThe number of points in the GR_POINT array used to define the polygon.
GR_POINT*pointsA pointer to an array of GR_POINT structures that define the vertices of the polygon.

ModeDescription
MWPOLY_EVENODDAreas of the polygon that overlap an odd number of times are not a part of the resulting region.
MWPOLY_WINDINGAreas of the polygon that overlap are always considered a part of the region.

Returns

The ID of the newly created region.

See Also

GR_POINT, GrNewRegion(), GrDestroyRegion(), GrPoly().