/**************************************************************************** * apps/graphics/pdcurses/pdc_touch.c * Public Domain Curses * RCSID("$Id: touch.c,v 1.29 2008/07/13 16:08:18 wmcbrine Exp $") * * Copyright (C) 2017 Gregory Nutt. All rights reserved. * Adapted by: Gregory Nutt * * Adapted from the original public domain pdcurses by Gregory Nutt and * released as part of NuttX under the 3-clause BSD license: * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in * the documentation and/or other materials provided with the * distribution. * 3. Neither the name NuttX nor the names of its contributors may be * used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * ****************************************************************************/ /* Name: touch * * Synopsis: * int touchwin(WINDOW *win); * int touchline(WINDOW *win, int start, int count); * int untouchwin(WINDOW *win); * int wtouchln(WINDOW *win, int y, int n, int changed); * bool is_linetouched(WINDOW *win, int line); * bool is_wintouched(WINDOW *win); * * Description: * touchwin() and touchline() throw away all information about * which parts of the window have been touched, pretending that the * entire window has been drawn on. This is sometimes necessary * when using overlapping windows, since a change to one window * will affect the other window, but the records of which lines * have been changed in the other window will not reflect the * change. * * untouchwin() marks all lines in the window as unchanged since * the last call to wrefresh(). * * wtouchln() makes n lines in the window, starting at line y, look * as if they have (changed == 1) or have not (changed == 0) been * changed since the last call to wrefresh(). * * is_linetouched() returns true if the specified line in the * specified window has been changed since the last call to * wrefresh(). * * is_wintouched() returns true if the specified window * has been changed since the last call to wrefresh(). * * Return Value: * All functions return OK on success and ERR on error except * is_wintouched() and is_linetouched(). * * Portability X/Open BSD SYS V * touchwin Y Y Y * touchline Y - 3.0 * untouchwin Y - 4.0 * wtouchln Y Y Y * is_linetouched Y - 4.0 * is_wintouched Y - 4.0 */ /**************************************************************************** * Included Files ****************************************************************************/ #include "curspriv.h" /**************************************************************************** * Public Functions ****************************************************************************/ int touchwin(WINDOW *win) { int i; PDC_LOG(("touchwin() - called: Win=%x\n", win)); if (!win) { return ERR; } for (i = 0; i < win->_maxy; i++) { win->_firstch[i] = 0; win->_lastch[i] = win->_maxx - 1; } return OK; } int touchline(WINDOW *win, int start, int count) { int i; PDC_LOG(("touchline() - called: win=%p start %d count %d\n", win, start, count)); if (!win || start > win->_maxy || start + count > win->_maxy) { return ERR; } for (i = start; i < start + count; i++) { win->_firstch[i] = 0; win->_lastch[i] = win->_maxx - 1; } return OK; } int untouchwin(WINDOW *win) { int i; PDC_LOG(("untouchwin() - called: win=%p", win)); if (!win) { return ERR; } for (i = 0; i < win->_maxy; i++) { win->_firstch[i] = _NO_CHANGE; win->_lastch[i] = _NO_CHANGE; } return OK; } int wtouchln(WINDOW *win, int y, int n, int changed) { int i; PDC_LOG(("wtouchln() - called: win=%p y=%d n=%d changed=%d\n", win, y, n, changed)); if (!win || y > win->_maxy || y + n > win->_maxy) { return ERR; } for (i = y; i < y + n; i++) { if (changed) { win->_firstch[i] = 0; win->_lastch[i] = win->_maxx - 1; } else { win->_firstch[i] = _NO_CHANGE; win->_lastch[i] = _NO_CHANGE; } } return OK; } bool is_linetouched(WINDOW *win, int line) { PDC_LOG(("is_linetouched() - called: win=%p line=%d\n", win, line)); if (!win || line > win->_maxy || line < 0) { return false; } return (win->_firstch[line] != _NO_CHANGE) ? true : false; } bool is_wintouched(WINDOW *win) { int i; PDC_LOG(("is_wintouched() - called: win=%p\n", win)); if (win) { for (i = 0; i < win->_maxy; i++) { if (win->_firstch[i] != _NO_CHANGE) { return true; } } } return false; }