CBL_SCR_ALLOCATE_VC_COLOR
Sets one or more specified virtual colormap entries to the RGB values supplied.
Syntax:
call "CBL_SCR_ALLOCATE_VC_COLOR" using table-count
color-attribute
RGB-values
returning status-code
Parameters:
|
Using call prototype (see Library Routines - Key) |
Picture (32-bit systems) |
table-count |
cblt-x2-compx |
pic x(2) comp-x. |
color-attribute |
cblt-x4-compx occurs n times. |
pic x(4) comp-x occurs n times. |
RGB-values |
Group predefined as cblt-generic-attr-rgb-values containing: |
Group, occurs n times, containing |
|
cblte-garv-red-value |
|
cblt-x2-compx |
|
pic x(2) comp-x. |
|
cblte-garv-green-value |
|
cblt-x2-compx |
|
pic x(2) comp-x. |
|
cblte-garv-blue-value |
|
cblt-x2-compx |
|
pic x(2) comp-x. |
|
cblte-garv-filler |
|
cblt-x1 occurs 2 |
|
pic x(2). |
status-code |
See Library Routines - Key |
On Entry:
table-count |
The number of colors to allocate. |
color-attribute |
The table of indexes to the locations in the virtual colormap in which to
store the specified RGB values. |
RGB-values |
The table of color(s) to add to the virtual colormap. |
On Exit:
table-count |
The number of colors successfully allocated. This is normally the number
requested but is less if the call was not entirely successful. |
RGB-values |
The table of RGB values actually used during the search, truncated to suit
the environment. |
cblte-garv-filler |
Unused. |
Comments:
The RGB values can either be specified as a literal or be obtained using
a call to the CBL_SCR_NAME_TO_RGB routine.
See Also: