Name

pset_char_ht − Defines the height of an uppercase character in the current font. 

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

Syntax

void pset_char_ht (
  Pfloat     height   /∗ (I) Character height in text local coordinates,
                             whose unit size is unscaled from modeling
                             coordinates.  The default value is 0.01. ∗/
)

Description

pset_char_ht specifies the height of an uppercase character in the current font.  Depending on the current 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 set character height element. 

By design, PHIGS fonts define a height-to-width ratio.  Therefore, this function implicitly specifies the width of the font.  The initial height and width values are both 0.01.  Text precision affects character height and width factors. See the pset_text_prec function. 

During structure traversal, the set character height element sets the current set character height entry in the PHIGS traversal state list.  Digital PHIGS binds the value to subsequently traversed text and text 3 primitives.  The character height parameter is specified in the text local coordinate system, along the character up vector.  For text output primitives, the text local coordinate system has unit size unscaled from modeling coordinates.  Digital PHIGS transforms the value into the text local coordinate system for display on the workstation.  If the workstation cannot facilitate the specified height, Digital PHIGS uses the nearest supported character height. 

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

See Also

pinq_text_extent
pinq_text_facs
pset_anno_char_ht
pset_char_expan
pset_char_space
pset_text_rep