GQPXA

GDDM-GKS V1R1 Programming Guide and Reference

GQPXA

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

Purpose


GQPXA	(wkid, px, py, dimx, dimy, isc, isr, dx, dy, errind, invval, colia)

APL code	1435
GKS RCP code	X'3800E100' (939581696)

Function: To inquire pixel array.

Inquiry function. Returns the current color indexes of a specific array of pixels on the display surface of a workstation. (See the section "GDDM-GKS restrictions" below.)

Parameters

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

px (specified by user) (short floating point)

py (specified by user) (short floating point)
The upper left corner in world coordinates.

dimx (specified by user) (fullword integer)

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

isc (specified by user) (fullword integer)

isr (specified by user) (fullword integer)
The start column and start row within the array.

dx (specified by user) (fullword integer)

dy (specified by user) (fullword integer)
The size of the requested pixel array.

errind (returned by GDDM) (fullword integer)
The error indicator.

invval (returned by GDDM) (fullword integer)
The presence of invalid values. The possible values are:

0 (GABSNT): Absent
1 (GPRSNT): Present

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

Operating states

GKOP, WSOP, WSAC, SGOP

Related functions

Inquire pixel (GQPX), Cell array (GCA)

Description

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

If the inquired information is available, it is returned as output, and errind is returned as 0 (zero). If the inquired information is not available, all output is invalid, and errind returns an error indicator.

GDDM-GKS Restrictions

The workstations supported by GDDM-GKS have no pixel store read-back capability. If this function is invoked, error 40 is reported in errind.

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
39: Specified workstation is neither of category OUTPUT nor of category OUTIN
40: Specified workstation has no pixel store read-back capability
91: Dimensions of color array are invalid

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