GPHIGS C FUNCTIONS - ANNOTATION TEXT RELATIVE 3

ANNOTATION TEXT RELATIVE 3

PANNO_TEXT_REL3

CALL SEQUENCE

void panno_text_rel3(

const Ppoint3	*ref_point	/* reference point	*/
const Pvec3	*offset	/* annotation offset	*/
const char	*char_string	/* annotation text string	*/

TYPES

typedef struct {
	Pfloat 	x;	/* x coordinate	*/
	Pfloat 	y;	/* y coordinate	*/
	Pfloat 	z;	/* z coordinate	*/
} Ppoint3;

typedef struct {
	Pfloat 	delta_x;	/* delta x	*/
	Pfloat 	delta_y;	/* delta y	*/
	Pfloat 	delta_z;	/* delta z	*/
} Pvec3;

PHIGS STATE

(PHOP, *, STOP, *).

EFFECT

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

The ANNOTATION TEXT RELATIVE 3 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 3 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 (x, y) axes of normalized projection coordinate (NPC) space at a depth defined by the ref_point.z value. 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 used in one of the two GPHIGS specific modes NRS or NDDS, 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.

In NDDS mode, (see BEGIN NON DUPLICATE DATA STORE), the element is stored in the structure but its content is not copied into the CSS. GPHIGS stores only the pointer to the user's data.

See GPHIGS user guide for more details on NRS and NDDS modes.

ERRORS

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