Ada95/html/dft_fgbg.3x.html

   1 <HTML>
   2 <BODY BGCOLOR="#99ccbb" TEXT="#000000" LINK="#4060b0" VLINK="#000080" ALINK="#ff4040">
   3 <PRE>
   4        <STRONG>use_default_colors</STRONG> - use terminal's default colors
   5
   6
   7 </PRE>
   8 <H2>SYNOPSIS</H2><PRE>
   9        <STRONG>#include</STRONG> <STRONG>&lt;curses.h&gt;</STRONG>
  10
  11        <STRONG>int</STRONG> <STRONG>use_default_colors(void);</STRONG>
  12
  13
  14 </PRE>
  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.
  24
  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.
  29
  30
  31 </PRE>
  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
  37        as well.
  38
  39
  40 </PRE>
  41 <H2>NOTES</H2><PRE>
  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
  44        or background colors.
  45
  46
  47 </PRE>
  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.
  53
  54
  55 </PRE>
  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>.
  58
  59
  60 </PRE>
  61 <H2>AUTHOR</H2><PRE>
  62        Thomas Dickey (from an analysis of  the  requirements  for
  63        color xterm for XFree86 3.1.2C, February 1996).
  64
  65
  66
  67
  68
  69
  70 </PRE>
  71 </BODY>
  72 </HTML>