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

GPHLCI - Set Highlighting Color Index

GPHLCI ( index)

Purpose

Use GPHLCI to insert a Set Highlighting 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 Highlighting 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 the graPHIGS API uses to render all subsequent highlighted primitives. This color overrides any color specified by the attribute color for the primitive or specified in the primitive definition.

This attribute sets the same traversal state as the Set Highlighting Color Direct (GPHLCD) subroutine. The traversal default for highlighting 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

GPHLCD
Set Highlighting Color Direct

RCP code

201328656 (X'0C000810')


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