ncurses/base/lib_color.c

   1 /****************************************************************************
   2  * Copyright (c) 1998-2011,2012 Free Software Foundation, Inc.              *
   3  *                                                                          *
   4  * Permission is hereby granted, free of charge, to any person obtaining a  *
   5  * copy of this software and associated documentation files (the            *
   6  * "Software"), to deal in the Software without restriction, including      *
   7  * without limitation the rights to use, copy, modify, merge, publish,      *
   8  * distribute, distribute with modifications, sublicense, and/or sell       *
   9  * copies of the Software, and to permit persons to whom the Software is    *
  10  * furnished to do so, subject to the following conditions:                 *
  11  *                                                                          *
  12  * The above copyright notice and this permission notice shall be included  *
  13  * in all copies or substantial portions of the Software.                   *
  14  *                                                                          *
  15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS  *
  16  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF               *
  17  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.   *
  18  * IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,   *
  19  * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR    *
  20  * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR    *
  21  * THE USE OR OTHER DEALINGS IN THE SOFTWARE.                               *
  22  *                                                                          *
  23  * Except as contained in this notice, the name(s) of the above copyright   *
  24  * holders shall not be used in advertising or otherwise to promote the     *
  25  * sale, use or other dealings in this Software without prior written       *
  26  * authorization.                                                           *
  27  ****************************************************************************/
  28
  29 /****************************************************************************
  30  *  Author: Zeyd M. Ben-Halim <zmbenhal@netcom.com> 1992,1995               *
  31  *     and: Eric S. Raymond <esr@snark.thyrsus.com>                         *
  32  *     and: Thomas E. Dickey                        1996-on                 *
  33  *     and: Juergen Pfeifer                         2009                    *
  34  ****************************************************************************/
  35
  36 /* lib_color.c
  37  *
  38  * Handles color emulation of SYS V curses
  39  */
  40
  41 #include <curses.priv.h>
  42 #include <tic.h>
  43
  44 #ifndef CUR
  45 #define CUR SP_TERMTYPE
  46 #endif
  47
  48 MODULE_ID("$Id: lib_color.c,v 1.106 2012/12/15 19:14:34 tom Exp $")
  49
  50 #ifdef USE_TERM_DRIVER
  51 #define CanChange      InfoOf(SP_PARM).canchange
  52 #define DefaultPalette InfoOf(SP_PARM).defaultPalette
  53 #define HasColor       InfoOf(SP_PARM).hascolor
  54 #define InitColor      InfoOf(SP_PARM).initcolor
  55 #define MaxColors      InfoOf(SP_PARM).maxcolors
  56 #define MaxPairs       InfoOf(SP_PARM).maxpairs
  57 #define UseHlsPalette  (DefaultPalette == _nc_hls_palette)
  58 #else
  59 #define CanChange      can_change
  60 #define DefaultPalette (hue_lightness_saturation ? hls_palette : cga_palette)
  61 #define HasColor       has_color
  62 #define InitColor      initialize_color
  63 #define MaxColors      max_colors
  64 #define MaxPairs       max_pairs
  65 #define UseHlsPalette  (hue_lightness_saturation)
  66 #endif
  67
  68 #ifndef USE_TERM_DRIVER
  69 /*
  70  * These should be screen structure members.  They need to be globals for
  71  * historical reasons.  So we assign them in start_color() and also in
  72  * set_term()'s screen-switching logic.
  73  */
  74 #if USE_REENTRANT
  75 NCURSES_EXPORT(int)
  76 NCURSES_PUBLIC_VAR(COLOR_PAIRS) (void)
  77 {
  78     return SP ? SP->_pair_count : -1;
  79 }
  80 NCURSES_EXPORT(int)
  81 NCURSES_PUBLIC_VAR(COLORS) (void)
  82 {
  83     return SP ? SP->_color_count : -1;
  84 }
  85 #else
  86 NCURSES_EXPORT_VAR(int) COLOR_PAIRS = 0;
  87 NCURSES_EXPORT_VAR(int) COLORS = 0;
  88 #endif
  89 #endif /* !USE_TERM_DRIVER */
  90
  91 #define DATA(r,g,b) {r,g,b, 0,0,0, 0}
  92
  93 #define TYPE_CALLOC(type,elts) typeCalloc(type, (unsigned)(elts))
  94
  95 #define MAX_PALETTE     8
  96
  97 #define OkColorHi(n)    (((n) < COLORS) && ((n) < maxcolors))
  98 #define InPalette(n)    ((n) >= 0 && (n) < MAX_PALETTE)
  99
 100 /*
 101  * Given a RGB range of 0..1000, we'll normally set the individual values
 102  * to about 2/3 of the maximum, leaving full-range for bold/bright colors.
 103  */
 104 #define RGB_ON  680
 105 #define RGB_OFF 0
 106 /* *INDENT-OFF* */
 107 static const color_t cga_palette[] =
 108 {
 109     /*  R               G               B */
 110     DATA(RGB_OFF,       RGB_OFF,        RGB_OFF),       /* COLOR_BLACK */
 111     DATA(RGB_ON,        RGB_OFF,        RGB_OFF),       /* COLOR_RED */
 112     DATA(RGB_OFF,       RGB_ON,         RGB_OFF),       /* COLOR_GREEN */
 113     DATA(RGB_ON,        RGB_ON,         RGB_OFF),       /* COLOR_YELLOW */
 114     DATA(RGB_OFF,       RGB_OFF,        RGB_ON),        /* COLOR_BLUE */
 115     DATA(RGB_ON,        RGB_OFF,        RGB_ON),        /* COLOR_MAGENTA */
 116     DATA(RGB_OFF,       RGB_ON,         RGB_ON),        /* COLOR_CYAN */
 117     DATA(RGB_ON,        RGB_ON,         RGB_ON),        /* COLOR_WHITE */
 118 };
 119
 120 static const color_t hls_palette[] =
 121 {
 122     /*          H       L       S */
 123     DATA(       0,      0,      0),             /* COLOR_BLACK */
 124     DATA(       120,    50,     100),           /* COLOR_RED */
 125     DATA(       240,    50,     100),           /* COLOR_GREEN */
 126     DATA(       180,    50,     100),           /* COLOR_YELLOW */
 127     DATA(       330,    50,     100),           /* COLOR_BLUE */
 128     DATA(       60,     50,     100),           /* COLOR_MAGENTA */
 129     DATA(       300,    50,     100),           /* COLOR_CYAN */
 130     DATA(       0,      50,     100),           /* COLOR_WHITE */
 131 };
 132
 133 #ifdef USE_TERM_DRIVER
 134 NCURSES_EXPORT_VAR(const color_t*) _nc_cga_palette = cga_palette;
 135 NCURSES_EXPORT_VAR(const color_t*) _nc_hls_palette = hls_palette;
 136 #endif
 137
 138 /* *INDENT-ON* */
 139
 140 /*
 141  * Ensure that we use color pairs only when colors have been started, and also
 142  * that the index is within the limits of the table which we allocated.
 143  */
 144 #define ValidPair(pair) \
 145     ((SP_PARM != 0) && (pair >= 0) && (pair < SP_PARM->_pair_limit) && SP_PARM->_coloron)
 146
 147 #if NCURSES_EXT_FUNCS
 148 /*
 149  * These are called from _nc_do_color(), which in turn is called from
 150  * vidattr - so we have to assume that sp may be null.
 151  */
 152 static int
 153 default_fg(NCURSES_SP_DCL0)
 154 {
 155     return (SP_PARM != 0) ? SP_PARM->_default_fg : COLOR_WHITE;
 156 }
 157
 158 static int
 159 default_bg(NCURSES_SP_DCL0)
 160 {
 161     return SP_PARM != 0 ? SP_PARM->_default_bg : COLOR_BLACK;
 162 }
 163 #else
 164 #define default_fg(sp) COLOR_WHITE
 165 #define default_bg(sp) COLOR_BLACK
 166 #endif
 167
 168 #ifndef USE_TERM_DRIVER
 169 /*
 170  * SVr4 curses is known to interchange color codes (1,4) and (3,6), possibly
 171  * to maintain compatibility with a pre-ANSI scheme.  The same scheme is
 172  * also used in the FreeBSD syscons.
 173  */
 174 static int
 175 toggled_colors(int c)
 176 {
 177     if (c < 16) {
 178         static const int table[] =
 179         {0, 4, 2, 6, 1, 5, 3, 7,
 180          8, 12, 10, 14, 9, 13, 11, 15};
 181         c = table[c];
 182     }
 183     return c;
 184 }
 185 #endif
 186
 187 static void
 188 set_background_color(NCURSES_SP_DCLx int bg, NCURSES_SP_OUTC outc)
 189 {
 190 #ifdef USE_TERM_DRIVER
 191     CallDriver_3(SP_PARM, color, FALSE, bg, outc);
 192 #else
 193     if (set_a_background) {
 194         TPUTS_TRACE("set_a_background");
 195         NCURSES_SP_NAME(tputs) (NCURSES_SP_ARGx
 196                                 TPARM_1(set_a_background, bg),
 197                                 1, outc);
 198     } else {
 199         TPUTS_TRACE("set_background");
 200         NCURSES_SP_NAME(tputs) (NCURSES_SP_ARGx
 201                                 TPARM_1(set_background, toggled_colors(bg)),
 202                                 1, outc);
 203     }
 204 #endif
 205 }
 206
 207 static void
 208 set_foreground_color(NCURSES_SP_DCLx int fg, NCURSES_SP_OUTC outc)
 209 {
 210 #ifdef USE_TERM_DRIVER
 211     CallDriver_3(SP_PARM, color, TRUE, fg, outc);
 212 #else
 213     if (set_a_foreground) {
 214         TPUTS_TRACE("set_a_foreground");
 215         NCURSES_SP_NAME(tputs) (NCURSES_SP_ARGx
 216                                 TPARM_1(set_a_foreground, fg),
 217                                 1, outc);
 218     } else {
 219         TPUTS_TRACE("set_foreground");
 220         NCURSES_SP_NAME(tputs) (NCURSES_SP_ARGx
 221                                 TPARM_1(set_foreground, toggled_colors(fg)),
 222                                 1, outc);
 223     }
 224 #endif
 225 }
 226
 227 static void
 228 init_color_table(NCURSES_SP_DCL0)
 229 {
 230     const color_t *tp = DefaultPalette;
 231     int n;
 232
 233     assert(tp != 0);
 234
 235     for (n = 0; n < COLORS; n++) {
 236         if (InPalette(n)) {
 237             SP_PARM->_color_table[n] = tp[n];
 238         } else {
 239             SP_PARM->_color_table[n] = tp[n % MAX_PALETTE];
 240             if (UseHlsPalette) {
 241                 SP_PARM->_color_table[n].green = 100;
 242             } else {
 243                 if (SP_PARM->_color_table[n].red)
 244                     SP_PARM->_color_table[n].red = 1000;
 245                 if (SP_PARM->_color_table[n].green)
 246                     SP_PARM->_color_table[n].green = 1000;
 247                 if (SP_PARM->_color_table[n].blue)
 248                     SP_PARM->_color_table[n].blue = 1000;
 249             }
 250         }
 251     }
 252 }
 253
 254 /*
 255  * Reset the color pair, e.g., to whatever color pair 0 is.
 256  */
 257 static bool
 258 reset_color_pair(NCURSES_SP_DCL0)
 259 {
 260 #ifdef USE_TERM_DRIVER
 261     return CallDriver(SP_PARM, rescol);
 262 #else
 263     bool result = FALSE;
 264
 265     (void) SP_PARM;
 266     if (orig_pair != 0) {
 267         TPUTS_TRACE("orig_pair");
 268         putp(orig_pair);
 269         result = TRUE;
 270     }
 271     return result;
 272 #endif
 273 }
 274
 275 /*
 276  * Reset color pairs and definitions.  Actually we do both more to accommodate
 277  * badly-written terminal descriptions than for the relatively rare case where
 278  * someone has changed the color definitions.
 279  */
 280 NCURSES_EXPORT(bool)
 281 NCURSES_SP_NAME(_nc_reset_colors) (NCURSES_SP_DCL0)
 282 {
 283     int result = FALSE;
 284
 285     T((T_CALLED("_nc_reset_colors(%p)"), (void *) SP_PARM));
 286     if (SP_PARM->_color_defs > 0)
 287         SP_PARM->_color_defs = -(SP_PARM->_color_defs);
 288     if (reset_color_pair(NCURSES_SP_ARG))
 289         result = TRUE;
 290
 291 #ifdef USE_TERM_DRIVER
 292     result = CallDriver(SP_PARM, rescolors);
 293 #else
 294     if (orig_colors != 0) {
 295         TPUTS_TRACE("orig_colors");
 296         putp(orig_colors);
 297         result = TRUE;
 298     }
 299 #endif
 300     returnBool(result);
 301 }
 302
 303 #if NCURSES_SP_FUNCS
 304 NCURSES_EXPORT(bool)
 305 _nc_reset_colors(void)
 306 {
 307     return NCURSES_SP_NAME(_nc_reset_colors) (CURRENT_SCREEN);
 308 }
 309 #endif
 310
 311 NCURSES_EXPORT(int)
 312 NCURSES_SP_NAME(start_color) (NCURSES_SP_DCL0)
 313 {
 314     int result = ERR;
 315     int maxpairs = 0, maxcolors = 0;
 316
 317     T((T_CALLED("start_color(%p)"), (void *) SP_PARM));
 318
 319     if (SP_PARM == 0) {
 320         result = ERR;
 321     } else if (SP_PARM->_coloron) {
 322         result = OK;
 323     } else {
 324         maxpairs = MaxPairs;
 325         maxcolors = MaxColors;
 326         if (reset_color_pair(NCURSES_SP_ARG) != TRUE) {
 327             set_foreground_color(NCURSES_SP_ARGx
 328                                  default_fg(NCURSES_SP_ARG),
 329                                  NCURSES_SP_NAME(_nc_outch));
 330             set_background_color(NCURSES_SP_ARGx
 331                                  default_bg(NCURSES_SP_ARG),
 332                                  NCURSES_SP_NAME(_nc_outch));
 333         }
 334 #if !NCURSES_EXT_COLORS
 335         /*
 336          * Without ext-colors, we cannot represent more than 256 color pairs.
 337          */
 338         if (maxpairs > 256)
 339             maxpairs = 256;
 340 #endif
 341
 342         if (maxpairs > 0 && maxcolors > 0) {
 343             SP_PARM->_pair_limit = maxpairs;
 344
 345 #if NCURSES_EXT_FUNCS
 346             /*
 347              * If using default colors, allocate extra space in table to
 348              * allow for default-color as a component of a color-pair.
 349              */
 350             SP_PARM->_pair_limit += (1 + (2 * maxcolors));
 351 #endif
 352             SP_PARM->_pair_count = maxpairs;
 353             SP_PARM->_color_count = maxcolors;
 354 #if !USE_REENTRANT
 355             COLOR_PAIRS = maxpairs;
 356             COLORS = maxcolors;
 357 #endif
 358
 359             SP_PARM->_color_pairs = TYPE_CALLOC(colorpair_t, SP_PARM->_pair_limit);
 360             if (SP_PARM->_color_pairs != 0) {
 361                 SP_PARM->_color_table = TYPE_CALLOC(color_t, maxcolors);
 362                 if (SP_PARM->_color_table != 0) {
 363                     SP_PARM->_color_pairs[0] = PAIR_OF(default_fg(NCURSES_SP_ARG),
 364                                                        default_bg(NCURSES_SP_ARG));
 365                     init_color_table(NCURSES_SP_ARG);
 366
 367                     T(("started color: COLORS = %d, COLOR_PAIRS = %d",
 368                        COLORS, COLOR_PAIRS));
 369
 370                     SP_PARM->_coloron = 1;
 371                     result = OK;
 372                 } else if (SP_PARM->_color_pairs != 0) {
 373                     FreeAndNull(SP_PARM->_color_pairs);
 374                 }
 375             }
 376         } else {
 377             result = OK;
 378         }
 379     }
 380     returnCode(result);
 381 }
 382
 383 #if NCURSES_SP_FUNCS
 384 NCURSES_EXPORT(int)
 385 start_color(void)
 386 {
 387     return NCURSES_SP_NAME(start_color) (CURRENT_SCREEN);
 388 }
 389 #endif
 390
 391 /* This function was originally written by Daniel Weaver <danw@znyx.com> */
 392 static void
 393 rgb2hls(int r, int g, int b, short *h, short *l, short *s)
 394 /* convert RGB to HLS system */
 395 {
 396     int min, max, t;
 397
 398     if ((min = g < r ? g : r) > b)
 399         min = b;
 400     if ((max = g > r ? g : r) < b)
 401         max = b;
 402
 403     /* calculate lightness */
 404     *l = (short) ((min + max) / 20);
 405
 406     if (min == max) {           /* black, white and all shades of gray */
 407         *h = 0;
 408         *s = 0;
 409         return;
 410     }
 411
 412     /* calculate saturation */
 413     if (*l < 50)
 414         *s = (short) (((max - min) * 100) / (max + min));
 415     else
 416         *s = (short) (((max - min) * 100) / (2000 - max - min));
 417
 418     /* calculate hue */
 419     if (r == max)
 420         t = (short) (120 + ((g - b) * 60) / (max - min));
 421     else if (g == max)
 422         t = (short) (240 + ((b - r) * 60) / (max - min));
 423     else
 424         t = (short) (360 + ((r - g) * 60) / (max - min));
 425
 426     *h = (short) (t % 360);
 427 }
 428
 429 /*
 430  * Extension (1997/1/18) - Allow negative f/b values to set default color
 431  * values.
 432  */
 433 NCURSES_EXPORT(int)
 434 NCURSES_SP_NAME(init_pair) (NCURSES_SP_DCLx short pair, short f, short b)
 435 {
 436     colorpair_t result;
 437     colorpair_t previous;
 438     int maxcolors;
 439
 440     T((T_CALLED("init_pair(%p,%d,%d,%d)"), (void *) SP_PARM, pair, f, b));
 441
 442     if (!ValidPair(pair))
 443         returnCode(ERR);
 444
 445     maxcolors = MaxColors;
 446
 447     previous = SP_PARM->_color_pairs[pair];
 448 #if NCURSES_EXT_FUNCS
 449     if (SP_PARM->_default_color || SP_PARM->_assumed_color) {
 450         bool isDefault = FALSE;
 451         bool wasDefault = FALSE;
 452         int default_pairs = SP_PARM->_default_pairs;
 453
 454         /*
 455          * Map caller's color number, e.g., -1, 0, 1, .., 7, etc., into
 456          * internal unsigned values which we will store in the _color_pairs[]
 457          * table.
 458          */
 459         if (isDefaultColor(f)) {
 460             f = COLOR_DEFAULT;
 461             isDefault = TRUE;
 462         } else if (!OkColorHi(f)) {
 463             returnCode(ERR);
 464         }
 465
 466         if (isDefaultColor(b)) {
 467             b = COLOR_DEFAULT;
 468             isDefault = TRUE;
 469         } else if (!OkColorHi(b)) {
 470             returnCode(ERR);
 471         }
 472
 473         /*
 474          * Check if the table entry that we are going to init/update used
 475          * default colors.
 476          */
 477         if ((FORE_OF(previous) == COLOR_DEFAULT)
 478             || (BACK_OF(previous) == COLOR_DEFAULT))
 479             wasDefault = TRUE;
 480
 481         /*
 482          * Keep track of the number of entries in the color pair table which
 483          * used a default color.
 484          */
 485         if (isDefault && !wasDefault) {
 486             ++default_pairs;
 487         } else if (wasDefault && !isDefault) {
 488             --default_pairs;
 489         }
 490
 491         /*
 492          * As an extension, ncurses allows the pair number to exceed the
 493          * terminal's color_pairs value for pairs using a default color.
 494          *
 495          * Note that updating a pair which used a default color with one
 496          * that does not will decrement the count - and possibly interfere
 497          * with sequentially adding new pairs.
 498          */
 499         if (pair > (SP_PARM->_pair_count + default_pairs)) {
 500             returnCode(ERR);
 501         }
 502         SP_PARM->_default_pairs = default_pairs;
 503     } else
 504 #endif
 505     {
 506         if ((f < 0) || !OkColorHi(f)
 507             || (b < 0) || !OkColorHi(b)
 508             || (pair < 1)) {
 509             returnCode(ERR);
 510         }
 511     }
 512
 513     /*
 514      * When a pair's content is changed, replace its colors (if pair was
 515      * initialized before a screen update is performed replacing original
 516      * pair colors with the new ones).
 517      */
 518     result = PAIR_OF(f, b);
 519     if (previous != 0
 520         && previous != result) {
 521         int y, x;
 522
 523         for (y = 0; y <= CurScreen(SP_PARM)->_maxy; y++) {
 524             struct ldat *ptr = &(CurScreen(SP_PARM)->_line[y]);
 525             bool changed = FALSE;
 526             for (x = 0; x <= CurScreen(SP_PARM)->_maxx; x++) {
 527                 if (GetPair(ptr->text[x]) == pair) {
 528                     /* Set the old cell to zero to ensure it will be
 529                        updated on the next doupdate() */
 530                     SetChar(ptr->text[x], 0, 0);
 531                     CHANGED_CELL(ptr, x);
 532                     changed = TRUE;
 533                 }
 534             }
 535             if (changed)
 536                 NCURSES_SP_NAME(_nc_make_oldhash) (NCURSES_SP_ARGx y);
 537         }
 538     }
 539
 540     SP_PARM->_color_pairs[pair] = result;
 541     if (GET_SCREEN_PAIR(SP_PARM) == pair)
 542         SET_SCREEN_PAIR(SP_PARM, (chtype) (~0));        /* force attribute update */
 543
 544 #ifdef USE_TERM_DRIVER
 545     CallDriver_3(SP_PARM, initpair, pair, f, b);
 546 #else
 547     if (initialize_pair && InPalette(f) && InPalette(b)) {
 548         const color_t *tp = DefaultPalette;
 549
 550         TR(TRACE_ATTRS,
 551            ("initializing pair: pair = %d, fg=(%d,%d,%d), bg=(%d,%d,%d)",
 552             pair,
 553             tp[f].red, tp[f].green, tp[f].blue,
 554             tp[b].red, tp[b].green, tp[b].blue));
 555
 556         TPUTS_TRACE("initialize_pair");
 557         putp(TPARM_7(initialize_pair,
 558                      pair,
 559                      tp[f].red, tp[f].green, tp[f].blue,
 560                      tp[b].red, tp[b].green, tp[b].blue));
 561     }
 562 #endif
 563
 564     returnCode(OK);
 565 }
 566
 567 #if NCURSES_SP_FUNCS
 568 NCURSES_EXPORT(int)
 569 init_pair(short pair, short f, short b)
 570 {
 571     return NCURSES_SP_NAME(init_pair) (CURRENT_SCREEN, pair, f, b);
 572 }
 573 #endif
 574
 575 #define okRGB(n) ((n) >= 0 && (n) <= 1000)
 576
 577 NCURSES_EXPORT(int)
 578 NCURSES_SP_NAME(init_color) (NCURSES_SP_DCLx
 579                              short color, short r, short g, short b)
 580 {
 581     int result = ERR;
 582     int maxcolors;
 583
 584     T((T_CALLED("init_color(%p,%d,%d,%d,%d)"),
 585        (void *) SP_PARM,
 586        color,
 587        r, g, b));
 588
 589     if (SP_PARM == 0)
 590         returnCode(result);
 591
 592     maxcolors = MaxColors;
 593
 594     if (InitColor
 595         && SP_PARM->_coloron
 596         && (color >= 0 && OkColorHi(color))
 597         && (okRGB(r) && okRGB(g) && okRGB(b))) {
 598
 599         SP_PARM->_color_table[color].init = 1;
 600         SP_PARM->_color_table[color].r = r;
 601         SP_PARM->_color_table[color].g = g;
 602         SP_PARM->_color_table[color].b = b;
 603
 604         if (UseHlsPalette) {
 605             rgb2hls(r, g, b,
 606                     &SP_PARM->_color_table[color].red,
 607                     &SP_PARM->_color_table[color].green,
 608                     &SP_PARM->_color_table[color].blue);
 609         } else {
 610             SP_PARM->_color_table[color].red = r;
 611             SP_PARM->_color_table[color].green = g;
 612             SP_PARM->_color_table[color].blue = b;
 613         }
 614
 615 #ifdef USE_TERM_DRIVER
 616         CallDriver_4(SP_PARM, initcolor, color, r, g, b);
 617 #else
 618         TPUTS_TRACE("initialize_color");
 619         putp(TPARM_4(initialize_color, color, r, g, b));
 620 #endif
 621         SP_PARM->_color_defs = max(color + 1, SP_PARM->_color_defs);
 622
 623         result = OK;
 624     }
 625     returnCode(result);
 626 }
 627
 628 #if NCURSES_SP_FUNCS
 629 NCURSES_EXPORT(int)
 630 init_color(short color, short r, short g, short b)
 631 {
 632     return NCURSES_SP_NAME(init_color) (CURRENT_SCREEN, color, r, g, b);
 633 }
 634 #endif
 635
 636 NCURSES_EXPORT(bool)
 637 NCURSES_SP_NAME(can_change_color) (NCURSES_SP_DCL)
 638 {
 639     int result = FALSE;
 640
 641     T((T_CALLED("can_change_color(%p)"), (void *) SP_PARM));
 642
 643     if (HasTerminal(SP_PARM) && (CanChange != 0)) {
 644         result = TRUE;
 645     }
 646
 647     returnCode(result);
 648 }
 649
 650 #if NCURSES_SP_FUNCS
 651 NCURSES_EXPORT(bool)
 652 can_change_color(void)
 653 {
 654     return NCURSES_SP_NAME(can_change_color) (CURRENT_SCREEN);
 655 }
 656 #endif
 657
 658 NCURSES_EXPORT(bool)
 659 NCURSES_SP_NAME(has_colors) (NCURSES_SP_DCL0)
 660 {
 661     int code = FALSE;
 662
 663     (void) SP_PARM;
 664     T((T_CALLED("has_colors()")));
 665     if (HasTerminal(SP_PARM)) {
 666 #ifdef USE_TERM_DRIVER
 667         code = HasColor;
 668 #else
 669         code = ((VALID_NUMERIC(max_colors) && VALID_NUMERIC(max_pairs)
 670                  && (((set_foreground != NULL)
 671                       && (set_background != NULL))
 672                      || ((set_a_foreground != NULL)
 673                          && (set_a_background != NULL))
 674                      || set_color_pair)) ? TRUE : FALSE);
 675 #endif
 676     }
 677     returnCode(code);
 678 }
 679
 680 #if NCURSES_SP_FUNCS
 681 NCURSES_EXPORT(bool)
 682 has_colors(void)
 683 {
 684     return NCURSES_SP_NAME(has_colors) (CURRENT_SCREEN);
 685 }
 686 #endif
 687
 688 NCURSES_EXPORT(int)
 689 NCURSES_SP_NAME(color_content) (NCURSES_SP_DCLx
 690                                 short color, short *r, short *g, short *b)
 691 {
 692     int result = ERR;
 693     int maxcolors;
 694
 695     T((T_CALLED("color_content(%p,%d,%p,%p,%p)"),
 696        (void *) SP_PARM,
 697        color,
 698        (void *) r,
 699        (void *) g,
 700        (void *) b));
 701
 702     if (SP_PARM == 0)
 703         returnCode(result);
 704
 705     maxcolors = MaxColors;
 706
 707     if (color < 0 || !OkColorHi(color) || !SP_PARM->_coloron) {
 708         result = ERR;
 709     } else {
 710         NCURSES_COLOR_T c_r = SP_PARM->_color_table[color].red;
 711         NCURSES_COLOR_T c_g = SP_PARM->_color_table[color].green;
 712         NCURSES_COLOR_T c_b = SP_PARM->_color_table[color].blue;
 713
 714         if (r)
 715             *r = c_r;
 716         if (g)
 717             *g = c_g;
 718         if (b)
 719             *b = c_b;
 720
 721         TR(TRACE_ATTRS, ("...color_content(%d,%d,%d,%d)",
 722                          color, c_r, c_g, c_b));
 723         result = OK;
 724     }
 725     returnCode(result);
 726 }
 727
 728 #if NCURSES_SP_FUNCS
 729 NCURSES_EXPORT(int)
 730 color_content(short color, short *r, short *g, short *b)
 731 {
 732     return NCURSES_SP_NAME(color_content) (CURRENT_SCREEN, color, r, g, b);
 733 }
 734 #endif
 735
 736 NCURSES_EXPORT(int)
 737 NCURSES_SP_NAME(pair_content) (NCURSES_SP_DCLx
 738                                short pair, short *f, short *b)
 739 {
 740     int result;
 741
 742     T((T_CALLED("pair_content(%p,%d,%p,%p)"),
 743        (void *) SP_PARM,
 744        pair,
 745        (void *) f,
 746        (void *) b));
 747
 748     if (!ValidPair(pair)) {
 749         result = ERR;
 750     } else {
 751         NCURSES_COLOR_T fg = (NCURSES_COLOR_T) FORE_OF(SP_PARM->_color_pairs[pair]);
 752         NCURSES_COLOR_T bg = (NCURSES_COLOR_T) BACK_OF(SP_PARM->_color_pairs[pair]);
 753
 754 #if NCURSES_EXT_FUNCS
 755         if (fg == COLOR_DEFAULT)
 756             fg = -1;
 757         if (bg == COLOR_DEFAULT)
 758             bg = -1;
 759 #endif
 760
 761         if (f)
 762             *f = fg;
 763         if (b)
 764             *b = bg;
 765
 766         TR(TRACE_ATTRS, ("...pair_content(%p,%d,%d,%d)",
 767                          (void *) SP_PARM,
 768                          pair,
 769                          fg, bg));
 770         result = OK;
 771     }
 772     returnCode(result);
 773 }
 774
 775 #if NCURSES_SP_FUNCS
 776 NCURSES_EXPORT(int)
 777 pair_content(short pair, short *f, short *b)
 778 {
 779     return NCURSES_SP_NAME(pair_content) (CURRENT_SCREEN, pair, f, b);
 780 }
 781 #endif
 782
 783 NCURSES_EXPORT(void)
 784 NCURSES_SP_NAME(_nc_do_color) (NCURSES_SP_DCLx
 785                                int old_pair,
 786                                int pair,
 787                                int reverse,
 788                                NCURSES_SP_OUTC outc)
 789 {
 790 #ifdef USE_TERM_DRIVER
 791     CallDriver_4(SP_PARM, docolor, old_pair, pair, reverse, outc);
 792 #else
 793     NCURSES_COLOR_T fg = COLOR_DEFAULT;
 794     NCURSES_COLOR_T bg = COLOR_DEFAULT;
 795     NCURSES_COLOR_T old_fg, old_bg;
 796
 797     if (!ValidPair(pair)) {
 798         return;
 799     } else if (pair != 0) {
 800         if (set_color_pair) {
 801             TPUTS_TRACE("set_color_pair");
 802             NCURSES_SP_NAME(tputs) (NCURSES_SP_ARGx
 803                                     TPARM_1(set_color_pair, pair),
 804                                     1, outc);
 805             return;
 806         } else if (SP_PARM != 0) {
 807             if (pair_content((short) pair, &fg, &bg) == ERR)
 808                 return;
 809         }
 810     }
 811
 812     if (old_pair >= 0
 813         && SP_PARM != 0
 814         && pair_content((short) old_pair, &old_fg, &old_bg) != ERR) {
 815         if ((isDefaultColor(fg) && !isDefaultColor(old_fg))
 816             || (isDefaultColor(bg) && !isDefaultColor(old_bg))) {
 817 #if NCURSES_EXT_FUNCS
 818             /*
 819              * A minor optimization - but extension.  If "AX" is specified in
 820              * the terminal description, treat it as screen's indicator of ECMA
 821              * SGR 39 and SGR 49, and assume the two sequences are independent.
 822              */
 823             if (SP_PARM->_has_sgr_39_49
 824                 && isDefaultColor(old_bg)
 825                 && !isDefaultColor(old_fg)) {
 826                 NCURSES_SP_NAME(tputs) (NCURSES_SP_ARGx "\033[39m", 1, outc);
 827             } else if (SP_PARM->_has_sgr_39_49
 828                        && isDefaultColor(old_fg)
 829                        && !isDefaultColor(old_bg)) {
 830                 NCURSES_SP_NAME(tputs) (NCURSES_SP_ARGx "\033[49m", 1, outc);
 831             } else
 832 #endif
 833                 reset_color_pair(NCURSES_SP_ARG);
 834         }
 835     } else {
 836         reset_color_pair(NCURSES_SP_ARG);
 837         if (old_pair < 0)
 838             return;
 839     }
 840
 841 #if NCURSES_EXT_FUNCS
 842     if (isDefaultColor(fg))
 843         fg = (short) default_fg(NCURSES_SP_ARG);
 844     if (isDefaultColor(bg))
 845         bg = (short) default_bg(NCURSES_SP_ARG);
 846 #endif
 847
 848     if (reverse) {
 849         NCURSES_COLOR_T xx = fg;
 850         fg = bg;
 851         bg = xx;
 852     }
 853
 854     TR(TRACE_ATTRS, ("setting colors: pair = %d, fg = %d, bg = %d", pair,
 855                      fg, bg));
 856
 857     if (!isDefaultColor(fg)) {
 858         set_foreground_color(NCURSES_SP_ARGx fg, outc);
 859     }
 860     if (!isDefaultColor(bg)) {
 861         set_background_color(NCURSES_SP_ARGx bg, outc);
 862     }
 863 #endif
 864 }
 865
 866 #if NCURSES_SP_FUNCS
 867 NCURSES_EXPORT(void)
 868 _nc_do_color(int old_pair, int pair, int reverse, NCURSES_OUTC outc)
 869 {
 870     SetSafeOutcWrapper(outc);
 871     NCURSES_SP_NAME(_nc_do_color) (CURRENT_SCREEN,
 872                                    old_pair,
 873                                    pair,
 874                                    reverse,
 875                                    _nc_outc_wrapper);
 876 }
 877 #endif