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

GPTXCD - Set Text Color Direct

GPTXCD (color)

Purpose

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

This structure element specifies the direct color values that the graPHIGS API uses to render the subsequent text primitives. At structure traversal time, the graPHIGS API uses these values to render all subsequent annotation and geometric 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 Index (GPTXCI) subroutine. The traversal default 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

GPASF
Attribute Source Flag Setting
GPQXTR
Inquire Extended Text Representation
GPTXCI
Set Text Color Index
GPXTXR
Set Extended Text Representation

RCP code

201328665 (X'0C000819')


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