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

GPTXI - Set Text Index

GPTXI (index)

Purpose

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

This structure element specifies an entry in the workstation's text bundle table. The entry contains attribute settings for text font, text precision, character expansion factor, character spacing, and color. At structure traversal time, the graPHIGS API uses these attribute settings to render all subsequent annotation and geometric text primitives for those attributes that have an aspect source flag set to 1=BUNDLED

The traversal default text index value is 1.

If the workstation does not support the specified text index, then the text index defaults to a value of 1.

Parameters

index -- specified by user, fullword integer

Text bundle table index (>=1)

Error Codes

5
FUNCTION REQUIRES STATE STOP OR NROP (NOT STCL)
60
BUNDLE INDEX VALUE < ONE

Related Subroutines

GPQLW
Inquire Length of Workstation State Tables
GPQPTR
Inquire Predefined Text Representation
GPQXTR
Inquire Extended Text Representation
GPQXTX
Inquire Extended Text Facilities
GPXTXR
Set Extended Text Representation

RCP code

201328387 (X'0C000703')


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