## Presentation Device Driver Reference for OS/2

[prev][next][parent][TOC]

### GrePolygonSet - Parameters

hdc (HDC) - input Device context handle.

flModel (LONG) - input Model flags.

These flags determine how polygons are drawn:

POLYGON_INCL Default setting. Fill is inclusive of bottom right.
POLYGON_EXCL Fill is exclusive of bottom right. Aids migration from other graphics models.

flOptions (ULONG) - input Option flags.

These flags determine how the polygons are filled:

POLYGON_ALTERNATE Fill is performed by using the alternate mode.
POLYGON_WINDING Fill is performed by using the winding mode.
POLYGON_BOUNDARY Draw boundary lines.
POLYGON_NOBOUNDARY Do not draw boundary lines.

paPolygon (PPOLYGON) - input Pointer to an array of POLYGON structures:

ulPoints Number of points in this polygon
aPointl Array of points defining polygon

If COM_TRANSFORM is not set, the function expects the points to be in screen coordinates.

cPolygons (LONG) - input Number of POLYGON structures.

When this is passed as 0, no action is taken except to return Successful.

pInstance (PVOID) - input Pointer to instance data.

lFunction (ULONG) - input High-order WORD=flags; low-order WORD = NGrePolygonSet.

rc (LONG) - returns Return codes.

This function returns an integer (cHits) indicating, where appropriate, whether correlation hits were detected:

GPI_OK Successful
GPI_HITS Successful with correlate hit (returned by display drivers when the correlate flag is ON, and a hit is detected)
GPI_ERROR Error

Possible Errors Detected: When an error is detected, the handling routine must call WinSetErrorInfo to post the condition. Error codes for conditions that the handling routine is expected to check include:

PMERR_COORDINATE_OVERFLOW
PMERR_INV_IN_AREA
PMERR_INV_IN_PATH

Refer to the "Error Explanations" section in the Presentation Manager Programming Reference for further explanation.