SET TEXT INDEX(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

SET TEXT INDEX − create a structure element containing a text representation index attribute

SYNOPSIS

C Syntax

void
pset_text_ind ( index )
Pintindex;text index

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

SET TEXT INDEX creates a structure element containing a text index number, which selects an entry from the workstation’s text bundle table. This attribute applies to the output primitives:

• TEXT
• TEXT 3
• ANNOTATION TEXT RELATIVE
• ANNOTATION TEXT RELATIVE 3

If the current edit mode is INSERT, a SET TEXT INDEX element is inserted into the currently open structure after the element pointed to by the current element pointer. If the edit mode is REPLACE, the new SET TEXT INDEX element replaces the element pointed to by the element pointer. In either case, the element pointer is updated to point to the new element.

C Input Parameter

indexA text index for a text representation on the workstation.

Execution

When the SET TEXT INDEX element is traversed, the ‘current text index’ value is set to the text index, which specifies an entry from the workstation’s text bundle table. The default text index is 1, and if the text index specified is not available on the workstation, 1 will be used.

A text representation contains values for the following attributes:

• text font
• text precision
• character expansion factor
• character spacing
• text colour index

Text output primitives which follow in the structure network will be drawn using the values from the specified representation for those attributes whose Aspect Source Flag (ASF) is set to BUNDLED. When the ASFs are INDIVIDUAL, the attributes come from the appropriate SET attribute elements.

Text representations are defined with SET TEXT REPRESENTATION.

ERRORS

005Ignoring function, function requires state (PHOP, ∗, STOP, ∗)

100Ignoring function, the bundle index value is less than one

Museum