4 <STRONG>dft_fgbg</STRONG> - use terminal's default colors
9 <STRONG>#include</STRONG> <STRONG><curses.h></STRONG>
11 <STRONG>int</STRONG> <STRONG>use_default_colors(void);</STRONG>
15 <H2>DESCRIPTION</H2><PRE>
16 This is an extension to the curses library. It is used
17 with terminals that support ISO 6429 color, or equivalent.
18 These terminals allow the application to reset color to an
19 unspecified default value (e.g., with SGR 39 or SGR 49).
20 Because they are designed to support this, their design
21 usually includes features to change the default foreground
22 or background colors so that they do not match the assump-
23 tion in XSI curses of white on black.
25 Applications that paint a colored background over the
26 whole screen are not adversely impacted by this type of
27 terminal design. However, there are applications that are
28 designed to work with the default background.
32 <H2>RETURN VALUE</H2><PRE>
33 The function returns the integer <STRONG>ERR</STRONG> upon failure and <STRONG>OK</STRONG>
34 on success. It will fail if either the terminal does not
35 support the <EM>orig</EM><STRONG>_</STRONG><EM>pair</EM> or <EM>orig</EM><STRONG>_</STRONG><EM>colors</EM> capability. If the
36 <EM>initialize</EM><STRONG>_</STRONG><EM>pair</EM> capability is found, this causes an error
42 Associated with this extension, the <STRONG><A HREF="init_pair.3x.html">init_pair(3X)</A></STRONG> function
43 accepts negative arguments to specify default foreground
48 <H2>PORTABILITY</H2><PRE>
49 These routines are specific to ncurses. They were not
50 supported on Version 7, BSD or System V implementations.
51 It is recommended that any code depending on them be con-
52 ditioned using NCURSES_VERSION.
56 <H2>SEE ALSO</H2><PRE>
57 <STRONG><A HREF="curs_color.3x.html">curs_color(3X)</A></STRONG>, <STRONG><A HREF="ded.1.html">ded(1)</A></STRONG>.
62 Thomas Dickey (from an analysis of the requirements for
63 color xterm for XFree86 3.1.2C, February 1996).