graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPXTXR - Set Extended Text Representation

GPXTXR (wsid, index, id, value)

Purpose

Use GPXTXR to set one field of the specified entry in the workstation's text bundle table.

These attribute values are applied during traversal when the appropriate ASF is set to 1=BUNDLED and the current text index is set to the specified entry. These attribute values can also be set individually.

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

index -- specified by user, fullword integer

Text index (>=1)

id -- specified by user, fullword integer

Text group identifier (1=TEXT_FONT, 2=TEXT_PRECISION, 3=CHARACTER_EXPANSION_FACTOR, 4=CHARACTER_SPACING, 5=TEXT_COLOR )

value -- specified by user, variable data

Value to be set in the field of the specified group identifier expressed in the data format listed below:

Group Identifier 1 - Text font

A fullword integer (1-255)

Group Identifier 2 - Text precision

A fullword integer (1=STRING_PREC, 2=CHAR_PREC, 3=STROKE_PREC )

Group Identifier 3 - Character expansion factor

A short floating-point value (>=0)

Group Identifier 4 - Character spacing

A short floating-point value.

Group Identifier 5 - Text color

Four fullwords of data with either of the following two formats:

      indexed format                        direct format
      -------------                         -------------
    0 |          1| fullword integer      0 |          2| fullword integer
      |-----------|                         |-----------|
    4 |color index| fullword integer      4 |component 1| short floating-point number
      |-----------|                         |-----------|
    8 |    ignored| fullword integer      8 |component 2| short floating-point number
      |-----------|                         |-----------|
   12 |    ignored| fullword integer     12 |component 3| short floating-point number
      -------------                         -------------

Error Codes

25: SPECIFIED WORKSTATION DOES NOT EXIST
35: WORKSTATION HAS ONLY INPUT CAPABILITIES
43: BUNDLE INDEX EXCEEDS WORKSTATION TABLE CAPACITY
60: BUNDLE INDEX VALUE < ONE
75: TEXT FONT VALUE IS INVALID
77: CHARACTER EXPANSION FACTOR <= ZERO
92: COLOR INDEX < ZERO
93: COLOR INDEX VALUE(S) EXCEED WORKSTATION TABLE CAPACITY
96: COLOR PARAMETER OUT OF RANGE FOR CURRENT COLOR MODEL
97: COLOR FORMAT PARAMETER IS INVALID
272: GROUP IDENTIFIER IS INVALID
305: TEXT PRECISION VALUE IS INVALID

Related Subroutines

GPASF: Attribute Source Flag Setting
GPCHSP: Set Character Spacing
GPCHXP: Set Character Expansion Factor
GPCML: Set Color Model
GPTXCD: Set Text Color Direct
GPTXCI: Set Text Color Index
GPTXFO: Set Text Font
GPTXI: Set Text Index
GPTXPR: Set Text Precision
GPQXTR: Inquire Extended Text Representation

RCP code

201345539 (X'0C004A03')