(PHP 4 >= 4.0.7, PHP 5 < 5.3.0, PECL ncurses >= 1.0.0)
ncurses_init_pair — Definește o pereche de culori
$pair
, int $fg
, int $bg
) : intDefinește sau redefinește perechea dată de culori cu valori noi pentru culoarea de prim plan și de fundal. Dacă perechea de culori a fost inițializată anterior, ecranul este actualizat și toate aparițiile ei sunt modificate pentru a reflecta definiția nouă.
Capacitățile de redare a culorilor trebuie să fie inițializate cu ncurses_start_color() înainte de a apela această funcție. Prima pereche de culori (perechea de culori 0) se presupune a fi implicit alb pe fundal negru, dar poate fi schimbată utilizând ncurses_assume_default_colors().
pairNumărul perechii de culori spre a fi definită.
fgCuloarea de prim plan pentru perechea de culori. Poate fi una din culorile predefinite sau una definită de ncurses_init_color() dacă terminalul posedă capacități de schimbare a culorilor.
bgCuloarea de fundal pentru perechea de culori. Poate fi una din culorile predefinite sau una definită de ncurses_init_color() dacă terminalul posedă capacități de schimbare a culorilor.
Întoarce -1 dacă funcția s-a executat cu succes, și 0 dacă ncurses sau susținerea culorilor nu a fost inițializată.
Observați că capacitățile de schimbare a culorilor nu sunt necesare pentru definirea perechilor atunci când se folosesc culori pre-existente, dar numai pentru modificarea definițiilor (componentele roșu, verde, albastru) ale culorilor înseși cu ncurses_init_color().
Example #1 Afișarea la ecran a unui șir de caractere cu o culoare specificată
<?php
ncurses_init();
// Dacă terminalul susține culor, inițializează și stabilește culoarea activă
if (ncurses_has_colors()) {
ncurses_start_color();
ncurses_init_pair(1, NCURSES_COLOR_YELLOW, NCURSES_COLOR_BLUE);
ncurses_color_set(1);
}
// Afișează un șir de caractere în poziția specificată
ncurses_mvaddstr(10, 10, "Hello world! Yellow on blue text!");
// Transmite afișajul la ecran
ncurses_refresh();
ncurses_end();
?>