PHIGURE C REFERENCE MANUAL - FIXED ANNOTATION TEXT 3D

FIXED ANNOTATION TEXT 3D

tannot_text_fixed3

CALL SEQUENCE

void tannot_text_fixed3 (strid, string, ref_point, anno_point, char_height, alignment)

INPUT PARAMETERS

Pint	strid;
char	*string;
Ppoint3	*ref_point;
Ppoint3	*anno_point;
Pfloat	char_height;
Ptext_align	*alignment;

ARGUMENTS

strid: Structure identifie
string: Character string to be displayed
ref_point: Reference point to be annotated
anno_point: Point where the text is generated
char_height: Character height
alignment: Text alignment

TYPES

typedef enum {
	PHOR_NORM,
	PHOR_LEFT,
	PHOR_CTR,
	PHOR_RIGHT
} Phor_text_align;

typedef enum {
	PVERT_NORM,
	PVERT_TOP,
	PVERT_CAP,
	PVERT_HALF,
	PVERT_BASE,
	PVERT_BOTTOM
} Pvert_text_align;

typedef struct {
	Phor_text_align	hor;
	Pvert_text_align	vert;
} Ptext_align;

EFFECT

This function creates a structure containing a text generated at annot_point which annotates the reference point ref_point of the current domain. The annotated point annot_point is defined in the NPC space (e.g. % of viewport). Thus the plane in which the character string is generated is always parallel to the display surface and the text is not subject to rotation or scaling operations. (modification of the viewing is irrelevant for the position where the text is drawn in the display surface)

The character height char_height is also defined in [0-1]. The offset between the annotated point anno_point and the reference point ref_point can be visualized calling tset_anno_style function. Character up vector can be set calling tset_anno_char_up_vec function. Text path can be set calling tset_anno_path function.