X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fterminfo.5.html;h=becb62195bc697a2d8b2afc53b7fae7f11cbabd0;hp=3ab6070bb64fe6c1d2e7f019d3356f41b4ff257f;hb=62ca6190a9a8ddccb2c4d5ca7b2ef9f88432da65;hpb=5606eb48618dde18a593793e2e5dafadf18d345b diff --git a/doc/html/man/terminfo.5.html b/doc/html/man/terminfo.5.html index 3ab6070b..becb6219 100644 --- a/doc/html/man/terminfo.5.html +++ b/doc/html/man/terminfo.5.html @@ -33,7 +33,7 @@ **************************************************************************** * @Id: terminfo.head,v 1.22 2016/10/15 17:02:31 tom Exp @ * Head of terminfo man page ends here - * @Id: terminfo.tail,v 1.74 2016/11/05 21:15:43 Alain.Williams Exp @ + * @Id: terminfo.tail,v 1.75 2016/12/24 22:54:11 tom Exp @ * Beginning of terminfo.tail file * This file is part of ncurses. * See "terminfo.head" for copyright. @@ -75,7 +75,7 @@ nals by giving a set of capabilities which they have, by specifying how to perform screen operations, and by speci- fying padding requirements and initialization sequences. - This describes ncurses version 6.0 (patch 20161119). + This describes ncurses version 6.0 (patch 20161224). Entries in terminfo consist of a sequence of `,' separated fields (embedded commas may be escaped with a backslash or @@ -2067,41 +2067,57 @@
- Most color terminals are either "Tektronix-like" or "HP- - like". Tektronix-like terminals have a predefined set of - N colors (where N usually 8), and can set character-cell - foreground and background characters independently, mixing - them into N * N color-pairs. On HP-like terminals, the - use must set each color pair up separately (foreground and - background are not independently settable). Up to M - color-pairs may be set up from 2*M different colors. - ANSI-compatible terminals are Tektronix-like. + The curses library functions init_pair and init_color + manipulate the color pairs and color values discussed in + this section (see curs_color(3x) for details on these and + related functions). + + Most color terminals are either "Tektronix-like" or "HP- + like": + + o Tektronix-like terminals have a predefined set of N + colors (where N is usually 8), and can set character- + cell foreground and background characters indepen- + dently, mixing them into N * N color-pairs. + + o On HP-like terminals, the user must set each color + pair up separately (foreground and background are not + independently settable). Up to M color-pairs may be + set up from 2*M different colors. ANSI-compatible + terminals are Tektronix-like. Some basic color capabilities are independent of the color method. The numeric capabilities colors and pairs specify - the maximum numbers of colors and color-pairs that can be - displayed simultaneously. The op (original pair) string - resets foreground and background colors to their default - values for the terminal. The oc string resets all colors - or color-pairs to their default values for the terminal. - Some terminals (including many PC terminal emulators) - erase screen areas with the current background color - rather than the power-up default background; these should + the maximum numbers of colors and color-pairs that can be + displayed simultaneously. The op (original pair) string + resets foreground and background colors to their default + values for the terminal. The oc string resets all colors + or color-pairs to their default values for the terminal. + Some terminals (including many PC terminal emulators) + erase screen areas with the current background color + rather than the power-up default background; these should have the boolean capability bce. - To change the current foreground or background color on a - Tektronix-type terminal, use setaf (set ANSI foreground) - and setab (set ANSI background) or setf (set foreground) - and setb (set background). These take one parameter, the - color number. The SVr4 documentation describes only - setaf/setab; the XPG4 draft says that "If the terminal - supports ANSI escape sequences to set background and fore- - ground, they should be coded as setaf and setab, respec- - tively. If the terminal supports other escape sequences - to set background and foreground, they should be coded as - setf and setb, respectively. The vidputs function and the - refresh functions use setaf and setab if they are - defined." + While the curses library works with color pairs (reflect- + ing the inability of some devices to set foreground and + background colors independently), there are separate capa- + bilities for setting these features: + + o To change the current foreground or background color + on a Tektronix-type terminal, use setaf (set ANSI + foreground) and setab (set ANSI background) or setf + (set foreground) and setb (set background). These + take one parameter, the color number. The SVr4 docu- + mentation describes only setaf/setab; the XPG4 draft + says that "If the terminal supports ANSI escape + sequences to set background and foreground, they + should be coded as setaf and setab, respectively. + + o If the terminal supports other escape sequences to set + background and foreground, they should be coded as + setf and setb, respectively. The vidputs and the + refresh functions use the setaf and setab capabilities + if they are defined. The setaf/setab and setf/setb capabilities take a single numeric argument each. Argument values 0-7 of setaf/setab @@ -2141,21 +2157,25 @@ On an HP-like terminal, use scp with a color-pair number parameter to set which color pair is current. - On a Tektronix-like terminal, the capability ccc may be - present to indicate that colors can be modified. If so, - the initc capability will take a color number (0 to colors - - 1)and three more parameters which describe the color. - These three parameters default to being interpreted as RGB - (Red, Green, Blue) values. If the boolean capability hls - is present, they are instead as HLS (Hue, Lightness, Satu- - ration) indices. The ranges are terminal-dependent. - - On an HP-like terminal, initp may give a capability for - changing a color-pair value. It will take seven parame- - ters; a color-pair number (0 to max_pairs - 1), and two - triples describing first background and then foreground - colors. These parameters must be (Red, Green, Blue) or - (Hue, Lightness, Saturation) depending on hls. + Some terminals allow the color values to be modified: + + o On a Tektronix-like terminal, the capability ccc may + be present to indicate that colors can be modified. + If so, the initc capability will take a color number + (0 to colors - 1)and three more parameters which + describe the color. These three parameters default to + being interpreted as RGB (Red, Green, Blue) values. + If the boolean capability hls is present, they are + instead as HLS (Hue, Lightness, Saturation) indices. + The ranges are terminal-dependent. + + o On an HP-like terminal, initp may give a capability + for changing a color-pair value. It will take seven + parameters; a color-pair number (0 to max_pairs - 1), + and two triples describing first background and then + foreground colors. These parameters must be (Red, + Green, Blue) or (Hue, Lightness, Saturation) depending + on hls. On some color terminals, colors collide with highlights. You can register these collisions with the ncv capability. @@ -2493,8 +2513,8 @@
- tic(1m), infocmp(1m), curses(3x), printf(3), term(5). - term_variables(3x). + tic(1m), infocmp(1m), curses(3x), curs_color(3x), + printf(3), term(5). term_variables(3x).