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

GPLMO - Set Lighting Calculation Mode

GPLMO (mode)

Purpose

Use GPLMO to insert a Set Lighting Calculation 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 Lighting Calculation Mode structure element depending on the current edit mode.

This structure element specifies a mode which the graPHIGS API uses at structure traversal time to control the lighting process of subsequent area defining output primitives in order to control the quality and performance of the resulting display. Performance typically decreases as quality increases. This value selects the most coarse granularity at which lighting calculations are to be performed.

The traversal default for lighting calculation mode is 1=NONE

If the workstation does not support the specified mode, then the lighting calculation mode defaults to 1=NONE

Parameters

mode -- specified by user, fullword integer

Lighting calculation mode (1=NONE, 2=PER_AREA, 3=PER_VERTEX )

Error Codes

5
FUNCTION REQUIRES STATE STOP OR NROP (NOT STCL)
257
LIGHTING CALCULATION MODE IS INVALID

Related Subroutines

GPBSPR
Set Back Surface Properties
GPDCI
Set Depth Cue Index
GPDCR
Set Depth Cue Representation
GPLSR
Set Light Source Representation
GPLSS
Set Light Source State
GPQAAF
Inquire Advanced Attribute Facilities
GPSPR
Set Surface Properties

RCP code

201343491 (X'0C004203')


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