Name

panno_text_rel − Specifies a reference point for the annotated text in world and defines an annotated offset. 

Operating States: PHOP, ∗, STOP, ∗
PHIGS standard function
Creates a structure element

Syntax

void panno_text_rel (
  const Ppoint   ∗ref_pt,  /∗ (I) Reference point, in modeling
                                  coordinates ∗/
  const Pvec     ∗offset,  /∗ (I) Annotation offset, in normalized
                                  projection coordinates ∗/
  const char     ∗text     /∗ (I) Character string ∗/
)

Data Structures

typedef struct {
    Pfloat     x;    /∗ x coordinate ∗/
    Pfloat     y;    /∗ y coordinate ∗/
} Ppoint;
typedef struct {
    Pfloat     delta_x;    /∗ delta x value ∗/
    Pfloat     delta_y;    /∗ delta y value ∗/
} Pvec;

Description

panno_text_rel specifies a reference point for the annotated text (text that must appear parallel to the viewing surface) in world coordinates, and then defines an annotated offset in normalized projection coordinates.  The annotation point is the point at which Digital PHIGS places the text, which Digital PHIGS computes by adding the value of the annotation offset argument to the transformed reference point. 

Depending on the text attribute source flag values, Digital PHIGS gathers the attributes -- text color, text precision, character expansion, character spacing, and text font -- from the current attribute text values or from the text bundle index attribute. 

Depending on the edit mode, this function either inserts the new structure element directly after the element indicated by the pointer or replaces the element indicated by the pointer.  The pointer then points to the new annotation text relative element. 

The annotation text relative element assumes that the z-coordinates of both the reference point and the annotation point are 0. 

If Digital PHIGS is in immediate mode, it performs this function immediately, but the function does not create a structure element. 

See Also

padd_names_set
panno_text_rel3
pinq_anno_facs
pinq_text_extent
premove_names_set
pset_anno_style
pset_anno_align
pset_anno_char_ht
pset_anno_char_up_vec
pset_anno_path
pset_char_expan
pset_char_space
pset_depth_cue_ind
pset_hlhsr_id
pset_indiv_asf
pset_text_align
pset_text_colr
pset_text_colr_ind
pset_text_font
pset_text_ind
pset_text_prec
pset_view_ind