GSPAR

GDDM-GKS V1R1 Programming Guide and Reference

GSPAR

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

Purpose


GSPAR	(wkid, pai, dimx, dimy, isc, isr, dx, dy, colia)

APL code	1348
GKS RCP code	X'38002F00' (939536128)

Function: To set pattern representation.

Attribute function. Defines the pattern array associated with a pattern index at a workstation. (See the section "GDDM-GKS restrictions" below.)

Parameters

wkid (specified by user) (fullword integer)
The workstation identifier.

pai (specified by user) (fullword integer)
The pattern index number.

dimx (specified by user) (fullword integer)

dimy (specified by user) (fullword integer)
The dimensions of the color index array colia.

isc (specified by user) (fullword integer)

isr (specified by user) (fullword integer)
The start column and start row of the pattern array in the color index array colia.

dx (specified by user) (fullword integer)

dy (specified by user) (fullword integer)
The number of columns and rows of the pattern array.

colia (specified by user) (an array of fullword integers)
The color index array (dimx groups of dimy elements).

Operating states

WSOP, WSAC, SGOP

Related functions

Inquire pattern representation (GQPAR), Inquire fill area facilities (GQFAF), Set fill area representation (GSFAR), Set fill area style index (GSFASI)

Description

The pattern index number and pattern array are stored in the pattern table (in the workstation state list) of the workstation wkid. The pattern array is used when fill area output primitives are displayed at the workstation with fill area interior style pattern, and the fill area style index is pai.

The pattern array is the array of color indexes with dimensions (dx,dy) passed in the color index array colia. The parameters isc and isr give the start column and start row of the pattern array in colia. To pass the entire color index array as the pattern array, isc and isr should be 1 and dx and dy should be equal to the dimensions of the color index array, dimx and dimy.

If fill areas are displayed with a pattern index that is not available at a workstation, pattern index 1 is used. If pattern index 1 is not available (that is, patterns are not supported at the workstation) the fill area is shaded with cross hatching using the fill area color index and default line type and width.

If a pattern representation is set by this function, the changes may affect the displayed primitives by causing an implicit regeneration of the display, depending on the workstation implicit regeneration mode.

GDDM-GKS Restrictions

Patterns are not available on plotter workstations supported by GDDM-GKS.

Patterns are not available on IBM 5080 workstations.

On other graphics devices, the pattern size is fixed (patterns are not transformed and the pattern size attribute is ignored) and patterns have a fixed number of rows and columns. The values you specify for the pattern array are truncated or replicated at the workstation to fit the fixed pattern size of the device.

Principal errors

7: GKS not in proper state: GKS shall be in one of the states WSOP, WSAC, or SGOP
20: Specified workstation identifier is invalid
25: Specified workstation is not open
33: Specified workstation is of category MI
35: Specified workstation is of category INPUT
36: Specified workstation is Workstation Independent Segment Storage
85: Specified pattern index is invalid
90: Interior style PATTERN is not supported on this workstation
91: Dimensions of color array are invalid
93: Color index is invalid

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