[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface : Subroutine Reference

GPCHXP - Set Character Expansion Factor

GPCHXP (expans)

Purpose

Use GPCHXP to insert a Set Character Expansion Factor structure element into the open structure following the element pointer or to replace the element pointed at by the element pointer with a Set Character Expansion Factor structure element depending on the current edit mode.

This structure element specifies the character expansion factor that the graPHIGS API uses at structure traversal time to render all subsequent text primitives when the character expansion attribute source flag is set to 2=INDIVIDUAL

The value is a fraction of the width/height ratio that the font designer specified. A value of 1.0 reproduces the font designer's width/height ratio.

The traversal default value for character expansion factor is 1.0.

If the workstation does not support a the character expansion factor or the specified expansion factor is negative or zero, then the graPHIGS API uses a default expansion factor of 1.0.

Parameters

expans -- specified by user, short floating-point number

Character expansion factor (>0)

Error Codes

5
FUNCTION REQUIRES STATE STOP OR NROP (NOT STCL)
77
CHARACTER EXPANSION FACTOR <= ZERO

Related Subroutines

GPASF
Attribute Source Flag Setting
GPQGFC
Inquire Geometric Font Characteristics
GPQPTR
Inquire Predefined Text Representation
GPQXAF
Inquire Extended Annotation Font Characteristics

RCP code

201328649 (X'0C000809')


[ Previous | Next | Contents | Glossary | Home | Search ]