Important Notice
The pages on this site contain documentation for very old MS-DOS software,
purely for historical purposes.
If you're looking for up-to-date documentation, particularly for programming,
you should not rely on the information found here, as it will be woefully
out of date.
_RemapAllPalette Procedure
◄Summary► ◄Details► ◄Example► ◄Back►
Argument
newpalette Array of LongInt colors
Description
The _RemapAllPalette procedure uses the color defined in the
newpalette array to reassign the color palette. The newpalette
array consists of elements containing LongInt color values. The
number of elements mapped from the array will be 16, 64, or 256,
depending on the current video mode. _RemapAllPalette works in
all video modes (except _OResColor mode), but only with EGA, MCGA,
or VGA hardware.
The default color values for 16-color modes are shown below:
Index Color Index Color
═════ ═══════ ═════ ═════════════
0 Black 8 Gray
1 Blue 9 Light Blue
2 Green 10 Light Green
3 Cyan 11 Light Cyan
4 Red 12 Light Red
5 Magenta 13 Light Magenta
6 Brown 14 Yellow
7 White 15 Bright White
For example, the first array element specifies the new color value
to be associated with color index 0 (the background color in
graphics modes). After the call to _RemapAllPalette, calls to
the _SetColor procedure use the new array of colors. The mapping
done by _RemapAllPalette changes the current display immediately.
The newpalette array can be larger than the number of colors
supported by the current video mode, but only the number of colors
supported by the current video mode, as indicated by
_GetVideoConfig, are used.
The LongInt color value is defined by combining three bytes of data
representing the three component colors: red, green, and blue. The
fourth (high) is ignored. See the help entry on _RemapPalette for
more information on how the three bytes are combined to form a
color value.
_GrStatus Returns
_GrError, _GrInvalidParameter