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

GPTXAL - Set Text Alignment

GPTXAL (horiz, vert)

Purpose

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

At structure traversal time, the graPHIGS API uses the specified alignment in this structure element to render all subsequent geometric text primitives. This setting affects the manner in which the graPHIGS API positions the geometric text extent rectangle in relation to the text position.

The traversal default for geometric text horizontal and vertical alignment is 1=NORMAL

If the workstation does not support the specified text alignment values, then the text alignment defaults to 1=NORMAL for both horizontal and vertical text alignment.

Parameters

horiz -- specified by user, fullword integer

Horizontal alignment (1=NORMAL, 2=LEFT_ALIGN, 3=CENTER, 4=RIGHT_ALIGN )

vert -- specified by user, fullword integer

Vertical alignment (1=NORMAL, 2=TOP, 3=CAP, 4=HALF, 5=BASE, 6=BOTTOM )

Error Codes

5
FUNCTION REQUIRES STATE STOP OR NROP (NOT STCL)
309
TEXT ALIGNMENT COMPONENT IS INVALID

Related Subroutines

GPTXPR
Set Text Precision

RCP code

201328908 (X'0C00090C')


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