ncurses/base/lib_color.c

   1 /****************************************************************************
   2  * Copyright (c) 1998-2012,2013 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.108 2013/03/09 22:33:38 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         (void) NCURSES_PUTP2("orig_pair", orig_pair);
 268         result = TRUE;
 269     }
 270     return result;
 271 #endif
 272 }
 273
 274 /*
 275  * Reset color pairs and definitions.  Actually we do both more to accommodate
 276  * badly-written terminal descriptions than for the relatively rare case where
 277  * someone has changed the color definitions.
 278  */
 279 NCURSES_EXPORT(bool)
 280 NCURSES_SP_NAME(_nc_reset_colors) (NCURSES_SP_DCL0)
 281 {
 282     int result = FALSE;
 283
 284     T((T_CALLED("_nc_reset_colors(%p)"), (void *) SP_PARM));
 285     if (SP_PARM->_color_defs > 0)
 286         SP_PARM->_color_defs = -(SP_PARM->_color_defs);
 287     if (reset_color_pair(NCURSES_SP_ARG))
 288         result = TRUE;
 289
 290 #ifdef USE_TERM_DRIVER
 291     result = CallDriver(SP_PARM, rescolors);
 292 #else
 293     if (orig_colors != 0) {
 294         NCURSES_PUTP2("orig_colors", orig_colors);
 295         result = TRUE;
 296     }
 297 #endif
 298     returnBool(result);
 299 }
 300
 301 #if NCURSES_SP_FUNCS
 302 NCURSES_EXPORT(bool)
 303 _nc_reset_colors(void)
 304 {
 305     return NCURSES_SP_NAME(_nc_reset_colors) (CURRENT_SCREEN);
 306 }
 307 #endif
 308
 309 NCURSES_EXPORT(int)
 310 NCURSES_SP_NAME(start_color) (NCURSES_SP_DCL0)
 311 {
 312     int result = ERR;
 313     int maxpairs = 0, maxcolors = 0;
 314
 315     T((T_CALLED("start_color(%p)"), (void *) SP_PARM));
 316
 317     if (SP_PARM == 0) {
 318         result = ERR;
 319     } else if (SP_PARM->_coloron) {
 320         result = OK;
 321     } else {
 322         maxpairs = MaxPairs;
 323         maxcolors = MaxColors;
 324         if (reset_color_pair(NCURSES_SP_ARG) != TRUE) {
 325             set_foreground_color(NCURSES_SP_ARGx
 326                                  default_fg(NCURSES_SP_ARG),
 327                                  NCURSES_SP_NAME(_nc_outch));
 328             set_background_color(NCURSES_SP_ARGx
 329                                  default_bg(NCURSES_SP_ARG),
 330                                  NCURSES_SP_NAME(_nc_outch));
 331         }
 332 #if !NCURSES_EXT_COLORS
 333         /*
 334          * Without ext-colors, we cannot represent more than 256 color pairs.
 335          */
 336         if (maxpairs > 256)
 337             maxpairs = 256;
 338 #endif
 339
 340         if (maxpairs > 0 && maxcolors > 0) {
 341             SP_PARM->_pair_limit = maxpairs;
 342
 343 #if NCURSES_EXT_FUNCS
 344             /*
 345              * If using default colors, allocate extra space in table to
 346              * allow for default-color as a component of a color-pair.
 347              */
 348             SP_PARM->_pair_limit += (1 + (2 * maxcolors));
 349 #endif
 350             SP_PARM->_pair_count = maxpairs;
 351             SP_PARM->_color_count = maxcolors;
 352 #if !USE_REENTRANT
 353             COLOR_PAIRS = maxpairs;
 354             COLORS = maxcolors;
 355 #endif
 356
 357             SP_PARM->_color_pairs = TYPE_CALLOC(colorpair_t, SP_PARM->_pair_limit);
 358             if (SP_PARM->_color_pairs != 0) {
 359                 SP_PARM->_color_table = TYPE_CALLOC(color_t, maxcolors);
 360                 if (SP_PARM->_color_table != 0) {
 361                     SP_PARM->_color_pairs[0] = PAIR_OF(default_fg(NCURSES_SP_ARG),
 362                                                        default_bg(NCURSES_SP_ARG));
 363                     init_color_table(NCURSES_SP_ARG);
 364
 365                     T(("started color: COLORS = %d, COLOR_PAIRS = %d",
 366                        COLORS, COLOR_PAIRS));
 367
 368                     SP_PARM->_coloron = 1;
 369                     result = OK;
 370                 } else if (SP_PARM->_color_pairs != 0) {
 371                     FreeAndNull(SP_PARM->_color_pairs);
 372                 }
 373             }
 374         } else {
 375             result = OK;
 376         }
 377     }
 378     returnCode(result);
 379 }
 380
 381 #if NCURSES_SP_FUNCS
 382 NCURSES_EXPORT(int)
 383 start_color(void)
 384 {
 385     return NCURSES_SP_NAME(start_color) (CURRENT_SCREEN);
 386 }
 387 #endif
 388
 389 /* This function was originally written by Daniel Weaver <danw@znyx.com> */
 390 static void
 391 rgb2hls(int r, int g, int b, short *h, short *l, short *s)
 392 /* convert RGB to HLS system */
 393 {
 394     int min, max, t;
 395
 396     if ((min = g < r ? g : r) > b)
 397         min = b;
 398     if ((max = g > r ? g : r) < b)
 399         max = b;
 400
 401     /* calculate lightness */
 402     *l = (short) ((min + max) / 20);
 403
 404     if (min == max) {           /* black, white and all shades of gray */
 405         *h = 0;
 406         *s = 0;
 407         return;
 408     }
 409
 410     /* calculate saturation */
 411     if (*l < 50)
 412         *s = (short) (((max - min) * 100) / (max + min));
 413     else
 414         *s = (short) (((max - min) * 100) / (2000 - max - min));
 415
 416     /* calculate hue */
 417     if (r == max)
 418         t = (short) (120 + ((g - b) * 60) / (max - min));
 419     else if (g == max)
 420         t = (short) (240 + ((b - r) * 60) / (max - min));
 421     else
 422         t = (short) (360 + ((r - g) * 60) / (max - min));
 423
 424     *h = (short) (t % 360);
 425 }
 426
 427 /*
 428  * Extension (1997/1/18) - Allow negative f/b values to set default color
 429  * values.
 430  */
 431 NCURSES_EXPORT(int)
 432 NCURSES_SP_NAME(init_pair) (NCURSES_SP_DCLx short pair, short f, short b)
 433 {
 434     colorpair_t result;
 435     colorpair_t previous;
 436     int maxcolors;
 437
 438     T((T_CALLED("init_pair(%p,%d,%d,%d)"), (void *) SP_PARM, pair, f, b));
 439
 440     if (!ValidPair(pair))
 441         returnCode(ERR);
 442
 443     maxcolors = MaxColors;
 444
 445     previous = SP_PARM->_color_pairs[pair];
 446 #if NCURSES_EXT_FUNCS
 447     if (SP_PARM->_default_color || SP_PARM->_assumed_color) {
 448         bool isDefault = FALSE;
 449         bool wasDefault = FALSE;
 450         int default_pairs = SP_PARM->_default_pairs;
 451
 452         /*
 453          * Map caller's color number, e.g., -1, 0, 1, .., 7, etc., into
 454          * internal unsigned values which we will store in the _color_pairs[]
 455          * table.
 456          */
 457         if (isDefaultColor(f)) {
 458             f = COLOR_DEFAULT;
 459             isDefault = TRUE;
 460         } else if (!OkColorHi(f)) {
 461             returnCode(ERR);
 462         }
 463
 464         if (isDefaultColor(b)) {
 465             b = COLOR_DEFAULT;
 466             isDefault = TRUE;
 467         } else if (!OkColorHi(b)) {
 468             returnCode(ERR);
 469         }
 470
 471         /*
 472          * Check if the table entry that we are going to init/update used
 473          * default colors.
 474          */
 475         if ((FORE_OF(previous) == COLOR_DEFAULT)
 476             || (BACK_OF(previous) == COLOR_DEFAULT))
 477             wasDefault = TRUE;
 478
 479         /*
 480          * Keep track of the number of entries in the color pair table which
 481          * used a default color.
 482          */
 483         if (isDefault && !wasDefault) {
 484             ++default_pairs;
 485         } else if (wasDefault && !isDefault) {
 486             --default_pairs;
 487         }
 488
 489         /*
 490          * As an extension, ncurses allows the pair number to exceed the
 491          * terminal's color_pairs value for pairs using a default color.
 492          *
 493          * Note that updating a pair which used a default color with one
 494          * that does not will decrement the count - and possibly interfere
 495          * with sequentially adding new pairs.
 496          */
 497         if (pair > (SP_PARM->_pair_count + default_pairs)) {
 498             returnCode(ERR);
 499         }
 500         SP_PARM->_default_pairs = default_pairs;
 501     } else
 502 #endif
 503     {
 504         if ((f < 0) || !OkColorHi(f)
 505             || (b < 0) || !OkColorHi(b)
 506             || (pair < 1)) {
 507             returnCode(ERR);
 508         }
 509     }
 510
 511     /*
 512      * When a pair's content is changed, replace its colors (if pair was
 513      * initialized before a screen update is performed replacing original
 514      * pair colors with the new ones).
 515      */
 516     result = PAIR_OF(f, b);
 517     if (previous != 0
 518         && previous != result) {
 519         int y, x;
 520
 521         for (y = 0; y <= CurScreen(SP_PARM)->_maxy; y++) {
 522             struct ldat *ptr = &(CurScreen(SP_PARM)->_line[y]);
 523             bool changed = FALSE;
 524             for (x = 0; x <= CurScreen(SP_PARM)->_maxx; x++) {
 525                 if (GetPair(ptr->text[x]) == pair) {
 526                     /* Set the old cell to zero to ensure it will be
 527                        updated on the next doupdate() */
 528                     SetChar(ptr->text[x], 0, 0);
 529                     CHANGED_CELL(ptr, x);
 530                     changed = TRUE;
 531                 }
 532             }
 533             if (changed)
 534                 NCURSES_SP_NAME(_nc_make_oldhash) (NCURSES_SP_ARGx y);
 535         }
 536     }
 537
 538     SP_PARM->_color_pairs[pair] = result;
 539     if (GET_SCREEN_PAIR(SP_PARM) == pair)
 540         SET_SCREEN_PAIR(SP_PARM, (chtype) (~0));        /* force attribute update */
 541
 542 #ifdef USE_TERM_DRIVER
 543     CallDriver_3(SP_PARM, initpair, pair, f, b);
 544 #else
 545     if (initialize_pair && InPalette(f) && InPalette(b)) {
 546         const color_t *tp = DefaultPalette;
 547
 548         TR(TRACE_ATTRS,
 549            ("initializing pair: pair = %d, fg=(%d,%d,%d), bg=(%d,%d,%d)",
 550             pair,
 551             tp[f].red, tp[f].green, tp[f].blue,
 552             tp[b].red, tp[b].green, tp[b].blue));
 553
 554         NCURSES_PUTP2("initialize_pair",
 555                       TPARM_7(initialize_pair,
 556                               pair,
 557                               tp[f].red, tp[f].green, tp[f].blue,
 558                               tp[b].red, tp[b].green, tp[b].blue));
 559     }
 560 #endif
 561
 562     returnCode(OK);
 563 }
 564
 565 #if NCURSES_SP_FUNCS
 566 NCURSES_EXPORT(int)
 567 init_pair(short pair, short f, short b)
 568 {
 569     return NCURSES_SP_NAME(init_pair) (CURRENT_SCREEN, pair, f, b);
 570 }
 571 #endif
 572
 573 #define okRGB(n) ((n) >= 0 && (n) <= 1000)
 574
 575 NCURSES_EXPORT(int)
 576 NCURSES_SP_NAME(init_color) (NCURSES_SP_DCLx
 577                              short color, short r, short g, short b)
 578 {
 579     int result = ERR;
 580     int maxcolors;
 581
 582     T((T_CALLED("init_color(%p,%d,%d,%d,%d)"),
 583        (void *) SP_PARM,
 584        color,
 585        r, g, b));
 586
 587     if (SP_PARM == 0)
 588         returnCode(result);
 589
 590     maxcolors = MaxColors;
 591
 592     if (InitColor
 593         && SP_PARM->_coloron
 594         && (color >= 0 && OkColorHi(color))
 595         && (okRGB(r) && okRGB(g) && okRGB(b))) {
 596
 597         SP_PARM->_color_table[color].init = 1;
 598         SP_PARM->_color_table[color].r = r;
 599         SP_PARM->_color_table[color].g = g;
 600         SP_PARM->_color_table[color].b = b;
 601
 602         if (UseHlsPalette) {
 603             rgb2hls(r, g, b,
 604                     &SP_PARM->_color_table[color].red,
 605                     &SP_PARM->_color_table[color].green,
 606                     &SP_PARM->_color_table[color].blue);
 607         } else {
 608             SP_PARM->_color_table[color].red = r;
 609             SP_PARM->_color_table[color].green = g;
 610             SP_PARM->_color_table[color].blue = b;
 611         }
 612
 613 #ifdef USE_TERM_DRIVER
 614         CallDriver_4(SP_PARM, initcolor, color, r, g, b);
 615 #else
 616         NCURSES_PUTP2("initialize_color",
 617                       TPARM_4(initialize_color, color, r, g, b));
 618 #endif
 619         SP_PARM->_color_defs = max(color + 1, SP_PARM->_color_defs);
 620
 621         result = OK;
 622     }
 623     returnCode(result);
 624 }
 625
 626 #if NCURSES_SP_FUNCS
 627 NCURSES_EXPORT(int)
 628 init_color(short color, short r, short g, short b)
 629 {
 630     return NCURSES_SP_NAME(init_color) (CURRENT_SCREEN, color, r, g, b);
 631 }
 632 #endif
 633
 634 NCURSES_EXPORT(bool)
 635 NCURSES_SP_NAME(can_change_color) (NCURSES_SP_DCL)
 636 {
 637     int result = FALSE;
 638
 639     T((T_CALLED("can_change_color(%p)"), (void *) SP_PARM));
 640
 641     if (HasTerminal(SP_PARM) && (CanChange != 0)) {
 642         result = TRUE;
 643     }
 644
 645     returnCode(result);
 646 }
 647
 648 #if NCURSES_SP_FUNCS
 649 NCURSES_EXPORT(bool)
 650 can_change_color(void)
 651 {
 652     return NCURSES_SP_NAME(can_change_color) (CURRENT_SCREEN);
 653 }
 654 #endif
 655
 656 NCURSES_EXPORT(bool)
 657 NCURSES_SP_NAME(has_colors) (NCURSES_SP_DCL0)
 658 {
 659     int code = FALSE;
 660
 661     (void) SP_PARM;
 662     T((T_CALLED("has_colors()")));
 663     if (HasTerminal(SP_PARM)) {
 664 #ifdef USE_TERM_DRIVER
 665         code = HasColor;
 666 #else
 667         code = ((VALID_NUMERIC(max_colors) && VALID_NUMERIC(max_pairs)
 668                  && (((set_foreground != NULL)
 669                       && (set_background != NULL))
 670                      || ((set_a_foreground != NULL)
 671                          && (set_a_background != NULL))
 672                      || set_color_pair)) ? TRUE : FALSE);
 673 #endif
 674     }
 675     returnCode(code);
 676 }
 677
 678 #if NCURSES_SP_FUNCS
 679 NCURSES_EXPORT(bool)
 680 has_colors(void)
 681 {
 682     return NCURSES_SP_NAME(has_colors) (CURRENT_SCREEN);
 683 }
 684 #endif
 685
 686 NCURSES_EXPORT(int)
 687 NCURSES_SP_NAME(color_content) (NCURSES_SP_DCLx
 688                                 short color, short *r, short *g, short *b)
 689 {
 690     int result = ERR;
 691     int maxcolors;
 692
 693     T((T_CALLED("color_content(%p,%d,%p,%p,%p)"),
 694        (void *) SP_PARM,
 695        color,
 696        (void *) r,
 697        (void *) g,
 698        (void *) b));
 699
 700     if (SP_PARM == 0)
 701         returnCode(result);
 702
 703     maxcolors = MaxColors;
 704
 705     if (color < 0 || !OkColorHi(color) || !SP_PARM->_coloron) {
 706         result = ERR;
 707     } else {
 708         NCURSES_COLOR_T c_r = SP_PARM->_color_table[color].red;
 709         NCURSES_COLOR_T c_g = SP_PARM->_color_table[color].green;
 710         NCURSES_COLOR_T c_b = SP_PARM->_color_table[color].blue;
 711
 712         if (r)
 713             *r = c_r;
 714         if (g)
 715             *g = c_g;
 716         if (b)
 717             *b = c_b;
 718
 719         TR(TRACE_ATTRS, ("...color_content(%d,%d,%d,%d)",
 720                          color, c_r, c_g, c_b));
 721         result = OK;
 722     }
 723     returnCode(result);
 724 }
 725
 726 #if NCURSES_SP_FUNCS
 727 NCURSES_EXPORT(int)
 728 color_content(short color, short *r, short *g, short *b)
 729 {
 730     return NCURSES_SP_NAME(color_content) (CURRENT_SCREEN, color, r, g, b);
 731 }
 732 #endif
 733
 734 NCURSES_EXPORT(int)
 735 NCURSES_SP_NAME(pair_content) (NCURSES_SP_DCLx
 736                                short pair, short *f, short *b)
 737 {
 738     int result;
 739
 740     T((T_CALLED("pair_content(%p,%d,%p,%p)"),
 741        (void *) SP_PARM,
 742        pair,
 743        (void *) f,
 744        (void *) b));
 745
 746     if (!ValidPair(pair)) {
 747         result = ERR;
 748     } else {
 749         NCURSES_COLOR_T fg = (NCURSES_COLOR_T) FORE_OF(SP_PARM->_color_pairs[pair]);
 750         NCURSES_COLOR_T bg = (NCURSES_COLOR_T) BACK_OF(SP_PARM->_color_pairs[pair]);
 751
 752 #if NCURSES_EXT_FUNCS
 753         if (fg == COLOR_DEFAULT)
 754             fg = -1;
 755         if (bg == COLOR_DEFAULT)
 756             bg = -1;
 757 #endif
 758
 759         if (f)
 760             *f = fg;
 761         if (b)
 762             *b = bg;
 763
 764         TR(TRACE_ATTRS, ("...pair_content(%p,%d,%d,%d)",
 765                          (void *) SP_PARM,
 766                          pair,
 767                          fg, bg));
 768         result = OK;
 769     }
 770     returnCode(result);
 771 }
 772
 773 #if NCURSES_SP_FUNCS
 774 NCURSES_EXPORT(int)
 775 pair_content(short pair, short *f, short *b)
 776 {
 777     return NCURSES_SP_NAME(pair_content) (CURRENT_SCREEN, pair, f, b);
 778 }
 779 #endif
 780
 781 NCURSES_EXPORT(void)
 782 NCURSES_SP_NAME(_nc_do_color) (NCURSES_SP_DCLx
 783                                int old_pair,
 784                                int pair,
 785                                int reverse,
 786                                NCURSES_SP_OUTC outc)
 787 {
 788 #ifdef USE_TERM_DRIVER
 789     CallDriver_4(SP_PARM, docolor, old_pair, pair, reverse, outc);
 790 #else
 791     NCURSES_COLOR_T fg = COLOR_DEFAULT;
 792     NCURSES_COLOR_T bg = COLOR_DEFAULT;
 793     NCURSES_COLOR_T old_fg = -1;
 794     NCURSES_COLOR_T old_bg = -1;
 795
 796     if (!ValidPair(pair)) {
 797         return;
 798     } else if (pair != 0) {
 799         if (set_color_pair) {
 800             TPUTS_TRACE("set_color_pair");
 801             NCURSES_SP_NAME(tputs) (NCURSES_SP_ARGx
 802                                     TPARM_1(set_color_pair, pair),
 803                                     1, outc);
 804             return;
 805         } else if (SP_PARM != 0) {
 806             if (pair_content((short) pair, &fg, &bg) == ERR)
 807                 return;
 808         }
 809     }
 810
 811     if (old_pair >= 0
 812         && SP_PARM != 0
 813         && pair_content((short) old_pair, &old_fg, &old_bg) != ERR) {
 814         if ((isDefaultColor(fg) && !isDefaultColor(old_fg))
 815             || (isDefaultColor(bg) && !isDefaultColor(old_bg))) {
 816 #if NCURSES_EXT_FUNCS
 817             /*
 818              * A minor optimization - but extension.  If "AX" is specified in
 819              * the terminal description, treat it as screen's indicator of ECMA
 820              * SGR 39 and SGR 49, and assume the two sequences are independent.
 821              */
 822             if (SP_PARM->_has_sgr_39_49
 823                 && isDefaultColor(old_bg)
 824                 && !isDefaultColor(old_fg)) {
 825                 NCURSES_SP_NAME(tputs) (NCURSES_SP_ARGx "\033[39m", 1, outc);
 826             } else if (SP_PARM->_has_sgr_39_49
 827                        && isDefaultColor(old_fg)
 828                        && !isDefaultColor(old_bg)) {
 829                 NCURSES_SP_NAME(tputs) (NCURSES_SP_ARGx "\033[49m", 1, outc);
 830             } else
 831 #endif
 832                 reset_color_pair(NCURSES_SP_ARG);
 833         }
 834     } else {
 835         reset_color_pair(NCURSES_SP_ARG);
 836         if (old_pair < 0)
 837             return;
 838     }
 839
 840 #if NCURSES_EXT_FUNCS
 841     if (isDefaultColor(fg))
 842         fg = (short) default_fg(NCURSES_SP_ARG);
 843     if (isDefaultColor(bg))
 844         bg = (short) default_bg(NCURSES_SP_ARG);
 845 #endif
 846
 847     if (reverse) {
 848         NCURSES_COLOR_T xx = fg;
 849         fg = bg;
 850         bg = xx;
 851     }
 852
 853     TR(TRACE_ATTRS, ("setting colors: pair = %d, fg = %d, bg = %d", pair,
 854                      fg, bg));
 855
 856     if (!isDefaultColor(fg)) {
 857         set_foreground_color(NCURSES_SP_ARGx fg, outc);
 858     }
 859     if (!isDefaultColor(bg)) {
 860         set_background_color(NCURSES_SP_ARGx bg, outc);
 861     }
 862 #endif
 863 }
 864
 865 #if NCURSES_SP_FUNCS
 866 NCURSES_EXPORT(void)
 867 _nc_do_color(int old_pair, int pair, int reverse, NCURSES_OUTC outc)
 868 {
 869     SetSafeOutcWrapper(outc);
 870     NCURSES_SP_NAME(_nc_do_color) (CURRENT_SCREEN,
 871                                    old_pair,
 872                                    pair,
 873                                    reverse,
 874                                    _nc_outc_wrapper);
 875 }
 876 #endif