ncurses_init_pair
(PHP 4 >= 4.0.7, PHP 5 < 5.3.0, PECL ncurses >= 1.0.0)
ncurses_init_pair — Definir una pareja de colores
Descripción
$pair
, int $fg
, int $bg
) : intDefine o redefine la pareja de colores dada para obtener los colores de primer plano y fondo dados. Si la pareja de colores estaba previamente inicializada, se refresca la pantalla y todas los casos de ella son cambiados para reflejar la nueva definición.
Las capacidades de color deben ser inicializadas usando ncurses_start_color() antes de llamar a esta función. Por omisión, la primera pareja de colores (pareja de colores 0) se asume que es blanco sobre negro, pero se puede cambiar usando ncurses_assume_default_colors().
Parámetros
-
pair -
El número de la pareja de colores a definir.
-
fg -
El color de primer plano de la pareja de colroes. Pude ser uno de los colores predefinidos o uno definido por ncurses_init_color() si el terminal tiene capacidades de cambio de color.
-
bg -
El color de fondo de la pareja de colores. Pude ser uno de los colores predefinidos o uno definido por ncurses_init_color() si el terminal tiene capacidades de cambio de color.
Valores devueltos
Devuelve -1 si la función tuvo éxito, y 0 si ncurses o el soporte para colores no fue inicializado.
Notas
Observe que las capacidades de cambio de color no son necesarias para definir pares de colores de colores preexistentes, excepto solo para los cambios de definiciones (componentes rojo, verde y azul) de los colores en sí por ncurses_init_color().
Ejemplos
Ejemplo #1 Escrivir una cadena con un color especificado en la pantalla
<?php
ncurses_init();
// Si el terminal soporta colores, inicializar y establecer el color activo
if (ncurses_has_colors()) {
ncurses_start_color();
ncurses_init_pair(1, NCURSES_COLOR_YELLOW, NCURSES_COLOR_BLUE);
ncurses_color_set(1);
}
// Escrivir una cadena en una ubicación especificada
ncurses_mvaddstr(10, 10, "¡Hola mundo! ¡Amarillo sobre texto azul!");
// Volcar la salida a la pantalla
ncurses_refresh();
ncurses_end();
?>
Ver también
- ncurses_pair_content() - Obtiene los colores de primer plano y fondo de una pareja de colores
- ncurses_start_color() - Inicializa la funcionalidad de color
add a note
