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

GPTXCI - Set Text Color Index

GPTXCI (index)

Purpose

Use GPTXCI to insert a Set Text 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 Text 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 that the graPHIGS API uses to render all subsequent annotation and geometric text primitives. At structure traversal time, the graPHIGS API uses this to render the text primitives when the text color aspect source flag is set to 2=INDIVIDUAL

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

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

GPASF
Attribute Source Flag Setting
GPQPTR
Inquire Predefined Text Representation
GPQXTR
Inquire Extended Text Representation
GPTXCD
Set Text Color Direct
GPXTXR
Set Extended Text Representation

RCP code

201328651 (X'0C00080B')


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