SET CHARACTER EXPANSION FACTOR(3P) — SUNPHIGS LIBRARY

NAME

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

SYNOPSIS

C Syntax

void
psetcharexpan ( exp_factor )
Pfloatexp_factor;character expansion factor

FORTRAN Syntax

SUBROUTINE pschxp ( CHXP )
REALCHXPcharacter 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.

FORTRAN Input Parameter

CHXPA 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 PHIGS traversal state list is set to exp_factor.

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

The default character expansion factor is 1.0, which results in no change from the width-to-height ratio of characters from their definition by the font designer. A character expansion factor 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 will be taken from the workstation’s representation indicated by the current text index. In this case, the expansion factor set with SET CHARACTER EXPANSION FACTOR will have no effect.

ERRORS

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

Museum