xref: /netbsd-src/lib/libcurses/touchwin.c (revision 53b02e147d4ed531c0d2a5ca9b3e8026ba3e99b5)
1 /*	$NetBSD: touchwin.c,v 1.33 2021/09/06 07:03:50 rin Exp $	*/
2 
3 /*
4  * Copyright (c) 1981, 1993, 1994
5  *	The Regents of the University of California.  All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  * 1. Redistributions of source code must retain the above copyright
11  *    notice, this list of conditions and the following disclaimer.
12  * 2. Redistributions in binary form must reproduce the above copyright
13  *    notice, this list of conditions and the following disclaimer in the
14  *    documentation and/or other materials provided with the distribution.
15  * 3. Neither the name of the University nor the names of its contributors
16  *    may be used to endorse or promote products derived from this software
17  *    without specific prior written permission.
18  *
19  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
20  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
23  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29  * SUCH DAMAGE.
30  */
31 
32 #include <sys/cdefs.h>
33 #ifndef lint
34 #if 0
35 static char sccsid[] = "@(#)touchwin.c	8.2 (Berkeley) 5/4/94";
36 #else
37 __RCSID("$NetBSD: touchwin.c,v 1.33 2021/09/06 07:03:50 rin Exp $");
38 #endif
39 #endif				/* not lint */
40 
41 #include "curses.h"
42 #include "curses_private.h"
43 
44 static int _cursesi_touchline_force(WINDOW *, int, int, int, int);
45 
46 /*
47  * __sync --
48  *	To be called after each window change.
49  */
50 void
51 __sync(WINDOW *win)
52 {
53 
54 	if (win->flags & __IMMEDOK)
55 		wrefresh(win);
56 	if (win->flags & __SYNCOK)
57 		wsyncup(win);
58 }
59 
60 /*
61  * is_linetouched --
62  *	Indicate if line has been touched or not.
63  */
64 bool
65 is_linetouched(WINDOW *win, int line)
66 {
67 	if (line > win->maxy)
68 		return FALSE;
69 
70 	__CTRACE(__CTRACE_LINE, "is_linetouched: (%p, line %d, dirty %d)\n",
71 	    win, line, (win->alines[line]->flags & __ISDIRTY));
72 	return (win->alines[line]->flags & __ISDIRTY) != 0;
73 }
74 
75 /*
76  * touchline --
77  *	Touch count lines starting at start.  This is the SUS v2 compliant
78  *	version.
79  */
80 int
81 touchline(WINDOW *win, int start, int count)
82 {
83 	__CTRACE(__CTRACE_LINE, "touchline: (%p, %d, %d)\n", win, start, count);
84 	return wtouchln(win, start, count, 1);
85 }
86 
87 /*
88  * wredrawln --
89  *	Mark count lines starting at start as corrupted.  Implemented using
90  *	wtouchln().
91  */
92 int wredrawln(WINDOW *win, int start, int count)
93 {
94 	__CTRACE(__CTRACE_LINE, "wredrawln: (%p, %d, %d)\n", win, start, count);
95 	return wtouchln(win, start, count, 1);
96 }
97 
98 /*
99  * is_wintouched --
100  *	Check if the window has been touched.
101  */
102 bool
103 is_wintouched(WINDOW *win)
104 {
105 	int y, maxy;
106 
107 	__CTRACE(__CTRACE_LINE, "is_wintouched: (%p, maxy %d)\n", win,
108 	    win->maxy);
109 	maxy = win->maxy;
110 	for (y = 0; y < maxy; y++) {
111 		if (is_linetouched(win, y) == TRUE)
112 			return TRUE;
113 	}
114 
115 	return FALSE;
116 }
117 
118 /*
119  * touchwin --
120  *	Make it look like the whole window has been changed.
121  */
122 int
123 touchwin(WINDOW *win)
124 {
125 	__CTRACE(__CTRACE_LINE, "touchwin: (%p)\n", win);
126 	return wtouchln(win, 0, win->maxy, 1);
127 }
128 
129 /*
130  * redrawwin --
131  *	Mark entire window as corrupted.  Implemented using wtouchln().
132  */
133 int
134 redrawwin(WINDOW *win)
135 {
136 	__CTRACE(__CTRACE_LINE, "redrawwin: (%p)\n", win);
137 	return wtouchln(win, 0, win->maxy, 1);
138 }
139 
140 /*
141  * untouchwin --
142  *	 Make it look like the window has not been changed.
143  */
144 int
145 untouchwin(WINDOW *win)
146 {
147 	__CTRACE(__CTRACE_LINE, "untouchwin: (%p)\n", win);
148 	return wtouchln(win, 0, win->maxy, 0);
149 }
150 
151 /*
152  * wtouchln --
153  *	If changed is 1 then touch n lines starting at line.  If changed
154  *	is 0 then mark the lines as unchanged.
155  */
156 int
157 wtouchln(WINDOW *win, int line, int n, int changed)
158 {
159 	int	y;
160 	__LINE	*wlp;
161 
162 	__CTRACE(__CTRACE_LINE, "wtouchln: (%p) %d, %d, %d\n",
163 	    win, line, n, changed);
164 	if (line < 0 || win->maxy <= line)
165 		return ERR;
166 	if (n < 0)
167 		return ERR;
168 	if (n > win->maxy - line)
169 		n = win->maxy - line;
170 
171 	for (y = line; y < line + n; y++) {
172 		if (changed == 1)
173 			_cursesi_touchline_force(win, y, 0,
174 			    (int) win->maxx - 1, 1);
175 		else {
176 			wlp = win->alines[y];
177 			if (*wlp->firstchp >= win->ch_off &&
178 			    *wlp->firstchp < win->maxx + win->ch_off)
179 				*wlp->firstchp = win->maxx + win->ch_off;
180 			if (*wlp->lastchp >= win->ch_off &&
181 			    *wlp->lastchp < win->maxx + win->ch_off)
182 				*wlp->lastchp = win->ch_off;
183 			wlp->flags &= ~(__ISDIRTY | __ISFORCED);
184 		}
185 	}
186 
187 	return OK;
188 }
189 
190 int
191 __touchwin(WINDOW *win)
192 {
193 	int	 y, maxy;
194 
195 	__CTRACE(__CTRACE_LINE, "__touchwin: (%p)\n", win);
196 	maxy = win->maxy;
197 	for (y = 0; y < maxy; y++)
198 		__touchline(win, y, 0, (int) win->maxx - 1);
199 	return OK;
200 }
201 
202 int
203 __touchline(WINDOW *win, int y, int sx, int ex)
204 {
205 
206 	return _cursesi_touchline_force(win, y, sx, ex, 0);
207 }
208 
209 /*
210  * Touch line y on window win starting from column sx and ending at
211  * column ex.  If force is 1 then we mark this line as a forced update
212  * which will bypass screen optimisation in the refresh code to rewrite
213  * this line unconditionally (even if refresh thinks the screen matches
214  * what is in the virtscr)
215  */
216 static int
217 _cursesi_touchline_force(WINDOW *win, int y, int sx, int ex, int force)
218 {
219 
220 	__CTRACE(__CTRACE_LINE, "__touchline: (%p, %d, %d, %d, %d)\n",
221 	    win, y, sx, ex, force);
222 	__CTRACE(__CTRACE_LINE, "__touchline: first = %d, last = %d\n",
223 	    *win->alines[y]->firstchp, *win->alines[y]->lastchp);
224 	sx += win->ch_off;
225 	ex += win->ch_off;
226 	win->alines[y]->flags |= __ISDIRTY;
227 	if (force == 1)
228 		win->alines[y]->flags |= __ISFORCED;
229 	/* firstchp/lastchp are shared between parent window and sub-window. */
230 	if (*win->alines[y]->firstchp > sx)
231 		*win->alines[y]->firstchp = sx;
232 	if (*win->alines[y]->lastchp < ex)
233 		*win->alines[y]->lastchp = ex;
234 	__CTRACE(__CTRACE_LINE, "__touchline: first = %d, last = %d\n",
235 	    *win->alines[y]->firstchp, *win->alines[y]->lastchp);
236 	return OK;
237 }
238 
239 void
240 wsyncup(WINDOW *win)
241 {
242 
243 	do {
244 		__touchwin(win);
245 		win = win->orig;
246 	} while (win);
247 }
248 
249 void
250 wsyncdown(WINDOW *win)
251 {
252 	WINDOW *w = win->orig;
253 
254 	while (w) {
255 		if (is_wintouched(w)) {
256 			__touchwin(win);
257 			break;
258 		}
259 		w = w->orig;
260 	}
261 }
262