X-Git-Url: http://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_color.3x.html;h=9aa1b1f0af58b7513f7c0f05b0ee4d760d5584e0;hb=96d6b16de0d487e5d3aed0302a179dbce11b5d96;hp=b7bd241aab38eb716b82843db0cff07d2065c7fa;hpb=71c0306f0824ef2b10c4c5813fb003db48f3012e;p=ncurses.git diff --git a/doc/html/man/curs_color.3x.html b/doc/html/man/curs_color.3x.html index b7bd241a..9aa1b1f0 100644 --- a/doc/html/man/curs_color.3x.html +++ b/doc/html/man/curs_color.3x.html @@ -27,7 +27,7 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: curs_color.3x,v 1.30 2010/07/31 16:12:01 tom Exp @ + * @Id: curs_color.3x,v 1.33 2010/10/02 23:19:27 tom Exp @ -->
@@ -55,6 +55,7 @@# include <curses.h> + int start_color(void); int init_pair(short pair, short f, short b); int init_color(short color, short r, short g, short b); @@ -108,17 +109,17 @@ pair to be changed, the foreground color number, and the background color number. For portable applications: - - The value of the first argument must be between 1 and - COLOR_PAIRS-1, except that if default colors are used - (see use_default_colors) the upper limit is adjusted - to allow for extra pairs which use a default color in - foreground and/or background. + o The value of the first argument must be between 1 and + COLOR_PAIRS-1, except that if default colors are used + (see use_default_colors) the upper limit is adjusted + to allow for extra pairs which use a default color in + foreground and/or background. - - The value of the second and third arguments must be - between 0 and COLORS. Color pair 0 is assumed to be - white on black, but is actually whatever the terminal - implements before color is initialized. It cannot be - modified by the application. + o The value of the second and third arguments must be + between 0 and COLORS. Color pair 0 is assumed to be + white on black, but is actually whatever the terminal + implements before color is initialized. It cannot be + modified by the application. If the color-pair was previously initialized, the screen is refreshed and all occurrences of that color-pair are @@ -205,72 +206,71 @@ turned from secondary functions such as init_pair if start_color was not called. - init_color - returns an error if the terminal does not sup- - port this feature, e.g., if the initial- - ize_color capability is absent from the termi- - nal description. + init_color + returns an error if the terminal does not support + this feature, e.g., if the initialize_color capa- + bility is absent from the terminal description. - start_color - returns an error If the color table cannot be - allocated. + start_color + returns an error if the color table cannot be al- + located.
- In the ncurses implementation, there is a separate color + In the ncurses implementation, there is a separate color activation flag, color palette, color pairs table, and as- - sociated COLORS and COLOR_PAIRS counts for each screen; - the start_color function only affects the current screen. + sociated COLORS and COLOR_PAIRS counts for each screen; + the start_color function only affects the current screen. The SVr4/XSI interface is not really designed with this in - mind, and historical implementations may use a single + mind, and historical implementations may use a single shared color palette. Note that setting an implicit background color via a color - pair affects only character cells that a character write - operation explicitly touches. To change the background - color used when parts of a window are blanked by erasing + pair affects only character cells that a character write + operation explicitly touches. To change the background + color used when parts of a window are blanked by erasing or scrolling operations, see curs_bkgd(3x). - Several caveats apply on 386 and 486 machines with VGA- + Several caveats apply on 386 and 486 machines with VGA- compatible graphics: - - COLOR_YELLOW is actually brown. To get yellow, use - COLOR_YELLOW combined with the A_BOLD attribute. + o COLOR_YELLOW is actually brown. To get yellow, use + COLOR_YELLOW combined with the A_BOLD attribute. - - The A_BLINK attribute should in theory cause the - background to go bright. This often fails to work, - and even some cards for which it mostly works (such - as the Paradise and compatibles) do the wrong thing - when you try to set a bright "yellow" background (you - get a blinking yellow foreground instead). + o The A_BLINK attribute should in theory cause the back- + ground to go bright. This often fails to work, and + even some cards for which it mostly works (such as the + Paradise and compatibles) do the wrong thing when you + try to set a bright "yellow" background (you get a + blinking yellow foreground instead). - - Color RGB values are not settable. + o Color RGB values are not settable.
- This implementation satisfies XSI Curses's minimum maxi- + This implementation satisfies XSI Curses's minimum maxi- mums for COLORS and COLOR_PAIRS. - The init_pair routine accepts negative values of fore- - ground and background color to support the use_de- - fault_colors extension, but only if that routine has been + The init_pair routine accepts negative values of fore- + ground and background color to support the use_de- + fault_colors extension, but only if that routine has been first invoked. - The assumption that COLOR_BLACK is the default background - color for all terminals can be modified using the as- + The assumption that COLOR_BLACK is the default background + color for all terminals can be modified using the as- sume_default_colors extension. - This implementation checks the pointers, e.g., for the - values returned by color_content and pair_content, and + This implementation checks the pointers, e.g., for the + values returned by color_content and pair_content, and will treat those as optional parameters when null.
- curses(3x), curs_initscr(3x), curs_attr(3x), default_col- - ors(3x) + curses(3x), curs_initscr(3x), curs_attr(3x), curs_vari- + ables(3x), default_colors(3x)