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

SET ANNOTATION TEXT PATH (PHOP,*,STOP,*)

Purpose

Use Set Annotation Text Path to insert a Set Annotation Text Path structure element into the open structure following the element pointer or replace the element pointed at by the element pointer with a Set Annotation Text 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 RIGHT.

If the workstation does not support the specified path value or the specified value is outside the allowable range, then the annotation path value defaults to RIGHT.

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

Language Bindings

C

pset_anno_path (text_path)

Input Parameters

Ptext_path text_path
Annotation text path (0=PPATH_RIGHT, 1=PPATH_LEFT, 2=PPATH_UP, 3=PPATH_DOWN).

FORTRAN

PSATP (atp)

Input Parameters

integer atp
Annotation text path (0=PRIGHT, 1=PLEFT, 2=PUP, 3=PDOWN).

Errors

5
Function Requires State (PHOP,*,STOP,*)

Related Subroutines

  • Set Text Precision


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