com32/cmenu/libmenu/cmenu.h - platform/external/syslinux - Git at Google

 /* -*- c -*- ------------------------------------------------------------- *
  *
  *   Copyright 2004-2005 Murali Krishnan Ganapathy - All Rights Reserved
  *
  *   This program is free software; you can redistribute it and/or modify
  *   it under the terms of the GNU General Public License as published by
  *   the Free Software Foundation, Inc., 53 Temple Place Ste 330,
  *   Boston MA 02111-1307, USA; either version 2 of the License, or
  *   (at your option) any later version; incorporated herein by reference.
  *
  * ----------------------------------------------------------------------- */

 /* This program can be compiled for DOS with the OpenWatcom compiler
  * (http://www.openwatcom.org/):
  *
  * wcl -3 -osx -mt <filename>.c
  */

 #ifndef __MENU_H__
 #define __MENU_H__

 #include "com32io.h"
 #include "tui.h"
 #include "syslnx.h"
 #include <string.h>
 #include <unistd.h>

 // TIMEOUT PARAMETERS
 /* If no key is pressed within TIMEOUTNUMSTEPS * TIMEOUTSTEPSIZE milliseconds
    and if a timeout handler is registered, then that will be called.
    The handler should either either take control from there on, or return without
    producing any change in the current video settings.

    For e.g. the handler could
    * Could just quit the menu program
    * beep and return.

    TIMEOUTSTEPSIZE is the interval for which the program sleeps without checking for
    any keystroke. So increasing this will make the response of the system slow.
    Decreasing this will make a lot of interrupt calls using up your CPU. Default
    value of TIMEOUTSTEPSIZE of 0.1 seconds should be right in most cases.

    TIMEOUTNUMSTEPS of 3000 corresponds to a wait time of 300 seconds or 5 minutes
 */

 #define TIMEOUTSTEPSIZE 10
 #define TIMEOUTNUMSTEPS 30000L

 // Attributes
 #define NORMALATTR    0x17
 #define NORMALHLITE   0x1F	// Normal Highlight attribute
 #define REVERSEATTR   0x70
 #define REVERSEHLITE  0x78	// Reverse Hightlight attribute
 #define INACTATTR     0x18
 #define INACTHLITE    0x10	// Inactive Highlight attribute
 #define REVINACTATTR  0x78
 #define REVINACTHLITE 0x70	// Reverse Inactive Highlight attr

 #define STATUSATTR    0x74
 #define STATUSHLITE   0x7B	// Status highlight

 #define FILLCHAR      ' '
 #define FILLATTR      NORMALATTR
 #define SHADOWATTR    0x00
 #define SPACECHAR     ' '

 #define TFILLCHAR     ' '
 #define TITLEATTR     0x70

 #define ENABLEHLITE   '<'	// Char which turns on highlight
 #define DISABLEHLITE  '>'	// Char which turns off highlight
 #define NOHLITE       0		// The offset into attrib array for non-hilite
 #define HLITE         1		// The offset for Hlite attrib

 #define MOREABOVE    '^'		// char to print when more menu items available above
 #define MOREBELOW    'v'		// more items available below

 // Attributes of the menu system
 #define MAXMENUS      250	// Maximum number of menu's allowed
 #define MAXMENUSIZE   100	// Default value for max num of entries in each menu
 #define MAXMENUHEIGHT 20	// Maximum number of entries displayed
 #define MENUBOXTYPE   BOX_SINSIN	// Default box type Look at tui.h for other values

 // Upper bounds on lengths
 // We copy the given string, so user can reuse the space used to store incoming arguments.
 #define MENULEN       78	// Each menu entry is atmost MENULEN chars
 #define STATLEN       78	// Maximum length of status string
 #define TITLELEN      78	// Maximum length of title string
 #define ACTIONLEN     255	// Maximum length of an action string

 // Layout of menu
 #define MENUROW       3		// Row where menu is displayed (relative to window)
 #define MENUCOL       4		// Col where menu is displayed (relative to window)
 #define MENUPAGE      1		// show in display page 1
 #define STATLINE      24	// Line number where status line starts (relative to window)

 // Used for printing debugging messages
 #define DEBUGLINE     23	// debugging info goes here

 // Other Chars
 #define RADIOMENUCHAR '>'	// > symbol for radio menu?
 #define CHECKED       '\140'	// Check mark
 #define UNCHECKED     '\146'	// Light bullet
 #define RADIOSEL      '.'	// Current Radio Selection
 #define RADIOUNSEL    ' '	// Radio option not selected

 typedef unsigned char uchar;

 // Types of menu's
 #define NORMALMENU 1
 #define RADIOMENU  2

 typedef enum { OPT_INACTIVE, OPT_SUBMENU, OPT_RUN, OPT_EXITMENU, OPT_CHECKBOX,
     OPT_RADIOMENU, OPT_SEP, OPT_INVISIBLE,
     OPT_RADIOITEM
 } t_action;

 typedef union {
     uchar submenunum;		// For submenu's
     uchar checked;		// For check boxes
     uchar radiomenunum;		// Item mapping to a radio menu
 } t_itemdata;

 struct s_menuitem;
 struct s_menu;
 struct s_menusystem;

 typedef struct {
     unsigned int valid:1;	// Is action valid?
     unsigned int refresh:1;	// Should we recompute menu stuff?
     unsigned int reserved:6;	// For future expansion
 } t_handler_return;

 t_handler_return ACTION_VALID, ACTION_INVALID;	// Specific values

 typedef t_handler_return(*t_item_handler) (struct s_menusystem *,
 					   struct s_menuitem *);
 typedef void (*t_menusystem_handler) (struct s_menusystem *,
 				      struct s_menuitem *);
 typedef void (*t_keys_handler) (struct s_menusystem *, struct s_menuitem *,
 				unsigned int scancode);
     // Last parameter = HIGH BYTE = scan code , LOW BYTE = ASCII CODE

 typedef enum { HDLR_SCREEN, HDLR_KEYS } t_handler;
 // Types of handlers for menu system

 // TIMEOUT is the list of possible values which can be returned by the handler
 // instructing the menusystem what to do. The default is CODE_WAIT
 typedef enum { CODE_WAIT, CODE_ENTER, CODE_ESCAPE } TIMEOUTCODE;
 typedef TIMEOUTCODE(*t_timeout_handler) (void);

 typedef struct s_menuitem {
     char *item;
     char *status;
     char *data;			// string containing kernel to run.. but...
     // for radio menu's this is a pointer to the item selected or NULL (initially)
     // for submenu's this string could be name of menu
     void *extra_data;		// Any other data user can point to
     unsigned int helpid;	// Used for Context sensitive help
     t_item_handler handler;	// Pointer to function of type menufn
     t_action action;
     t_itemdata itemdata;	// Data depends on action value
     uchar shortcut;		// one of [A-Za-z0-9] shortcut for this menu item
     uchar index;		// Index within the menu array
     uchar parindex;		// Index of the menu in which this item appears.

 } t_menuitem;

 typedef t_menuitem *pt_menuitem;	// Pointer to type menuitem

 typedef struct s_menu {
     pt_menuitem *items;		// pointer to array of pointer to menuitems
     char *title;		// Title string for menu
     char *name;			// menu can be referred to by this string
     int maxmenusize;		// the size of array allocated
     uchar numitems;		// how many items do we actually have
     uchar menuwidth;
     uchar row, col;		// Position where this menu should be displayed
     uchar menuheight;		// Maximum number of items to be displayed
 } t_menu;

 typedef t_menu *pt_menu;	// Pointer to type menu

 typedef struct s_menusystem {
     pt_menu menus[MAXMENUS];
     char *title;
     t_menusystem_handler handler;	// Menu system handler
     t_keys_handler keys_handler;	// Handler for unknown keys
     t_timeout_handler ontimeout;	// Timeout handler
     unsigned long tm_numsteps;
     // Time to wait for key press=numsteps * stepsize milliseconds
     unsigned int tm_stepsize;	// Timeout step size (in milliseconds)
     // Total timeout max time spent idle before we call handler
     unsigned long tm_total_timeout;	// (in milli seconds)
     unsigned long tm_sofar_timeout;	// All accumulated timeout
     // total timeout handler
     t_timeout_handler ontotaltimeout;	// Total timeout handler

     int maxmenuheight;
     uchar nummenus;
     uchar normalattr[2];	// [0] is non-hlite attr, [1] is hlite attr
     uchar reverseattr[2];
     uchar inactattr[2];
     uchar revinactattr[2];
     uchar statusattr[2];
     uchar fillchar;
     uchar fillattr;
     uchar spacechar;
     uchar tfillchar;
     uchar titleattr;
     uchar shadowattr;
     uchar statline;
     uchar menupage;
     int maxrow, minrow, numrows;	// Number of rows in the window
     int maxcol, mincol, numcols;	// Number of columns in the window

     // Menu box look
     char box_horiz, box_ltrt, box_rtlt;	// Some chars of the box, for redrawing portions of the box

 } t_menusystem;

 typedef t_menusystem *pt_menusystem;	// Pointer to type menusystem

 pt_menuitem showmenus(uchar startmenu);

 pt_menusystem init_menusystem(const char *title);

 void close_menusystem(void);	// Deallocate memory used

 void set_normal_attr(uchar normal, uchar selected, uchar inactivenormal,
 		     uchar inactiveselected);

 void set_normal_hlite(uchar normal, uchar selected, uchar inactivenormal,
 		      uchar inactiveselected);

 void set_status_info(uchar statusattr, uchar statushlite, uchar statline);

 void set_title_info(uchar tfillchar, uchar titleattr);

 void set_misc_info(uchar fillchar, uchar fillattr, uchar spacechar,
 		   uchar shadowattr);

 void set_window_size(uchar top, uchar left, uchar bot, uchar right);	// Set the window which menusystem should use

 void set_menu_options(uchar maxmenuheight);
 // maximum height of a menu

 void reg_handler(t_handler htype, void *handler);	// Register handler

 void unreg_handler(t_handler htype);

 void reg_ontimeout(t_timeout_handler, unsigned int numsteps,
 		   unsigned int stepsize);
 // Set timeout handler, set 0 for default values.
 // So stepsize=0 means numsteps is measured in centiseconds.
 void unreg_ontimeout(void);

 void reg_ontotaltimeout(t_timeout_handler, unsigned long numcentiseconds);
 void unreg_ontotaltimeout(void);

 // Find the number of the menu given the name
 // Returns -1 if not found
 uchar find_menu_num(const char *name);

 // Create a new menu and return its position
 uchar add_menu(const char *title, int maxmenusize);

 // Create a named menu and return its position
 uchar add_named_menu(const char *name, const char *title, int maxmenusize);

 void set_menu_pos(uchar row, uchar col);	// Set the position of this menu.

 // Add item to the "current" menu
 pt_menuitem add_item(const char *item, const char *status, t_action action,
 		     const char *data, uchar itemdata);

 // Set shortcut key and help id
 void set_item_options(uchar shortcut, int helpid);

 // Set the shortcut key for the current item
 static inline void set_shortcut(uchar shortcut)
 {
     set_item_options(shortcut, 0xFFFF);
 }

 // Add a separator to the "current" menu
 pt_menuitem add_sep(void);

 // Generate string based on state of checkboxes and radioitem in given menu
 // and append string to existing contents of "line"
 // line must have enough space allocated
 void gen_append_line(const char *menu_name, char *line);

 #endif
	/* -- c -- ------------------------------------------------------------- *
	*
	* Copyright 2004-2005 Murali Krishnan Ganapathy - All Rights Reserved
	*
	* This program is free software; you can redistribute it and/or modify
	* it under the terms of the GNU General Public License as published by
	* the Free Software Foundation, Inc., 53 Temple Place Ste 330,
	* Boston MA 02111-1307, USA; either version 2 of the License, or
	* (at your option) any later version; incorporated herein by reference.
	*
	* ----------------------------------------------------------------------- */

	/* This program can be compiled for DOS with the OpenWatcom compiler
	* (http://www.openwatcom.org/):
	*
	* wcl -3 -osx -mt <filename>.c
	*/

	#ifndef __MENU_H__
	#define __MENU_H__

	#include "com32io.h"
	#include "tui.h"
	#include "syslnx.h"
	#include <string.h>
	#include <unistd.h>

	// TIMEOUT PARAMETERS
	/* If no key is pressed within TIMEOUTNUMSTEPS * TIMEOUTSTEPSIZE milliseconds
	and if a timeout handler is registered, then that will be called.
	The handler should either either take control from there on, or return without
	producing any change in the current video settings.

	For e.g. the handler could
	* Could just quit the menu program
	* beep and return.

	TIMEOUTSTEPSIZE is the interval for which the program sleeps without checking for
	any keystroke. So increasing this will make the response of the system slow.
	Decreasing this will make a lot of interrupt calls using up your CPU. Default
	value of TIMEOUTSTEPSIZE of 0.1 seconds should be right in most cases.

	TIMEOUTNUMSTEPS of 3000 corresponds to a wait time of 300 seconds or 5 minutes
	*/

	#define TIMEOUTSTEPSIZE 10
	#define TIMEOUTNUMSTEPS 30000L

	// Attributes
	#define NORMALATTR 0x17
	#define NORMALHLITE 0x1F // Normal Highlight attribute
	#define REVERSEATTR 0x70
	#define REVERSEHLITE 0x78 // Reverse Hightlight attribute
	#define INACTATTR 0x18
	#define INACTHLITE 0x10 // Inactive Highlight attribute
	#define REVINACTATTR 0x78
	#define REVINACTHLITE 0x70 // Reverse Inactive Highlight attr

	#define STATUSATTR 0x74
	#define STATUSHLITE 0x7B // Status highlight

	#define FILLCHAR ' '
	#define FILLATTR NORMALATTR
	#define SHADOWATTR 0x00
	#define SPACECHAR ' '

	#define TFILLCHAR ' '
	#define TITLEATTR 0x70

	#define ENABLEHLITE '<' // Char which turns on highlight
	#define DISABLEHLITE '>' // Char which turns off highlight
	#define NOHLITE 0 // The offset into attrib array for non-hilite
	#define HLITE 1 // The offset for Hlite attrib

	#define MOREABOVE '^' // char to print when more menu items available above
	#define MOREBELOW 'v' // more items available below

	// Attributes of the menu system
	#define MAXMENUS 250 // Maximum number of menu's allowed
	#define MAXMENUSIZE 100 // Default value for max num of entries in each menu
	#define MAXMENUHEIGHT 20 // Maximum number of entries displayed
	#define MENUBOXTYPE BOX_SINSIN // Default box type Look at tui.h for other values

	// Upper bounds on lengths
	// We copy the given string, so user can reuse the space used to store incoming arguments.
	#define MENULEN 78 // Each menu entry is atmost MENULEN chars
	#define STATLEN 78 // Maximum length of status string
	#define TITLELEN 78 // Maximum length of title string
	#define ACTIONLEN 255 // Maximum length of an action string

	// Layout of menu
	#define MENUROW 3 // Row where menu is displayed (relative to window)
	#define MENUCOL 4 // Col where menu is displayed (relative to window)
	#define MENUPAGE 1 // show in display page 1
	#define STATLINE 24 // Line number where status line starts (relative to window)

	// Used for printing debugging messages
	#define DEBUGLINE 23 // debugging info goes here

	// Other Chars
	#define RADIOMENUCHAR '>' // > symbol for radio menu?
	#define CHECKED '\140' // Check mark
	#define UNCHECKED '\146' // Light bullet
	#define RADIOSEL '.' // Current Radio Selection
	#define RADIOUNSEL ' ' // Radio option not selected

	typedef unsigned char uchar;

	// Types of menu's
	#define NORMALMENU 1
	#define RADIOMENU 2

	typedef enum { OPT_INACTIVE, OPT_SUBMENU, OPT_RUN, OPT_EXITMENU, OPT_CHECKBOX,
	OPT_RADIOMENU, OPT_SEP, OPT_INVISIBLE,
	OPT_RADIOITEM
	} t_action;

	typedef union {
	uchar submenunum; // For submenu's
	uchar checked; // For check boxes
	uchar radiomenunum; // Item mapping to a radio menu
	} t_itemdata;

	struct s_menuitem;
	struct s_menu;
	struct s_menusystem;

	typedef struct {
	unsigned int valid:1; // Is action valid?
	unsigned int refresh:1; // Should we recompute menu stuff?
	unsigned int reserved:6; // For future expansion
	} t_handler_return;

	t_handler_return ACTION_VALID, ACTION_INVALID; // Specific values

	typedef t_handler_return(t_item_handler) (struct s_menusystem ,
	struct s_menuitem *);
	typedef void (t_menusystem_handler) (struct s_menusystem ,
	struct s_menuitem *);
	typedef void (t_keys_handler) (struct s_menusystem , struct s_menuitem *,
	unsigned int scancode);
	// Last parameter = HIGH BYTE = scan code , LOW BYTE = ASCII CODE

	typedef enum { HDLR_SCREEN, HDLR_KEYS } t_handler;
	// Types of handlers for menu system

	// TIMEOUT is the list of possible values which can be returned by the handler
	// instructing the menusystem what to do. The default is CODE_WAIT
	typedef enum { CODE_WAIT, CODE_ENTER, CODE_ESCAPE } TIMEOUTCODE;
	typedef TIMEOUTCODE(*t_timeout_handler) (void);

	typedef struct s_menuitem {
	char *item;
	char *status;
	char *data; // string containing kernel to run.. but...
	// for radio menu's this is a pointer to the item selected or NULL (initially)
	// for submenu's this string could be name of menu
	void *extra_data; // Any other data user can point to
	unsigned int helpid; // Used for Context sensitive help
	t_item_handler handler; // Pointer to function of type menufn
	t_action action;
	t_itemdata itemdata; // Data depends on action value
	uchar shortcut; // one of [A-Za-z0-9] shortcut for this menu item
	uchar index; // Index within the menu array
	uchar parindex; // Index of the menu in which this item appears.

	} t_menuitem;

	typedef t_menuitem *pt_menuitem; // Pointer to type menuitem

	typedef struct s_menu {
	pt_menuitem *items; // pointer to array of pointer to menuitems
	char *title; // Title string for menu
	char *name; // menu can be referred to by this string
	int maxmenusize; // the size of array allocated
	uchar numitems; // how many items do we actually have
	uchar menuwidth;
	uchar row, col; // Position where this menu should be displayed
	uchar menuheight; // Maximum number of items to be displayed
	} t_menu;

	typedef t_menu *pt_menu; // Pointer to type menu

	typedef struct s_menusystem {
	pt_menu menus[MAXMENUS];
	char *title;
	t_menusystem_handler handler; // Menu system handler
	t_keys_handler keys_handler; // Handler for unknown keys
	t_timeout_handler ontimeout; // Timeout handler
	unsigned long tm_numsteps;
	// Time to wait for key press=numsteps * stepsize milliseconds
	unsigned int tm_stepsize; // Timeout step size (in milliseconds)
	// Total timeout max time spent idle before we call handler
	unsigned long tm_total_timeout; // (in milli seconds)
	unsigned long tm_sofar_timeout; // All accumulated timeout
	// total timeout handler
	t_timeout_handler ontotaltimeout; // Total timeout handler

	int maxmenuheight;
	uchar nummenus;
	uchar normalattr[2]; // [0] is non-hlite attr, [1] is hlite attr
	uchar reverseattr[2];
	uchar inactattr[2];
	uchar revinactattr[2];
	uchar statusattr[2];
	uchar fillchar;
	uchar fillattr;
	uchar spacechar;
	uchar tfillchar;
	uchar titleattr;
	uchar shadowattr;
	uchar statline;
	uchar menupage;
	int maxrow, minrow, numrows; // Number of rows in the window
	int maxcol, mincol, numcols; // Number of columns in the window

	// Menu box look
	char box_horiz, box_ltrt, box_rtlt; // Some chars of the box, for redrawing portions of the box

	} t_menusystem;

	typedef t_menusystem *pt_menusystem; // Pointer to type menusystem

	pt_menuitem showmenus(uchar startmenu);

	pt_menusystem init_menusystem(const char *title);

	void close_menusystem(void); // Deallocate memory used

	void set_normal_attr(uchar normal, uchar selected, uchar inactivenormal,
	uchar inactiveselected);

	void set_normal_hlite(uchar normal, uchar selected, uchar inactivenormal,
	uchar inactiveselected);

	void set_status_info(uchar statusattr, uchar statushlite, uchar statline);

	void set_title_info(uchar tfillchar, uchar titleattr);

	void set_misc_info(uchar fillchar, uchar fillattr, uchar spacechar,
	uchar shadowattr);

	void set_window_size(uchar top, uchar left, uchar bot, uchar right); // Set the window which menusystem should use

	void set_menu_options(uchar maxmenuheight);
	// maximum height of a menu

	void reg_handler(t_handler htype, void *handler); // Register handler

	void unreg_handler(t_handler htype);

	void reg_ontimeout(t_timeout_handler, unsigned int numsteps,
	unsigned int stepsize);
	// Set timeout handler, set 0 for default values.
	// So stepsize=0 means numsteps is measured in centiseconds.
	void unreg_ontimeout(void);

	void reg_ontotaltimeout(t_timeout_handler, unsigned long numcentiseconds);
	void unreg_ontotaltimeout(void);

	// Find the number of the menu given the name
	// Returns -1 if not found
	uchar find_menu_num(const char *name);

	// Create a new menu and return its position
	uchar add_menu(const char *title, int maxmenusize);

	// Create a named menu and return its position
	uchar add_named_menu(const char name, const char title, int maxmenusize);

	void set_menu_pos(uchar row, uchar col); // Set the position of this menu.

	// Add item to the "current" menu
	pt_menuitem add_item(const char item, const char status, t_action action,
	const char *data, uchar itemdata);

	// Set shortcut key and help id
	void set_item_options(uchar shortcut, int helpid);

	// Set the shortcut key for the current item
	static inline void set_shortcut(uchar shortcut)
	{
	set_item_options(shortcut, 0xFFFF);
	}

	// Add a separator to the "current" menu
	pt_menuitem add_sep(void);

	// Generate string based on state of checkboxes and radioitem in given menu
	// and append string to existing contents of "line"
	// line must have enough space allocated
	void gen_append_line(const char menu_name, char line);

	#endif