GQCR

GDDM-GKS V1R1 Programming Guide and Reference

GQCR

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

Purpose


GQCR	(wkid, coli, type, errind, cr, cg, cb)

APL code	1482
GKS RCP code	X'3800B800' (939571200)

Function: To inquire color representation.

Inquiry function. Returns the color representation values of a color table entry in a workstation state list.

Parameters

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

coli (specified by user) (fullword integer)
The color index.

type (specified by user) (fullword integer)
The type of returned values. The possible values are:

0 (GSET): Set
1 (GREALI): Realized

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

cr (returned by GDDM) (short floating point)
The intensity of red color (0 to 1).

cg (returned by GDDM) (short floating point)
The intensity of green color (0 to 1).

cb (returned by GDDM) (short floating point)
The intensity of blue color (0 to 1).

Operating states

WSOP, WSAC, SGOP

Related functions

Set color representation (GSCR)

Description

The color representation in red, green, and blue intensities for the color index coli is returned.

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.

If you request set values (type = 0), GQCR returns the values you set when you defined the color associated with color index coli.

If you request realized values (type = 1), GQCR returns the closest approximation to the set values that the device can support.

If the device is capable of representing the color you defined, set values and realized values are the same.

You can find out which color indexes are in use by calling Inquire list element of color indexes (GQECI).

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
93: Color index is invalid
94: A representation for the specified color index has not been defined on this workstation

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