GSCHSP

GDDM-GKS V1R1 Programming Guide and Reference

GSCHSP

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

Purpose


GSCHSP	(chsp)

APL code	1329
GKS RCP code	X'38001D00' (939531520)

Function: To set character spacing.

Attribute function. Sets the current character spacing.

Parameters

chsp (specified by user) (short floating point)
The character spacing, specified as a fraction of the current character height.

Operating states

GKOP, WSOP, WSAC, SGOP

Related functions

Set aspect source flags (GSASF), Set character height (GSCHH), Set text font and precision (GSTXFP), Inquire character spacing (GQCHSP)

Description

This function sets the "current character spacing" entry in the GKS state list to the value given by chsp. If the aspect source flag for character spacing is individual, the value given by chsp is used for the display of subsequent text output primitives.

The character spacing value specifies overlap or additional spacing between characters. If the character spacing is zero (the default), characters are drawn one after the other, according to the text path, without any additional space between them. Positive values for chsp will insert additional space between characters; negative values will cause adjacent characters to overlap.

The operation of this function depends on the text mode (string, character, or stroke precision). For string precision, the character spacing is not used. For character and stroke precisions, the character spacing is evaluated exactly.

Principal errors

8: GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC, or SGOP

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