graPHIGS Programming Interface: Subroutine Reference

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')