curses.h revision 1.21 1 /* $NetBSD: curses.h,v 1.21 1998/01/30 04:33:32 perry 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. All advertising materials mentioning features or use of this software
16 * must display the following acknowledgement:
17 * This product includes software developed by the University of
18 * California, Berkeley and its contributors.
19 * 4. Neither the name of the University nor the names of its contributors
20 * may be used to endorse or promote products derived from this software
21 * without specific prior written permission.
22 *
23 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
24 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
27 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
28 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
29 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
30 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
32 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33 * SUCH DAMAGE.
34 *
35 * @(#)curses.h 8.5 (Berkeley) 4/29/95
36 */
37
38 #ifndef _CURSES_H_
39 #define _CURSES_H_
40
41 #include <stdio.h>
42 #include <termcap.h>
43
44 /*
45 * The following #defines and #includes are present for backward
46 * compatibility only. They should not be used in future code.
47 *
48 * START BACKWARD COMPATIBILITY ONLY.
49 */
50 #ifndef _CURSES_PRIVATE
51 #ifndef __cplusplus
52 #define bool char
53 #endif
54 #define reg register
55
56 #ifndef TRUE
57 #define TRUE (1)
58 #endif
59 #ifndef FALSE
60 #define FALSE (0)
61 #endif
62
63 #define _puts(s) tputs(s, 0, __cputchar)
64 #define _putchar(c) __cputchar(c)
65
66 /* Old-style terminal modes access. */
67 #define baudrate() (cfgetospeed(&__baset))
68 #define crmode() cbreak()
69 #define erasechar() (__baset.c_cc[VERASE])
70 #define killchar() (__baset.c_cc[VKILL])
71 #define nocrmode() nocbreak()
72 #define ospeed (cfgetospeed(&__baset))
73 #endif /* _CURSES_PRIVATE */
74
75 extern char GT; /* Gtty indicates tabs. */
76 extern char NONL; /* Term can't hack LF doing a CR. */
77 extern char UPPERCASE; /* Terminal is uppercase only. */
78
79 extern int My_term; /* Use Def_term regardless. */
80 extern char *Def_term; /* Default terminal type. */
81
82 /* Termcap capabilities. */
83 extern char AM, BS, CA, DA, EO, HC, IN, MI, MS, NC, NS, OS,
84 PC, UL, XB, XN, XT, XS, XX;
85 extern char *AL, *BC, *BT, *CD, *CE, *CL, *CM, *CR, *CS, *DC, *DL,
86 *DM, *DO, *ED, *EI, *K0, *K1, *K2, *K3, *K4, *K5, *K6,
87 *K7, *K8, *K9, *HO, *IC, *IM, *IP, *KD, *KE, *KH, *KL,
88 *KR, *KS, *KU, *LL, *MA, *ND, *NL, *RC, *SC, *SE, *SF,
89 *SO, *SR, *TA, *TE, *TI, *UC, *UE, *UP, *US, *VB, *VS,
90 *VE, *al, *dl, *sf, *sr,
91 *AL_PARM, *DL_PARM, *UP_PARM, *DOWN_PARM, *LEFT_PARM,
92 *RIGHT_PARM;
93
94 /* END BACKWARD COMPATIBILITY ONLY. */
95
96 /* 8-bit ASCII characters. */
97 #define unctrl(c) __unctrl[(c) & 0xff]
98 #define unctrllen(ch) __unctrllen[(ch) & 0xff]
99
100 extern char *__unctrl[256]; /* Control strings. */
101 extern char __unctrllen[256]; /* Control strings length. */
102
103 /*
104 * A window an array of __LINE structures pointed to by the 'lines' pointer.
105 * A line is an array of __LDATA structures pointed to by the 'line' pointer.
106 *
107 * IMPORTANT: the __LDATA structure must NOT induce any padding, so if new
108 * fields are added -- padding fields with *constant values* should ensure
109 * that the compiler will not generate any padding when storing an array of
110 * __LDATA structures. This is to enable consistent use of memcmp, and memcpy
111 * for comparing and copying arrays.
112 */
113 typedef struct {
114 char ch; /* the actual character */
115
116 #define __STANDOUT 0x01 /* Added characters are standout. */
117 char attr; /* attributes of character */
118 } __LDATA;
119
120 #define __LDATASIZE (sizeof(__LDATA))
121
122 typedef struct {
123 #define __ISDIRTY 0x01 /* Line is dirty. */
124 #define __ISPASTEOL 0x02 /* Cursor is past end of line */
125 #define __FORCEPAINT 0x04 /* Force a repaint of the line */
126 unsigned int flags;
127 unsigned int hash; /* Hash value for the line. */
128 size_t *firstchp, *lastchp; /* First and last chngd columns ptrs */
129 size_t firstch, lastch; /* First and last changed columns. */
130 __LDATA *line; /* Pointer to the line text. */
131 } __LINE;
132
133 typedef struct __window { /* Window structure. */
134 struct __window *nextp, *orig; /* Subwindows list and parent. */
135 size_t begy, begx; /* Window home. */
136 size_t cury, curx; /* Current x, y coordinates. */
137 size_t maxy, maxx; /* Maximum values for curx, cury. */
138 short ch_off; /* x offset for firstch/lastch. */
139 __LINE **lines; /* Array of pointers to the lines */
140 __LINE *lspace; /* line space (for cleanup) */
141 __LDATA *wspace; /* window space (for cleanup) */
142
143 #define __ENDLINE 0x001 /* End of screen. */
144 #define __FLUSH 0x002 /* Fflush(stdout) after refresh. */
145 #define __FULLWIN 0x004 /* Window is a screen. */
146 #define __IDLINE 0x008 /* Insert/delete sequences. */
147 #define __SCROLLWIN 0x010 /* Last char will scroll window. */
148 #define __SCROLLOK 0x020 /* Scrolling ok. */
149 #define __CLEAROK 0x040 /* Clear on next refresh. */
150 #define __WSTANDOUT 0x080 /* Standout window */
151 #define __LEAVEOK 0x100 /* If curser left */
152 unsigned int flags;
153 } WINDOW;
154
155 /* Curses external declarations. */
156 extern WINDOW *curscr; /* Current screen. */
157 extern WINDOW *stdscr; /* Standard screen. */
158
159 extern struct termios __orig_termios; /* Terminal state before curses */
160 extern struct termios __baset; /* Our base terminal state */
161 extern int __tcaction; /* If terminal hardware set. */
162
163 extern int COLS; /* Columns on the screen. */
164 extern int LINES; /* Lines on the screen. */
165
166 extern char *ttytype; /* Full name of current terminal. */
167
168 #define ERR (0) /* Error return. */
169 #define OK (1) /* Success return. */
170
171 /* Standard screen pseudo functions. */
172 #define addbytes(s, n) __waddbytes(stdscr, s, n, 0)
173 #define addch(ch) waddch(stdscr, ch)
174 #define addnstr(s, n) waddnstr(stdscr, s, n)
175 #define addstr(s) __waddbytes(stdscr, s, strlen(s), 0)
176 #define clear() wclear(stdscr)
177 #define clrtobot() wclrtobot(stdscr)
178 #define clrtoeol() wclrtoeol(stdscr)
179 #define delch() wdelch(stdscr)
180 #define deleteln() wdeleteln(stdscr)
181 #define erase() werase(stdscr)
182 #define getch() wgetch(stdscr)
183 #define getstr(s) wgetstr(stdscr, s)
184 #define inch() winch(stdscr)
185 #define insch(ch) winsch(stdscr, ch)
186 #define insertln() winsertln(stdscr)
187 #define move(y, x) wmove(stdscr, y, x)
188 #define refresh() wrefresh(stdscr)
189 #define standend() wstandend(stdscr)
190 #define standout() wstandout(stdscr)
191 #define waddbytes(w, s, n) __waddbytes(w, s, n, 0)
192 #define waddstr(w, s) __waddbytes(w, s, strlen(s), 0)
193
194 /* Standard screen plus movement pseudo functions. */
195 #define mvaddbytes(y, x, s, n) mvwaddbytes(stdscr, y, x, s, n)
196 #define mvaddch(y, x, ch) mvwaddch(stdscr, y, x, ch)
197 #define mvaddnstr(y, x, s, n) mvwaddnstr(stdscr, y, x, s, n)
198 #define mvaddstr(y, x, s) mvwaddstr(stdscr, y, x, s)
199 #define mvdelch(y, x) mvwdelch(stdscr, y, x)
200 #define mvgetch(y, x) mvwgetch(stdscr, y, x)
201 #define mvgetstr(y, x, s) mvwgetstr(stdscr, y, x, s)
202 #define mvinch(y, x) mvwinch(stdscr, y, x)
203 #define mvinsch(y, x, c) mvwinsch(stdscr, y, x, c)
204 #define mvwaddbytes(w, y, x, s, n) \
205 (wmove(w, y, x) == ERR ? ERR : __waddbytes(w, s, n, 0))
206 #define mvwaddch(w, y, x, ch) \
207 (wmove(w, y, x) == ERR ? ERR : waddch(w, ch))
208 #define mvwaddnstr(w, y, x, s, n) \
209 (wmove(w, y, x) == ERR ? ERR : waddnstr(w, s, n))
210 #define mvwaddstr(w, y, x, s) \
211 (wmove(w, y, x) == ERR ? ERR : __waddbytes(w, s, strlen(s), 0))
212 #define mvwdelch(w, y, x) \
213 (wmove(w, y, x) == ERR ? ERR : wdelch(w))
214 #define mvwgetch(w, y, x) \
215 (wmove(w, y, x) == ERR ? ERR : wgetch(w))
216 #define mvwgetstr(w, y, x, s) \
217 (wmove(w, y, x) == ERR ? ERR : wgetstr(w, s))
218 #define mvwinch(w, y, x) \
219 (wmove(w, y, x) == ERR ? ERR : winch(w))
220 #define mvwinsch(w, y, x, c) \
221 (wmove(w, y, x) == ERR ? ERR : winsch(w, c))
222
223
224 /* Psuedo functions. */
225 #define clearok(w, bf) \
226 ((bf) ? ((w)->flags |= __CLEAROK) : ((w)->flags &= ~__CLEAROK))
227 #define flushok(w, bf) \
228 ((bf) ? ((w)->flags |= __FLUSH) : ((w)->flags &= ~__FLUSH))
229 #define leaveok(w, bf) \
230 ((bf) ? ((w)->flags |= __LEAVEOK) : ((w)->flags &= ~__LEAVEOK))
231 #define scrollok(w, bf) \
232 ((bf) ? ((w)->flags |= __SCROLLOK) : ((w)->flags &= ~__SCROLLOK))
233 #define winch(w) \
234 ((w)->lines[(w)->cury]->line[(w)->curx].ch & 0177)
235
236 #define getyx(w, y, x) (y) = getcury(w), (x) = getcurx(w)
237 #define getbegyx(w, y, x) (y) = getbegy(w), (x) = getbegx(w)
238 #define getmaxyx(w, y, x) (y) = getmaxy(w), (x) = getmaxx(w)
239 #define getcury(w) ((w)->cury)
240 #define getcurx(w) ((w)->curx)
241 #define getbegy(w) ((w)->begy)
242 #define getbegx(w) ((w)->begx)
243 #define getmaxy(w) ((w)->maxy)
244 #define getmaxx(w) ((w)->maxx)
245
246 /* Public function prototypes. */
247 __BEGIN_DECLS
248 int box __P((WINDOW *, int, int));
249 int cbreak __P((void));
250 int delwin __P((WINDOW *));
251 int echo __P((void));
252 int endwin __P((void));
253 char *fullname __P((char *, char *));
254 char *getcap __P((char *));
255 int gettmode __P((void));
256 void idlok __P((WINDOW *, int));
257 WINDOW *initscr __P((void));
258 char *longname __P((char *, char *));
259 int mvcur __P((int, int, int, int));
260 int mvprintw __P((int, int, const char *, ...));
261 int mvscanw __P((int, int, const char *, ...));
262 int mvwin __P((WINDOW *, int, int));
263 int mvwprintw __P((WINDOW *, int, int, const char *, ...));
264 int mvwscanw __P((WINDOW *, int, int, const char *, ...));
265 WINDOW *newwin __P((int, int, int, int));
266 int nl __P((void));
267 int nocbreak __P((void));
268 int noecho __P((void));
269 int nonl __P((void));
270 int noraw __P((void));
271 int overlay __P((WINDOW *, WINDOW *));
272 int overwrite __P((WINDOW *, WINDOW *));
273 int printw __P((const char *, ...));
274 int raw __P((void));
275 int resetty __P((void));
276 int savetty __P((void));
277 int scanw __P((const char *, ...));
278 int scroll __P((WINDOW *));
279 int setterm __P((char *));
280 int sscans __P((WINDOW *, const char *, ...));
281 WINDOW *subwin __P((WINDOW *, int, int, int, int));
282 int suspendwin __P((void));
283 int touchline __P((WINDOW *, int, int, int));
284 int touchoverlap __P((WINDOW *, WINDOW *));
285 int touchwin __P((WINDOW *));
286 int vwprintw __P((WINDOW *, const char *, _BSD_VA_LIST_));
287 int vwscanw __P((WINDOW *, const char *, _BSD_VA_LIST_));
288 int waddch __P((WINDOW *, int));
289 int waddnstr __P((WINDOW *, const char *, int));
290 int wclear __P((WINDOW *));
291 int wclrtobot __P((WINDOW *));
292 int wclrtoeol __P((WINDOW *));
293 int wdelch __P((WINDOW *));
294 int wdeleteln __P((WINDOW *));
295 int werase __P((WINDOW *));
296 int wgetch __P((WINDOW *));
297 int wgetstr __P((WINDOW *, char *));
298 int winsch __P((WINDOW *, int));
299 int winsertln __P((WINDOW *));
300 int wmove __P((WINDOW *, int, int));
301 int wprintw __P((WINDOW *, const char *, ...));
302 int wrefresh __P((WINDOW *));
303 int wscanw __P((WINDOW *, const char *, ...));
304 int wstandend __P((WINDOW *));
305 int wstandout __P((WINDOW *));
306 int vwprintw __P((WINDOW *, const char *, _BSD_VA_LIST_));
307
308 /* Private functions that are needed for user programs prototypes. */
309 void __cputchar __P((int));
310 int __waddbytes __P((WINDOW *, const char *, int, int));
311 __END_DECLS
312
313 /* Private functions. */
314 #ifdef _CURSES_PRIVATE
315 void __CTRACE __P((const char *, ...));
316 unsigned int __hash __P((char *, int));
317 void __id_subwins __P((WINDOW *));
318 int __mvcur __P((int, int, int, int, int));
319 void __restore_stophandler __P((void));
320 void __set_stophandler __P((void));
321 void __set_subwin __P((WINDOW *, WINDOW *));
322 void __startwin __P((void));
323 void __stop_signal_handler __P((int));
324 void __swflags __P((WINDOW *));
325 int __touchline __P((WINDOW *, int, int, int, int));
326 int __touchwin __P((WINDOW *));
327 char *__tscroll __P((const char *, int, int));
328 int __waddch __P((WINDOW *, __LDATA *));
329 int __stopwin __P((void));
330 void __restartwin __P((void));
331
332 /* Private #defines. */
333 #define min(a,b) (a < b ? a : b)
334 #define max(a,b) (a > b ? a : b)
335
336 /* Private externs. */
337 extern int __echoit;
338 extern int __endwin;
339 extern int __pfast;
340 extern int __rawmode;
341 extern int __noqch;
342 #endif
343
344 #endif /* !_CURSES_H_ */
345