ncurses 5.9 - patch 20110416
[ncurses.git] / ncurses / base / lib_color.c
index 297a14c36d6eaf518825f697d0c2918771d9fdb6..a5c181c8b4b140e60e492d00370d9b455fc5237a 100644 (file)
@@ -1,5 +1,5 @@
 /****************************************************************************
- * Copyright (c) 1998 Free Software Foundation, Inc.                        *
+ * Copyright (c) 1998-2009,2010 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            *
 /****************************************************************************
  *  Author: Zeyd M. Ben-Halim <zmbenhal@netcom.com> 1992,1995               *
  *     and: Eric S. Raymond <esr@snark.thyrsus.com>                         *
+ *     and: Thomas E. Dickey                        1996-on                 *
+ *     and: Juergen Pfeifer                         2009                    *
  ****************************************************************************/
 
 /* lib_color.c
  *
  * Handles color emulation of SYS V curses
- *
  */
 
 #include <curses.priv.h>
-
-#include <term.h>
-
-MODULE_ID("$Id: lib_color.c,v 1.36 1999/10/03 00:20:37 Philippe.Blain Exp $")
-
+#include <tic.h>
+
+#ifndef CUR
+#define CUR SP_TERMTYPE
+#endif
+
+MODULE_ID("$Id: lib_color.c,v 1.98 2010/04/24 22:57:53 tom Exp $")
+
+#ifdef USE_TERM_DRIVER
+#define CanChange      InfoOf(SP_PARM).canchange
+#define DefaultPalette InfoOf(SP_PARM).defaultPalette
+#define HasColor       InfoOf(SP_PARM).hascolor
+#define InitColor      InfoOf(SP_PARM).initcolor
+#define MaxColors      InfoOf(SP_PARM).maxcolors
+#define MaxPairs       InfoOf(SP_PARM).maxpairs
+#define UseHlsPalette  (DefaultPalette == _nc_hls_palette)
+#else
+#define CanChange      can_change
+#define DefaultPalette (hue_lightness_saturation ? hls_palette : cga_palette)
+#define HasColor       has_color
+#define InitColor      initialize_color
+#define MaxColors      max_colors
+#define MaxPairs       max_pairs
+#define UseHlsPalette  (hue_lightness_saturation)
+#endif
+
+#ifndef USE_TERM_DRIVER
 /*
  * These should be screen structure members.  They need to be globals for
- * hystorical reasons.  So we assign them in start_color() and also in
+ * historical reasons.  So we assign them in start_color() and also in
  * set_term()'s screen-switching logic.
  */
-int COLOR_PAIRS;
-int COLORS;
+#if USE_REENTRANT
+NCURSES_EXPORT(int)
+NCURSES_PUBLIC_VAR(COLOR_PAIRS) (void)
+{
+    return SP ? SP->_pair_count : -1;
+}
+NCURSES_EXPORT(int)
+NCURSES_PUBLIC_VAR(COLORS) (void)
+{
+    return SP ? SP->_color_count : -1;
+}
+#else
+NCURSES_EXPORT_VAR(int) COLOR_PAIRS = 0;
+NCURSES_EXPORT_VAR(int) COLORS = 0;
+#endif
+#endif /* !USE_TERM_DRIVER */
+
+#define DATA(r,g,b) {r,g,b, 0,0,0, 0}
+
+#define TYPE_CALLOC(type,elts) typeCalloc(type, (unsigned)(elts))
+
+#define MAX_PALETTE    8
+
+#define OkColorHi(n)   (((n) < COLORS) && ((n) < maxcolors))
+#define InPalette(n)   ((n) >= 0 && (n) < MAX_PALETTE)
 
 /*
  * Given a RGB range of 0..1000, we'll normally set the individual values
@@ -57,141 +103,300 @@ int COLORS;
  */
 #define RGB_ON  680
 #define RGB_OFF 0
-
+/* *INDENT-OFF* */
 static const color_t cga_palette[] =
 {
-    /*  R              G               B */
-       {RGB_OFF,       RGB_OFF,        RGB_OFF},       /* COLOR_BLACK */
-       {RGB_ON,        RGB_OFF,        RGB_OFF},       /* COLOR_RED */
-       {RGB_OFF,       RGB_ON,         RGB_OFF},       /* COLOR_GREEN */
-       {RGB_ON,        RGB_ON,         RGB_OFF},       /* COLOR_YELLOW */
-       {RGB_OFF,       RGB_OFF,        RGB_ON},        /* COLOR_BLUE */
-       {RGB_ON,        RGB_OFF,        RGB_ON},        /* COLOR_MAGENTA */
-       {RGB_OFF,       RGB_ON,         RGB_ON},        /* COLOR_CYAN */
-       {RGB_ON,        RGB_ON,         RGB_ON},        /* COLOR_WHITE */
+    /*  R               G               B */
+    DATA(RGB_OFF,      RGB_OFF,        RGB_OFF),       /* COLOR_BLACK */
+    DATA(RGB_ON,       RGB_OFF,        RGB_OFF),       /* COLOR_RED */
+    DATA(RGB_OFF,      RGB_ON,         RGB_OFF),       /* COLOR_GREEN */
+    DATA(RGB_ON,       RGB_ON,         RGB_OFF),       /* COLOR_YELLOW */
+    DATA(RGB_OFF,      RGB_OFF,        RGB_ON),        /* COLOR_BLUE */
+    DATA(RGB_ON,       RGB_OFF,        RGB_ON),        /* COLOR_MAGENTA */
+    DATA(RGB_OFF,      RGB_ON,         RGB_ON),        /* COLOR_CYAN */
+    DATA(RGB_ON,       RGB_ON,         RGB_ON),        /* COLOR_WHITE */
 };
+
 static const color_t hls_palette[] =
 {
-    /*  H      L       S */
-       {0,     0,      0},     /* COLOR_BLACK */
-       {120,   50,     100},   /* COLOR_RED */
-       {240,   50,     100},   /* COLOR_GREEN */
-       {180,   50,     100},   /* COLOR_YELLOW */
-       {330,   50,     100},   /* COLOR_BLUE */
-       {60,    50,     100},   /* COLOR_MAGENTA */
-       {300,   50,     100},   /* COLOR_CYAN */
-       {0,     50,     100},   /* COLOR_WHITE */
+    /*         H       L       S */
+    DATA(      0,      0,      0),             /* COLOR_BLACK */
+    DATA(      120,    50,     100),           /* COLOR_RED */
+    DATA(      240,    50,     100),           /* COLOR_GREEN */
+    DATA(      180,    50,     100),           /* COLOR_YELLOW */
+    DATA(      330,    50,     100),           /* COLOR_BLUE */
+    DATA(      60,     50,     100),           /* COLOR_MAGENTA */
+    DATA(      300,    50,     100),           /* COLOR_CYAN */
+    DATA(      0,      50,     100),           /* COLOR_WHITE */
 };
 
+#ifdef USE_TERM_DRIVER
+NCURSES_EXPORT_VAR(const color_t*) _nc_cga_palette = cga_palette;
+NCURSES_EXPORT_VAR(const color_t*) _nc_hls_palette = hls_palette;
+#endif
+
+/* *INDENT-ON* */
+
+/*
+ * Ensure that we use color pairs only when colors have been started, and also
+ * that the index is within the limits of the table which we allocated.
+ */
+#define ValidPair(pair) \
+    ((SP_PARM != 0) && (pair >= 0) && (pair < SP_PARM->_pair_limit) && SP_PARM->_coloron)
+
+#if NCURSES_EXT_FUNCS
+/*
+ * These are called from _nc_do_color(), which in turn is called from
+ * vidattr - so we have to assume that sp may be null.
+ */
+static int
+default_fg(NCURSES_SP_DCL0)
+{
+    return (SP_PARM != 0) ? SP_PARM->_default_fg : COLOR_WHITE;
+}
+
+static int
+default_bg(NCURSES_SP_DCL0)
+{
+    return SP_PARM != 0 ? SP_PARM->_default_bg : COLOR_BLACK;
+}
+#else
+#define default_fg(sp) COLOR_WHITE
+#define default_bg(sp) COLOR_BLACK
+#endif
+
+#ifndef USE_TERM_DRIVER
 /*
  * SVr4 curses is known to interchange color codes (1,4) and (3,6), possibly
  * to maintain compatibility with a pre-ANSI scheme.  The same scheme is
  * also used in the FreeBSD syscons.
  */
-static int toggled_colors(int c)
+static int
+toggled_colors(int c)
 {
     if (c < 16) {
        static const int table[] =
-               { 0,  4,  2,  6,  1,  5,  3,  7,
-                 8, 12, 10, 14,  9, 13, 11, 15};
+       {0, 4, 2, 6, 1, 5, 3, 7,
+        8, 12, 10, 14, 9, 13, 11, 15};
        c = table[c];
     }
     return c;
 }
+#endif
 
-static void set_background_color(int bg, int  (*outc)(int))
+static void
+set_background_color(NCURSES_SP_DCLx int bg, NCURSES_SP_OUTC outc)
 {
-       if (set_a_background)
-       {
-           TPUTS_TRACE("set_a_background");
-           tputs(tparm(set_a_background, bg), 1, outc);
-       }
-       else
-       {
-           TPUTS_TRACE("set_background");
-           tputs(tparm(set_background, toggled_colors(bg)), 1, outc);
-       }
+#ifdef USE_TERM_DRIVER
+    CallDriver_3(SP_PARM, color, FALSE, bg, outc);
+#else
+    if (set_a_background) {
+       TPUTS_TRACE("set_a_background");
+       NCURSES_SP_NAME(tputs) (NCURSES_SP_ARGx
+                               TPARM_1(set_a_background, bg),
+                               1, outc);
+    } else {
+       TPUTS_TRACE("set_background");
+       NCURSES_SP_NAME(tputs) (NCURSES_SP_ARGx
+                               TPARM_1(set_background, toggled_colors(bg)),
+                               1, outc);
+    }
+#endif
 }
 
-static void set_foreground_color(int fg, int  (*outc)(int))
+static void
+set_foreground_color(NCURSES_SP_DCLx int fg, NCURSES_SP_OUTC outc)
 {
-       if (set_a_foreground)
-       {
-           TPUTS_TRACE("set_a_foreground");
-           tputs(tparm(set_a_foreground, fg), 1, outc);
-       }
-       else
-       {
-           TPUTS_TRACE("set_foreground");
-           tputs(tparm(set_foreground, toggled_colors(fg)), 1, outc);
-       }
+#ifdef USE_TERM_DRIVER
+    CallDriver_3(SP_PARM, color, TRUE, fg, outc);
+#else
+    if (set_a_foreground) {
+       TPUTS_TRACE("set_a_foreground");
+       NCURSES_SP_NAME(tputs) (NCURSES_SP_ARGx
+                               TPARM_1(set_a_foreground, fg),
+                               1, outc);
+    } else {
+       TPUTS_TRACE("set_foreground");
+       NCURSES_SP_NAME(tputs) (NCURSES_SP_ARGx
+                               TPARM_1(set_foreground, toggled_colors(fg)),
+                               1, outc);
+    }
+#endif
 }
 
-static bool set_original_colors(void)
+static void
+init_color_table(NCURSES_SP_DCL0)
 {
-       if (orig_pair != 0) {
-               TPUTS_TRACE("orig_pair");
-               putp(orig_pair);
-               return TRUE;
-       }
-       else if (orig_colors != NULL)
-       {
-               TPUTS_TRACE("orig_colors");
-               putp(orig_colors);
-               return TRUE;
+    const color_t *tp = DefaultPalette;
+    int n;
+
+    assert(tp != 0);
+
+    for (n = 0; n < COLORS; n++) {
+       if (InPalette(n)) {
+           SP_PARM->_color_table[n] = tp[n];
+       } else {
+           SP_PARM->_color_table[n] = tp[n % MAX_PALETTE];
+           if (UseHlsPalette) {
+               SP_PARM->_color_table[n].green = 100;
+           } else {
+               if (SP_PARM->_color_table[n].red)
+                   SP_PARM->_color_table[n].red = 1000;
+               if (SP_PARM->_color_table[n].green)
+                   SP_PARM->_color_table[n].green = 1000;
+               if (SP_PARM->_color_table[n].blue)
+                   SP_PARM->_color_table[n].blue = 1000;
+           }
        }
-       return FALSE;
+    }
 }
 
-int start_color(void)
+/*
+ * Reset the color pair, e.g., to whatever color pair 0 is.
+ */
+static bool
+reset_color_pair(NCURSES_SP_DCL0)
 {
-       T((T_CALLED("start_color()")));
+#ifdef USE_TERM_DRIVER
+    return CallDriver(SP_PARM, rescol);
+#else
+    bool result = FALSE;
+
+    (void) SP_PARM;
+    if (orig_pair != 0) {
+       TPUTS_TRACE("orig_pair");
+       putp(orig_pair);
+       result = TRUE;
+    }
+    return result;
+#endif
+}
 
-       if (set_original_colors() != TRUE)
-       {
-               set_foreground_color(COLOR_WHITE, _nc_outch);
-               set_background_color(COLOR_BLACK, _nc_outch);
+/*
+ * Reset color pairs and definitions.  Actually we do both more to accommodate
+ * badly-written terminal descriptions than for the relatively rare case where
+ * someone has changed the color definitions.
+ */
+NCURSES_EXPORT(bool)
+NCURSES_SP_NAME(_nc_reset_colors) (NCURSES_SP_DCL0)
+{
+    int result = FALSE;
+
+    T((T_CALLED("_nc_reset_colors(%p)"), (void *) SP_PARM));
+    if (SP_PARM->_color_defs > 0)
+       SP_PARM->_color_defs = -(SP_PARM->_color_defs);
+    if (reset_color_pair(NCURSES_SP_ARG))
+       result = TRUE;
+
+#ifdef USE_TERM_DRIVER
+    result = CallDriver(SP_PARM, rescolors);
+#else
+    if (orig_colors != 0) {
+       TPUTS_TRACE("orig_colors");
+       putp(orig_colors);
+       result = TRUE;
+    }
+#endif
+    returnBool(result);
+}
+
+#if NCURSES_SP_FUNCS
+NCURSES_EXPORT(bool)
+_nc_reset_colors(void)
+{
+    return NCURSES_SP_NAME(_nc_reset_colors) (CURRENT_SCREEN);
+}
+#endif
+
+NCURSES_EXPORT(int)
+NCURSES_SP_NAME(start_color) (NCURSES_SP_DCL0)
+{
+    int result = ERR;
+    int maxpairs = 0, maxcolors = 0;
+
+    T((T_CALLED("start_color(%p)"), (void *) SP_PARM));
+
+    if (SP_PARM == 0) {
+       result = ERR;
+    } else if (SP_PARM->_coloron) {
+       result = OK;
+    } else {
+       maxpairs = MaxPairs;
+       maxcolors = MaxColors;
+       if (reset_color_pair(NCURSES_SP_ARG) != TRUE) {
+           set_foreground_color(NCURSES_SP_ARGx
+                                default_fg(NCURSES_SP_ARG),
+                                NCURSES_SP_NAME(_nc_outch));
+           set_background_color(NCURSES_SP_ARGx
+                                default_bg(NCURSES_SP_ARG),
+                                NCURSES_SP_NAME(_nc_outch));
        }
 
-       if (max_pairs != -1)
-               COLOR_PAIRS = SP->_pair_count = max_pairs;
-       else
-               returnCode(ERR);
-       if ((SP->_color_pairs = typeCalloc(unsigned short, max_pairs)) == 0)
-               returnCode(ERR);
-       SP->_color_pairs[0] = PAIR_OF(COLOR_WHITE, COLOR_BLACK);
-       if (max_colors != -1)
-               COLORS = SP->_color_count = max_colors;
-       else
-               returnCode(ERR);
-       SP->_coloron = 1;
-
-       if ((SP->_color_table = typeMalloc(color_t, COLORS)) == 0)
-               returnCode(ERR);
-       if (hue_lightness_saturation)
-           memcpy(SP->_color_table, hls_palette, sizeof(color_t) * COLORS);
-       else
-           memcpy(SP->_color_table, cga_palette, sizeof(color_t) * COLORS);
-
-       T(("started color: COLORS = %d, COLOR_PAIRS = %d", COLORS, COLOR_PAIRS));
-
-       returnCode(OK);
+       if (maxpairs > 0 && maxcolors > 0) {
+           SP_PARM->_pair_limit = maxpairs;
+
+#if NCURSES_EXT_FUNCS
+           /*
+            * If using default colors, allocate extra space in table to
+            * allow for default-color as a component of a color-pair.
+            */
+           SP_PARM->_pair_limit += (1 + (2 * maxcolors));
+#endif
+           SP_PARM->_pair_count = maxpairs;
+           SP_PARM->_color_count = maxcolors;
+#if !USE_REENTRANT
+           COLOR_PAIRS = maxpairs;
+           COLORS = maxcolors;
+#endif
+
+           SP_PARM->_color_pairs = TYPE_CALLOC(colorpair_t, SP_PARM->_pair_limit);
+           if (SP_PARM->_color_pairs != 0) {
+               SP_PARM->_color_table = TYPE_CALLOC(color_t, maxcolors);
+               if (SP_PARM->_color_table != 0) {
+                   SP_PARM->_color_pairs[0] = PAIR_OF(default_fg(NCURSES_SP_ARG),
+                                                      default_bg(NCURSES_SP_ARG));
+                   init_color_table(NCURSES_SP_ARG);
+
+                   T(("started color: COLORS = %d, COLOR_PAIRS = %d",
+                      COLORS, COLOR_PAIRS));
+
+                   SP_PARM->_coloron = 1;
+                   result = OK;
+               } else if (SP_PARM->_color_pairs != 0) {
+                   FreeAndNull(SP_PARM->_color_pairs);
+               }
+           }
+       } else {
+           result = OK;
+       }
+    }
+    returnCode(result);
 }
 
+#if NCURSES_SP_FUNCS
+NCURSES_EXPORT(int)
+start_color(void)
+{
+    return NCURSES_SP_NAME(start_color) (CURRENT_SCREEN);
+}
+#endif
+
 /* This function was originally written by Daniel Weaver <danw@znyx.com> */
-static void rgb2hls(short r, short g, short b, short *h, short *l, short *s)
+static void
+rgb2hls(short r, short g, short b, short *h, short *l, short *s)
 /* convert RGB to HLS system */
 {
     short min, max, t;
 
-    if ((min = g < r ? g : r) > b) min = b;
-    if ((max = g > r ? g : r) < b) max = b;
+    if ((min = g < r ? g : r) > b)
+       min = b;
+    if ((max = g > r ? g : r) < b)
+       max = b;
 
     /* calculate lightness */
-    *l = (min + max) / 20;
+    *l = (short) ((min + max) / 20);
 
-    if (min == max)            /* black, white and all shades of gray */
-    {
+    if (min == max) {          /* black, white and all shades of gray */
        *h = 0;
        *s = 0;
        return;
@@ -199,17 +404,17 @@ static void rgb2hls(short r, short g, short b, short *h, short *l, short *s)
 
     /* calculate saturation */
     if (*l < 50)
-       *s = ((max - min) * 100) / (max + min);
-    else *s = ((max - min) * 100) / (2000 - max - min);
+       *s = (short) (((max - min) * 100) / (max + min));
+    else
+       *s = (short) (((max - min) * 100) / (2000 - max - min));
 
     /* calculate hue */
     if (r == max)
-       t = 120 + ((g - b) * 60) / (max - min);
+       t = (short) (120 + ((g - b) * 60) / (max - min));
+    else if (g == max)
+       t = (short) (240 + ((b - r) * 60) / (max - min));
     else
-       if (g == max)
-           t = 240 + ((b - r) * 60) / (max - min);
-       else
-           t = 360 + ((r - g) * 60) / (max - min);
+       t = (short) (360 + ((r - g) * 60) / (max - min));
 
     *h = t % 360;
 }
@@ -218,212 +423,437 @@ static void rgb2hls(short r, short g, short b, short *h, short *l, short *s)
  * Extension (1997/1/18) - Allow negative f/b values to set default color
  * values.
  */
-int init_pair(short pair, short f, short b)
+NCURSES_EXPORT(int)
+NCURSES_SP_NAME(init_pair) (NCURSES_SP_DCLx short pair, short f, short b)
 {
-       unsigned result;
-
-       T((T_CALLED("init_pair(%d,%d,%d)"), pair, f, b));
-
-       if ((pair < 1) || (pair >= COLOR_PAIRS))
-               returnCode(ERR);
-       if (SP->_default_color)
-       {
-               if (f < 0)
-                       f = C_MASK;
-               if (b < 0)
-                       b = C_MASK;
-               if (f >= COLORS && f != C_MASK)
-                       returnCode(ERR);
-               if (b >= COLORS && b != C_MASK)
-                       returnCode(ERR);
+    colorpair_t result;
+    colorpair_t previous;
+    int maxcolors;
+
+    T((T_CALLED("init_pair(%p,%d,%d,%d)"), (void *) SP_PARM, pair, f, b));
+
+    if (!ValidPair(pair))
+       returnCode(ERR);
+
+    maxcolors = MaxColors;
+
+    previous = SP_PARM->_color_pairs[pair];
+#if NCURSES_EXT_FUNCS
+    if (SP_PARM->_default_color) {
+       bool isDefault = FALSE;
+       bool wasDefault = FALSE;
+       int default_pairs = SP_PARM->_default_pairs;
+
+       /*
+        * Map caller's color number, e.g., -1, 0, 1, .., 7, etc., into
+        * internal unsigned values which we will store in the _color_pairs[]
+        * table.
+        */
+       if (isDefaultColor(f)) {
+           f = COLOR_DEFAULT;
+           isDefault = TRUE;
+       } else if (!OkColorHi(f)) {
+           returnCode(ERR);
+       }
+
+       if (isDefaultColor(b)) {
+           b = COLOR_DEFAULT;
+           isDefault = TRUE;
+       } else if (!OkColorHi(b)) {
+           returnCode(ERR);
        }
-       else
-       if ((f < 0) || (f >= COLORS)
-        || (b < 0) || (b >= COLORS))
-               returnCode(ERR);
 
        /*
-        * When a pair's content is changed, replace its colors (if pair was
-        * initialized before a screen update is performed replacing original
-        * pair colors with the new ones).
+        * Check if the table entry that we are going to init/update used
+        * default colors.
         */
-       result = PAIR_OF(f,b);
-       if (SP->_color_pairs[pair] != 0
-        && SP->_color_pairs[pair] != result) {
-           int y, x;
-           attr_t z = COLOR_PAIR(pair);
-
-           for (y = 0; y <= curscr->_maxy; y++) {
-               struct ldat *ptr = &(curscr->_line[y]);
-               bool changed = FALSE;
-               for (x = 0; x <= curscr->_maxx; x++) {
-                   if ((ptr->text[x] & A_COLOR) == z) {
-                       /* Set the old cell to zero to ensure it will be
-                          updated on the next doupdate() */
-                       ptr->text[x] = 0;
-                       CHANGED_CELL(ptr,x);
-                       changed = TRUE;
-                   }
-               }
-               if (changed)
-                       _nc_make_oldhash(y);
-           }
+       if ((FORE_OF(previous) == COLOR_DEFAULT)
+           || (BACK_OF(previous) == COLOR_DEFAULT))
+           wasDefault = TRUE;
+
+       /*
+        * Keep track of the number of entries in the color pair table which
+        * used a default color.
+        */
+       if (isDefault && !wasDefault) {
+           ++default_pairs;
+       } else if (wasDefault && !isDefault) {
+           --default_pairs;
        }
-       SP->_color_pairs[pair] = result;
-
-       if (initialize_pair)
-       {
-           const color_t *tp = hue_lightness_saturation ? hls_palette : cga_palette;
-
-           T(("initializing pair: pair = %d, fg=(%d,%d,%d), bg=(%d,%d,%d)",
-              pair,
-              tp[f].red, tp[f].green, tp[f].blue,
-              tp[b].red, tp[b].green, tp[b].blue));
-
-           if (initialize_pair)
-           {
-               TPUTS_TRACE("initialize_pair");
-               putp(tparm(initialize_pair,
-                           pair,
-                           tp[f].red, tp[f].green, tp[f].blue,
-                           tp[b].red, tp[b].green, tp[b].blue));
+
+       /*
+        * As an extension, ncurses allows the pair number to exceed the
+        * terminal's color_pairs value for pairs using a default color.
+        *
+        * Note that updating a pair which used a default color with one
+        * that does not will decrement the count - and possibly interfere
+        * with sequentially adding new pairs.
+        */
+       if (pair > (SP_PARM->_pair_count + default_pairs)) {
+           returnCode(ERR);
+       }
+       SP_PARM->_default_pairs = default_pairs;
+    } else
+#endif
+    {
+       if ((f < 0) || !OkColorHi(f)
+           || (b < 0) || !OkColorHi(b)
+           || (pair < 1))
+           returnCode(ERR);
+    }
+
+    /*
+     * When a pair's content is changed, replace its colors (if pair was
+     * initialized before a screen update is performed replacing original
+     * pair colors with the new ones).
+     */
+    result = PAIR_OF(f, b);
+    if (previous != 0
+       && previous != result) {
+       int y, x;
+
+       for (y = 0; y <= CurScreen(SP_PARM)->_maxy; y++) {
+           struct ldat *ptr = &(CurScreen(SP_PARM)->_line[y]);
+           bool changed = FALSE;
+           for (x = 0; x <= CurScreen(SP_PARM)->_maxx; x++) {
+               if (GetPair(ptr->text[x]) == pair) {
+                   /* Set the old cell to zero to ensure it will be
+                      updated on the next doupdate() */
+                   SetChar(ptr->text[x], 0, 0);
+                   CHANGED_CELL(ptr, x);
+                   changed = TRUE;
+               }
            }
+           if (changed)
+               NCURSES_SP_NAME(_nc_make_oldhash) (NCURSES_SP_ARGx y);
        }
+    }
 
-       returnCode(OK);
+    SP_PARM->_color_pairs[pair] = result;
+    if (GET_SCREEN_PAIR(SP_PARM) == pair)
+       SET_SCREEN_PAIR(SP_PARM, (chtype) (~0));        /* force attribute update */
+
+#ifdef USE_TERM_DRIVER
+    CallDriver_3(SP_PARM, initpair, pair, f, b);
+#else
+    if (initialize_pair && InPalette(f) && InPalette(b)) {
+       const color_t *tp = DefaultPalette;
+
+       TR(TRACE_ATTRS,
+          ("initializing pair: pair = %d, fg=(%d,%d,%d), bg=(%d,%d,%d)",
+           pair,
+           tp[f].red, tp[f].green, tp[f].blue,
+           tp[b].red, tp[b].green, tp[b].blue));
+
+       TPUTS_TRACE("initialize_pair");
+       putp(TPARM_7(initialize_pair,
+                    pair,
+                    tp[f].red, tp[f].green, tp[f].blue,
+                    tp[b].red, tp[b].green, tp[b].blue));
+    }
+#endif
+
+    returnCode(OK);
+}
+
+#if NCURSES_SP_FUNCS
+NCURSES_EXPORT(int)
+init_pair(short pair, short f, short b)
+{
+    return NCURSES_SP_NAME(init_pair) (CURRENT_SCREEN, pair, f, b);
 }
+#endif
 
-int init_color(short color, short r, short g, short b)
+#define okRGB(n) ((n) >= 0 && (n) <= 1000)
+
+NCURSES_EXPORT(int)
+NCURSES_SP_NAME(init_color) (NCURSES_SP_DCLx
+                            short color, short r, short g, short b)
 {
-       T((T_CALLED("init_color(%d,%d,%d,%d)"), color, r, g, b));
+    int result = ERR;
+    int maxcolors;
+
+    T((T_CALLED("init_color(%p,%d,%d,%d,%d)"),
+       (void *) SP_PARM,
+       color,
+       r, g, b));
 
-       if (initialize_color == NULL)
-               returnCode(ERR);
+    if (SP_PARM == 0)
+       returnCode(result);
 
-       if (color < 0 || color >= COLORS)
-               returnCode(ERR);
-       if (r < 0 || r > 1000 || g < 0 ||  g > 1000 || b < 0 || b > 1000)
-               returnCode(ERR);
+    maxcolors = MaxColors;
 
-       if (hue_lightness_saturation)
+    if (InitColor
+       && SP_PARM->_coloron
+       && (color >= 0 && OkColorHi(color))
+       && (okRGB(r) && okRGB(g) && okRGB(b))) {
+
+       SP_PARM->_color_table[color].init = 1;
+       SP_PARM->_color_table[color].r = r;
+       SP_PARM->_color_table[color].g = g;
+       SP_PARM->_color_table[color].b = b;
+
+       if (UseHlsPalette) {
            rgb2hls(r, g, b,
-                     &SP->_color_table[color].red,
-                     &SP->_color_table[color].green,
-                     &SP->_color_table[color].blue);
-       else
-       {
-               SP->_color_table[color].red = r;
-               SP->_color_table[color].green = g;
-               SP->_color_table[color].blue = b;
+                   &SP_PARM->_color_table[color].red,
+                   &SP_PARM->_color_table[color].green,
+                   &SP_PARM->_color_table[color].blue);
+       } else {
+           SP_PARM->_color_table[color].red = r;
+           SP_PARM->_color_table[color].green = g;
+           SP_PARM->_color_table[color].blue = b;
        }
 
-       if (initialize_color)
-       {
-               TPUTS_TRACE("initialize_color");
-               putp(tparm(initialize_color, color, r, g, b));
-       }
-       returnCode(OK);
+#ifdef USE_TERM_DRIVER
+       CallDriver_4(SP_PARM, initcolor, color, r, g, b);
+#else
+       TPUTS_TRACE("initialize_color");
+       putp(TPARM_4(initialize_color, color, r, g, b));
+#endif
+       SP_PARM->_color_defs = max(color + 1, SP_PARM->_color_defs);
+
+       result = OK;
+    }
+    returnCode(result);
 }
 
-bool can_change_color(void)
+#if NCURSES_SP_FUNCS
+NCURSES_EXPORT(int)
+init_color(short color, short r, short g, short b)
 {
-       T((T_CALLED("can_change_color()")));
-       returnCode ((can_change != 0) ? TRUE : FALSE);
+    return NCURSES_SP_NAME(init_color) (CURRENT_SCREEN, color, r, g, b);
 }
+#endif
 
-bool has_colors(void)
+NCURSES_EXPORT(bool)
+NCURSES_SP_NAME(can_change_color) (NCURSES_SP_DCL)
 {
-       T((T_CALLED("has_colors()")));
-       returnCode (((max_colors != -1) && (max_pairs != -1)
-                    && (((set_foreground != NULL)
-                         && (set_background != NULL))
-                        || ((set_a_foreground != NULL)
-                            && (set_a_background != NULL))
-                        || set_color_pair)) ? TRUE : FALSE);
+    T((T_CALLED("can_change_color(%p)"), (void *) SP_PARM));
+    returnCode((CanChange != 0) ? TRUE : FALSE);
 }
 
-int color_content(short color, short *r, short *g, short *b)
+#if NCURSES_SP_FUNCS
+NCURSES_EXPORT(bool)
+can_change_color(void)
 {
-    T((T_CALLED("color_content(%d,%p,%p,%p)"), color, r, g, b));
-    if (color < 0 || color >= COLORS)
-       returnCode(ERR);
+    return NCURSES_SP_NAME(can_change_color) (CURRENT_SCREEN);
+}
+#endif
 
-    if (r) *r = SP->_color_table[color].red;
-    if (g) *g = SP->_color_table[color].green;
-    if (b) *b = SP->_color_table[color].blue;
-    returnCode(OK);
+NCURSES_EXPORT(bool)
+NCURSES_SP_NAME(has_colors) (NCURSES_SP_DCL0)
+{
+    int code;
+
+    (void) SP_PARM;
+    T((T_CALLED("has_colors()")));
+#ifdef USE_TERM_DRIVER
+    code = HasColor;
+#else
+    code = ((VALID_NUMERIC(max_colors) && VALID_NUMERIC(max_pairs)
+            && (((set_foreground != NULL)
+                 && (set_background != NULL))
+                || ((set_a_foreground != NULL)
+                    && (set_a_background != NULL))
+                || set_color_pair)) ? TRUE : FALSE);
+#endif
+    returnCode(code);
 }
 
-int pair_content(short pair, short *f, short *b)
+#if NCURSES_SP_FUNCS
+NCURSES_EXPORT(bool)
+has_colors(void)
 {
-       T((T_CALLED("pair_content(%d,%p,%p)"), pair, f, b));
+    return NCURSES_SP_NAME(has_colors) (CURRENT_SCREEN);
+}
+#endif
 
-       if ((pair < 0) || (pair >= COLOR_PAIRS))
-               returnCode(ERR);
-       if (f) *f = ((SP->_color_pairs[pair] >> C_SHIFT) & C_MASK);
-       if (b) *b =  (SP->_color_pairs[pair] & C_MASK);
+NCURSES_EXPORT(int)
+NCURSES_SP_NAME(color_content) (NCURSES_SP_DCLx
+                               short color, short *r, short *g, short *b)
+{
+    int result = ERR;
+    int maxcolors;
+
+    T((T_CALLED("color_content(%p,%d,%p,%p,%p)"),
+       (void *) SP_PARM,
+       color,
+       (void *) r,
+       (void *) g,
+       (void *) b));
+
+    if (SP_PARM == 0)
+       returnCode(result);
+
+    maxcolors = MaxColors;
+
+    if (color < 0 || !OkColorHi(color) || !SP_PARM->_coloron) {
+       result = ERR;
+    } else {
+       NCURSES_COLOR_T c_r = SP_PARM->_color_table[color].red;
+       NCURSES_COLOR_T c_g = SP_PARM->_color_table[color].green;
+       NCURSES_COLOR_T c_b = SP_PARM->_color_table[color].blue;
+
+       if (r)
+           *r = c_r;
+       if (g)
+           *g = c_g;
+       if (b)
+           *b = c_b;
+
+       TR(TRACE_ATTRS, ("...color_content(%d,%d,%d,%d)",
+                        color, c_r, c_g, c_b));
+       result = OK;
+    }
+    returnCode(result);
+}
 
-       returnCode(OK);
+#if NCURSES_SP_FUNCS
+NCURSES_EXPORT(int)
+color_content(short color, short *r, short *g, short *b)
+{
+    return NCURSES_SP_NAME(color_content) (CURRENT_SCREEN, color, r, g, b);
 }
+#endif
 
-void _nc_do_color(int pair, bool reverse, int (*outc)(int))
+NCURSES_EXPORT(int)
+NCURSES_SP_NAME(pair_content) (NCURSES_SP_DCLx
+                              short pair, short *f, short *b)
 {
-    short fg, bg;
+    int result;
+
+    T((T_CALLED("pair_content(%p,%d,%p,%p)"),
+       (void *) SP_PARM,
+       pair,
+       (void *) f,
+       (void *) b));
+
+    if (!ValidPair(pair)) {
+       result = ERR;
+    } else {
+       NCURSES_COLOR_T fg = FORE_OF(SP_PARM->_color_pairs[pair]);
+       NCURSES_COLOR_T bg = BACK_OF(SP_PARM->_color_pairs[pair]);
+
+#if NCURSES_EXT_FUNCS
+       if (fg == COLOR_DEFAULT)
+           fg = -1;
+       if (bg == COLOR_DEFAULT)
+           bg = -1;
+#endif
+
+       if (f)
+           *f = fg;
+       if (b)
+           *b = bg;
+
+       TR(TRACE_ATTRS, ("...pair_content(%p,%d,%d,%d)",
+                        (void *) SP_PARM,
+                        pair,
+                        fg, bg));
+       result = OK;
+    }
+    returnCode(result);
+}
 
-    if (pair == 0)
-    {
-       if (orig_pair)
-       {
-           TPUTS_TRACE("orig_pair");
-           tputs(orig_pair, 1, outc);
-       }
-       else if (set_color_pair)
-       {
+#if NCURSES_SP_FUNCS
+NCURSES_EXPORT(int)
+pair_content(short pair, short *f, short *b)
+{
+    return NCURSES_SP_NAME(pair_content) (CURRENT_SCREEN, pair, f, b);
+}
+#endif
+
+NCURSES_EXPORT(void)
+NCURSES_SP_NAME(_nc_do_color) (NCURSES_SP_DCLx
+                              short old_pair,
+                              short pair,
+                              bool reverse,
+                              NCURSES_SP_OUTC outc)
+{
+#ifdef USE_TERM_DRIVER
+    CallDriver_4(SP_PARM, docolor, old_pair, pair, reverse, outc);
+#else
+    NCURSES_COLOR_T fg = COLOR_DEFAULT;
+    NCURSES_COLOR_T bg = COLOR_DEFAULT;
+    NCURSES_COLOR_T old_fg, old_bg;
+
+    if (!ValidPair(pair)) {
+       return;
+    } else if (pair != 0) {
+       if (set_color_pair) {
            TPUTS_TRACE("set_color_pair");
-           tputs(tparm(set_color_pair, pair), 1, outc);
-       }
-       else
-       {
-           set_foreground_color(COLOR_WHITE, outc);
-           set_background_color(COLOR_BLACK, outc);
+           NCURSES_SP_NAME(tputs) (NCURSES_SP_ARGx
+                                   TPARM_1(set_color_pair, pair),
+                                   1, outc);
+           return;
+       } else if (SP_PARM != 0) {
+           pair_content((short) pair, &fg, &bg);
        }
     }
-    else
-    {
-       if (set_color_pair)
-       {
-           TPUTS_TRACE("set_color_pair");
-           tputs(tparm(set_color_pair, pair), 1, outc);
+
+    if (old_pair >= 0
+       && SP_PARM != 0
+       && pair_content(old_pair, &old_fg, &old_bg) != ERR) {
+       if ((isDefaultColor(fg) && !isDefaultColor(old_fg))
+           || (isDefaultColor(bg) && !isDefaultColor(old_bg))) {
+#if NCURSES_EXT_FUNCS
+           /*
+            * A minor optimization - but extension.  If "AX" is specified in
+            * the terminal description, treat it as screen's indicator of ECMA
+            * SGR 39 and SGR 49, and assume the two sequences are independent.
+            */
+           if (SP_PARM->_has_sgr_39_49
+               && isDefaultColor(old_bg)
+               && !isDefaultColor(old_fg)) {
+               NCURSES_SP_NAME(tputs) (NCURSES_SP_ARGx "\033[39m", 1, outc);
+           } else if (SP_PARM->_has_sgr_39_49
+                      && isDefaultColor(old_fg)
+                      && !isDefaultColor(old_bg)) {
+               NCURSES_SP_NAME(tputs) (NCURSES_SP_ARGx "\033[49m", 1, outc);
+           } else
+#endif
+               reset_color_pair(NCURSES_SP_ARG);
        }
-       else
-       {
-           pair_content(pair, &fg, &bg);
-           if (reverse) {
-               short xx = fg;
-               fg = bg;
-               bg = xx;
-           }
+    } else {
+       reset_color_pair(NCURSES_SP_ARG);
+       if (old_pair < 0)
+           return;
+    }
 
-           T(("setting colors: pair = %d, fg = %d, bg = %d", pair, fg, bg));
+#if NCURSES_EXT_FUNCS
+    if (isDefaultColor(fg))
+       fg = (short) default_fg(NCURSES_SP_ARG);
+    if (isDefaultColor(bg))
+       bg = (short) default_bg(NCURSES_SP_ARG);
+#endif
+
+    if (reverse) {
+       NCURSES_COLOR_T xx = fg;
+       fg = bg;
+       bg = xx;
+    }
 
-           if (fg == C_MASK || bg == C_MASK)
-           {
-               if (set_original_colors() != TRUE)
-               {
-                       if (fg == C_MASK)
-                               set_foreground_color(COLOR_WHITE, outc);
-                       if (bg == C_MASK)
-                               set_background_color(COLOR_BLACK, outc);
-               }
-           }
-           if (fg != C_MASK)
-           {
-               set_foreground_color(fg, outc);
-           }
-           if (bg != C_MASK)
-           {
-               set_background_color(bg, outc);
-           }
-       }
+    TR(TRACE_ATTRS, ("setting colors: pair = %d, fg = %d, bg = %d", pair,
+                    fg, bg));
+
+    if (!isDefaultColor(fg)) {
+       set_foreground_color(NCURSES_SP_ARGx fg, outc);
     }
+    if (!isDefaultColor(bg)) {
+       set_background_color(NCURSES_SP_ARGx bg, outc);
+    }
+#endif
+}
+
+#if NCURSES_SP_FUNCS
+NCURSES_EXPORT(void)
+_nc_do_color(short old_pair, short pair, bool reverse, NCURSES_OUTC outc)
+{
+    SetSafeOutcWrapper(outc);
+    NCURSES_SP_NAME(_nc_do_color) (CURRENT_SCREEN,
+                                  old_pair,
+                                  pair,
+                                  reverse,
+                                  _nc_outc_wrapper);
 }
+#endif