ncurses_init_pair
(PHP 4 >= 4.0.7, PHP 5 < 5.3.0, PECL ncurses >= 1.0.0)
ncurses_init_pair — Definește o pereche de culori
Descrierea
$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().
Parametri
-
pair -
Numărul perechii de culori spre a fi definită.
-
fg -
Culoarea 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.
-
bg -
Culoarea 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.
Valorile întoarse
Întoarce -1 dacă funcția s-a executat cu succes, și
0 dacă ncurses sau susținerea culorilor nu a fost
inițializată.
Note
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().
Exemple
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();
?>
A se vedea și
- ncurses_pair_content() - Obține culorile de prim plan și de fundal ale unei perechi de culori
- ncurses_start_color() - Inițializează funcționalitatea culorilor
add a note
