ncurses/base/lib_bkgd.c

   1 /****************************************************************************
   2  * Copyright 2018-2020,2021 Thomas E. Dickey                                *
   3  * Copyright 1998-2014,2016 Free Software Foundation, Inc.                  *
   4  *                                                                          *
   5  * Permission is hereby granted, free of charge, to any person obtaining a  *
   6  * copy of this software and associated documentation files (the            *
   7  * "Software"), to deal in the Software without restriction, including      *
   8  * without limitation the rights to use, copy, modify, merge, publish,      *
   9  * distribute, distribute with modifications, sublicense, and/or sell       *
  10  * copies of the Software, and to permit persons to whom the Software is    *
  11  * furnished to do so, subject to the following conditions:                 *
  12  *                                                                          *
  13  * The above copyright notice and this permission notice shall be included  *
  14  * in all copies or substantial portions of the Software.                   *
  15  *                                                                          *
  16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS  *
  17  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF               *
  18  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.   *
  19  * IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,   *
  20  * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR    *
  21  * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR    *
  22  * THE USE OR OTHER DEALINGS IN THE SOFTWARE.                               *
  23  *                                                                          *
  24  * Except as contained in this notice, the name(s) of the above copyright   *
  25  * holders shall not be used in advertising or otherwise to promote the     *
  26  * sale, use or other dealings in this Software without prior written       *
  27  * authorization.                                                           *
  28  ****************************************************************************/
  29
  30 /****************************************************************************
  31  *  Author: Zeyd M. Ben-Halim <zmbenhal@netcom.com> 1992,1995               *
  32  *     and: Eric S. Raymond <esr@snark.thyrsus.com>                         *
  33  *     and: Juergen Pfeifer                         1997                    *
  34  *     and: Sven Verdoolaege                        2000                    *
  35  *     and: Thomas E. Dickey                        1996-on                 *
  36  ****************************************************************************/
  37
  38 #include <curses.priv.h>
  39
  40 MODULE_ID("$Id: lib_bkgd.c,v 1.61 2021/02/06 21:18:08 tom Exp $")
  41
  42 static const NCURSES_CH_T blank = NewChar(BLANK_TEXT);
  43
  44 /*
  45  * Set the window's background information.
  46  */
  47 #if USE_WIDEC_SUPPORT
  48 NCURSES_EXPORT(void)
  49 #else
  50 static NCURSES_INLINE void
  51 #endif
  52 wbkgrndset(WINDOW *win, const ARG_CH_T ch)
  53 {
  54     T((T_CALLED("wbkgdset(%p,%s)"), (void *) win, _tracech_t(ch)));
  55
  56     if (win) {
  57         attr_t off = AttrOf(win->_nc_bkgd);
  58         attr_t on = AttrOf(CHDEREF(ch));
  59
  60         toggle_attr_off(WINDOW_ATTRS(win), off);
  61         toggle_attr_on(WINDOW_ATTRS(win), on);
  62
  63 #if NCURSES_EXT_COLORS
  64         {
  65             int pair;
  66
  67             if ((pair = GetPair(win->_nc_bkgd)) != 0)
  68                 SET_WINDOW_PAIR(win, 0);
  69             if ((pair = GetPair(CHDEREF(ch))) != 0)
  70                 SET_WINDOW_PAIR(win, pair);
  71         }
  72 #endif
  73
  74         if (CharOf(CHDEREF(ch)) == L('\0')) {
  75             SetChar(win->_nc_bkgd, BLANK_TEXT, AttrOf(CHDEREF(ch)));
  76             if_EXT_COLORS(SetPair(win->_nc_bkgd, GetPair(CHDEREF(ch))));
  77         } else {
  78             win->_nc_bkgd = CHDEREF(ch);
  79         }
  80 #if USE_WIDEC_SUPPORT
  81         /*
  82          * If we're compiled for wide-character support, _bkgrnd is the
  83          * preferred location for the background information since it stores
  84          * more than _bkgd.  Update _bkgd each time we modify _bkgrnd, so the
  85          * macro getbkgd() will work.
  86          */
  87         {
  88             cchar_t wch;
  89             int tmp;
  90
  91             memset(&wch, 0, sizeof(wch));
  92             (void) wgetbkgrnd(win, &wch);
  93             tmp = _nc_to_char((wint_t) CharOf(wch));
  94
  95             win->_bkgd = (((tmp == EOF) ? ' ' : (chtype) tmp)
  96                           | (AttrOf(wch) & ALL_BUT_COLOR)
  97                           | (chtype) ColorPair(GET_WINDOW_PAIR(win)));
  98         }
  99 #endif
 100     }
 101     returnVoid;
 102 }
 103
 104 NCURSES_EXPORT(void)
 105 wbkgdset(WINDOW *win, chtype ch)
 106 {
 107     NCURSES_CH_T wch;
 108     SetChar2(wch, ch);
 109     wbkgrndset(win, CHREF(wch));
 110 }
 111
 112 /*
 113  * Set the window's background information and apply it to each cell.
 114  */
 115 static NCURSES_INLINE int
 116 _nc_background(WINDOW *win, const ARG_CH_T ch, bool narrow)
 117 {
 118 #undef  SP_PARM
 119 #define SP_PARM SP              /* to use Charable() */
 120     int code = ERR;
 121
 122 #if USE_WIDEC_SUPPORT
 123     T((T_CALLED("%s(%p,%s)"),
 124        narrow ? "wbkgd" : "wbkgrnd",
 125        (void *) win,
 126        _tracecchar_t(ch)));
 127 #define TraceChar(c) _tracecchar_t2(1, &(c))
 128 #else
 129     T((T_CALLED("%s(%p,%s)"),
 130        "wbkgd",
 131        (void *) win,
 132        _tracech_t(ch)));
 133     (void) narrow;
 134 #define TraceChar(c) _tracechar(CharOf(c))
 135 #endif
 136
 137     if (SP == 0) {
 138         ;
 139     } else if (win) {
 140         NCURSES_CH_T new_bkgd = CHDEREF(ch);
 141         NCURSES_CH_T old_bkgd;
 142         int y;
 143         NCURSES_CH_T old_char;
 144         attr_t old_attr;
 145         int old_pair;
 146         NCURSES_CH_T new_char;
 147         attr_t new_attr;
 148         int new_pair;
 149
 150         /* SVr4 trims color info if non-color terminal */
 151         if (!SP->_pair_limit) {
 152             RemAttr(new_bkgd, A_COLOR);
 153             SetPair(new_bkgd, 0);
 154         }
 155
 156         /* avoid setting background-character to a null */
 157         if (CharOf(new_bkgd) == 0) {
 158             NCURSES_CH_T tmp_bkgd = blank;
 159             SetAttr(tmp_bkgd, AttrOf(new_bkgd));
 160             SetPair(tmp_bkgd, GetPair(new_bkgd));
 161             new_bkgd = tmp_bkgd;
 162         }
 163
 164         memset(&old_bkgd, 0, sizeof(old_bkgd));
 165         (void) wgetbkgrnd(win, &old_bkgd);
 166
 167         if (!memcmp(&old_bkgd, &new_bkgd, sizeof(new_bkgd))) {
 168             T(("...unchanged"));
 169             returnCode(OK);
 170         }
 171
 172         old_char = old_bkgd;
 173         RemAttr(old_char, ~A_CHARTEXT);
 174         old_attr = AttrOf(old_bkgd);
 175         old_pair = GetPair(old_bkgd);
 176
 177         if (!(old_attr & A_COLOR)) {
 178             old_pair = 0;
 179         }
 180         T(("... old background char %s, attr %s, pair %d",
 181            TraceChar(old_char), _traceattr(old_attr), old_pair));
 182
 183         new_char = new_bkgd;
 184         RemAttr(new_char, ~A_CHARTEXT);
 185         new_attr = AttrOf(new_bkgd);
 186         new_pair = GetPair(new_bkgd);
 187
 188         /* SVr4 limits background character to printable 7-bits */
 189         if (
 190 #if USE_WIDEC_SUPPORT
 191                narrow &&
 192 #endif
 193                !Charable(new_bkgd)) {
 194             new_char = old_char;
 195         }
 196         if (!(new_attr & A_COLOR)) {
 197             new_pair = 0;
 198         }
 199         T(("... new background char %s, attr %s, pair %d",
 200            TraceChar(new_char), _traceattr(new_attr), new_pair));
 201
 202         (void) wbkgrndset(win, CHREF(new_bkgd));
 203
 204         /* SVr4 updates color pair if old/new match, otherwise just attrs */
 205         if ((new_pair != 0) && (new_pair == old_pair)) {
 206             WINDOW_ATTRS(win) = new_attr;
 207             SET_WINDOW_PAIR(win, new_pair);
 208         } else {
 209             WINDOW_ATTRS(win) = new_attr;
 210         }
 211
 212         for (y = 0; y <= win->_maxy; y++) {
 213             int x;
 214
 215             for (x = 0; x <= win->_maxx; x++) {
 216                 NCURSES_CH_T *cp = &(win->_line[y].text[x]);
 217                 int tmp_pair = GetPair(*cp);
 218                 attr_t tmp_attr = AttrOf(*cp);
 219
 220                 if (CharEq(*cp, old_bkgd)) {
 221 #if USE_WIDEC_SUPPORT
 222                     if (!narrow) {
 223                         if (Charable(new_bkgd)) {
 224                             SetChar2(*cp, CharOf(new_char));
 225                         } else {
 226                             SetChar(*cp, L' ', AttrOf(new_char));
 227                         }
 228                         memcpy(cp->chars,
 229                                new_char.chars,
 230                                CCHARW_MAX * sizeof(cp->chars[0]));
 231                     } else
 232 #endif
 233                         SetChar2(*cp, CharOf(new_char));
 234                 }
 235                 if (tmp_pair != 0) {
 236                     if (tmp_pair == old_pair) {
 237                         SetAttr(*cp, (tmp_attr & ~old_attr) | new_attr);
 238                         SetPair(*cp, new_pair);
 239                     } else {
 240                         SetAttr(*cp,
 241                                 (tmp_attr & (~old_attr | A_COLOR))
 242                                 | (new_attr & ALL_BUT_COLOR));
 243                     }
 244                 } else {
 245                     SetAttr(*cp, (tmp_attr & ~old_attr) | new_attr);
 246                     SetPair(*cp, new_pair);
 247                 }
 248             }
 249         }
 250         touchwin(win);
 251         _nc_synchook(win);
 252         code = OK;
 253     }
 254     returnCode(code);
 255 }
 256
 257 #if USE_WIDEC_SUPPORT
 258 NCURSES_EXPORT(int)
 259 wbkgrnd(WINDOW *win, const ARG_CH_T ch)
 260 {
 261     return _nc_background(win, ch, FALSE);
 262 }
 263 #endif
 264
 265 NCURSES_EXPORT(int)
 266 wbkgd(WINDOW *win, chtype ch)
 267 {
 268     NCURSES_CH_T wch;
 269     SetChar2(wch, ch);
 270     return _nc_background(win, CHREF(wch), TRUE);
 271 }