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

GPAN3 - Annotation Text 3

GPAN3 (point, length, text)

Purpose

Use GPAN3 to insert an Annotation Text 3 structure element into the open structure following the element pointer or to replace the element pointed at by the element pointer with an Annotation Text 3 structure element depending on the current edit mode.

This structure element specifies a string of text in three-dimensional Modelling Coordinate (MC) space to be drawn at the specified location in a plane parallel to the view plane.

At the time this structure element is created, the current Text Character Set value in the graPHIGS API State List is bound to this character string.

The size and orientation of annotation text is not affected by rotation and scaling. Only its position changes.

Parameters

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

x, y, and z coordinates of the annotation text position.

length -- specified by user, fullword integer

Length of the annotation text string in bytes (>=0)

text -- specified by user, variable length character string

Text string to be displayed.

Error Codes

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

Related Subroutines

GPAAL
Set Annotation Alignment
GPAH
Set Annotation Height
GPAHSC
Set Annotation Height Scale Factor
GPAPT
Set Annotation Path
GPAUP
Set Annotation Up Vector
GPCHPM
Set Character Positioning Mode
GPCHSP
Set Character Spacing
GPTXCD
Set Text Color Direct
GPTXCI
Set Text Color Index
GPTXFO
Set Text Font
GPTXI
Set Text Index
GPTXPR
Set Text Precision
GPQXAF
Inquire Extended Annotation Font Characteristics

RCP code

201328140 (X'0C00060C')


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