Allocate a color pair
(PHP 4 >= 4.0.7, PHP 5, PECL ncurses:1.0.0)
int ncurses_init_pair ( intpair, intfg, intbg )
Warning:
This function is
EXPERIMENTAL. The behaviour of this function, the
name of this function, and anything else documented about this
function may change without notice in a future release of PHP.
Use this function at your own risk.
Warning:
This function is
currently not documented; only the argument list is
available.
Creates a reference to a pair of colors that can then be called to change the appearance of an element of the ncurses display.
The guaranteed available colors are defined as constants. See the beginning of the Ncurses section.
This is only of use if your terminal is color-enabled. See ncurses_has_colors() and ncurses_start_color().
the new display color for a character is set using ncurses_color_set();
E.g.
ncurses_start_color();
ncurses_init_pair(1,NCURSES_COLOR_RED,NCURSES_COLOR_BLACK);
ncurses_color_set(1); // turn the new color pair on.
// display what you want colored with this pair
ncurses_color_set(0); // return to the default color pair.
The default color pair (0) cannot be redefined.