graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPCCM - Set Convexity Checking Mode

GPCCM (mode)

Purpose

Use GPCCM to set the current convexity checking mode in the graPHIGS API state list.

Your application can set this mode to 1=OFF or 2=ON If the convexity checking mode is set to 2=ON , then the graPHIGS API determines if subsequent primitives with indeterminate convexity are convex for the following primitives:

GPPG2: Polygon 2
GPPG3: Polygon 3
GPPGD2: Polygon 2 With Data
GPPGD3: Polygon 3 With Data

The graPHIGS API then stores the convexity determination as part of the structure element, which can enhance traversal performance.

The default convexity checking mode is 1=OFF

Parameters

mode -- specified by user, fullword integer

Convexity checking mode (1=OFF, 2=ON )

Error Codes

98: CONVEXITY CHECKING MODE IS INVALID

Related Subroutines

GPPG2: Polygon 2
GPPG3: Polygon 3
GPPGD2: Polygon 2 With Data
GPPGD3: Polygon 3 With Data

RCP code

201330966 (X'0C001116')