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

GPISM - Set Interior Shading Method

GPISM (method)

Purpose

Use GPISM to insert a Set Interior Shading Method structure element into the open structure following the element pointer, or to replace the element pointed at by the element pointer with a Set Interior Shading Method structure element, depending on the current edit mode.

The graPHIGS API uses this element to specify the shading of the interior of subsequent area primitives.

If the face distinguish mode (GPFDMO) is 1=NONE , then the graPHIGS API uses this method to shade the interior of both front and back facing portions of area primitives. If the face distinguish mode is 2=COLOR_SURFACE_PROPERTIES , then the graPHIGS API uses this method only on front facing portions of subsequent area primitives.

The interior shading methods include 1=SHADING_NONE which is also known as flat shading, 2=SHADING_COLOR , traditionally known as Gourand shading, and 3=SHADING_DATA See The graPHIGS Programming Interface: Understanding Concepts for information on the interactions between lighting, shading, and data mapping.

For compatibility, the Set Interior Shading Method traversal state is also set by the GPLMO subroutine. For more information, see The graPHIGS Programming Interface: Understanding Concepts

The traversal default interior shading method is 2=SHADING_COLOR If the workstation does not support the specified method, then the graPHIGS API uses 2=SHADING_COLOR

Parameters

method -- specified by user, fullword integer

Interior shading method (1=SHADING_NONE, 2=SHADING_COLOR, 3=SHADING_DATA ).

Error Codes

5
FUNCTION REQUIRES STATE STOP OR NROP (NOT STCL)
512
METHOD NOT SUPPORTED

Related Subroutines

GPBISM
Set Back Interior Shading Method
GPQAAF
Inquire Advanced Attribute Facilities

RCP code

201343511 (X'0C004217')


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