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

Chapter 3. Attribute Structure Elements

Attribute values describe the appearance of output primitives, including size, shape, style, and color.

This group of subroutines creates structure elements and requires that the structure state is Structure Open (STOP) When the graPHIGS API encounters the elements in this section at traversal time, it modifies the current traversal time registers.

Your application can specify some attribute values directly through a structure element or indirectly by using an index to a bundle table in the Workstation State List (WSL) During structure traversal, the current Attribute Source Flag (ASF) setting determines whether the graPHIGS API draws a primitive using an individual or bundled value of an attribute. For more information about attributes, see The graPHIGS Programming Interface: Understanding Concepts

For attribute values supported on a specific workstation, use the appropriate Inquiry programming subroutines or see The graPHIGS Programming Interface: Technical Reference

GPAAL - Set Annotation Alignment

GPAAL (horiz, vert)

Purpose

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

This structure element specifies the alignment the graPHIGS API uses at structure traversal time to render all subsequent annotation text primitives.

The alignment values affect the position of the annotation text extent rectangle in relation to the text position.

The traversal default for annotation alignment is 1=NORMAL If the specified alignment values are not within the allowable range, then the graPHIGS API uses a default alignment of 1=NORMAL for both horizontal and vertical.

For more information concerning annotation text and annotation text attributes, see The graPHIGS Programming Interface: Understanding Concepts

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

201328659 (X'0C000813')


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