ncurses/base/lib_refresh.c

   1 /****************************************************************************
   2  * Copyright (c) 1998-2006,2007 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  ****************************************************************************/
  34
  35 /*
  36  *      lib_refresh.c
  37  *
  38  *      The routines wrefresh() and wnoutrefresh().
  39  *
  40  */
  41
  42 #include <curses.priv.h>
  43
  44 MODULE_ID("$Id: lib_refresh.c,v 1.40 2007/07/07 22:08:38 tom Exp $")
  45
  46 NCURSES_EXPORT(int)
  47 wrefresh(WINDOW *win)
  48 {
  49     int code;
  50
  51     T((T_CALLED("wrefresh(%p)"), win));
  52
  53     if (win == 0) {
  54         code = ERR;
  55     } else if (win == curscr) {
  56         curscr->_clear = TRUE;
  57         code = doupdate();
  58     } else if ((code = wnoutrefresh(win)) == OK) {
  59         if (win->_clear)
  60             newscr->_clear = TRUE;
  61         code = doupdate();
  62         /*
  63          * Reset the clearok() flag in case it was set for the special
  64          * case in hardscroll.c (if we don't reset it here, we'll get 2
  65          * refreshes because the flag is copied from stdscr to newscr).
  66          * Resetting the flag shouldn't do any harm, anyway.
  67          */
  68         win->_clear = FALSE;
  69     }
  70     returnCode(code);
  71 }
  72
  73 NCURSES_EXPORT(int)
  74 wnoutrefresh(WINDOW *win)
  75 {
  76     NCURSES_SIZE_T limit_x;
  77     NCURSES_SIZE_T src_row, src_col;
  78     NCURSES_SIZE_T begx;
  79     NCURSES_SIZE_T begy;
  80     NCURSES_SIZE_T dst_row, dst_col;
  81 #if USE_SCROLL_HINTS
  82     bool wide;
  83 #endif
  84
  85     T((T_CALLED("wnoutrefresh(%p)"), win));
  86 #ifdef TRACE
  87     if (_nc_tracing & TRACE_UPDATE)
  88         _tracedump("...win", win);
  89 #endif /* TRACE */
  90
  91     /*
  92      * This function will break badly if we try to refresh a pad.
  93      */
  94     if ((win == 0)
  95         || (win->_flags & _ISPAD))
  96         returnCode(ERR);
  97
  98     /* put them here so "win == 0" won't break our code */
  99     begx = win->_begx;
 100     begy = win->_begy;
 101
 102     newscr->_nc_bkgd = win->_nc_bkgd;
 103     WINDOW_ATTRS(newscr) = WINDOW_ATTRS(win);
 104
 105     /* merge in change information from all subwindows of this window */
 106     wsyncdown(win);
 107
 108 #if USE_SCROLL_HINTS
 109     /*
 110      * For pure efficiency, we'd want to transfer scrolling information
 111      * from the window to newscr whenever the window is wide enough that
 112      * its update will dominate the cost of the update for the horizontal
 113      * band of newscr that it occupies.  Unfortunately, this threshold
 114      * tends to be complex to estimate, and in any case scrolling the
 115      * whole band and rewriting the parts outside win's image would look
 116      * really ugly.  So.  What we do is consider the window "wide" if it
 117      * either (a) occupies the whole width of newscr, or (b) occupies
 118      * all but at most one column on either vertical edge of the screen
 119      * (this caters to fussy people who put boxes around full-screen
 120      * windows).  Note that changing this formula will not break any code,
 121      * merely change the costs of various update cases.
 122      */
 123     wide = (begx <= 1 && win->_maxx >= (newscr->_maxx - 1));
 124 #endif
 125
 126     win->_flags &= ~_HASMOVED;
 127
 128     /*
 129      * Microtweaking alert!  This double loop is one of the genuine
 130      * hot spots in the code.  Even gcc doesn't seem to do enough
 131      * common-subexpression chunking to make it really tense,
 132      * so we'll force the issue.
 133      */
 134
 135     /* limit(dst_col) */
 136     limit_x = win->_maxx;
 137     /* limit(src_col) */
 138     if (limit_x > newscr->_maxx - begx)
 139         limit_x = newscr->_maxx - begx;
 140
 141     for (src_row = 0, dst_row = begy + win->_yoffset;
 142          src_row <= win->_maxy && dst_row <= newscr->_maxy;
 143          src_row++, dst_row++) {
 144         register struct ldat *nline = &newscr->_line[dst_row];
 145         register struct ldat *oline = &win->_line[src_row];
 146
 147         if (oline->firstchar != _NOCHANGE) {
 148             int last_src = oline->lastchar;
 149
 150             if (last_src > limit_x)
 151                 last_src = limit_x;
 152
 153             src_col = oline->firstchar;
 154             dst_col = src_col + begx;
 155
 156             if_WIDEC({
 157                 register int j;
 158
 159                 /*
 160                  * Ensure that we will copy complete multi-column characters
 161                  * on the left-boundary.
 162                  */
 163                 if (isWidecExt(oline->text[src_col])) {
 164                     j = 1 + dst_col - WidecExt(oline->text[src_col]);
 165                     if (j < 0)
 166                         j = 0;
 167                     if (dst_col > j) {
 168                         src_col -= (dst_col - j);
 169                         dst_col = j;
 170                     }
 171                 }
 172
 173                 /*
 174                  * Ensure that we will copy complete multi-column characters
 175                  * on the right-boundary.
 176                  */
 177                 j = last_src;
 178                 if (WidecExt(oline->text[j])) {
 179                     ++j;
 180                     while (j <= limit_x) {
 181                         if (isWidecBase(oline->text[j])) {
 182                             break;
 183                         } else {
 184                             last_src = j;
 185                         }
 186                         ++j;
 187                     }
 188                 }
 189             });
 190
 191             if_WIDEC({
 192                 static cchar_t blank = BLANK;
 193                 int last_dst = begx + ((last_src < win->_maxx)
 194                                        ? last_src
 195                                        : win->_maxx);
 196                 int fix_left = dst_col;
 197                 int fix_right = last_dst;
 198                 register int j;
 199
 200                 /*
 201                  * Check for boundary cases where we may overwrite part of a
 202                  * multi-column character.  For those, wipe the remainder of
 203                  * the character to blanks.
 204                  */
 205                 j = dst_col;
 206                 if (isWidecExt(nline->text[j])) {
 207                     /*
 208                      * On the left, we only care about multi-column characters
 209                      * that extend into the changed region.
 210                      */
 211                     fix_left = 1 + j - WidecExt(nline->text[j]);
 212                     if (fix_left < 0)
 213                         fix_left = 0;   /* only if cell is corrupt */
 214                 }
 215
 216                 j = last_dst;
 217                 if (WidecExt(nline->text[j]) != 0) {
 218                     /*
 219                      * On the right, any multi-column character is a problem,
 220                      * unless it happens to be contained in the change, and
 221                      * ending at the right boundary of the change.  The
 222                      * computation for 'fix_left' accounts for the left-side of
 223                      * this character.  Find the end of the character.
 224                      */
 225                     ++j;
 226                     while (j <= newscr->_maxx && isWidecExt(nline->text[j])) {
 227                         fix_right = j++;
 228                     }
 229                 }
 230
 231                 /*
 232                  * The analysis is simpler if we do the clearing afterwards.
 233                  * Do that now.
 234                  */
 235                 if (fix_left < dst_col || fix_right > last_dst) {
 236                     for (j = fix_left; j <= fix_right; ++j) {
 237                         nline->text[j] = blank;
 238                         CHANGED_CELL(nline, j);
 239                     }
 240                 }
 241             });
 242
 243             /*
 244              * Copy the changed text.
 245              */
 246             for (; src_col <= last_src; src_col++, dst_col++) {
 247                 if (!CharEq(oline->text[src_col], nline->text[dst_col])) {
 248                     nline->text[dst_col] = oline->text[src_col];
 249                     CHANGED_CELL(nline, dst_col);
 250                 }
 251             }
 252
 253         }
 254 #if USE_SCROLL_HINTS
 255         if (wide) {
 256             int oind = oline->oldindex;
 257
 258             nline->oldindex = ((oind == _NEWINDEX)
 259                                ? _NEWINDEX
 260                                : (begy + oind + win->_yoffset));
 261         }
 262 #endif /* USE_SCROLL_HINTS */
 263
 264         oline->firstchar = oline->lastchar = _NOCHANGE;
 265         if_USE_SCROLL_HINTS(oline->oldindex = src_row);
 266     }
 267
 268     if (win->_clear) {
 269         win->_clear = FALSE;
 270         newscr->_clear = TRUE;
 271     }
 272
 273     if (!win->_leaveok) {
 274         newscr->_cury = win->_cury + win->_begy + win->_yoffset;
 275         newscr->_curx = win->_curx + win->_begx;
 276     }
 277     newscr->_leaveok = win->_leaveok;
 278
 279 #ifdef TRACE
 280     if (_nc_tracing & TRACE_UPDATE)
 281         _tracedump("newscr", newscr);
 282 #endif /* TRACE */
 283     returnCode(OK);
 284 }