/* * menu.c * This file is part of LCDd, the lcdproc server. * * This file is released under the GNU General Public License. Refer to the * COPYING file distributed with this package. * * Copyright (c) 1999, William Ferrell, Scott Scriven * 2002, Joris Robijn * 2004, F5 Networks, Inc. - IP-address input * 2005, Peter Marschall - error checks, ... * * Handles a menu and all actions that can be performed on it. Note that a * menu is itself also a menuitem. * * Menus are similar to "pull-down" menus, but have some extra features. * They can contain "normal" menu items, checkboxes, sliders, "movers", * etc.. * * The servermenu is created from servermenu.c * * For separation this file should never need to include menuscreen.h. * */ #include #include #include #include #include #include "config.h" #include "menuitem.h" #include "menu.h" #include "shared/report.h" #include "drivers.h" #include "screen.h" #include "widget.h" /** Basicly a patched version of LL_GetByIndex() that ignores hidden * entries completely. (But it takes a menu as an argument.) */ static void * menu_get_subitem(Menu * menu, int index) { MenuItem * item; int i = 0; debug (RPT_DEBUG, "%s( menu=[%s], index=%d )", __FUNCTION__, ((menu != NULL) ? menu->id : "(null)"), index); for (item = LL_GetFirst(menu->data.menu.contents); item != NULL; item = LL_GetNext(menu->data.menu.contents)) { if ( ! item->is_hidden) { if (i == index) return item; /* hidden items don't count at all... */ ++i; } } return NULL; } /** * Searches for a subitem with id item_id. This function ignores hidden * entries completely. * * @return index of subitem if found and -1 otherwise. */ static int menu_get_index_of(Menu * menu, char * item_id) { MenuItem * item; int i = 0; debug (RPT_DEBUG, "%s( menu=[%s], item_id=%s )", __FUNCTION__, ((menu != NULL) ? menu->id : "(null)"), item_id); for (item = LL_GetFirst(menu->data.menu.contents); item != NULL; item = LL_GetNext(menu->data.menu.contents)) { if ( ! item->is_hidden) { if (strcmp(item_id, item->id) == 0) return i; /* hidden items don't count at all... */ ++i; } } return -1; } static int menu_visible_item_count(Menu * menu) { MenuItem * item; int i = 0; for (item = LL_GetFirst(menu->data.menu.contents); item != NULL; item = LL_GetNext(menu->data.menu.contents)) { if ( ! item->is_hidden) ++i; } return i; } Menu * menu_create (char *id, MenuEventFunc(*event_func), char *text, Client *client) { Menu *new_menu; debug (RPT_DEBUG, "%s( id=\"%s\", event_func=%p, text=\"%s\", client=%p )", __FUNCTION__, id, event_func, text, client); new_menu = menuitem_create (MENUITEM_MENU, id, event_func, text, client); if (new_menu != NULL) { new_menu->data.menu.contents = LL_new(); new_menu->data.menu.association = NULL; } return new_menu; } void menu_destroy (Menu *menu) { debug (RPT_DEBUG, "%s( menu=[%s] )", __FUNCTION__, ((menu != NULL) ? menu->id : "(null)")); if (menu == NULL) return; menu_destroy_all_items (menu); LL_Destroy (menu->data.menu.contents); menu->data.menu.contents = NULL; /* After this the general menuitem routine destroys the rest... */ } void menu_add_item (Menu *menu, MenuItem *item) { debug (RPT_DEBUG, "%s( menu=[%s], item=[%s] )", __FUNCTION__, ((menu != NULL) ? menu->id : "(null)"), ((item != NULL) ? item->id : "(null)")); if ((menu == NULL) || (item == NULL)) return; /* Add the item to the menu */ LL_Push (menu->data.menu.contents, item); item->parent = menu; } void menu_remove_item (Menu *menu, MenuItem *item) { int i; MenuItem * item2; debug (RPT_DEBUG, "%s( menu=[%s], item=[%s] )", __FUNCTION__, ((menu != NULL) ? menu->id : "(null)"), ((item != NULL) ? item->id : "(null)")); if ((menu == NULL) || (item == NULL)) return; /* Find the item */ for (item2 = LL_GetFirst(menu->data.menu.contents), i = 0; item2 != NULL; item2 = LL_GetNext(menu->data.menu.contents), i++ ) { if (item == item2) { LL_DeleteNode (menu->data.menu.contents); if (menu->data.menu.selector_pos >= i) { menu->data.menu.selector_pos--; if (menu->data.menu.scroll > 0) menu->data.menu.scroll--; } return; } } } void menu_destroy_all_items (Menu *menu) { MenuItem * item; debug (RPT_DEBUG, "%s( menu=[%s] )", __FUNCTION__, ((menu != NULL) ? menu->id : "(null)")); if (menu == NULL) return; for( item = menu_getfirst_item(menu); item != NULL; item = menu_getfirst_item(menu) ) { menuitem_destroy (item); LL_Remove (menu->data.menu.contents, item); } } MenuItem *menu_get_current_item (Menu *menu) { return (MenuItem*) ((menu != NULL) ? menu_get_subitem(menu, menu->data.menu.selector_pos) : NULL); } MenuItem *menu_find_item (Menu *menu, char *id, bool recursive) { MenuItem * item; debug (RPT_DEBUG, "%s( menu=[%s], id=\"%s\", recursive=%d )", __FUNCTION__, ((menu != NULL) ? menu->id : "(null)"), id, recursive); if ((menu == NULL) || (id == NULL)) return NULL; if (strcmp(menu->id, id) == 0) return menu; for( item = menu_getfirst_item(menu); item != NULL; item = menu_getnext_item(menu) ) { if ( strcmp(item->id, id) == 0 ) { return item; } else if (recursive && item->type == MENUITEM_MENU) { MenuItem * res; res = menu_find_item (item, id, recursive); if (res) { return res; } } } return NULL; } void menu_set_association(Menu *menu, void *assoc) { menu->data.menu.association = assoc; } void menu_reset (Menu *menu) { debug (RPT_DEBUG, "%s( menu=[%s] )", __FUNCTION__, ((menu != NULL) ? menu->id : "(null)")); if (menu == NULL) return; menu->data.menu.selector_pos = 0; menu->data.menu.scroll = 0; } void menu_build_screen (MenuItem *menu, Screen *s) { Widget * w; MenuItem * subitem; int itemnr; debug (RPT_DEBUG, "%s( menu=[%s], screen=[%s] )", __FUNCTION__, ((menu != NULL) ? menu->id : "(null)"), ((s != NULL) ? s->id : "(null)")); if ((menu == NULL) || (s == NULL)) return; /* TODO: Put menu in a frame to do easy scrolling */ /* Problem: frames are not handled correctly by renderer */ /* Create menu title widget */ w = widget_create ("title", WID_TITLE, s); if (w != NULL) { screen_add_widget (s, w); w->text = strdup(menu->text); w->x = 1; } /* Create widgets for each subitem in the menu */ for (subitem = LL_GetFirst (menu->data.menu.contents), itemnr = 0; subitem != NULL; subitem = LL_GetNext (menu->data.menu.contents), itemnr ++ ) { char buf[10]; if (subitem->is_hidden) continue; snprintf (buf, sizeof(buf)-1, "text%d", itemnr); buf[sizeof(buf)-1] = 0; w = widget_create (buf, WID_STRING, s); /* (buf will be copied) */ if (w != NULL) { screen_add_widget (s, w); w->x = 2; switch (subitem->type) { case MENUITEM_CHECKBOX: /* Limit string length */ w->text = strdup (subitem->text); if (strlen(subitem->text) >= display_props->width-2) { (w->text)[display_props->width-2] = 0; } /* Add icon for checkbox */ snprintf (buf, sizeof(buf)-1, "icon%d", itemnr); buf[sizeof(buf)-1] = 0; w = widget_create (buf, WID_ICON, s); /* (buf will be copied) */ screen_add_widget (s, w); w->x = display_props->width - 1; w->length = ICON_CHECKBOX_OFF; break; case MENUITEM_RING: /* Create string for text + ringtext */ w->text = malloc (display_props->width); break; case MENUITEM_MENU: /* Limit string length */ w->text = malloc( strlen(subitem->text) + 4 ); strcpy( w->text, subitem->text ); strcat( w->text, " >" ); if (strlen(subitem->text) >= display_props->width-1) { (w->text)[display_props->width-1] = '\0'; } break; case MENUITEM_ACTION: case MENUITEM_SLIDER: case MENUITEM_NUMERIC: case MENUITEM_ALPHA: case MENUITEM_IP: /* Limit string length */ w->text = strdup (subitem->text); if (strlen(subitem->text) >= display_props->width-1) { (w->text)[display_props->width-1] = '\0'; } break; default: assert(!"unexpected menuitem type"); } } } /* Add arrow for selection on the left */ w = widget_create ("selector", WID_ICON, s); if (w != NULL) { screen_add_widget (s, w); w->length = ICON_SELECTOR_AT_LEFT; w->x = 1; } /* Add scrollers on the right side on top and bottom */ /* TODO: when menu is in a frame, these can be removed */ w = widget_create ("upscroller", WID_ICON, s); if (w != NULL) { screen_add_widget (s, w); w->length = ICON_ARROW_UP; w->x = display_props->width; w->y = 1; } w = widget_create ("downscroller", WID_ICON, s); if (w != NULL) { screen_add_widget (s, w); w->length = ICON_ARROW_DOWN; w->x = display_props->width; w->y = display_props->height; } } void menu_update_screen (MenuItem *menu, Screen *s) { Widget * w; MenuItem * subitem; int itemnr; int hidden_count = 0; debug (RPT_DEBUG, "%s( menu=[%s], screen=[%s] )", __FUNCTION__, ((menu != NULL) ? menu->id : "(null)"), ((s != NULL) ? s->id : "(null)")); if ((menu == NULL) || (s == NULL)) return; /* Update widgets for the title */ w = screen_find_widget (s, "title"); if (!w) report (RPT_ERR, "%s: could not find widget: %s", __FUNCTION__, "title"); w->y = 1 - menu->data.menu.scroll; /* TODO: remove next 5 limes when rendering is safe */ if (w->y > 0 && w->y <= display_props->height) { w->type = WID_TITLE; } else { w->type = WID_NONE; /* make invisible */ } /* Update widgets for each subitem in the menu */ for (subitem = LL_GetFirst (menu->data.menu.contents), itemnr = 0; subitem; subitem = LL_GetNext (menu->data.menu.contents), itemnr ++ ) { char buf[10]; char * p; if (subitem->is_hidden) { debug(RPT_DEBUG, "%s: menu %s has hidden menu: %s", __FUNCTION__, menu->id, subitem->id); ++hidden_count; continue; } snprintf (buf, sizeof(buf)-1, "text%d", itemnr); buf[sizeof(buf)-1] = 0; w = screen_find_widget (s, buf); if (!w) report (RPT_ERR, "%s: could not find widget: %s", __FUNCTION__, buf); w->y = 2 + itemnr - hidden_count - menu->data.menu.scroll; /* TODO: remove next 5 lines when rendering is safe */ if (w->y > 0 && w->y <= display_props->height) { w->type = WID_STRING; } else { w->type = WID_NONE; /* make invisible */ } switch (subitem->type) { case MENUITEM_CHECKBOX: /* Update icon value for checkbox */ snprintf (buf, sizeof(buf)-1, "icon%d", itemnr); buf[sizeof(buf)-1] = 0; w = screen_find_widget (s, buf); if (!w) report (RPT_ERR, "%s: could not find widget: %s", __FUNCTION__, buf); w->y = 2 + itemnr - menu->data.menu.scroll; w->length = ((int[]){ICON_CHECKBOX_OFF,ICON_CHECKBOX_ON,ICON_CHECKBOX_GRAY})[subitem->data.checkbox.value]; /* TODO: remove next 5 lines when rendering is safe */ if (w->y > 0 && w->y <= display_props->height) { w->type = WID_ICON; } else { w->type = WID_NONE; /* make invisible */ } break; case MENUITEM_RING: if (subitem->data.ring.value >= LL_Length(subitem->data.ring.strings)) { /* No strings available */ memcpy (w->text, subitem->text, display_props->width - 2); w->text[ display_props->width - 2 ] = 0; } else { /* Limit string length and add ringstring */ p = LL_GetByIndex (subitem->data.ring.strings, subitem->data.ring.value); assert(p != NULL); if (strlen(p) > display_props->width - 3) { short a = display_props->width - 3; /* We need to limit the ring string and DON'T * display the item text */ strcpy (w->text, " "); memcpy (w->text + 1, p, a); w->text[a + 1] = 0; } else { short b = display_props->width - 2 - strlen (p); short c = min (strlen (subitem->text), b - 1); /* We don't limit the ring string */ memset (w->text, ' ', b); memcpy (w->text, subitem->text, c); strcpy (w->text + b, p); } } break; default: break; } } /* Update selector position */ w = screen_find_widget (s, "selector"); if (w != NULL) w->y = 2 + menu->data.menu.selector_pos - menu->data.menu.scroll; else report (RPT_ERR, "%s: could not find widget: %s", __FUNCTION__, "selector"); /* Enable upscroller (if necessary) */ w = screen_find_widget (s, "upscroller"); if (w != NULL) w->type = (menu->data.menu.scroll > 0) ? WID_ICON : WID_NONE; else report (RPT_ERR, "%s: could not find widget: %s", __FUNCTION__, "upscroller"); /* Enable downscroller (if necessary) */ w = screen_find_widget (s, "downscroller"); if (w != NULL) w->type = (menu_visible_item_count(menu) >= menu->data.menu.scroll + display_props->height) ? WID_ICON : WID_NONE; else report (RPT_ERR, "%s: could not find widget: %s", __FUNCTION__, "downscroller"); } MenuItem * menu_get_item_for_predecessor_check(Menu *menu) { MenuItem *subitem = menu_get_subitem(menu, menu->data.menu.selector_pos); if ( ! subitem) return NULL; switch (subitem->type) { case MENUITEM_ACTION: case MENUITEM_CHECKBOX: case MENUITEM_RING: // for types without own screen: look for menu's // predecessor if its subitem doesn't have one. (Since // menus can't have successors this problem arises // only for predecessors.) if (subitem->predecessor_id == NULL) return menu; return subitem; case MENUITEM_MENU: case MENUITEM_SLIDER: case MENUITEM_NUMERIC: case MENUITEM_ALPHA: case MENUITEM_IP: return menu; default: return NULL; } } MenuItem * menu_get_item_for_successor_check(Menu *menu) { MenuItem *subitem = menu_get_subitem(menu, menu->data.menu.selector_pos); if ( ! subitem) return NULL; switch (subitem->type) { case MENUITEM_ACTION: case MENUITEM_CHECKBOX: case MENUITEM_RING: return subitem; case MENUITEM_MENU: case MENUITEM_SLIDER: case MENUITEM_NUMERIC: case MENUITEM_ALPHA: case MENUITEM_IP: return menu; default: return NULL; } } MenuResult menu_process_input(Menu *menu, MenuToken token, char * key, bool extended) { MenuItem *subitem; debug (RPT_DEBUG, "%s( menu=[%s], token=%d, key=\"%s\" )", __FUNCTION__, ((menu != NULL) ? menu->id : "(null)"), token, key); if (menu == NULL) return MENURESULT_ERROR; switch (token) { case MENUTOKEN_MENU: subitem = menu_get_item_for_predecessor_check(menu); if ( ! subitem) return MENURESULT_ERROR; return menuitem_predecessor2menuresult( subitem->predecessor_id, MENURESULT_CLOSE); case MENUTOKEN_ENTER: subitem = menu_get_subitem (menu, menu->data.menu.selector_pos); if (!subitem) break; switch (subitem->type) { case MENUITEM_ACTION: if (subitem->event_func) subitem->event_func (subitem, MENUEVENT_SELECT); return menuitem_successor2menuresult( subitem->successor_id, MENURESULT_NONE); case MENUITEM_CHECKBOX: if (subitem->data.checkbox.allow_gray) { subitem->data.checkbox.value = (subitem->data.checkbox.value + 1) % 3; } else { subitem->data.checkbox.value = (subitem->data.checkbox.value + 1) % 2; } if (subitem->event_func) subitem->event_func (subitem, MENUEVENT_UPDATE); return menuitem_successor2menuresult( subitem->successor_id, MENURESULT_NONE); case MENUITEM_RING: subitem->data.ring.value = (subitem->data.ring.value + 1) % LL_Length (subitem->data.ring.strings); if (subitem->event_func) subitem->event_func (subitem, MENUEVENT_UPDATE); return menuitem_successor2menuresult( subitem->successor_id, MENURESULT_NONE); case MENUITEM_MENU: case MENUITEM_SLIDER: case MENUITEM_NUMERIC: case MENUITEM_ALPHA: case MENUITEM_IP: return MENURESULT_ENTER; default: break; } return MENURESULT_ERROR; case MENUTOKEN_UP: if (menu->data.menu.selector_pos > 0) { menu->data.menu.selector_pos --; if (menu->data.menu.selector_pos + 1 < menu->data.menu.scroll) menu->data.menu.scroll --; } else if (menu->data.menu.selector_pos == 0) { // wrap around to last menu entry menu->data.menu.selector_pos = menu_visible_item_count(menu) - 1; menu->data.menu.scroll = menu->data.menu.selector_pos + 2 - display_props->height; } return MENURESULT_NONE; case MENUTOKEN_DOWN: if (menu->data.menu.selector_pos < menu_visible_item_count(menu) - 1) { menu->data.menu.selector_pos ++; if (menu->data.menu.selector_pos - menu->data.menu.scroll + 2 > display_props->height) menu->data.menu.scroll ++; } else { // wrap araound to 1st menu entry menu->data.menu.selector_pos = 0; menu->data.menu.scroll = 0; } return MENURESULT_NONE; case MENUTOKEN_LEFT: if (!extended) return MENURESULT_NONE; subitem = menu_get_subitem (menu, menu->data.menu.selector_pos); if (subitem == NULL) break; switch (subitem->type) { case MENUITEM_CHECKBOX: /* note: this dangerous looking code works since * CheckboxValue is an enum >= 0. */ if (subitem->data.checkbox.allow_gray) { subitem->data.checkbox.value = (subitem->data.checkbox.value - 1) % 3; } else { subitem->data.checkbox.value = (subitem->data.checkbox.value - 1) % 2; } if (subitem->event_func) subitem->event_func (subitem, MENUEVENT_UPDATE); return MENURESULT_NONE; case MENUITEM_RING: /* ring: jump to the end if beginning is reached */ subitem->data.ring.value = (subitem->data.ring.value < 1) ? LL_Length (subitem->data.ring.strings) - 1 : (subitem->data.ring.value - 1) % LL_Length (subitem->data.ring.strings); if (subitem->event_func) subitem->event_func (subitem, MENUEVENT_UPDATE); return MENURESULT_NONE; default: break; } return MENURESULT_NONE; case MENUTOKEN_RIGHT: if (!extended) return MENURESULT_NONE; subitem = menu_get_subitem(menu, menu->data.menu.selector_pos); if (subitem == NULL) break; switch (subitem->type) { case MENUITEM_CHECKBOX: if (subitem->data.checkbox.allow_gray) { subitem->data.checkbox.value = (subitem->data.checkbox.value + 1) % 3; } else { subitem->data.checkbox.value = (subitem->data.checkbox.value + 1) % 2; } if (subitem->event_func) subitem->event_func (subitem, MENUEVENT_UPDATE); return MENURESULT_NONE; case MENUITEM_RING: subitem->data.ring.value = (subitem->data.ring.value + 1) % LL_Length (subitem->data.ring.strings); if (subitem->event_func) subitem->event_func (subitem, MENUEVENT_UPDATE); return MENURESULT_NONE; case MENUITEM_MENU: return MENURESULT_ENTER; default: break; } return MENURESULT_NONE; case MENUTOKEN_OTHER: /* TODO: move to the selected number and enter it */ return MENURESULT_NONE; } return MENURESULT_ERROR; } /** positions current item pointer on subitem subitem_id. If subitem_id is * hidden or not valid subitem of menu this function does nothing. */ void menu_select_subitem(Menu *menu, char * subitem_id) { assert(menu != NULL); debug(RPT_DEBUG, "%s( menu=[%s], subitem_id=\"%s\" )", __FUNCTION__, menu->id, subitem_id); int position = menu_get_index_of(menu, subitem_id); if (position < 0) { debug(RPT_DEBUG, "%s: subitem \"%s\" not found" " or hidden in \"%s\", ignored", __FUNCTION__, subitem_id, menu->id); return; } // debug(RPT_DEBUG, "%s: %s->%s is at position %d," // " current item is at menu position: %d, scroll: %d", // __FUNCTION__, menu->id, subitem_id, position, // menu->data.menu.selector_pos, menu->data.menu.scroll); menu->data.menu.selector_pos = position; menu->data.menu.scroll = position; }