graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPPG2 - Polygon 2

GPPG2 (areas, npoint, width, pointlist)

Purpose

Use GPPG2 to specify a two-dimensional polygon primitive and insert it into the open structure following the element pointer or to replace the element pointed at by the element pointer with a Polygon 2 structure element depending on the current edit mode.

This structure element defines the boundary of contours which may be hollow or filled with a uniform color, a pattern, or a hatch style. You can display the boundary of the primitive with or without an edge. The normal on Polygon 2 is (0,0,1)

All points specified are placed in the x, y plane. Polygon attributes are applied to this primitive.

Parameters

areas -- specified by user, fullword integer

Number of subareas (>=0)

npoint -- specified by user, array of fullword integers

Number of points per subarea (>=0)

width -- specified by user, fullword integer

Number of fullwords between subsequent x values (>=2)

pointlist -- specified by user, array of short floating-point numbers (MC)

Array of points specified in row order.

The input array contains a list of points in which subsequent x values are separated by width fullwords.

For the i ^th subarea, the array contains 2npoint(i) short floating-point numbers. The pointlist is a continuous list of points with the points for subarea i+1 immediately following those of subarea i

All points in the pointlist must be coplanar.

Error Codes

5: FUNCTION REQUIRES STATE STOP OR NROP (NOT STCL)
198: NUMBER OF SUBAREAS < ZERO
199: POLYGON SUBAREA HAS < ZERO POINTS
557: WIDTH PARAMETER < MINIMUM ALLOWED

Related Subroutines

GPBICD: Set Back Interior Color Direct
GPBICI: Set Back Interior Color Index
GPBSCD: Set Back Specular Color Direct
GPBSCI: Set Back Specular Color Index
GPBSPR: Set Back Surface Properties
GPECD: Set Edge Color Direct
GPECI: Set Edge Color Index
GPEI: Set Edge Index
GPELT: Set Edge Linetype
GPESC: Set Edge Scale Factor
GPFDMO: Set Face Distinguish Mode
GPICD: Set Interior Color Direct
GPICI: Set Interior Color Index
GPII: Set Interior Index
GPIS: Set Interior Style
GPISI: Set Interior Style Index
GPLMO: Set Lighting Calculation Mode
GPLSS: Set Light Source State
GPPGC: Set Polygon Culling
GPSAC: Set Surface Approximation Criteria
GPSCD: Set Specular Color Direct
GPSCI: Set Specular Color Index
GPSPR: Set Surface Properties
GPTCAC: Set Trimming Curve Approximation Criteria

RCP code

201328136 (X'0C000608')