init_color Subroutine
Purpose
Changes a color definition.
Library
Curses Library (libcurses.a)
Syntax
Description
The init_color subroutine changes a color definition. A single color is defined by the combination of its red, green, and blue components. The init_color subroutine changes all the occurrences of the color on the screen immediately. If the color is changed successfully, this subroutines returns OK. Otherwise, it returns ERR.
Note: The values for the red, green, and blue
components must be between 0 (no component) and 1000 (maximum amount
of component). The init_color subroutine sets values less
than 0 to 0 and values greater than 1000 to 1000.
To determine if you can change a terminal's color definitions, see the can_change_color subroutine.
Return Values
| Item | Description |
|---|---|
| OK | Indicates the color was changed successfully. |
| ERR | Indicates the color was not changed. |
Parameters
| Item | Description |
|---|---|
| Color | Identifies the color to change. The value of the parameter must be between 0 and COLORS-1. |
| R | Specifies the desired intensity of the red component. |
| G | Specifies the desired intensity of the green component. |
| B | Specifies the desired intensity of the blue component. |
Examples
To initialize the color definition for color 11 to violet on a terminal that supports at least 12 colors, use:
init_color(11,500,0,500);