curses_private.h revision 1.80 1 /* $NetBSD: curses_private.h,v 1.80 2022/05/03 07:25:34 blymn Exp $ */
2
3 /*-
4 * Copyright (c) 1998-2000 Brett Lymn
5 * (blymn (at) baea.com.au, brett_lymn (at) yahoo.com.au)
6 * All rights reserved.
7 *
8 * This code has been donated to The NetBSD Foundation by the Author.
9 *
10 * Redistribution and use in source and binary forms, with or without
11 * modification, are permitted provided that the following conditions
12 * are met:
13 * 1. Redistributions of source code must retain the above copyright
14 * notice, this list of conditions and the following disclaimer.
15 * 2. The name of the author may not be used to endorse or promote products
16 * derived from this software without specific prior written permission
17 *
18 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
19 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
20 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
21 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
22 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
23 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
24 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
25 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
26 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
27 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28 *
29 *
30 */
31
32 /* Modified by Ruibiao Qiu <ruibiao (at) arl.wustl.edu,ruibiao (at) gmail.com>
33 * to add support for wide characters
34 * Changes:
35 * - Add a compiler variable HAVE_WCHAR for wide character only code
36 * - Add a pointer to liked list of non-spacing characters in __ldata
37 * and the macro to access the width field in the attribute field
38 * - Add a circular input character buffer in __screen to handle
39 * wide-character input (used in get_wch())
40 */
41
42 #include <term.h>
43 #include <termios.h>
44
45 /* Private structure definitions for curses. */
46
47 /* Termcap capabilities. */
48 #ifdef HAVE_WCHAR
49 /*
50 * Add a list of non-spacing characters to each spacing
51 * character in a singly linked list
52 */
53 typedef struct nschar_t {
54 wchar_t ch; /* Non-spacing character */
55 struct nschar_t *next; /* Next non-spacing character */
56 } nschar_t;
57 #endif /* HAVE_WCHAR */
58
59 /*
60 * A window is an array of __LINE structures pointed to by the 'lines' pointer.
61 * A line is an array of __LDATA structures pointed to by the 'line' pointer.
62 *
63 * IMPORTANT: the __LDATA structure must NOT induce any padding, so if new
64 * fields are added -- padding fields with *constant values* should ensure
65 * that the compiler will not generate any padding when storing an array of
66 * __LDATA structures. This is to enable consistent use of memcmp, and memcpy
67 * for comparing and copying arrays.
68 */
69
70 struct __ldata {
71 wchar_t ch; /* Character */
72 attr_t attr; /* Attributes */
73 #define CA_CONTINUATION 0x0001 /* a continuation cell */
74 #define CA_BACKGROUND 0x0002 /* background char */
75 int16_t cflags; /* internal attributes for wide char */
76 #ifdef HAVE_WCHAR
77 nschar_t *nsp; /* Foreground non-spacing character pointer */
78 int16_t wcols; /* display width of a wide char */
79 #endif /* HAVE_WCHAR */
80 };
81
82 #define __LDATASIZE (sizeof(__LDATA))
83
84 struct __line {
85 #ifdef DEBUG
86 #define SENTINEL_VALUE 0xaac0ffee
87
88 unsigned int sentinel; /* try to catch line overflows */
89 #endif
90 #define __ISDIRTY 0x01 /* Line is dirty. */
91 #define __ISPASTEOL 0x02 /* Cursor is past end of line */
92 #define __ISFORCED 0x04 /* Force update, no optimisation */
93 unsigned int flags;
94 unsigned int hash; /* Hash value for the line. */
95 int *firstchp, *lastchp; /* First and last chngd columns ptrs */
96 int firstch, lastch; /* First and last changed columns. */
97 __LDATA *line; /* Pointer to the line text. */
98 };
99
100 struct __window { /* Window structure. */
101 struct __window *nextp, *orig; /* Subwindows list and parent. */
102 int begy, begx; /* Window home. */
103 int cury, curx; /* Current x, y coordinates. */
104 int maxy, maxx; /* Maximum values for curx, cury. */
105 int reqy, reqx; /* Size requested when created */
106 int ch_off; /* x offset for firstch/lastch. */
107 __LINE **alines; /* Array of pointers to the lines */
108 __LINE *lspace; /* line space (for cleanup) */
109 __LDATA *wspace; /* window space (for cleanup) */
110
111 #define __ENDLINE 0x00000001 /* End of screen. */
112 #define __FLUSH 0x00000002 /* Fflush(stdout) after refresh. */
113 #define __FULLWIN 0x00000004 /* Window is a screen. */
114 #define __IDLINE 0x00000008 /* Insert/delete sequences. */
115 #define __SCROLLWIN 0x00000010 /* Last char will scroll window. */
116 #define __SCROLLOK 0x00000020 /* Scrolling ok. */
117 #define __CLEAROK 0x00000040 /* Clear on next refresh. */
118 #define __LEAVEOK 0x00000100 /* If cursor left */
119 #define __KEYPAD 0x00010000 /* If interpreting keypad codes */
120 #define __NOTIMEOUT 0x00020000 /* Wait indefinitely for func keys */
121 #define __IDCHAR 0x00040000 /* insert/delete char sequences */
122 #define __ISPAD 0x00080000 /* "window" is a pad */
123 #define __ISDERWIN 0x00100000 /* "window" is derived from parent */
124 #define __IMMEDOK 0x00200000 /* refreshed when changed */
125 #define __SYNCOK 0x00400000 /* sync when changed */
126 #define __HALFDELAY 0x00800000 /* In half delay mode */
127 unsigned int flags;
128 int delay; /* delay for getch() */
129 attr_t wattr; /* Character attributes */
130 wchar_t bch; /* Background character */
131 attr_t battr; /* Background attributes */
132 uint32_t wcols; /* Background column width */
133 int scr_t, scr_b; /* Scrolling region top, bottom */
134 SCREEN *screen; /* Screen for this window */
135 int pbegy, pbegx,
136 sbegy, sbegx,
137 smaxy, smaxx; /* Saved prefresh() values */
138 int dery, derx; /* derived window coordinates
139 - top left corner of source
140 relative to parent win */
141 #ifdef HAVE_WCHAR
142 nschar_t *bnsp; /* Background non-spacing char list */
143 #endif /* HAVE_WCHAR */
144 FILE *fp; /* for window formatted printf */
145 char *buf; /* buffer for window formatted printf */
146 size_t buflen; /* length of above buffer */
147 };
148
149 /* Set of attributes unset by 'me' - 'mb', 'md', 'mh', 'mk', 'mp' and 'mr'. */
150 #ifndef HAVE_WCHAR
151 #define __TERMATTR \
152 (__REVERSE | __BLINK | __DIM | __BOLD | __BLANK | __PROTECT)
153 #else
154 #define __TERMATTR \
155 (__REVERSE | __BLINK | __DIM | __BOLD | __BLANK | __PROTECT \
156 | WA_TOP | WA_LOW | WA_LEFT | WA_RIGHT | WA_HORIZONTAL | WA_VERTICAL)
157 #endif /* HAVE_WCHAR */
158
159 struct __winlist {
160 struct __window *winp; /* The window. */
161 struct __winlist *nextp; /* Next window. */
162 };
163
164 struct __color {
165 short num;
166 short red;
167 short green;
168 short blue;
169 int flags;
170 };
171
172 /* List of colour pairs */
173 struct __pair {
174 short fore;
175 short back;
176 int flags;
177 };
178
179 /* Maximum colours */
180 #define MAX_COLORS 256
181 /* Maximum colour pairs - determined by number of colour bits in attr_t */
182 #define MAX_PAIRS PAIR_NUMBER(__COLOR)
183
184 typedef struct keymap keymap_t;
185
186 /* POSIX allows up to 8 columns in a label. */
187 #define MAX_SLK_COLS 8
188 #ifdef HAVE_WCHAR
189 #define MAX_SLK_LABEL sizeof(wchar_t) * MAX_SLK_COLS
190 #else
191 #define MAX_SLK_LABEL MAX_SLK_COLS
192 #endif
193 struct __slk_label {
194 char *text;
195 int justify;
196 #define SLK_JUSTIFY_LEFT 0
197 #define SLK_JUSTIFY_CENTER 1
198 #define SLK_JUSTIFY_RIGHT 2
199 char label[MAX_SLK_LABEL + 1];
200 int x;
201 };
202
203 #define MAX_RIPS 5
204 struct __ripoff {
205 int nlines;
206 WINDOW *win;
207 };
208
209 /* this is the encapsulation of the terminal definition, one for
210 * each terminal that curses talks to.
211 */
212 struct __screen {
213 FILE *infd, *outfd; /* input and output file descriptors */
214 WINDOW *curscr; /* Current screen. */
215 WINDOW *stdscr; /* Standard screen. */
216 WINDOW *__virtscr; /* Virtual screen (for doupdate()). */
217 int curwin; /* current window for refresh */
218 int lx, ly; /* loop parameters for refresh */
219 int COLS; /* Columns on the screen. */
220 int LINES; /* Lines on the screen. */
221 int nripped; /* Number of ripofflines. */
222 struct __ripoff ripped[MAX_RIPS]; /* ripofflines. */
223 int ESCDELAY; /* Delay between keys in esc seq's. */
224 #define ESCDELAY_DEFAULT 300 /* milliseconds. */
225 int TABSIZE; /* Size of a tab. */
226 #define TABSIZE_DEFAULT 8 /* spaces. */
227 int COLORS; /* Maximum colors on the screen */
228 int COLOR_PAIRS; /* Maximum color pairs on the screen */
229 int My_term; /* Use Def_term regardless. */
230 char GT; /* Gtty indicates tabs. */
231 char NONL; /* Term can't hack LF doing a CR. */
232 char UPPERCASE; /* Terminal is uppercase only. */
233
234 chtype acs_char[NUM_ACS];
235 #ifdef HAVE_WCHAR
236 cchar_t wacs_char[ NUM_ACS ];
237 #endif /* HAVE_WCHAR */
238 struct __color colours[MAX_COLORS];
239 struct __pair colour_pairs[MAX_PAIRS];
240 attr_t nca;
241
242 /* Style of colour manipulation */
243 #define COLOR_NONE 0
244 #define COLOR_ANSI 1 /* ANSI/DEC-style colour manipulation */
245 #define COLOR_HP 2 /* HP-style colour manipulation */
246 #define COLOR_TEK 3 /* Tektronix-style colour manipulation */
247 #define COLOR_OTHER 4 /* None of the others but can set fore/back */
248 int color_type;
249
250 attr_t mask_op;
251 attr_t mask_me;
252 attr_t mask_ue;
253 attr_t mask_se;
254 TERMINAL *term;
255 int old_mode; /* old cursor visibility state for terminal */
256 keymap_t *base_keymap;
257 int echoit;
258 int pfast;
259 int rawmode;
260 int nl;
261 int noqch;
262 int clearok;
263 int useraw;
264 struct __winlist *winlistp;
265 struct termios cbreakt, rawt, *curt, save_termios;
266 struct termios orig_termios, baset, savedtty;
267 int ovmin;
268 int ovtime;
269 char *stdbuf;
270 unsigned int len;
271 int meta_state;
272 char padchar;
273 int endwin;
274 int notty;
275 int resized;
276 wchar_t *unget_list;
277 int unget_len, unget_pos;
278 int filtered;
279 int checkfd;
280
281 /* soft label key */
282 bool is_term_slk;
283 WINDOW *slk_window;
284 int slk_format;
285 #define SLK_FMT_INVAL -1
286 #define SLK_FMT_3_2_3 0
287 #define SLK_FMT_4_4 1
288 int slk_nlabels;
289 int slk_label_len;
290 bool slk_hidden;
291 struct __slk_label *slk_labels;
292
293 #define MAX_CBUF_SIZE 8
294 #ifdef HAVE_WCHAR
295 int cbuf_head; /* header to cbuf */
296 int cbuf_tail; /* tail to cbuf */
297 int cbuf_cur; /* the current char in cbuf */
298 mbstate_t sp; /* wide char processing state */
299 char cbuf[ MAX_CBUF_SIZE ]; /* input character buffer */
300 #endif /* HAVE_WCHAR */
301 };
302
303
304 extern char __GT; /* Gtty indicates tabs. */
305 extern char __NONL; /* Term can't hack LF doing a CR. */
306 extern char __UPPERCASE; /* Terminal is uppercase only. */
307 extern int My_term; /* Use Def_term regardless. */
308 extern const char *Def_term; /* Default terminal type. */
309 extern SCREEN *_cursesi_screen; /* The current screen in use */
310
311 /* Debugging options/functions. */
312 #ifdef DEBUG
313 #define __CTRACE_TSTAMP 0x00000001
314 #define __CTRACE_MISC 0x00000002
315 #define __CTRACE_INIT 0x00000004
316 #define __CTRACE_SCREEN 0x00000008
317 #define __CTRACE_WINDOW 0x00000010
318 #define __CTRACE_REFRESH 0x00000020
319 #define __CTRACE_COLOR 0x00000040
320 #define __CTRACE_INPUT 0x00000080
321 #define __CTRACE_OUTPUT 0x00000100
322 #define __CTRACE_LINE 0x00000200
323 #define __CTRACE_ATTR 0x00000400
324 #define __CTRACE_ERASE 0x00000800
325 #define __CTRACE_FILEIO 0x00001000
326 #define __CTRACE_ALL 0x7fffffff
327 void __CTRACE(int, const char *, ...) __attribute__((__format__(__printf__, 2, 3)));
328 #else
329 #define __CTRACE(area, fmt, ...) __nothing
330 #endif
331
332 /* Common erase logic */
333 #ifdef HAVE_WCHAR
334 #define __NEED_ERASE(_sp, _bch, _battr) \
335 ((_sp)->ch != (_bch) || \
336 (((_sp)->cflags & CA_BACKGROUND) != CA_BACKGROUND) || \
337 ((_sp)->attr & WA_ATTRIBUTES) != (_battr) || \
338 (_sp)->nsp != NULL || \
339 (_sp)->wcols < 0)
340 #else
341 #define __NEED_ERASE(_sp, _bch, _battr) \
342 ((_sp)->ch != (_bch) || (_sp)->attr != (_battr))
343 #endif
344
345 /* Private functions. */
346 int __cputchar_args(int, void *);
347 void _cursesi_free_keymap(keymap_t *);
348 int _cursesi_gettmode(SCREEN *);
349 void _cursesi_reset_acs(SCREEN *);
350 int _cursesi_addbyte(WINDOW *, __LINE **, int *, int *, int , attr_t, int);
351 int _cursesi_addwchar(WINDOW *, __LINE **, int *, int *, const cchar_t *,
352 int);
353 int _cursesi_waddbytes(WINDOW *, const char *, int, attr_t, int);
354 #ifdef HAVE_WCHAR
355 void _cursesi_reset_wacs(SCREEN *);
356 #endif /* HAVE_WCHAR */
357 void _cursesi_resetterm(SCREEN *);
358 int _cursesi_setterm(char *, SCREEN *);
359 int __delay(void);
360 unsigned int __hash_more(const void *, size_t, unsigned int);
361 unsigned int __hash_line(const __LDATA *, int);
362 #define __hash(s, len) __hash_more((s), (len), 0u)
363 void __id_subwins(WINDOW *);
364 void __init_getch(SCREEN *);
365 void __init_acs(SCREEN *);
366 int _cursesi_celleq(__LDATA *, __LDATA *);
367 #ifdef HAVE_WCHAR
368 void __init_get_wch(SCREEN *);
369 void __init_wacs(SCREEN *);
370 int __cputwchar_args( wchar_t, void * );
371 void _cursesi_copy_wchar(__LDATA *, __LDATA *);
372 int _cursesi_copy_nsp(nschar_t *, struct __ldata *);
373 void __cursesi_free_nsp(nschar_t *);
374 void __cursesi_win_free_nsp(WINDOW *);
375 void __cursesi_putnsp(nschar_t *, const int, const int);
376 void __cursesi_chtype_to_cchar(chtype, cchar_t *);
377 #endif /* HAVE_WCHAR */
378 int __fgetc_resize(FILE *);
379 int __unget(wint_t);
380 int __mvcur(int, int, int, int, int);
381 WINDOW *__newwin(SCREEN *, int, int, int, int, int, int);
382 int __nodelay(void);
383 int __notimeout(void);
384 void __restartwin(void);
385 void __restore_colors(void);
386 void __restore_cursor_vis(void);
387 void __restore_meta_state(void);
388 void __restore_termios(void);
389 void __restore_stophandler(void);
390 void __restore_winchhandler(void);
391 int __ripoffscreen(SCREEN *);
392 int __ripoffresize(SCREEN *);
393 void __ripofftouch(SCREEN *);
394 int __rippedlines(const SCREEN *, int);
395 void __save_termios(void);
396 void __set_color(WINDOW *win, attr_t attr);
397 void __set_stophandler(void);
398 void __set_winchhandler(void);
399 void __set_subwin(WINDOW *, WINDOW *);
400 int __slk_init(SCREEN *);
401 void __slk_free(SCREEN *);
402 int __slk_resize(SCREEN *, int cols);
403 int __slk_noutrefresh(SCREEN *);
404 void __startwin(SCREEN *);
405 void __stop_signal_handler(int);
406 int __stopwin(void);
407 void __swflags(WINDOW *);
408 void __sync(WINDOW *);
409 int __timeout(int);
410 int __touchline(WINDOW *, int, int, int);
411 int __touchwin(WINDOW *, int);
412 int __unripoffline(int (*)(WINDOW *, int));
413 void __unsetattr(int);
414 void __unset_color(WINDOW *win);
415 int __waddch(WINDOW *, __LDATA *);
416 int __wgetnstr(WINDOW *, char *, int);
417 void __winch_signal_handler(int);
418
419 /* Private #defines. */
420 #define min(a,b) ((a) < (b) ? (a) : (b))
421 #define max(a,b) ((a) > (b) ? (a ): (b))
422
423 /* Private externs. */
424 extern int __echoit;
425 extern int __endwin;
426 extern int __pfast;
427 extern int __rawmode;
428 extern int __noqch;
429 extern attr_t __mask_op, __mask_me, __mask_ue, __mask_se;
430 extern WINDOW *__virtscr;
431 extern int __using_color;
432 extern int __do_color_init;
433 extern attr_t __default_color;
434