ANNOTATION TEXT RELATIVE

PATR

CALL SEQUENCE

CALL PATR (RPX, RPY, APX, APY, CHARS)

INPUT PARAMETERS

REAL RPX, RPY

Reference point (MC).

REAL APX, APY

NPC offset. The z value is set to 0. The offsets specified in APX, APY, APZ are added to the transformed coordinates of reference point RPX, RPY, RPZ and are then the point from which the text is drawn.

CHARACTER*(*) CHARS

Character string.

PHIGS STATE

EFFECT

This function characterizes the 2D shape of the annotation text relative primitive.

The ANNOTATION TEXT RELATIVE element is inserted in the open structure after element pointer or replaces the element indicated by element pointer, depending on the edit mode value. Element pointer is updated and points to the ANNOTATION TEXT RELATIVE structure element. The values specified in the function are associated with the element.

When an element of this type is interpreted, a character string is displayed. The annotation text is drawn in the plane (x, y) parallel to the axes (x, y) of normalized projection coordinates (NPC) space at a depth zero. Contrary to that for the text primitive, the plane in which the annotation text is drawn is always parallel to the NPC display surface.

List of attributes associated with Annotation Text Relative:

TEXT FONT

TEXT PRECISION

TEXT COLOUR

CHARACTER EXPANSION FACTOR

CHARACTER SPACING

ANNOTATION STYLE

ANNOTATION CHARACTER HEIGHT

ANNOTATION CHARACTER UP VECTOR

ANNOTATION TEXT PATH

ANNOTATION TEXT ALIGNMENT

EXTENSION TO THE PHIGS STANDARD

If NRS modes, the effect of this function is different from the effect described in the standard.

In NRS mode, (see OPEN PIPE), the element is not stored in a structure. It is sent to the workstation on which the pipe is opened.

ERRORS

5

Ignoring function, function requires state (PHOP,*, STOP,*)

SEE ALSO

open structure, open pipe (ext), set text index, set text font, set text precision, set character expansion factor, set character spacing, set annotation text character height, set annotation text character up vector, set annotation text path, set annotation text alignment, set annotation style, set text colour, set text colour index, annotation text relative 3, inquire current element content, inquire current element type and size