menu_sys.def revision 1.45 1 /* $NetBSD: menu_sys.def,v 1.45 2003/07/27 07:21:58 dsl Exp $ */
2
3 /*
4 * Copyright 1997 Piermont Information Systems Inc.
5 * All rights reserved.
6 *
7 * Written by Philip A. Nelson for Piermont Information Systems Inc.
8 *
9 * Redistribution and use in source and binary forms, with or without
10 * modification, are permitted provided that the following conditions
11 * are met:
12 * 1. Redistributions of source code must retain the above copyright
13 * notice, this list of conditions and the following disclaimer.
14 * 2. Redistributions in binary form must reproduce the above copyright
15 * notice, this list of conditions and the following disclaimer in the
16 * documentation and/or other materials provided with the distribution.
17 * 3. All advertising materials mentioning features or use of this software
18 * must display the following acknowledgement:
19 * This product includes software develooped for the NetBSD Project by
20 * Piermont Information Systems Inc.
21 * 4. The name of Piermont Information Systems Inc. may not be used to endorse
22 * or promote products derived from this software without specific prior
23 * written permission.
24 *
25 * THIS SOFTWARE IS PROVIDED BY PIERMONT INFORMATION SYSTEMS INC. ``AS IS''
26 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
27 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
28 * ARE DISCLAIMED. IN NO EVENT SHALL PIERMONT INFORMATION SYSTEMS INC. BE
29 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
30 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
31 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
32 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
33 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
34 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
35 * THE POSSIBILITY OF SUCH DAMAGE.
36 *
37 */
38
39 /* menu_sys.defs -- Menu system standard routines. */
40
41 #include <string.h>
42 #include <ctype.h>
43
44 #define REQ_EXECUTE 1000
45 #define REQ_NEXT_ITEM 1001
46 #define REQ_PREV_ITEM 1002
47 #define REQ_REDISPLAY 1003
48 #define REQ_SCROLLDOWN 1004
49 #define REQ_SCROLLUP 1005
50 #define REQ_HELP 1006
51
52 /* Macros */
53 #define MAX(x,y) ((x)>(y)?(x):(y))
54 #define MIN(x,y) ((x)<(y)?(x):(y))
55
56 /* Initialization state. */
57 static int __menu_init = 0;
58 int __m_endwin = 0;
59 static int max_lines = 0, max_cols = 0;
60 static const char *scrolltext = " <: page up, >: page down";
61
62 static menudesc *menus = menu_def;
63
64 #ifdef DYNAMIC_MENUS
65 static int num_menus = 0;
66 #define DYN_INIT_NUM 32
67 #endif
68
69 /* prototypes for in here! */
70 static void init_menu(menudesc *m);
71 static char opt_ch(menudesc *m, int op_no);
72 static void draw_menu(menudesc *m, void *arg);
73 static void process_help(menudesc *m, int num);
74 static void process_req(menudesc *m, void *arg, int num, int req);
75 static int menucmd(WINDOW *w);
76
77 #ifndef NULL
78 #define NULL 0
79 #endif
80
81 /* menu system processing routines */
82 #define mbeep() (void)fputc('\a', stderr)
83
84 static int
85 menucmd(WINDOW *w)
86 {
87 int ch;
88
89 while (TRUE) {
90 ch = wgetch(w);
91
92 switch (ch) {
93 case '\n':
94 return REQ_EXECUTE;
95 case '\016': /* Control-P */
96 case KEY_DOWN:
97 return REQ_NEXT_ITEM;
98 case '\020': /* Control-N */
99 case KEY_UP:
100 return REQ_PREV_ITEM;
101 case '\014': /* Control-L */
102 return REQ_REDISPLAY;
103 case '<':
104 case '\010': /* Control-H (backspace) */
105 case KEY_PPAGE:
106 case KEY_LEFT:
107 return REQ_SCROLLUP;
108 case '\026': /* Control-V */
109 case '>':
110 case ' ':
111 case KEY_NPAGE:
112 case KEY_RIGHT:
113 return REQ_SCROLLDOWN;
114 case '?':
115 return REQ_HELP;
116 case '\033': /* esc-v is scroll down */
117 ch = wgetch(w);
118 if (ch == 'v')
119 return REQ_SCROLLUP;
120 else
121 ch = 0; /* zap char so we beep */
122 }
123
124 if (isalpha(ch))
125 return ch;
126
127 mbeep();
128 wrefresh(w);
129 }
130 }
131
132 static void
133 init_menu(menudesc *m)
134 {
135 int wmax;
136 int hadd, wadd, exithadd;
137 int i;
138 const char *title;
139
140 hadd = ((m->mopt & MC_NOBOX) ? 0 : 2);
141 wadd = ((m->mopt & MC_NOBOX) ? 2 : 4);
142
143 if (m->title && *(title = MSG_XLAT(m->title)) != 0) {
144 wmax = strlen(title);
145 hadd += 2;
146 } else {
147 m->title = NULL;
148 title = "untitled";
149 wmax = 0;
150 }
151 exithadd = ((m->mopt & MC_NOEXITOPT) ? 0 : 1);
152
153
154 /* Calculate h? h == number of visible options. */
155 if (m->h == 0)
156 m->h = m->numopts + exithadd;
157 m->h = MIN(m->h, max_lines - m->y - hadd);
158
159 if (m->h < m->numopts + exithadd) {
160 if (!(m->mopt & MC_SCROLL) || m->h < 3) {
161 endwin();
162 (void)fprintf(stderr,
163 "Window too short for menu \"%s\"\n",
164 title);
165 exit(1);
166 }
167 hadd++;
168 m->h--;
169 } else
170 m->mopt &= ~MC_SCROLL;
171 #if 0
172 /* check for screen fit */
173 if (m->y + m->h + hadd > max_lines) {
174 endwin();
175 (void)fprintf(stderr,
176 "Screen too short (%d + %d + %d > %d) for menu \"%s\"\n",
177 m->y, m->h, hadd, max_lines, title);
178 exit(1);
179
180 }
181 #endif
182
183 /* Calculate w? */
184 if (m->w == 0) {
185 if (m->mopt & MC_SCROLL)
186 wmax = MAX(wmax,strlen(scrolltext));
187 for (i = 0; i < m->numopts; i++)
188 wmax = MAX(wmax, strlen(MSG_XLAT(m->opts[i].opt_name)) + 3);
189 m->w = wmax;
190 }
191
192 /* check and adjust for screen fit */
193 if (m->w + wadd > max_cols) {
194 endwin();
195 (void)fprintf(stderr,
196 "Screen too narrow for menu \"%s\"\n", title);
197 exit(1);
198
199 }
200 if (m->x == -1)
201 m->x = (max_cols - (m->w + wadd)) / 2; /* center */
202 else if (m->x + m->w + wadd > max_cols)
203 m->x = max_cols - (m->w + wadd);
204
205 /* Get the windows. */
206 m->mw = newwin(m->h + hadd, m->w + wadd, m->y, m->x);
207
208 if (m->mw == NULL) {
209 endwin();
210 (void)fprintf(stderr,
211 "Could not create window (%d + %d, %d + %d, %d, %d) for menu \"%s\"\n",
212 m->h, hadd, m->w, wadd, m->y, m->x, title);
213 exit(1);
214 }
215 keypad(m->mw, TRUE); /* enable multi-key assembling for win */
216
217 /* XXX is it even worth doing this right? */
218 if (has_colors()) {
219 wbkgd(m->mw, COLOR_PAIR(1));
220 wattrset(m->mw, COLOR_PAIR(1));
221 }
222 }
223
224 static char
225 opt_ch(menudesc *m, int op_no)
226 {
227 char c;
228
229 if (op_no == m->numopts)
230 return 'x';
231
232 if (op_no < 25) {
233 c = 'a' + op_no;
234 if (c >= 'x')
235 c++;
236 } else
237 c = 'A' + op_no - 25;
238 return c;
239 }
240
241 static void
242 draw_menu_line(menudesc *m, int opt, int cury, void *arg, const char *text)
243 {
244 int hasbox = m->mopt & MC_NOBOX ? 0 : 1;
245
246 if (m->cursel == opt) {
247 mvwaddstr(m->mw, cury, hasbox, ">");
248 wstandout(m->mw);
249 } else
250 mvwaddstr(m->mw, cury, hasbox, " ");
251 if (!(m->mopt & MC_NOSHORTCUT))
252 wprintw(m->mw, "%c: ", opt_ch(m, opt));
253
254 if (!text && m->draw_line)
255 m->draw_line(m, opt, arg);
256 else
257 waddstr(m->mw, MSG_XLAT(text));
258 if (m->cursel == opt)
259 wstandend(m->mw);
260 }
261
262 static void
263 draw_menu(menudesc *m, void *arg)
264 {
265 int opt;
266 int hasbox, cury, maxy;
267 int tadd;
268 int hasexit = (m->mopt & MC_NOEXITOPT ? 0 : 1);
269
270 if (m->mopt & MC_NOBOX) {
271 cury = 0;
272 maxy = m->h;
273 hasbox = 0;
274 } else {
275 cury = 1;
276 maxy = m->h + 1;
277 hasbox = 1;
278 }
279
280 /* Clear the window */
281 wclear(m->mw);
282
283 if (m->title) {
284 mvwaddstr(m->mw, hasbox, hasbox, " ");
285 waddstr(m->mw, MSG_XLAT(m->title));
286 tadd = 2;
287 cury += tadd;
288 maxy += tadd;
289 } else
290 tadd = 0;
291
292 if (m->cursel == -1) {
293 m->cursel = m->numopts;
294 if (m->h <= m->numopts)
295 m->topline = m->numopts + 1 - m->h;
296 }
297
298 while (m->cursel >= m->topline + m->h)
299 m->topline = MIN(m->topline + m->h,
300 m->numopts + hasexit - m->h);
301 while (m->cursel < m->topline)
302 m->topline = MAX(0, m->topline - m->h);
303
304 for (opt = m->topline; opt < m->numopts; opt++) {
305 if (cury >= maxy)
306 break;
307 draw_menu_line(m, opt, cury++, arg, m->opts[opt].opt_name);
308 }
309
310 /* Add the exit option. */
311 if (!(m->mopt & MC_NOEXITOPT)) {
312 if (cury < maxy)
313 draw_menu_line(m, m->numopts, cury++, arg, m->exitstr);
314 else
315 opt = 0;
316 }
317
318 /* Add the scroll line */
319 if (opt != m->numopts || m->topline != 0)
320 mvwaddstr(m->mw, cury, hasbox, scrolltext);
321
322 /* Add the box. */
323 if (!(m->mopt & MC_NOBOX))
324 box(m->mw, 0, 0);
325
326 wmove(m->mw, tadd + hasbox + m->cursel - m->topline, hasbox);
327 wrefresh(m->mw);
328 }
329
330 static void
331 /*ARGSUSED*/
332 process_help(menudesc *m, int num)
333 {
334 const char *help = m->helpstr;
335 int lineoff = 0;
336 int curoff = 0;
337 int again;
338 int winin;
339
340 /* Is there help? */
341 if (!help) {
342 mbeep();
343 return;
344 }
345 help = MSG_XLAT(help);
346
347 /* Display the help information. */
348 do {
349 if (lineoff < curoff) {
350 help = MSG_XLAT(m->helpstr);
351 curoff = 0;
352 }
353 while (*help && curoff < lineoff) {
354 if (*help == '\n')
355 curoff++;
356 help++;
357 }
358
359 wclear(stdscr);
360 mvwaddstr(stdscr, 0, 0,
361 "Help: exit: x, page up: u <, page down: d >");
362 mvwaddstr(stdscr, 2, 0, help);
363 wmove(stdscr, 1, 0);
364 wrefresh(stdscr);
365
366 do {
367 winin = wgetch(stdscr);
368 if (winin < KEY_MIN)
369 winin = tolower(winin);
370 again = 0;
371 switch (winin) {
372 case '<':
373 case 'u':
374 case KEY_UP:
375 case KEY_LEFT:
376 case KEY_PPAGE:
377 if (lineoff)
378 lineoff -= max_lines - 2;
379 else
380 again = 1;
381 break;
382 case '>':
383 case 'd':
384 case KEY_DOWN:
385 case KEY_RIGHT:
386 case KEY_NPAGE:
387 if (*help)
388 lineoff += max_lines - 2;
389 else
390 again = 1;
391 break;
392 case 'q':
393 break;
394 case 'x':
395 winin = 'q';
396 break;
397 default:
398 again = 1;
399 }
400 if (again)
401 mbeep();
402 } while (again);
403 } while (winin != 'q');
404 }
405
406 static void
407 process_req(menudesc *m, void *arg, int num, int req)
408 {
409 int ch;
410 int hasexit = (m->mopt & MC_NOEXITOPT ? 0 : 1);
411
412 switch(req) {
413
414 case REQ_EXECUTE:
415 return;
416
417 case REQ_NEXT_ITEM:
418 ch = m->cursel;
419 for (;;) {
420 ch++;
421 if (ch >= m->numopts + hasexit) {
422 mbeep();
423 return;
424 }
425 if (hasexit && ch == m->numopts)
426 break;
427 if (!(m->opts[ch].opt_flags & OPT_IGNORE))
428 break;
429 }
430 m->cursel = ch;
431 if (m->mopt & MC_SCROLL && m->cursel >= m->topline + m->h)
432 m->topline = m->cursel - m->h + 1;
433 break;
434
435 case REQ_PREV_ITEM:
436 ch = m->cursel;
437 for (;;) {
438 if (ch <= 0) {
439 mbeep();
440 return;
441 }
442 ch--;
443 if (!(m->opts[ch].opt_flags & OPT_IGNORE))
444 break;
445 }
446 m->cursel = ch;
447 if (m->cursel < m->topline)
448 m->topline = m->cursel;
449 break;
450
451 case REQ_HELP:
452 process_help(m, num);
453 /* FALLTHROUGH */
454
455 case REQ_REDISPLAY:
456 wclear(stdscr);
457 wrefresh(stdscr);
458 if (m->post_act)
459 (*m->post_act)(m, arg);
460 break;
461
462 case REQ_SCROLLUP:
463 if (m->cursel == 0) {
464 mbeep();
465 return;
466 }
467 m->topline = MAX(0, m->topline - m->h);
468 m->cursel = MAX(0, m->cursel - m->h);
469 wclear(m->mw);
470 break;
471
472 case REQ_SCROLLDOWN:
473 if (m->cursel >= m->numopts + hasexit - 1) {
474 mbeep();
475 return;
476 }
477 m->topline = MIN(m->topline + m->h,
478 MAX(m->numopts + hasexit - m->h, 0));
479 m->cursel = MIN(m->numopts + hasexit - 1, m->cursel + m->h);
480 wclear(m->mw);
481 break;
482
483 default:
484 ch = req;
485 if (ch == 'x' && hasexit) {
486 m->cursel = m->numopts;
487 break;
488 }
489 if (m->mopt & MC_NOSHORTCUT) {
490 mbeep();
491 return;
492 }
493 if (ch > 'z')
494 ch = 255;
495 if (ch >= 'a') {
496 if (ch > 'x')
497 ch--;
498 ch = ch - 'a';
499 } else
500 ch = 25 + ch - 'A';
501 if (ch < 0 || ch >= m->numopts) {
502 mbeep();
503 return;
504 }
505 if (m->opts[ch].opt_flags & OPT_IGNORE) {
506 mbeep();
507 return;
508 }
509 m->cursel = ch;
510 }
511
512 draw_menu(m, arg);
513 }
514
515 int
516 menu_init(void)
517 {
518
519 if (__menu_init)
520 return 0;
521
522 #ifdef USER_MENU_INIT
523 if (USER_MENU_INIT)
524 return 1;
525 #endif
526
527 if (initscr() == NULL)
528 return 1;
529
530 cbreak();
531 noecho();
532
533 /* XXX Should be configurable but it almost isn't worth it. */
534 if (has_colors()) {
535 start_color();
536 init_pair(1, COLOR_WHITE, COLOR_BLUE);
537 bkgd(COLOR_PAIR(1));
538 attrset(COLOR_PAIR(1));
539 }
540
541 max_lines = getmaxy(stdscr);
542 max_cols = getmaxx(stdscr);
543 keypad(stdscr, TRUE);
544 #ifdef DYNAMIC_MENUS
545 num_menus = DYN_INIT_NUM;
546 while (num_menus < DYN_MENU_START)
547 num_menus *= 2;
548 menus = malloc(sizeof(menudesc) * num_menus);
549 if (menus == NULL)
550 return 2;
551 (void)memset(menus, 0, sizeof(menudesc) * num_menus);
552 (void)memcpy(menus, menu_def, sizeof(menudesc) * DYN_MENU_START);
553 #endif
554
555 __menu_init = 1;
556 return 0;
557 }
558
559 void
560 process_menu(int num, void *arg)
561 {
562 int sel = 0;
563 int req, done;
564 int last_num;
565 menu_ent *opt;
566
567 menudesc *m;
568
569 m = &menus[num];
570
571 done = FALSE;
572
573 /* Initialize? */
574 if (menu_init()) {
575 __menu_initerror();
576 return;
577 }
578
579 if (__m_endwin) {
580 wclear(stdscr);
581 wrefresh(stdscr);
582 __m_endwin = 0;
583 }
584 if (m->mw == NULL)
585 init_menu(m);
586
587 /* Default to select option 0 and display from 0 */
588 m->topline = 0;
589 if ((m->mopt & (MC_DFLTEXIT | MC_NOEXITOPT)) == MC_DFLTEXIT)
590 m->cursel = -1;
591 else
592 m->cursel = 0;
593
594 while (!done) {
595 last_num = num;
596 if (__m_endwin) {
597 wclear(stdscr);
598 wrefresh(stdscr);
599 __m_endwin = 0;
600 }
601 /* Process the display action */
602 if (m->post_act)
603 (*m->post_act)(m, arg);
604 draw_menu(m, arg);
605
606 while ((req = menucmd(m->mw)) != REQ_EXECUTE)
607 process_req(m, arg, num, req);
608
609 sel = m->cursel;
610 if (!(m->mopt & MC_NOCLEAR)) {
611 wclear(m->mw);
612 wrefresh(m->mw);
613 }
614
615 /* Process the items */
616 if (sel < m->numopts) {
617 opt = &m->opts[sel];
618 if (opt->opt_flags & OPT_IGNORE)
619 continue;
620 if (opt->opt_flags & OPT_ENDWIN) {
621 endwin();
622 __m_endwin = 1;
623 }
624 if (opt->opt_action)
625 done = (*opt->opt_action)(m, arg);
626 if (opt->opt_menu != -1) {
627 if (opt->opt_flags & OPT_SUB)
628 process_menu(opt->opt_menu, arg);
629 else
630 num = opt->opt_menu;
631 }
632
633 if (opt->opt_flags & OPT_EXIT)
634 done = TRUE;
635
636 } else
637 done = TRUE;
638
639 /* Reselect m just in case */
640 if (num != last_num) {
641 m = &menus[num];
642
643 /* Initialize? */
644 if (m->mw == NULL)
645 init_menu(m);
646 if (m->post_act)
647 (*m->post_act)(m,arg);
648 }
649 }
650
651 if (m->mopt & MC_NOCLEAR) {
652 wclear(m->mw);
653 wrefresh(m->mw);
654 }
655
656 /* Process the exit action */
657 if (m->exit_act)
658 (*m->exit_act)(m, arg);
659 }
660
661 /* Control L is end of standard routines, remaining only for dynamic. */
663
664 /* Beginning of routines for dynamic menus. */
665
666 static int
667 double_menus(void)
668 {
669 menudesc *temp;
670 int sz = sizeof(menudesc) * num_menus;
671
672 temp = realloc(menus, sz * 2);
673 if (temp == NULL)
674 return 0;
675 (void)memset(temp + num_menus, 0, sz);
676 menus = temp;
677 num_menus *= 2;
678
679 return 1;
680 }
681
682 int
683 new_menu(const char *title, menu_ent *opts, int numopts,
684 int x, int y, int h, int w, int mopt,
685 void (*post_act)(menudesc *, void *),
686 void (*draw_line)(menudesc *, int, void *),
687 void (*exit_act)(menudesc *, void *),
688 const char *help, const char *exit_str)
689 {
690 int ix;
691 menudesc *m;
692
693 /* Find free menu entry. */
694 for (ix = DYN_MENU_START; ; ix++) {
695 if (ix > num_menus && !double_menus())
696 return -1;
697 if (!(menus[ix].mopt & MC_VALID))
698 break;
699 }
700
701 /* Set Entries */
702 m = menus + ix;
703 m->title = title;
704 m->opts = opts;
705 m->numopts = numopts;
706 m->x = x;
707 m->y = y;
708 m->h = h;
709 m->w = w;
710 m->mopt = mopt | MC_VALID;
711 m->post_act = post_act;
712 m->draw_line = draw_line;
713 m->exit_act = exit_act;
714 m->helpstr = help;
715 m->exitstr = exit_str ? exit_str : "Exit";
716
717 init_menu(m);
718
719 return ix;
720 }
721
722 void
723 free_menu(int menu_no)
724 {
725 menudesc *m;
726
727 if (menu_no < 0 || menu_no >= num_menus)
728 return;
729
730 m = menus + menu_no;
731 if ((m->mopt & MC_VALID))
732 return;
733 if (m->mw != NULL)
734 delwin(m->mw);
735 memset(m, 0, sizeof *m);
736 }
737
738 void
739 set_menu_numopts(int menu, int numopts)
740 {
741
742 menus[menu].numopts = numopts;
743 }
744