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

GPCHH - Set Character Height

GPCHH (height)

Purpose

Use GPCHH to insert a Set Character Height 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 Height structure element depending on the current edit mode.

This structure element specifies the character height in Modelling Coordinate (MC) space that the graPHIGS API uses when rendering subsequent geometric text primitives.

The traversal default for character height value is 0.01.

When the graPHIGS API encounters an element of this type, it uses the absolute value of the specified character height. If the workstation does not support a continuous range of character heights, then the graPHIGS API uses the closest supported value.

Parameters

height -- specified by user, short floating-point number (MC)

Character height (>0)

Error Codes

5
FUNCTION REQUIRES STATE STOP OR NROP (NOT STCL)
78
CHARACTER HEIGHT VALUE <= ZERO

Related Subroutines

GPQGFC
Inquire Geometric Font Characteristics

RCP code

201328652 (X'0C00080C')


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