NAME

SET CHARACTER EXPANSION FACTOR − create structure element to set the current character expansion factor attribute

SYNOPSIS

C Syntax

void
pset_char_expan ( exp_factor )
Pfloatexp_factor;character expansion factor

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

SET CHARACTER EXPANSION FACTOR creates a structure element containing a value for the current character expansion attribute, which changes the characters’ width-to-height ratio from the ratio with which the font was designed. 

When the character expansion factor Aspect Source Flag (ASF) is set to INDIVIDUAL, this attribute applies to the following output primitives:

• TEXT

• TEXT 3

• ANNOTATION TEXT RELATIVE

• ANNOTATION TEXT RELATIVE 3

C Input Parameter

exp_factor
A real value specifying the character expansion factor.

Execution

If the current edit mode is INSERT, a SET CHARACTER EXPANSION FACTOR element is inserted into the currently open structure after the element pointed to by the current element pointer.  If the edit mode is REPLACE, the new SET CHARACTER EXPANSION FACTOR element replaces the element pointed to by the element pointer. In either case, the element pointer is updated to point to the new element.  When the SET CHARACTER EXPANSION FACTOR element is traversed, the current character expansion factor entry in the traversal state list is set to exp_factor. 

When the current character expansion factor ASF is set to INDIVIDUAL, characters in text output primitives that follow in the structure network are modified by the absolute value of the expansion factor specified. 

The default character expansion factor is 1.0, which results in no change in the width-to-height ratio of characters from their definition by the font designer.  A character expansion factor of less than 1.0 produces narrower characters, and a character expansion factor greater than 1.0 produces wider characters. 

When the character expansion factor ASF is set to BUNDLED, the character expansion factor is taken from the workstation’s representation indicated by the current text index.  In this case, the expansion factor set with SET CHARACTER EXPANSION FACTOR has no effect. 

ERRORS

005Ignoring function, function requires state (PHOP, ∗, STOP, ∗)

SEE ALSO

SET INDIVIDUAL ASF (3P)
SET TEXT REPRESENTATION (3P)
SET CHARACTER HEIGHT (3P)
SET CHARACTER SPACING (3P)

September 02, 1992