GSPA

GDDM-GKS V1R1 Programming Guide and Reference

GSPA

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

Purpose


GSPA	(szx, szy)

APL code	1339
GKS RCP code	X'38002700' (939534080)

Function: To set pattern size.

Attribute function. Sets the pattern height and width. (See the section "GDDM-GKS restrictions" below.)

Parameters

szx (specified by user) (short floating point)

szy (specified by user) (short floating point)
The pattern size in world coordinates.

Operating states

GKOP, WSOP, WSAC, SGOP

Related functions

Set pattern reference point (GSPARF), Set pattern representation (GSPAR), Fill area (GFA), Inquire pattern size (GQPA)

Description

(See the section "GDDM-GKS restrictions" below.)

This function sets the pattern height and width for fill area output primitives. The current pattern width vector in the GKS state list is set to the vector (szx,0). The current pattern height vector in the GKS state list is set to the vector (0,szy).

When the fill area interior style is pattern, these vectors are used with the current pattern reference point for displaying the patterned fill area output primitives. The pattern width and height vector form the two sides of a pattern box. This lower left corner of the box is positioned on the pattern reference point that you can set in the Set pattern reference point (GSPARF) function. The box is divided into several color cells defined in the Set pattern representation (GSPAR) function. GKS replicates the pattern box to cover the entire interior of the fill area.

GDDM-GKS Restrictions

On the graphics devices supported by GDDM-GKS, patterns are not transformed, and the pattern size and pattern reference point attributes are not honored.

Principal errors

8: GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC, or SGOP
87: Pattern size value is not positive

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