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

GPICI - Set Interior Color Index

GPICI (index)

Purpose

Use GPICI to insert a Set 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 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 contains the color values the graPHIGS API uses to fill all following polygon definitions if the interior style is set to 1=HOLLOW and edge is 1=OFF , or the interior style is set to 2=SOLID or 4=HATCH

Face distinguish mode must be set to 2=COLOR_SURFACE_PROPERTIES for the graPHIGS API to fill the front facing properties only. If the face distinguish mode is 1=NONE , then the graPHIGS API uses the color values to fill both the front facing and back facing portions of the polygon definitions.

This index is used at structure traversal time to render the interiors when the interior color aspect source flag is set to 2=INDIVIDUAL

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

If the workstation does not support the specified 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

GPASF
Attribute Source Flag Setting
GPEF
Set Edge Flag
GPFDMO
Set Face Distinguish Mode
GPICD
Set Interior Color Direct
GPQPIR
Inquire Predefined Interior Representation
GPQXIR
Inquire Extended Interior Representation
GPXIR
Set Extended Interior Representation

RCP code

201328899 (X'0C000903')


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