X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_color.3x.html;h=39a73184fccb26dd5f428d442c8583e2c7c8698b;hp=b7bd241aab38eb716b82843db0cff07d2065c7fa;hb=3a935d9991cdf43ebfa952073c9b555f73a3e011;hpb=71c0306f0824ef2b10c4c5813fb003db48f3012e
diff --git a/doc/html/man/curs_color.3x.html b/doc/html/man/curs_color.3x.html
index b7bd241a..39a73184 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.35 2010/12/20 00:50:58 tom Exp @
-->
@@ -55,6 +55,7 @@
SYNOPSIS
# 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
@@ -199,78 +200,77 @@
will return ERR on attempts to use color values outside
the range 0 to COLORS-1 (except for the default colors ex-
tension), or use color pairs outside the range 0 to COL-
- OR_PAIR-1. Color values used in init_color must be in the
- range 0 to 1000. An error is returned from all functions
- if the terminal has not been initialized. An error is re-
- turned from secondary functions such as init_pair if
+ OR_PAIRS-1. Color values used in init_color must be in
+ the range 0 to 1000. An error is returned from all func-
+ tions if the terminal has not been initialized. An error
+ is returned 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.
NOTES
- 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.
PORTABILITY
- 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.
SEE ALSO
- 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)