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

GPBICI - Set Back Interior Color Index

GPBICI (index)

Purpose

Use GPBICI to insert a Set Back Interior 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 Back Interior Color Index structure element depending on the current edit mode.

This structure element specifies an entry in the workstation's rendering color table that defines the color values. During structure traversal, the graPHIGS API uses these values to render the back facing portions of all following area definitions if the interior style is set to 1=HOLLOW and the edge flag is set to 1=OFF or if the interior style is 2=SOLID or 4=HATCH

Face distinguish mode must be set to 2=COLOR_SURFACE_PROPERTIES If the face distinguish mode is 1=NONE , then the graPHIGS API uses the current interior color to render the back facing portions of all following area definitions.

This attribute sets the same traversal state as the Set Back Interior Color Direct (GPBICD) subroutine. The traversal default value for back interior color is an index value of 1.

If the workstation does not support the specified back interior color index value, then the back interior 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

GPBICD
Set Back Interior Color Direct
GPEF
Set Edge Flag
GPFDMO
Set Face Distinguish Mode
GPICD
Set Interior Color Direct
GPICI
Set Interior Color Index
GPIS
Set Interior Style

RCP code

201343498 (X'0C00420A')


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