Table of Contents
Define colour pair
Synopsis
cpair [--foreground <foreground>] [--background <background>] <pair index>
Examples
Redefine the default colour pair as yellow on cyan
cpair --foreground 3 --background 6 0
Redefine the default colour pair using 24-bit RGB colours
colour --rgb 0xa0522d 7 colour --rgb 0x4682b4 4 cpair --foreground 7 --background 4 0
Redefine the editable text colour pair as red on white
cpair --foreground 1 --background 7 4
Reset the default colour pair
cpair 0
Description
Define the specified colour pair index to use the specified foreground colour index and the specified background colour index. If the foreground colour index is omitted, then a white foreground will be used. If the background colour index is omitted, then a black or transparent background will be used.
The colour indexes refer to colours as defined using the colour command.
The default colour pair definitions are:
| Pair index | Usage | Foreground colour index | Background colour index |
|---|---|---|---|
| 0 | Default colour | 9 (default: white) | 9 (default: black or transparent) |
| 1 | Normal user interface text | 7 (white) | 4 (blue or transparent) |
| 2 | Highlighted text | 7 (white) | 1 (red) |
| 3 | Separators | 6 (cyan) | 4 (blue or transparent) |
| 4 | Editable text | 0 (black) | 6 (cyan) |
| 5 | Error messages | 7 (white) | 1 (red) |
| 6 | Help URLs | 6 (cyan) | 4 (blue or transparent) |
| 7 | PXE menu selection | 0 (black) | 7 (white) |
Command status
| Success | The colour pair was successfully defined |
|---|---|
| Failure | The colour pair was not successfully defined |
See also
Build options
This command is available only when the build option CONSOLE_CMD is enabled.
