graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPTX2 - Geometric Text 2

GPTX2 (point, length, text)

Purpose

Use GPTX2 to insert a two-dimensional, geometric text element into the open structure following the element pointer or to replace the element pointed at by the element pointer with a Geometric Text 2 structure element depending on the current edit mode.

This structure element specifies a string of geometric text that the graPHIGS API draws at the specified location in the x, y plane.

When you create this structure element, the current Text Character Set value in the graPHIGS API State List is bound to this character string.

Parameters

point -- specified by user, 2 short floating-point numbers (MC)

x and y coordinates of the text position.

length -- specified by user, fullword integer

Length of text string in bytes (>=0)

text -- specified by user, variable length character string

Text to be displayed.

Error Codes

5: FUNCTION REQUIRES STATE STOP OR NROP (NOT STCL)
108: NUMBER OF CHARACTERS IN TEXT STRING < ZERO

Related Subroutines

GPCHH: Set Character Height
GPCHPM: Set Character Positioning Mode
GPCHSP: Set Character Spacing
GPCHUB: Set Character Up and Base Vectors
GPCHUP: Set Character Up Vector
GPCHXP: Set Character Expansion Factor
GPQGFC: Inquire Geometric Font Characteristics
GPQXTX: Inquire Extended Text Facilities
GPTXAL: Set Text Alignment
GPTXCD: Set Text Color Direct
GPTXCI: Set Text Color Index
GPTXFO: Set Text Font
GPTXI: Set Text Index
GPTXPR: Set Text Precision
GPTXPT: Set Text Path

RCP code

201328134 (X'0C000606')