comparison: pdcurses/touch.c
pdcurses/touch.c
- branch
- protocol5
- changeset 106
- 7b156b764d11
- parent 97
- 2d43f05b284c
equal
deleted
inserted
replaced
| 104:a76af67a3a4b | 106:7b156b764d11 |
|---|---|
| 1 /* Public Domain Curses */ | |
| 2 | |
| 3 #include <curspriv.h> | |
| 4 | |
| 5 RCSID("$Id: touch.c,v 1.29 2008/07/13 16:08:18 wmcbrine Exp $") | |
| 6 | |
| 7 /*man-start************************************************************** | |
| 8 | |
| 9 Name: touch | |
| 10 | |
| 11 Synopsis: | |
| 12 int touchwin(WINDOW *win); | |
| 13 int touchline(WINDOW *win, int start, int count); | |
| 14 int untouchwin(WINDOW *win); | |
| 15 int wtouchln(WINDOW *win, int y, int n, int changed); | |
| 16 bool is_linetouched(WINDOW *win, int line); | |
| 17 bool is_wintouched(WINDOW *win); | |
| 18 | |
| 19 Description: | |
| 20 touchwin() and touchline() throw away all information about | |
| 21 which parts of the window have been touched, pretending that the | |
| 22 entire window has been drawn on. This is sometimes necessary | |
| 23 when using overlapping windows, since a change to one window | |
| 24 will affect the other window, but the records of which lines | |
| 25 have been changed in the other window will not reflect the | |
| 26 change. | |
| 27 | |
| 28 untouchwin() marks all lines in the window as unchanged since | |
| 29 the last call to wrefresh(). | |
| 30 | |
| 31 wtouchln() makes n lines in the window, starting at line y, look | |
| 32 as if they have (changed == 1) or have not (changed == 0) been | |
| 33 changed since the last call to wrefresh(). | |
| 34 | |
| 35 is_linetouched() returns TRUE if the specified line in the | |
| 36 specified window has been changed since the last call to | |
| 37 wrefresh(). | |
| 38 | |
| 39 is_wintouched() returns TRUE if the specified window | |
| 40 has been changed since the last call to wrefresh(). | |
| 41 | |
| 42 Return Value: | |
| 43 All functions return OK on success and ERR on error except | |
| 44 is_wintouched() and is_linetouched(). | |
| 45 | |
| 46 Portability X/Open BSD SYS V | |
| 47 touchwin Y Y Y | |
| 48 touchline Y - 3.0 | |
| 49 untouchwin Y - 4.0 | |
| 50 wtouchln Y Y Y | |
| 51 is_linetouched Y - 4.0 | |
| 52 is_wintouched Y - 4.0 | |
| 53 | |
| 54 **man-end****************************************************************/ | |
| 55 | |
| 56 int touchwin(WINDOW *win) | |
| 57 { | |
| 58 int i; | |
| 59 | |
| 60 PDC_LOG(("touchwin() - called: Win=%x\n", win)); | |
| 61 | |
| 62 if (!win) | |
| 63 return ERR; | |
| 64 | |
| 65 for (i = 0; i < win->_maxy; i++) | |
| 66 { | |
| 67 win->_firstch[i] = 0; | |
| 68 win->_lastch[i] = win->_maxx - 1; | |
| 69 } | |
| 70 | |
| 71 return OK; | |
| 72 } | |
| 73 | |
| 74 int touchline(WINDOW *win, int start, int count) | |
| 75 { | |
| 76 int i; | |
| 77 | |
| 78 PDC_LOG(("touchline() - called: win=%p start %d count %d\n", | |
| 79 win, start, count)); | |
| 80 | |
| 81 if (!win || start > win->_maxy || start + count > win->_maxy) | |
| 82 return ERR; | |
| 83 | |
| 84 for (i = start; i < start + count; i++) | |
| 85 { | |
| 86 win->_firstch[i] = 0; | |
| 87 win->_lastch[i] = win->_maxx - 1; | |
| 88 } | |
| 89 | |
| 90 return OK; | |
| 91 } | |
| 92 | |
| 93 int untouchwin(WINDOW *win) | |
| 94 { | |
| 95 int i; | |
| 96 | |
| 97 PDC_LOG(("untouchwin() - called: win=%p", win)); | |
| 98 | |
| 99 if (!win) | |
| 100 return ERR; | |
| 101 | |
| 102 for (i = 0; i < win->_maxy; i++) | |
| 103 { | |
| 104 win->_firstch[i] = _NO_CHANGE; | |
| 105 win->_lastch[i] = _NO_CHANGE; | |
| 106 } | |
| 107 | |
| 108 return OK; | |
| 109 } | |
| 110 | |
| 111 int wtouchln(WINDOW *win, int y, int n, int changed) | |
| 112 { | |
| 113 int i; | |
| 114 | |
| 115 PDC_LOG(("wtouchln() - called: win=%p y=%d n=%d changed=%d\n", | |
| 116 win, y, n, changed)); | |
| 117 | |
| 118 if (!win || y > win->_maxy || y + n > win->_maxy) | |
| 119 return ERR; | |
| 120 | |
| 121 for (i = y; i < y + n; i++) | |
| 122 { | |
| 123 if (changed) | |
| 124 { | |
| 125 win->_firstch[i] = 0; | |
| 126 win->_lastch[i] = win->_maxx - 1; | |
| 127 } | |
| 128 else | |
| 129 { | |
| 130 win->_firstch[i] = _NO_CHANGE; | |
| 131 win->_lastch[i] = _NO_CHANGE; | |
| 132 } | |
| 133 } | |
| 134 | |
| 135 return OK; | |
| 136 } | |
| 137 | |
| 138 bool is_linetouched(WINDOW *win, int line) | |
| 139 { | |
| 140 PDC_LOG(("is_linetouched() - called: win=%p line=%d\n", win, line)); | |
| 141 | |
| 142 if (!win || line > win->_maxy || line < 0) | |
| 143 return FALSE; | |
| 144 | |
| 145 return (win->_firstch[line] != _NO_CHANGE) ? TRUE : FALSE; | |
| 146 } | |
| 147 | |
| 148 bool is_wintouched(WINDOW *win) | |
| 149 { | |
| 150 int i; | |
| 151 | |
| 152 PDC_LOG(("is_wintouched() - called: win=%p\n", win)); | |
| 153 | |
| 154 if (win) | |
| 155 for (i = 0; i < win->_maxy; i++) | |
| 156 if (win->_firstch[i] != _NO_CHANGE) | |
| 157 return TRUE; | |
| 158 | |
| 159 return FALSE; | |
| 160 } |
