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

GPSCD - Set Specular Color Direct

GPSCD (color)

Purpose

Use GPSCD to insert a Set 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 Specular Color Direct structure element depending on the current edit mode.

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

If the face distinguish mode is 1=NONE , then the graPHIGS API uses the color values on both the front facing and back facing surfaces. If the face distinguish mode is set to 2=COLOR_SURFACE_PROPERTIES , then the graPHIGS API uses the color values on the front facing portions only.

This attribute sets the same traversal state as the Set Specular Color Index (GPSCI) subroutine. The traversal default for 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

GPFDMO
Set Face Distinguish Mode
GPSCI
Set Specular Color Index

RCP code

201343497 (X'0C004209')


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