(PHP 4 >= 4.2.0, PHP 5 < 5.3.0, PECL ncurses >= 1.0.0)

ncurses_init_colorDefine a terminal color


ncurses_init_color ( int $color , int $r , int $g , int $b ) : int

Defines or redefines the given color. When this function is called, all occurrences of the given color on the screen, if any, immediately change to the new definition.

Color capabilities must be supported by the terminal and initialized using ncurses_start_color() prior to calling this function. In addition, the terminal must have color changing capabilities; use ncurses_can_change_color() to check for this.



The identification number of the color to redefine. It may be one of the default color constants.


A color value, between 0 and 1000, for the red component.


A color value, between 0 and 1000, for the green component.


A color value, between 0 and 1000, for the blue component.

Return Values

Returns -1 if the function was successful, and 0 if ncurses or terminal color capabilities have not been initialized or the terminal does not have color changing capabilities.

See Also

add a note add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top