1 /****************************************************************************
2 * Copyright 2018-2019,2020 Thomas E. Dickey *
3 * Copyright 1998-2014,2016 Free Software Foundation, Inc. *
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: *
13 * The above copyright notice and this permission notice shall be included *
14 * in all copies or substantial portions of the Software. *
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. *
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 *
28 ****************************************************************************/
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 ****************************************************************************/
38 #include <curses.priv.h>
40 MODULE_ID("$Id: lib_bkgd.c,v 1.54 2020/02/02 23:34:34 tom Exp $")
43 * Set the window's background information.
48 static NCURSES_INLINE void
50 wbkgrndset(WINDOW *win, const ARG_CH_T ch)
52 T((T_CALLED("wbkgdset(%p,%s)"), (void *) win, _tracech_t(ch)));
55 attr_t off = AttrOf(win->_nc_bkgd);
56 attr_t on = AttrOf(CHDEREF(ch));
58 toggle_attr_off(WINDOW_ATTRS(win), off);
59 toggle_attr_on(WINDOW_ATTRS(win), on);
61 #if NCURSES_EXT_COLORS
65 if ((pair = GetPair(win->_nc_bkgd)) != 0)
66 SET_WINDOW_PAIR(win, 0);
67 if ((pair = GetPair(CHDEREF(ch))) != 0)
68 SET_WINDOW_PAIR(win, pair);
72 if (CharOf(CHDEREF(ch)) == L('\0')) {
73 SetChar(win->_nc_bkgd, BLANK_TEXT, AttrOf(CHDEREF(ch)));
74 if_EXT_COLORS(SetPair(win->_nc_bkgd, GetPair(CHDEREF(ch))));
76 win->_nc_bkgd = CHDEREF(ch);
80 * If we're compiled for wide-character support, _bkgrnd is the
81 * preferred location for the background information since it stores
82 * more than _bkgd. Update _bkgd each time we modify _bkgrnd, so the
83 * macro getbkgd() will work.
89 memset(&wch, 0, sizeof(wch));
90 (void) wgetbkgrnd(win, &wch);
91 tmp = _nc_to_char((wint_t) CharOf(wch));
93 win->_bkgd = (((tmp == EOF) ? ' ' : (chtype) tmp)
94 | (AttrOf(wch) & ALL_BUT_COLOR)
95 | (chtype) ColorPair(GET_WINDOW_PAIR(win)));
103 wbkgdset(WINDOW *win, chtype ch)
107 wbkgrndset(win, CHREF(wch));
111 * Set the window's background information and apply it to each cell.
113 #if USE_WIDEC_SUPPORT
116 static NCURSES_INLINE int
119 wbkgrnd(WINDOW *win, const ARG_CH_T ch)
122 #define SP_PARM SP /* to use Charable() */
125 T((T_CALLED("wbkgd(%p,%s)"), (void *) win, _tracech_t(ch)));
130 NCURSES_CH_T new_bkgd = CHDEREF(ch);
131 NCURSES_CH_T old_bkgd;
133 NCURSES_CH_T old_char;
136 NCURSES_CH_T new_char;
140 /* SVr4 trims color info if non-color terminal */
141 if (!SP->_pair_limit) {
142 RemAttr(new_bkgd, A_COLOR);
143 SetPair(new_bkgd, 0);
146 memset(&old_bkgd, 0, sizeof(old_bkgd));
147 (void) wgetbkgrnd(win, &old_bkgd);
149 if (!memcmp(&old_bkgd, &new_bkgd, sizeof(new_bkgd))) {
155 RemAttr(old_char, ~A_CHARTEXT);
156 old_attr = AttrOf(old_bkgd);
157 old_pair = GetPair(old_bkgd);
159 if (!(old_attr & A_COLOR)) {
162 T(("... old background char %s, attr %s, pair %d",
163 _tracechar(CharOf(old_char)), _traceattr(old_attr), old_pair));
166 RemAttr(new_char, ~A_CHARTEXT);
167 new_attr = AttrOf(new_bkgd);
168 new_pair = GetPair(new_bkgd);
170 /* SVr4 limits background character to printable 7-bits */
171 if (!Charable(new_bkgd)) {
174 if (!(new_attr & A_COLOR)) {
177 T(("... new background char %s, attr %s, pair %d",
178 _tracechar(CharOf(new_char)), _traceattr(new_attr), new_pair));
180 (void) wbkgrndset(win, CHREF(new_bkgd));
182 /* SVr4 updates color pair if old/new match, otherwise just attrs */
183 if ((new_pair != 0) && (new_pair == old_pair)) {
184 WINDOW_ATTRS(win) = new_attr;
185 SET_WINDOW_PAIR(win, new_pair);
187 WINDOW_ATTRS(win) = new_attr;
190 for (y = 0; y <= win->_maxy; y++) {
193 for (x = 0; x <= win->_maxx; x++) {
194 NCURSES_CH_T *cp = &(win->_line[y].text[x]);
195 int tmp_pair = GetPair(*cp);
196 attr_t tmp_attr = AttrOf(*cp);
198 if (CharEq(*cp, old_bkgd)) {
199 SetChar2(*cp, CharOf(new_char));
202 if (tmp_pair == old_pair) {
203 SetAttr(*cp, (tmp_attr & ~old_attr) | new_attr);
204 SetPair(*cp, new_pair);
207 (tmp_attr & (~old_attr | A_COLOR))
208 | (new_attr & ALL_BUT_COLOR));
211 SetAttr(*cp, (tmp_attr & ~old_attr) | new_attr);
212 SetPair(*cp, new_pair);
224 wbkgd(WINDOW *win, chtype ch)
228 return wbkgrnd(win, CHREF(wch));