Home | History | Annotate | Line # | Download | only in menuc
menu_sys.def revision 1.38
      1 /*	$NetBSD: menu_sys.def,v 1.38 2003/06/04 19:07:39 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 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 static int num_avail  = 0;
     67 #define DYN_INIT_NUM 32
     68 #endif
     69 
     70 /* prototypes for in here! */
     71 static void init_menu(struct menudesc *m);
     72 static char opt_ch(int op_no);
     73 static void draw_menu(struct menudesc *m);
     74 static void process_help(struct menudesc *m, int num);
     75 static void process_req(struct menudesc *m, int num, int req);
     76 static int menucmd(WINDOW *w);
     77 
     78 #ifndef NULL
     79 #define NULL 0
     80 #endif
     81 
     82 /* menu system processing routines */
     83 #define mbeep() (void)fputc('\a', stderr)
     84 
     85 static int
     86 menucmd(WINDOW *w)
     87 {
     88 	int ch;
     89 
     90 	while (TRUE) {
     91 		ch = wgetch(w);
     92 
     93 		switch (ch) {
     94 		case '\n':
     95 			return REQ_EXECUTE;
     96 		case '\016':  /* Control-P */
     97 		case KEY_DOWN:
     98 			return REQ_NEXT_ITEM;
     99 		case '\020':  /* Control-N */
    100 		case KEY_UP:
    101 			return REQ_PREV_ITEM;
    102 		case '\014':  /* Control-L */
    103 			return REQ_REDISPLAY;
    104 		case '<':
    105 		case '\010':  /* Control-H (backspace) */
    106 		case KEY_PPAGE:
    107 		case KEY_LEFT:
    108 			return REQ_SCROLLUP;
    109 		case '\026':  /* Control-V */
    110 		case '>':
    111 		case ' ':
    112 		case KEY_NPAGE:
    113 		case KEY_RIGHT:
    114 			return REQ_SCROLLDOWN;
    115 		case '?':
    116 			return REQ_HELP;
    117 		case '\033': /* esc-v is scroll down */
    118 			ch = wgetch(w);
    119 			if (ch == 'v')
    120 				return REQ_SCROLLUP;
    121 			else
    122 				ch = 0; /* zap char so we beep */
    123 		}
    124 
    125 		if (isalpha(ch))
    126 			return ch;
    127 
    128 		mbeep();
    129 		wrefresh(w);
    130 	}
    131 }
    132 
    133 static void
    134 init_menu(struct menudesc *m)
    135 {
    136 	int wmax;
    137 	int hadd, wadd, exithadd;
    138 	int i;
    139 
    140 	hadd = ((m->mopt & MC_NOBOX) ? 0 : 2);
    141 	wadd = ((m->mopt & MC_NOBOX) ? 2 : 4);
    142 
    143 	hadd += strlen(m->title) != 0 ? 2 : 0;
    144 	exithadd = ((m->mopt & MC_NOEXITOPT) ? 0 : 1);
    145 
    146 	wmax = strlen(m->title);
    147 
    148 	/* Calculate h? h == number of visible options. */
    149 	if (m->h == 0)
    150 		m->h = m->numopts + exithadd;
    151 	else
    152 		m->h -= hadd;
    153 	m->h = MIN(m->h, max_lines - m->y - hadd);
    154 
    155 	if (m->h < m->numopts + exithadd) {
    156 		if (!(m->mopt & MC_SCROLL) || m->h < 3) {
    157 			endwin();
    158 			(void)fprintf(stderr,
    159 				"Window too short for menu \"%s\"\n",
    160 				m->title);
    161 			exit(1);
    162 		}
    163 		hadd++;
    164 		m->h--;
    165 	} else
    166 		m->mopt &= ~MC_SCROLL;
    167 #if 0
    168 	/* check for screen fit */
    169 	if (m->y + m->h + hadd > max_lines) {
    170 		endwin();
    171 		(void)fprintf(stderr,
    172 		    "Screen too short (%d + %d + %d > %d) for menu \"%s\"\n",
    173 			m->y, m->h, hadd, max_lines, m->title);
    174 		exit(1);
    175 
    176 	}
    177 #endif
    178 
    179 	/* Calculate w? */
    180 	if (m->w == 0) {
    181 		if (m->mopt & MC_SCROLL)
    182 			wmax = MAX(wmax,strlen(scrolltext));
    183 		for (i = 0; i < m->numopts; i++)
    184 			wmax = MAX(wmax, strlen(m->opts[i].opt_name) + 3);
    185 		m->w = wmax;
    186 	}
    187 
    188 	/* check and adjust for screen fit */
    189 	if (m->w + wadd > max_cols) {
    190 		endwin();
    191 		(void)fprintf(stderr,
    192 			"Screen too narrow for menu \"%s\"\n", m->title);
    193 		exit(1);
    194 
    195 	}
    196 	if (m->x == -1)
    197 		m->x = (max_cols - (m->w + wadd)) / 2;	/* center */
    198 	else if (m->x + m->w + wadd > max_cols)
    199 		m->x = max_cols - (m->w + wadd);
    200 
    201 	/* Get the windows. */
    202 	m->mw = newwin(m->h + hadd, m->w + wadd, m->y, m->x);
    203 
    204 	if (m->mw == NULL) {
    205 		endwin();
    206 		(void)fprintf(stderr,
    207 			"Could not create window for menu \"%s\"\n", m->title);
    208 		exit(1);
    209 	}
    210 	keypad(m->mw, TRUE); /* enable multi-key assembling for win */
    211 
    212 	/* XXX is it even worth doing this right? */
    213 	if (has_colors()) {
    214 		wbkgd(m->mw, COLOR_PAIR(1));
    215 		wattrset(m->mw, COLOR_PAIR(1));
    216 	}
    217 }
    218 
    219 static char
    220 opt_ch(int op_no)
    221 {
    222 	char c;
    223 	if (op_no < 25) {
    224 		c = 'a' + op_no;
    225 		if (c >= 'x')
    226 			c++;
    227 	} else
    228 		c = 'A' + op_no - 25;
    229 	return c;
    230 }
    231 
    232 static void
    233 draw_menu_line(struct menudesc *m, int i, int cury, char opt, const char *text)
    234 {
    235 	int hasbox = m->mopt & MC_NOBOX ? 0 : 1;
    236 
    237 	if (m->cursel == i) {
    238 		mvwaddstr(m->mw, cury, hasbox, ">");
    239 		wstandout(m->mw);
    240 	} else
    241 		mvwaddstr(m->mw, cury, hasbox, " ");
    242 	if (!(m->mopt & MC_NOSHORTCUT))
    243 		wprintw(m->mw, "%c: ", opt);
    244 	waddstr(m->mw, text);
    245 	if (m->cursel == i)
    246 		wstandend(m->mw);
    247 }
    248 
    249 static void
    250 draw_menu(struct menudesc *m)
    251 {
    252 	int opt;
    253 	int hasbox, cury, maxy;
    254 	int tadd;
    255 
    256 	if (m->mopt & MC_NOBOX) {
    257 		cury = 0;
    258 		maxy = m->h;
    259 		hasbox = 0;
    260 	} else {
    261 		cury = 1;
    262 		maxy = m->h + 1;
    263 		hasbox = 1;
    264 	}
    265 
    266 	/* Clear the window */
    267 	wclear(m->mw);
    268 
    269 	tadd = strlen(m->title) ? 2 : 0;
    270 
    271 	if (tadd) {
    272 		mvwaddstr(m->mw, hasbox, hasbox, " ");
    273 		mvwaddstr(m->mw, hasbox, hasbox + 1, m->title);
    274 		cury += tadd;
    275 		maxy += tadd;
    276 	}
    277 
    278 	for (opt = m->topline; opt < m->numopts; opt++) {
    279 		if (cury >= maxy)
    280 			break;
    281 		draw_menu_line(m, opt, cury++, opt_ch(opt),
    282 				m->opts[opt].opt_name);
    283 	}
    284 
    285 	/* Add the exit option. */
    286 	if (!(m->mopt & MC_NOEXITOPT)) {
    287 		if (cury < maxy)
    288 			draw_menu_line(m, m->numopts, cury++, 'x', m->exitstr);
    289 		else
    290 			opt = 0;
    291 	}
    292 
    293 	/* Add the scroll line */
    294 	if (opt != m->numopts || m->topline != 0)
    295 		mvwaddstr(m->mw, cury, hasbox, scrolltext);
    296 
    297 	/* Add the box. */
    298 	if (!(m->mopt & MC_NOBOX))
    299 		box(m->mw, 0, 0);
    300 
    301 	wmove(m->mw, tadd + hasbox + m->cursel - m->topline, hasbox);
    302 	wrefresh(m->mw);
    303 }
    304 
    305 static void
    306 /*ARGSUSED*/
    307 process_help(struct menudesc *m, int num)
    308 {
    309 	const char *help = m->helpstr;
    310 	int lineoff = 0;
    311 	int curoff = 0;
    312 	int again;
    313 	int winin;
    314 
    315 	/* Is there help? */
    316 	if (!help) {
    317 		mbeep();
    318 		return;
    319 	}
    320 
    321 	/* Display the help information. */
    322 	do {
    323 		if (lineoff < curoff) {
    324 			help = m->helpstr;
    325 			curoff = 0;
    326 		}
    327 		while (*help && curoff < lineoff) {
    328 			if (*help == '\n')
    329 				curoff++;
    330 			help++;
    331 		}
    332 
    333 		wclear(stdscr);
    334 		mvwaddstr(stdscr, 0, 0,
    335 			"Help: exit: x,  page up: u <, page down: d >");
    336 		mvwaddstr(stdscr, 2, 0, help);
    337 		wmove(stdscr, 1, 0);
    338 		wrefresh(stdscr);
    339 
    340 		do {
    341 			winin = wgetch(stdscr);
    342 			if (winin < KEY_MIN)
    343 				winin = tolower(winin);
    344 			again = 0;
    345 			switch (winin) {
    346 				case '<':
    347 				case 'u':
    348 				case KEY_UP:
    349 				case KEY_LEFT:
    350 				case KEY_PPAGE:
    351 					if (lineoff)
    352 						lineoff -= max_lines - 2;
    353 					else
    354 						again = 1;
    355 					break;
    356 				case '>':
    357 				case 'd':
    358 				case KEY_DOWN:
    359 				case KEY_RIGHT:
    360 				case KEY_NPAGE:
    361 					if (*help)
    362 						lineoff += max_lines - 2;
    363 					else
    364 						again = 1;
    365 					break;
    366 				case 'q':
    367 					break;
    368 				case 'x':
    369 					winin = 'q';
    370 					break;
    371 				default:
    372 					again = 1;
    373 			}
    374 			if (again)
    375 				mbeep();
    376 		} while (again);
    377 	} while (winin != 'q');
    378 
    379 	/* Restore current menu */
    380 	wclear(stdscr);
    381 	wrefresh(stdscr);
    382 	if (m->post_act)
    383 		(*m->post_act)();
    384 }
    385 
    386 static void
    387 process_req(struct menudesc *m, int num, int req)
    388 {
    389 	int ch;
    390 	int hasexit = (m->mopt & MC_NOEXITOPT ? 0 : 1);
    391 
    392 	switch(req) {
    393 
    394 	case REQ_EXECUTE:
    395 		return;
    396 
    397 	case REQ_NEXT_ITEM:
    398 		if (m->cursel >= m->numopts + hasexit - 1) {
    399 			mbeep();
    400 			return;
    401 		}
    402 		m->cursel++;
    403 		if (m->mopt & MC_SCROLL && m->cursel >= m->topline + m->h)
    404 			m->topline += 1;
    405 		break;
    406 
    407 	case REQ_PREV_ITEM:
    408 		if (m->cursel <= 0) {
    409 			mbeep();
    410 			return;
    411 		}
    412 		m->cursel--;
    413 		if (m->cursel < m->topline)
    414 			m->topline -= 1;
    415 		break;
    416 
    417 	case REQ_REDISPLAY:
    418 		wclear(stdscr);
    419 		wrefresh(stdscr);
    420 		if (m->post_act)
    421 			(*m->post_act)();
    422 		break;
    423 
    424 	case REQ_HELP:
    425 		process_help(m, num);
    426 		break;
    427 
    428 	case REQ_SCROLLUP:
    429 		if (m->cursel == 0) {
    430 			mbeep();
    431 			return;
    432 		}
    433 		m->topline = MAX(0, m->topline - m->h);
    434 		m->cursel = MAX(0, m->cursel - m->h);
    435 		wclear(m->mw);
    436 		break;
    437 
    438 	case REQ_SCROLLDOWN:
    439 		if (m->cursel >= m->numopts + hasexit - 1) {
    440 			mbeep();
    441 			return;
    442 		}
    443 		m->topline = MIN(m->topline + m->h,
    444 				 MAX(m->numopts + hasexit - m->h, 0));
    445 		m->cursel = MIN(m->numopts + hasexit - 1, m->cursel + m->h);
    446 		wclear(m->mw);
    447 		break;
    448 
    449 	default:
    450 		ch = req;
    451 		if (ch == 'x' && hasexit) {
    452 			m->cursel = m->numopts;
    453 			break;
    454 		}
    455 		if (m->mopt & MC_NOSHORTCUT) {
    456 			mbeep();
    457 			return;
    458 		}
    459 		if (ch > 'z')
    460 			ch = 255;
    461 		if (ch >= 'a') {
    462 			if (ch > 'x')
    463 				ch--;
    464 			ch = ch - 'a';
    465 		} else
    466 			ch = 25 + ch - 'A';
    467 		if (ch < 0 || ch >= m->numopts) {
    468 			mbeep();
    469 			return;
    470 		}
    471 		m->cursel = ch;
    472 	}
    473 
    474 	while (m->cursel >= m->topline + m->h)
    475 		m->topline = MIN(m->topline + m->h,
    476 				 m->numopts + hasexit - m->h);
    477 	while (m->cursel < m->topline)
    478 		m->topline = MAX(0, m->topline - m->h);
    479 
    480 	draw_menu(m);
    481 }
    482 
    483 int
    484 menu_init(void)
    485 {
    486 
    487 	if (__menu_init)
    488 		return 0;
    489 
    490 #ifdef	USER_MENU_INIT
    491 	if (USER_MENU_INIT)
    492 		return 1;
    493 #endif
    494 
    495 	if (initscr() == NULL)
    496 		return 1;
    497 
    498 	cbreak();
    499 	noecho();
    500 
    501 	/* XXX Should be configurable but it almost isn't worth it. */
    502 	if (has_colors()) {
    503 		start_color();
    504 		init_pair(1, COLOR_WHITE, COLOR_BLUE);
    505 		bkgd(COLOR_PAIR(1));
    506 		attrset(COLOR_PAIR(1));
    507 	}
    508 
    509 	max_lines = getmaxy(stdscr);
    510 	max_cols = getmaxx(stdscr);
    511 	keypad(stdscr, TRUE);
    512 #ifdef DYNAMIC_MENUS
    513 	num_menus = DYN_INIT_NUM;
    514 	while (num_menus < DYN_MENU_START)
    515 		num_menus *= 2;
    516 	menus = malloc(sizeof(menudesc) * num_menus);
    517 	if (menus == NULL)
    518 		return 2;
    519 	(void)memset(menus, 0, sizeof(menudesc) * num_menus);
    520 	(void)memcpy(menus, menu_def, sizeof(menudesc) * DYN_MENU_START);
    521 	num_avail = num_menus - DYN_MENU_START;
    522 #endif
    523 
    524 	__menu_init = 1;
    525 	return 0;
    526 }
    527 
    528 void
    529 process_menu(int num, void *arg)
    530 {
    531 	int sel = 0;
    532 	int req, done;
    533 	int last_num;
    534 	menu_ent *opt;
    535 
    536 	struct menudesc *m;
    537 
    538 	m = &menus[num];
    539 
    540 	done = FALSE;
    541 
    542 	/* Initialize? */
    543 	if (menu_init()) {
    544 		__menu_initerror();
    545 		return;
    546 	}
    547 
    548 	if (__m_endwin) {
    549      		wclear(stdscr);
    550 		wrefresh(stdscr);
    551 		__m_endwin = 0;
    552 	}
    553 	if (m->mw == NULL)
    554 		init_menu(m);
    555 
    556 	/* Always preselect option 0 and display from 0! */
    557 	m->cursel = 0;
    558 	m->topline = 0;
    559 
    560 	while (!done) {
    561 		last_num = num;
    562 		if (__m_endwin) {
    563 			wclear(stdscr);
    564 			wrefresh(stdscr);
    565 			__m_endwin = 0;
    566 		}
    567 		/* Process the display action */
    568 		if (m->post_act)
    569 			(*m->post_act)();
    570 		draw_menu(m);
    571 
    572 		while ((req = menucmd(m->mw)) != REQ_EXECUTE)
    573 			process_req(m, num, req);
    574 
    575 		sel = m->cursel;
    576 		if (!(m->mopt & MC_NOCLEAR)) {
    577 			wclear(m->mw);
    578 			wrefresh(m->mw);
    579 		}
    580 
    581 		/* Process the items */
    582 		if (sel < m->numopts) {
    583 			opt = &m->opts[sel];
    584 			if (opt->opt_flags & OPT_ENDWIN) {
    585 				endwin();
    586 				__m_endwin = 1;
    587 			}
    588 			if (opt->opt_action)
    589 				done = (*opt->opt_action)(m, opt, arg);
    590 			if (opt->opt_menu != -1) {
    591 				if (opt->opt_flags & OPT_SUB)
    592 					process_menu(opt->opt_menu, arg);
    593 				else
    594 					num = opt->opt_menu;
    595 			}
    596 
    597                         if (opt->opt_flags & OPT_EXIT)
    598                                 done = TRUE;
    599 
    600 		} else
    601 			done = TRUE;
    602 
    603 		/* Reselect m just in case */
    604 		if (num != last_num) {
    605 			m = &menus[num];
    606 
    607 			/* Initialize? */
    608 			if (m->mw == NULL)
    609 				init_menu(m);
    610 			if (m->post_act)
    611 				(*m->post_act)();
    612 		}
    613 	}
    614 
    615 	if (m->mopt & MC_NOCLEAR) {
    616 		wclear(m->mw);
    617 		wrefresh(m->mw);
    618 	}
    619 
    620 	/* Process the exit action */
    621 	if (m->exit_act)
    622 		(*m->exit_act)();
    623 }
    624 
    625 /* Control L is end of standard routines, remaining only for dynamic. */
    627 
    628 /* Beginning of routines for dynamic menus. */
    629 
    630 static int
    631 double_menus(void)
    632 {
    633 	menudesc *temp;
    634 
    635 	temp  = malloc(sizeof(menudesc) * num_menus * 2);
    636 	if (temp == NULL)
    637 		return 0;
    638 	(void)memset(temp, 0, sizeof(menudesc) * num_menus * 2);
    639 	(void)memcpy(temp, menus, sizeof(menudesc) * num_menus);
    640 	free(menus);
    641 	menus = temp;
    642 	num_avail = num_menus;
    643 	num_menus *= 2;
    644 
    645 	return 1;
    646 }
    647 
    648 int
    649 new_menu(const char *title, menu_ent *opts, int numopts,
    650 	int x, int y, int h, int w, int mopt,
    651 	void (*post_act)(void), void (*exit_act)(void),
    652 	const char * help, const char *exit)
    653 {
    654 	int ix;
    655 
    656 	/* Check for free menu entry. */
    657 	if (num_avail == 0)
    658 		if (!double_menus())
    659 			return -1;
    660 
    661 	/* Find free menu entry. */
    662 	for (ix = DYN_MENU_START; ix < num_menus && menus[ix].mopt & MC_VALID;
    663 		ix++) /* do  nothing */;
    664 
    665 	/* if ix == num_menus ... panic */
    666 
    667 	/* Set Entries */
    668 	menus[ix].title = title ? title : "";
    669 	menus[ix].opts = opts;
    670 	menus[ix].numopts = numopts;
    671 	menus[ix].x = x;
    672 	menus[ix].y = y;
    673 	menus[ix].h = h;
    674 	menus[ix].w = w;
    675 	menus[ix].mopt = mopt | MC_VALID;
    676 	menus[ix].post_act = post_act;
    677 	menus[ix].exit_act = exit_act;
    678 	menus[ix].helpstr  = help;
    679 	menus[ix].exitstr  = exit ? exit : "Exit";
    680 
    681 	init_menu(&menus[ix]);
    682 
    683 	return ix;
    684 }
    685 
    686 void
    687 free_menu(int menu_no)
    688 {
    689 	if (menu_no < num_menus) {
    690 		menus[menu_no].mopt &= ~MC_VALID;
    691 		if (menus[menu_no].mw != NULL)
    692 			delwin(menus[menu_no].mw);
    693 	}
    694 }
    695