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

GPCHPM - Set Character Positioning Mode

GPCHPM (posmode)

Purpose

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

The character positioning mode determines whether the graPHIGS API uses the character positioning box for the specific character or the nominal positioning box for the font in rendering annotation and geometric text primitives.

In the symbol definition for fonts, character positioning boxes are defined for the font (all symbols in the font) and optionally for each individual symbol. This structure element only applies if the font contains character positioning boxes defined for each individual symbol. If the font only has a character positioning box defined for the font and not for the individual symbols, then this element does not affect the font.

The traversal default for character positioning mode is 1=CONSTANT

Parameters

posmode -- specified by user, fullword integer

Character position mode (1=CONSTANT, 2=PROPORTIONAL )

Error Codes

5
FUNCTION REQUIRES STATE STOP OR NROP (NOT STCL)
81
CHARACTER POSITIONING MODE IS INVALID

Related Subroutines

GPQXTX
Inquire Extended Text Facilities

RCP code

201328661 (X'0C000815')


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