| |
Gets and sets the RGB value used when displaying color text
attributes.
Syntax
object.ColorMap(Index) [= color ]
Remarks
The ColorMap property array provides access to the virtual
display color table which determines what RGB values are used to
display foreground and background text color attributes.
When the emulator processes an escape sequence that changes the
current foreground or background color, the actual RGB color value is
determined by looking up the value in the virtual display's color
table. The ColorMap property is useful for determining what
values are being used when a color attribute is set and enables an
application to change those colors. The emulator currently supports a
maximum of sixteen (16) color values, and the index into the table
corresponds to the color as defined by the standard for ANSI
terminals:
| Index |
Color |
Default (Hex) |
Default (Integer) |
Default (RGB) |
| 0 |
Black |
0 |
0 |
RGB(0,0,0) |
| 1 |
Red |
000000A0h |
160 |
RGB(160,0,0) |
| 2 |
Green |
0000A000h |
40960 |
RGB(0,160,0) |
| 3 |
Yellow |
0000A0A0h |
41120 |
RGB(160,160,0) |
| 4 |
Blue |
00A00000h |
10485760 |
RGB(0,0,160) |
| 5 |
Magenta |
00A000A0h |
10485920 |
RGB(160,0,160) |
| 6 |
Cyan |
00A0A000h |
10526720 |
RGB(0,160,160) |
| 7 |
White |
00E0E0E0h |
14737632 |
RGB(224,224,224) |
| 8 |
Gray |
00C0C0C0h |
12632256 |
RGB(192,192,192) |
| 9 |
Light Red |
008080FFh |
8421631 |
RGB(255,128,128) |
| 10 |
Light Green |
0090EE90h |
9498256 |
RGB(144,238,144) |
| 11 |
Light Yellow |
00C0FFFFh |
12648447 |
RGB(255,255,192) |
| 12 |
Light Blue |
00E6D8ADh |
15128749 |
RGB(173,216,230) |
| 13 |
Light Magenta |
00FFC0FFh |
16761087 |
RGB(255,192,255) |
| 14 |
Light Cyan |
00FFFFE0h |
16777184 |
RGB(224,255,255) |
| 15 |
High White |
00FFFFFFh |
16777215 |
RGB(255,255,255) |
A standard ANSI color terminal supports eight standard colors
(0-7). To select a foreground color, you add 30 to the color index
and pass that value as a parameter to the SGR (select graphic
rendition) escape sequence. To select a background color, you add
40 to the color index. For example, to set the current foreground
color to white and the background color to blue, you could send the
following escape sequence:
ESC [ 37;44 m
Note that if you wanted to set the foreground color to a bold
version of standard yellow, you would first set the bold attribute,
and then use the index value of 3, such as:
ESC [ 1;33m
Changing the value of the ColorMap property array allows
the application to make selective changes to the actual RGB color
value that is used when a color attribute is set. Note that changes
to the color map will only affect new characters as they are
displayed, not any previously displayed characters.
Data Type
Integer (Int32)
See Also
BackColor Property,
BoldColor Property, Cell
Property, ForeColor Property
|
|