GSCR

GDDM-GKS V1R1 Programming Guide and Reference

GSCR

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

Purpose


GSCR	(wkid, ci, cr, cg, cb)

APL code	1349
GKS RCP code	X'38003000' (939536384)

Function: To set color representation.

Attribute function. Associates a color with a color index at a workstation, using the RGB (red, green, blue) color model.

Parameters

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

ci (specified by user) (fullword integer)
The color table index, at the workstation, defined by this function.

cr (specified by user) (short floating point)
A number in the range 0.0 to 1.0 representing the red intensity.

cg (specified by user) (short floating point)
A number in the range 0.0 to 1.0 representing the green intensity.

cb (specified by user) (short floating point)
A number in the range 0.0 to 1.0 representing the blue intensity.

Operating states

WSOP, WSAC, SGOP

Related functions

Inquire list element of color indexes (GQECI), Inquire color representation (GQCR), Inquire color facilities (GQCF), Inquire predefined color representation (GQPCR), Inquire maximum length of workstation state tables (GQLWK), Inquire dynamic modification of workstation attributes (GQDWKA)

Description

This function associates a color with a color table index at the workstation specified by wkid. The function uses the RGB color model, defining a color in terms of red, green, and blue intensities.

If you specify a color that is not available at the workstation, the closest available color is used. The function Inquire color representation (GQCR) returns the realized values on any device.

When you change the color associated with an index, all primitives with that index are drawn in the new color. If you draw a primitive with an undefined color index, the color associated with color index 1 at the workstation is used.

GKS supports the indexes 0 (background) and 1 (foreground) as initial preset values for all devices. You can reset the values for background and foreground by resetting the representations for these indexes to the desired values.

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
96: Color is outside range (0,1)

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