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

GPBSCD - Set Back Specular Color Direct

GPBSCD (color)

Purpose

Use GPBSCD to insert a Set Back Specular Color Direct structure element into the open structure following the element pointer or to replace the element pointed at by the element pointer with a Set Back Specular Color Direct structure element depending on the current edit mode.

This structure element specifies the color values that the graPHIGS API uses for the specular highlights at structure traversal time. The specular highlights are produced by lighting calculations in area geometries.

Face distinguish mode (GPFDMO) must be set to 2=COLOR_SURFACE_PROPERTIES If the face distinguish mode is 1=NONE , then the graPHIGS API uses the current specular color in lighting calculations for back facing portions of subsequent surfaces.

This attribute sets the same traversal state as the Set Back Specular Color Index (GPBSCI) subroutine. The traversal default for back specular color is the content of entry 1 of the rendering color table.

Parameters

color -- specified by user, 3 short floating-point numbers

Three color components of the current direct color model in the graPHIGS API state list (0.0<=component<=1.0)

Error Codes

5
FUNCTION REQUIRES STATE STOP OR NROP (NOT STCL)
96
COLOR PARAMETER OUT OF RANGE FOR CURRENT COLOR MODEL

Related Subroutines

GPBSCI
Set Back Specular Color Index
GPFDMO
Set Face Distinguish Mode

RCP code

201343501 (X'0C00420D')


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