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

GPCHLS - Set Character Line Scale Factor

GPCHLS (scale)

Purpose

Use GPCHLS to insert a Set Character Line Scale 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 Line Scale Factor structure element depending on the current edit mode.

This structure element specifies a value that the graPHIGS API uses to determine the height of the characters when rendering all subsequent character line primitives.

This value is multiplied by the nominal height specified in the primitive definition to determine the actual height of the characters. The graPHIGS API maps the calculated value to the closest height available on the workstation.

The traversal default for character line scale factor is 1.0.

Parameters

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

Character line scale factor (>=0.0)

Error Codes

5
FUNCTION REQUIRES STATE STOP OR NROP (NOT STCL)
76
CHARACTER LINE SCALE FACTOR < ZERO

Related Subroutines

GPQGFC
Inquire Geometric Font Characteristics

RCP code

201343241 (X'0C004109')


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