Name

pset_char_expan − Defines character width. 

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

Syntax

void pset_char_expan (
  Pfloat  expfac      /∗ (I) Character expansion factor.  The default value
                             is 1.0. ∗/
)

Description

pset_char_expan controls the width of a character.  The value specifies the deviation of the nominal character width-to-height ratio, as defined in the font design. 

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 expansion factor element. 

The set character expansion factor element sets the specified value for the current character expansion factor entry in the PHIGS traversal state list during traversal.  If the current text font ASF entry in the PHIGS traversal state list is INDIVIDUAL, Digital PHIGS binds the value to subsequently traversed text and text 3 primitives.  If the ASF setting is BUNDLED, the value has no effect. 

During structure traversal, Digital PHIGS considers only the magnitude of the character expansion factor.  If the result of taking the absolute value of the character expansion factor value is not supported, Digital PHIGS maps the result to the closest value available on the workstation. 

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

See Also

panno_text_rel
panno_text_rel3
pinq_text_extent
pset_char_ht
pset_char_space
pset_indiv_asf
pset_text_ind
pset_text_rep
ptext
ptext3