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

GPTXR - Set Text Representation

GPTXR (wsid, index, font, prec, factor, space, color)

Purpose

Use GPTXR to set the given attribute values into the specified entry of the text bundle table.

If a precision is specified that is not supported by the workstation, that workstation substitutes the font's highest available precision.

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

index -- specified by user, fullword integer

Text bundle table index (>=1) Index of table entry to be loaded.

font -- specified by user, fullword integer

Text font (>=1)

prec -- specified by user, fullword integer

Text precision (1=STRING_PREC, 2=CHAR_PREC, 3=STROKE_PREC )

factor -- specified by user, short floating-point number

Character expansion factor (>0) Specifies the deviation of the character's width-to-height ratio from the ratio specified by the font designer.

space -- specified by user, short floating-point number

Character spacing between two adjacent characters. This is specified as a fraction of the character's height.

color -- specified by user, fullword integer

Text color index (>=0)

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
305
TEXT PRECISION VALUE IS INVALID

Related Subroutines

GPXTXR
Set Extended Text Representation

RCP code

201329411 (X'0C000B03')

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