GSCMAP(3g,L) AIX Technical Reference GSCMAP(3g,L)
-------------------------------------------------------------------------------
gscmap
PURPOSE
Specifies the color mapping.
C SYNTAX
int gscmap_ (number, red, green, blue)
int *number, *red, *green, *blue;
FORTRAN SYNTAX
INTEGER function gscmap (number, red, green, blue)
INTEGER number, red (*), green (*), blue (*)
PASCAL SYNTAX
FUNCTION gscmap_ (
VAR number INTEGER;
VAR red, green, blue: ARRAY [0..k] of INTEGER
): INTEGER [PUBLIC];
DESCRIPTION
The gscmap subroutine specifies the mapping between the color index attribute
and the color it produces on the display.
The default color table mapping for the first 16 colors is the same as the
default color map attributes in KSR mode. The remaining color values are
initialized in a hardware dependent manner.
Parameters
number Indicates how many colors the input intensity arrays contain.
red, green, blue
Define arrays that contain the intensity levels of the corresponding
color. Each entry in an array specifies the intensity value for the
corresponding color index.
The value in each entry for the red, green, and blue intensity arrays
is between 0x0000, representing zero intensity, and 0x3FFF,
representing full intensity. The following additional increments of
intensity are possible, depending on the adapter hardware in use:
Processed November 7, 1990 GSCMAP(3g,L) 1
GSCMAP(3g,L) AIX Technical Reference GSCMAP(3g,L)
0x2000 1/2 intensity
0x1000 1/4 intensity
0x0800 1/8 intensity
0x0400 1/16 intensity
0x0200 1/32 intensity
0x0100 1/64 intensity.
Combinations of these values can be used to create intermediate levels
of intensity. For example, "0x0C00" gives 3/16 intensity, while
"0x3000" gives 3/4 intensity.
The actual number of bits from bit 13 to bit 0 that affect the color
on the display is dependent on the number of bits in the
digital-to-analog converter of the adapter hardware in use. This size
information is available by using the gsqdsp subroutine.
An application cannot change a single arbitrary color entry in the color map
(or the VLT). It must change all the entries for all the colors up to and
including the desired entry.
For Pascal, the application must declare the arrays passed as being fixed
length and declare the routine as accepting arrays of that length; the k in the
routine declaration must be a constant.
RETURN VALUE
GS_SUCC Successful.
GS_TABL Invalid table length.
GS_INAC Virtual terminal inactive.
Processed November 7, 1990 GSCMAP(3g,L) 2