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

GPAPT - Set Annotation Path

GPAPT (path)

Purpose

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

This structure element specifies the writing direction of characters in a text string relative to the Annotation Up vector. At structure traversal time, the graPHIGS API uses this path value to render all subsequent annotation text primitives.

The traversal default for annotation path is 1=RIGHT

If the workstation does not support the specified path value, then the annotation path value defaults to 1=RIGHT

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

Parameters

path -- specified by user, fullword integer

Specifies the path for annotation text primitives (1=RIGHT, 2=LEFT, 3=UP, 4=DOWN )

Error Codes

5
FUNCTION REQUIRES STATE STOP OR NROP (NOT STCL)
306
TEXT PATH VALUE IS INVALID

Related Subroutines

GPTXPR
Set Text Precision

RCP code

201328667 (X'0C00081B')


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