-<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
<!--
****************************************************************************
- * Copyright (c) 1998-2000,2002 Free Software Foundation, Inc. *
+ * Copyright (c) 1998-2010,2011 Free Software Foundation, Inc. *
* *
* Permission is hereby granted, free of charge, to any person obtaining a *
* copy of this software and associated documentation files (the *
* sale, use or other dealings in this Software without prior written *
* authorization. *
****************************************************************************
- * Author: Thomas E. Dickey <dickey@clark.net> 1997,1999,2000
- * @Id: default_colors.3x,v 1.16 2002/02/16 22:39:52 tom Exp @
+ * Author: Thomas E. Dickey 1997,1999,2000,2005
+ * @Id: default_colors.3x,v 1.23 2011/01/03 21:52:27 Tim.van.der.Molen Exp @
-->
<HTML>
<HEAD>
<HR>
<PRE>
<!-- Manpage converted by man2html 3.0.1 -->
+<STRONG><A HREF="default_colors.3x.html">default_colors(3x)</A></STRONG> <STRONG><A HREF="default_colors.3x.html">default_colors(3x)</A></STRONG>
+
+
+
</PRE>
<H2>NAME</H2><PRE>
These functions return the integer <STRONG>ERR</STRONG> upon failure and <STRONG>OK</STRONG>
on success. They will fail if either the terminal does
not support the <EM>orig</EM><STRONG>_</STRONG><EM>pair</EM> or <EM>orig</EM><STRONG>_</STRONG><EM>colors</EM> capability. If
- the <EM>initialize</EM><STRONG>_</STRONG><EM>pair</EM> capability is found, this causes an
- error as well.
+ the <EM>initialize</EM><STRONG>_</STRONG><EM>pair</EM> capability is not found, this causes
+ an error as well.
</PRE>
<H2>NOTES</H2><PRE>
- Associated with this extension, the <STRONG><A HREF="init_pair.3x.html">init_pair(3x)</A></STRONG> function
+ Associated with this extension, the <STRONG>init_pair</STRONG> function
accepts negative arguments to specify default foreground
or background colors.
+ The <EM>use</EM><STRONG>_</STRONG><EM>default</EM><STRONG>_</STRONG><EM>colors()</EM> function was added to support
+ <EM>ded</EM>. This is a full-screen application which uses curses
+ to manage only part of the screen. The bottom portion of
+ the screen, which is of adjustable size, is left uncolored
+ to display the results from shell commands. The top por-
+ tion of the screen colors filenames using a scheme like
+ the "color ls" programs. Attempting to manage the back-
+ ground color of the screen for this application would give
+ unsatisfactory results for a variety of reasons. This
+ extension was devised after noting that color xterm (and
+ similar programs) provides a background color which does
+ not necessarily correspond to any of the ANSI colors.
+ While a special terminfo entry could be constructed using
+ nine colors, there was no mechanism provided within curses
+ to account for the related <EM>orig</EM><STRONG>_</STRONG><EM>pair</EM> and <EM>back</EM><STRONG>_</STRONG><EM>color</EM><STRONG>_</STRONG><EM>erase</EM>
+ capabilities.
+
+ The <EM>assume</EM><STRONG>_</STRONG><EM>default</EM><STRONG>_</STRONG><EM>colors()</EM> function was added to solve a
+ different problem: support for applications which would
+ use environment variables and other configuration to
+ bypass curses' notion of the terminal's default colors,
+ setting specific values.
+
</PRE>
<H2>PORTABILITY</H2><PRE>
- These routines are specific to ncurses. They were not
- supported on Version 7, BSD or System V implementations.
- It is recommended that any code depending on them be con-
+ These routines are specific to ncurses. They were not
+ supported on Version 7, BSD or System V implementations.
+ It is recommended that any code depending on them be con-
ditioned using NCURSES_VERSION.
</PRE>
<H2>SEE ALSO</H2><PRE>
- <STRONG><A HREF="curs_color.3x.html">curs_color(3x)</A></STRONG>, <STRONG><A HREF="ded.1.html">ded(1)</A></STRONG>.
+ <STRONG><A HREF="curs_color.3x.html">curs_color(3x)</A></STRONG>, <STRONG>ded(1)</STRONG>.
</PRE>
<H2>AUTHOR</H2><PRE>
- Thomas Dickey (from an analysis of the requirements for
+ Thomas Dickey (from an analysis of the requirements for
color xterm for XFree86 3.1.2C, February 1996).
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+ <STRONG><A HREF="default_colors.3x.html">default_colors(3x)</A></STRONG>
</PRE>
<HR>
<ADDRESS>
projects / ncurses.git / blobdiff