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

GPBICD - Set Back Interior Color Direct

GPBICD (color)

Purpose

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

This structure element specifies direct 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 (see GPIS - Set Interior Style) and the edge flag is set to 1=OFF (see GPEF - Set Edge Flag) or if the interior style is set to 1=HOLLOW the interior style is set to 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 Index (GPBICI) subroutine. The traversal default for back interior 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

GPBICI
Set Back Interior Color Index
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

201343499 (X'0C00420B')


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