[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface : Subroutine Reference

GPFDMO - Set Face Distinguish Mode

GPFDMO (mode)

Purpose

Use GPFDMO to insert a Set Face Distinguish Mode structure element into the open structure following the element pointer or to replace the element pointed at by the element pointer with a Set Face Distinguish Mode structure element depending on the current edit mode.

During structure traversal, this structure element sets the current face distinguish mode entry in the graPHIGS API traversal state list to the value specified by the parameter. The graPHIGS API uses this value when creating subsequent area defining output primitives.

Face distinguish mode must be set to 2=COLOR_SURFACE_PROPERTIES for the graPHIGS API to apply the front face color and surface properties attributes to the front face facets, and to apply the back face color and surface properties attributes to back face facets. If face distinguish mode is set to 1=NONE , then the graPHIGS API applies front face color and surface properties attributes to both the front and back face facets.

The traversal default for face distinguish mode is 1=NONE

Parameters

mode -- specified by user, fullword integer

Face distinguish mode (1=NONE, 2=COLOR_SURFACE_PROPERTIES )

Error Codes

5
FUNCTION REQUIRES STATE STOP OR NROP (NOT STCL)
88
FACE DISTINGUISH MODE IS INVALID

Related Subroutines

GPQAAF
Inquire Advanced Attribute Facilities

RCP code

201343495 (X'0C004207')


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