GSCHXP

GDDM-GKS V1R1 Programming Guide and Reference

GSCHXP

GDDM-GKS V1R1 Programming Guide and Reference
SC33-0334-00

Purpose


GSCHXP	(chxp)

APL code	1328
GKS RCP code	X'38001C00' (939531264)

Function: To set character expansion factor.

Output attribute. Sets the character expansion factor.

Parameters

chxp (specified by user) (short floating point)
The character expansion factor. The font width-to-height ratio for a character is multiplied by the value specified, to give the output width-to-height ratio of that character.

Operating states

GKOP, WSOP, WSAC, SGOP

Related functions

Set character height (GSCHH), Inquire character expansion factor (GQCHXP), Inquire character width (GQCHW)

Description

The "current character expansion factor" entry in the GKS state list is set to the value given by chxp. The value is used for the display of subsequent text output primitives created when the character expansion factor aspect source flag (ASF) is individual. (If the ASF is bundled, the value has no effect.)

The character expansion factor affects the width of characters but not the height. When characters are displayed at a workstation, the width is defined by the product of the transformed character width attribute, the character expansion factor, and the font width-to-height ratio for the character. The font width-to-height ratio can vary from character to character according to the font design. The character width attribute is set implicitly when the character height is set using the function Set character height (GSCHH).

Principal errors

8: GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC, or SGOP
77: Character expansion factor is less than or equal to zero

Notices | Terms of use | Support | Contact z/OS