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

GPSCI - Set Specular Color Index

GPSCI (index)

Purpose

Use GPSCI to insert a Set Specular Color Index 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 Index 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 Direct (GPSCD) subroutine. The traversal default for specular color is a color index value of 1.

If the workstation does not support the specified specular color index, then the color index defaults to a value of 1.

Parameters

index -- specified by user, fullword integer

Color index (>=0)

Error Codes

5
FUNCTION REQUIRES STATE STOP OR NROP (NOT STCL)
92
COLOR INDEX < ZERO

Related Subroutines

GPFDMO
Set Face Distinguish Mode
GPSCD
Set Specular Color Direct

RCP code

201343496 (X'0C004208')


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