1 /****************************************************************************
2 * Copyright (c) 1998-2008,2009 Free Software Foundation, Inc. *
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: *
12 * The above copyright notice and this permission notice shall be included *
13 * in all copies or substantial portions of the Software. *
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. *
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 *
27 ****************************************************************************/
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 * and: Juergen Pfeifer 2009 *
34 ****************************************************************************/
39 ** The routines to handle option setting.
43 #include <curses.priv.h>
48 #define CUR SP_TERMTYPE
51 MODULE_ID("$Id: lib_options.c,v 1.65 2009/07/04 18:14:31 tom Exp $")
53 static int _nc_meta(SCREEN *, bool);
56 idlok(WINDOW *win, bool flag)
59 SCREEN *sp = CURRENT_SCREEN;
61 T((T_CALLED("idlok(%p,%d)"), win, flag));
64 _nc_idlok = win->_idlok = (flag && (has_il() || change_scroll_region));
71 idcok(WINDOW *win, bool flag)
74 SCREEN *sp = CURRENT_SCREEN;
76 T((T_CALLED("idcok(%p,%d)"), win, flag));
79 _nc_idcok = win->_idcok = (flag && has_ic());
85 NCURSES_SP_NAME(halfdelay) (NCURSES_SP_DCLx int t)
87 T((T_CALLED("halfdelay(%d)"), t));
89 if (t < 1 || t > 255 || SP_PARM == 0)
93 SP_PARM->_cbreak = t + 1;
101 return NCURSES_SP_NAME(halfdelay) (CURRENT_SCREEN, t);
106 nodelay(WINDOW *win, bool flag)
108 T((T_CALLED("nodelay(%p,%d)"), win, flag));
121 notimeout(WINDOW *win, bool f)
123 T((T_CALLED("notimeout(%p,%d)"), win, f));
133 wtimeout(WINDOW *win, int delay)
135 T((T_CALLED("wtimeout(%p,%d)"), win, delay));
144 keypad(WINDOW *win, bool flag)
146 T((T_CALLED("keypad(%p,%d)"), win, flag));
149 win->_use_keypad = flag;
150 returnCode(_nc_keypad(SP, flag));
156 meta(WINDOW *win GCC_UNUSED, bool flag)
160 /* Ok, we stay relaxed and don't signal an error if win is NULL */
161 T((T_CALLED("meta(%p,%d)"), win, flag));
162 result = _nc_meta(SP, flag);
166 /* curs_set() moved here to narrow the kernel interface */
169 NCURSES_SP_NAME(curs_set) (NCURSES_SP_DCLx int vis)
173 T((T_CALLED("curs_set(%p,%d)"), SP_PARM, vis));
174 if (SP_PARM != 0 && vis >= 0 && vis <= 2) {
175 int cursor = SP_PARM->_cursor;
182 result = _nc_putp_flush("cursor_visible", cursor_visible);
185 result = _nc_putp_flush("cursor_normal", cursor_normal);
188 result = _nc_putp_flush("cursor_invisible", cursor_invisible);
192 result = (cursor == -1 ? 1 : cursor);
193 SP_PARM->_cursor = vis;
203 return (NCURSES_SP_NAME(curs_set) (CURRENT_SCREEN, vis));
208 NCURSES_SP_NAME(typeahead) (NCURSES_SP_DCLx int fd)
210 T((T_CALLED("typeahead(%d)"), fd));
212 SP_PARM->_checkfd = fd;
223 return NCURSES_SP_NAME(typeahead) (CURRENT_SCREEN, fd);
230 ** Return TRUE if the current terminal has the given key
234 #if NCURSES_EXT_FUNCS
236 has_key_internal(int keycode, TRIES * tp)
240 else if (tp->value == keycode)
243 return (has_key_internal(keycode, tp->child)
244 || has_key_internal(keycode, tp->sibling));
248 NCURSES_SP_NAME(has_key) (NCURSES_SP_DCLx int keycode)
250 T((T_CALLED("has_key(%p,%d)"), SP_PARM, keycode));
251 returnCode(SP != 0 ? has_key_internal(keycode, SP_PARM->_keytry) : FALSE);
258 return NCURSES_SP_NAME(has_key) (CURRENT_SCREEN, keycode);
261 #endif /* NCURSES_EXT_FUNCS */
264 * Internal entrypoints use SCREEN* parameter to obtain capabilities rather
268 #define CUR SP_TERMTYPE
271 NCURSES_SP_NAME(_nc_putp_flush) (NCURSES_SP_DCLx
272 const char *name, const char *value)
274 int rc = _nc_putp(name, value);
283 _nc_putp_flush(const char *name, const char *value)
285 return NCURSES_SP_NAME(_nc_putp_flush) (CURRENT_SCREEN, name, value);
289 /* Turn the keypad on/off
291 * Note: we flush the output because changing this mode causes some terminals
292 * to emit different escape sequences for cursor and keypad keys. If we don't
293 * flush, then the next wgetch may get the escape sequence that corresponds to
294 * the terminal state _before_ switching modes.
297 _nc_keypad(SCREEN *sp, bool flag)
304 * We might have this situation in a multithreaded application that
305 * has wgetch() reading in more than one thread. putp() and below
306 * may use SP explicitly.
308 if (_nc_use_pthreads && sp != CURRENT_SCREEN) {
311 /* cannot use use_screen(), since that is not in tinfo library */
312 _nc_lock_global(curses);
313 save_sp = CURRENT_SCREEN;
315 rc = _nc_keypad(sp, flag);
316 _nc_set_screen(save_sp);
317 _nc_unlock_global(curses);
322 (void) _nc_putp_flush("keypad_xmit", keypad_xmit);
323 } else if (!flag && keypad_local) {
324 (void) _nc_putp_flush("keypad_local", keypad_local);
327 if (flag && !sp->_tried) {
331 sp->_keypad_on = flag;
339 _nc_meta(SCREEN *sp, bool flag)
343 /* Ok, we stay relaxed and don't signal an error if win is NULL */
346 sp->_use_meta = flag;
349 _nc_putp("meta_on", meta_on);
351 _nc_putp("meta_off", meta_off);