GSCH

GDDM V3R2 Base Application Programming Reference

GSCH

GDDM V3R2 Base Application Programming Reference
SC33-0868-02

Function

To set current character shear.


   GSCH        (dx, dy)

   APL code               558
   GDDM RCP code          X'0C0C070C' (202114828)

Parameters

dx (specified by user) (short floating point)

dy (specified by user) (short floating point)
The x and y separation of two points on an upright character stroke.

If dx=0 and dy=1 (initial default), "upright" characters result. If dx and dy are both positive or both negative, the characters slope from bottom left to top right. If dx and dy are of opposite signs, the characters slope from top left to bottom right. No character inversion ever takes place as a result of a shear alone. (Inversion can be performed with the GSCB call.)

Usually, it is an error to specify a zero value for dy because this would imply an "infinite" shear. However, if both dx and dy are zero, the attribute is set to the drawing default value.

Description






            




   Figure 6. Character shear (GSCH)

Shears mode-3 characters to the angle defined by dx,dy. The character-shear attribute remains in effect until it is changed by another GSCH call.

When a segment is created by the GSSEG call, the character-shear attribute is set to the drawing default value.

When a segment is closed by the GSSCLS call, the character-shear attribute is reset to the value that was in effect when the segment was created.

Characters in a character string may be subjected to a shear transformation. This causes upright lines to be inclined to their normal angle, rather as if the characters were italic. The top of the character box remains parallel to the character baseline.

The relative vector dx,dy defines the angle of the upright strokes relative to the baseline; see Figure 6.

The call has no effect on mode-1 (string precision) character strings.

For mode-2 (character precision) strings, the call may affect the position of individual characters but not their shape.

In character-mode 3, the transformation is observed accurately.

Principal errors

ADM0157 E: ANGLE f1, f2 NOT DEFINED
ADM0158 E: INVALID FUNCTION IN AREA DEFINITION

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