[ Previous | Next | Contents | Glossary | Home | Search ]
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')


[ Previous | Next | Contents | Glossary | Home | Search ]