graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPPG3 - Polygon 3

GPPG3 (areas, npoint, width, pointlist)

Purpose

Use GPPG3 to specify a three-dimensional polygon primitive element 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 3 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 pattern, or hatch style. You can display the boundary of the primitive with or without an edge.

All points specified must lie in the same plane, but the graPHIGS API does not check to verify this. The system behavior is undefined in this case.

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 (>=3)

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 3npoint(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 coplaner.

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

201328135 (X'0C000607')