Update the discussion of themeing in the manual, and put a note in the wps tags appen...
[kugel-rb.git] / apps / menu.c
blob670a2352021a09f92083d9401a3279d8f2630dd5
1 /***************************************************************************
2 * __________ __ ___.
3 * Open \______ \ ____ ____ | | _\_ |__ _______ ___
4 * Source | _// _ \_/ ___\| |/ /| __ \ / _ \ \/ /
5 * Jukebox | | ( <_> ) \___| < | \_\ ( <_> > < <
6 * Firmware |____|_ /\____/ \___ >__|_ \|___ /\____/__/\_ \
7 * \/ \/ \/ \/ \/
8 * $Id$
10 * Copyright (C) 2002 Robert E. Hak
12 * This program is free software; you can redistribute it and/or
13 * modify it under the terms of the GNU General Public License
14 * as published by the Free Software Foundation; either version 2
15 * of the License, or (at your option) any later version.
17 * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
18 * KIND, either express or implied.
20 ****************************************************************************/
22 2005 Kevin Ferrare :
23 - Multi screen support
24 - Rewrote/removed a lot of code now useless with the new gui API
26 #include <stdbool.h>
27 #include <stdlib.h>
28 #include "config.h"
29 #include "system.h"
31 #include "appevents.h"
32 #include "lcd.h"
33 #include "font.h"
34 #include "file.h"
35 #include "menu.h"
36 #include "button.h"
37 #include "kernel.h"
38 #include "debug.h"
39 #include "usb.h"
40 #include "panic.h"
41 #include "settings.h"
42 #include "settings_list.h"
43 #include "option_select.h"
44 #include "screens.h"
45 #include "talk.h"
46 #include "lang.h"
47 #include "misc.h"
48 #include "action.h"
49 #include "menus/exported_menus.h"
50 #include "string.h"
51 #include "root_menu.h"
52 #include "audio.h"
53 #include "viewport.h"
54 #include "quickscreen.h"
56 #ifdef HAVE_LCD_BITMAP
57 #include "icons.h"
58 #endif
60 /* gui api */
61 #include "list.h"
62 #include "buttonbar.h"
64 #define MAX_MENUS 8
65 /* used to allow for dynamic menus */
66 #define MAX_MENU_SUBITEMS 64
67 static struct menu_item_ex *current_submenus_menu;
68 static int current_subitems[MAX_MENU_SUBITEMS];
69 static int current_subitems_count = 0;
70 static int talk_menu_item(int selected_item, void *data);
72 static void get_menu_callback(const struct menu_item_ex *m,
73 menu_callback_type *menu_callback)
75 if (m->flags&(MENU_HAS_DESC|MENU_DYNAMIC_DESC))
76 *menu_callback= m->callback_and_desc->menu_callback;
77 else
78 *menu_callback = m->menu_callback;
81 static int get_menu_selection(int selected_item, const struct menu_item_ex *menu)
83 int type = (menu->flags&MENU_TYPE_MASK);
84 if ((type == MT_MENU || type == MT_RETURN_ID)
85 && (selected_item<current_subitems_count))
86 return current_subitems[selected_item];
87 return selected_item;
89 static int find_menu_selection(int selected)
91 int i;
92 for (i=0; i< current_subitems_count; i++)
93 if (current_subitems[i] == selected)
94 return i;
95 return 0;
97 static const char* get_menu_item_name(int selected_item,
98 void * data,
99 char *buffer,
100 size_t buffer_len)
102 const struct menu_item_ex *menu = (const struct menu_item_ex *)data;
103 int type = (menu->flags&MENU_TYPE_MASK);
104 selected_item = get_menu_selection(selected_item, menu);
106 (void)buffer_len;
107 /* only MT_MENU or MT_RETURN_ID is allowed in here */
108 if (type == MT_RETURN_ID)
110 if (menu->flags&MENU_DYNAMIC_DESC)
111 return menu->menu_get_name_and_icon->list_get_name(selected_item,
112 menu->menu_get_name_and_icon->list_get_name_data, buffer);
113 return menu->strings[selected_item];
116 menu = menu->submenus[selected_item];
118 if ((menu->flags&MENU_DYNAMIC_DESC) && (type != MT_SETTING_W_TEXT))
119 return menu->menu_get_name_and_icon->list_get_name(selected_item,
120 menu->menu_get_name_and_icon->list_get_name_data, buffer);
122 type = (menu->flags&MENU_TYPE_MASK);
123 if ((type == MT_SETTING) || (type == MT_SETTING_W_TEXT))
125 const struct settings_list *v
126 = find_setting(menu->variable, NULL);
127 if (v)
128 return str(v->lang_id);
129 else return "Not Done yet!";
131 return P2STR(menu->callback_and_desc->desc);
133 #ifdef HAVE_LCD_BITMAP
134 static enum themable_icons menu_get_icon(int selected_item, void * data)
136 const struct menu_item_ex *menu = (const struct menu_item_ex *)data;
137 int menu_icon = Icon_NOICON;
138 selected_item = get_menu_selection(selected_item, menu);
140 if ((menu->flags&MENU_TYPE_MASK) == MT_RETURN_ID)
142 return Icon_Menu_functioncall;
144 menu = menu->submenus[selected_item];
145 if (menu->flags&MENU_HAS_DESC)
146 menu_icon = menu->callback_and_desc->icon_id;
147 else if (menu->flags&MENU_DYNAMIC_DESC)
148 menu_icon = menu->menu_get_name_and_icon->icon_id;
150 if (menu_icon == Icon_NOICON)
152 switch (menu->flags&MENU_TYPE_MASK)
154 case MT_SETTING:
155 case MT_SETTING_W_TEXT:
156 menu_icon = Icon_Menu_setting;
157 break;
158 case MT_MENU:
159 menu_icon = Icon_Submenu;
160 break;
161 case MT_FUNCTION_CALL:
162 case MT_RETURN_VALUE:
163 menu_icon = Icon_Menu_functioncall;
164 break;
167 return menu_icon;
169 #endif
171 static void init_menu_lists(const struct menu_item_ex *menu,
172 struct gui_synclist *lists, int selected, bool callback,
173 struct viewport parent[NB_SCREENS])
175 int i, count = MENU_GET_COUNT(menu->flags);
176 int type = (menu->flags&MENU_TYPE_MASK);
177 menu_callback_type menu_callback = NULL;
178 int icon;
179 current_subitems_count = 0;
181 if (type == MT_RETURN_ID)
182 get_menu_callback(menu, &menu_callback);
184 for (i=0; i<count; i++)
186 if (type != MT_RETURN_ID)
187 get_menu_callback(menu->submenus[i],&menu_callback);
188 if (menu_callback)
190 if (menu_callback(ACTION_REQUEST_MENUITEM,
191 type==MT_RETURN_ID ? (void*)(intptr_t)i: menu->submenus[i])
192 != ACTION_EXIT_MENUITEM)
194 current_subitems[current_subitems_count] = i;
195 current_subitems_count++;
198 else
200 current_subitems[current_subitems_count] = i;
201 current_subitems_count++;
204 current_submenus_menu = (struct menu_item_ex *)menu;
206 gui_synclist_init(lists,get_menu_item_name,(void*)menu,false,1, parent);
207 #ifdef HAVE_LCD_BITMAP
208 if (menu->callback_and_desc->icon_id == Icon_NOICON)
209 icon = Icon_Submenu_Entered;
210 else
211 icon = menu->callback_and_desc->icon_id;
212 gui_synclist_set_title(lists, P2STR(menu->callback_and_desc->desc), icon);
213 gui_synclist_set_icon_callback(lists, global_settings.show_icons?menu_get_icon:NULL);
214 #else
215 (void)icon;
216 gui_synclist_set_icon_callback(lists, NULL);
217 #endif
218 if(global_settings.talk_menu)
219 gui_synclist_set_voice_callback(lists, talk_menu_item);
220 gui_synclist_set_nb_items(lists,current_subitems_count);
221 gui_synclist_limit_scroll(lists,true);
222 gui_synclist_select_item(lists, find_menu_selection(selected));
224 get_menu_callback(menu,&menu_callback);
225 if (callback && menu_callback)
226 menu_callback(ACTION_ENTER_MENUITEM,menu);
227 gui_synclist_draw(lists);
228 gui_synclist_speak_item(lists);
231 static int talk_menu_item(int selected_item, void *data)
233 const struct menu_item_ex *menu = (const struct menu_item_ex *)data;
234 int id = -1;
235 int type;
236 unsigned char *str;
237 int sel = get_menu_selection(selected_item, menu);
239 if ((menu->flags&MENU_TYPE_MASK) == MT_MENU)
241 type = menu->submenus[sel]->flags&MENU_TYPE_MASK;
242 if ((type == MT_SETTING) || (type == MT_SETTING_W_TEXT))
243 talk_setting(menu->submenus[sel]->variable);
244 else
246 if (menu->submenus[sel]->flags&(MENU_DYNAMIC_DESC))
248 int (*list_speak_item)(int selected_item, void * data)
249 = menu->submenus[sel]->menu_get_name_and_icon->
250 list_speak_item;
251 if(list_speak_item)
252 list_speak_item(sel, menu->submenus[sel]->
253 menu_get_name_and_icon->
254 list_get_name_data);
255 else
257 char buffer[80];
258 str = menu->submenus[sel]->menu_get_name_and_icon->
259 list_get_name(sel, menu->submenus[sel]->
260 menu_get_name_and_icon->
261 list_get_name_data, buffer);
262 id = P2ID(str);
265 else
266 id = P2ID(menu->submenus[sel]->callback_and_desc->desc);
267 if (id != -1)
268 talk_id(id,false);
271 else if(((menu->flags&MENU_TYPE_MASK) == MT_RETURN_ID))
273 if ((menu->flags&MENU_DYNAMIC_DESC) == 0)
275 unsigned char *s = (unsigned char *)menu->strings[sel];
276 /* string list, try to talk it if ID2P was used */
277 id = P2ID(s);
278 if (id != -1)
279 talk_id(id,false);
282 return 0;
285 void do_setting_from_menu(const struct menu_item_ex *temp,
286 struct viewport parent[NB_SCREENS])
288 int setting_id, oldval;
289 const struct settings_list *setting =
290 find_setting(temp->variable, &setting_id);
291 char *title;
292 char padded_title[MAX_PATH];
293 int var_type = setting->flags&F_T_MASK;
294 if (var_type == F_T_INT || var_type == F_T_UINT)
296 oldval = *(int*)setting->setting;
298 else if (var_type == F_T_BOOL)
300 oldval = *(bool*)setting->setting;
302 else
303 oldval = 0;
304 if ((temp->flags&MENU_TYPE_MASK) == MT_SETTING_W_TEXT)
305 title = temp->callback_and_desc->desc;
306 else
307 title = ID2P(setting->lang_id);
309 /* Pad the title string by repeating it. This is needed
310 so the scroll settings title can actually be used to
311 test the setting */
312 if (setting->flags&F_PADTITLE)
314 int i = 0, len;
315 if (setting->lang_id == -1)
316 title = (char*)setting->cfg_vals;
317 else
318 title = P2STR((unsigned char*)title);
319 len = strlen(title);
320 while (i < MAX_PATH-1)
322 int padlen = MIN(len, MAX_PATH-1-i);
323 memcpy(&padded_title[i], title, padlen);
324 i += padlen;
325 if (i<MAX_PATH-1)
326 padded_title[i++] = ' ';
328 padded_title[i] = '\0';
329 title = padded_title;
332 option_screen((struct settings_list *)setting, parent,
333 setting->flags&F_TEMPVAR, title);
336 /* display a menu */
337 int do_menu(const struct menu_item_ex *start_menu, int *start_selected,
338 struct viewport parent[NB_SCREENS], bool hide_theme)
340 int selected = start_selected? *start_selected : 0;
341 int action;
342 struct gui_synclist lists;
343 const struct menu_item_ex *temp, *menu;
344 int ret = 0, i;
345 bool redraw_lists;
346 FOR_NB_SCREENS(i)
347 viewportmanager_theme_enable(i, !hide_theme, NULL);
349 const struct menu_item_ex *menu_stack[MAX_MENUS];
350 int menu_stack_selected_item[MAX_MENUS];
351 int stack_top = 0;
352 bool in_stringlist, done = false;
353 struct viewport *vps = NULL;
354 #ifdef HAVE_BUTTONBAR
355 struct gui_buttonbar buttonbar;
356 gui_buttonbar_init(&buttonbar);
357 gui_buttonbar_set_display(&buttonbar, &(screens[SCREEN_MAIN]) );
358 gui_buttonbar_set(&buttonbar, "<<<", "", "");
359 #endif
361 menu_callback_type menu_callback = NULL;
362 if (start_menu == NULL)
363 menu = &main_menu_;
364 else menu = start_menu;
366 /* if hide_theme is true, assume parent has been fixed before passed into
367 * this function, e.g. with viewport_set_defaults(parent, screen) */
368 init_menu_lists(menu, &lists, selected, true, parent);
369 vps = *(lists.parent);
370 in_stringlist = ((menu->flags&MENU_TYPE_MASK) == MT_RETURN_ID);
371 /* load the callback, and only reload it if menu changes */
372 get_menu_callback(menu, &menu_callback);
374 #ifdef HAVE_BUTTONBAR
375 if (!hide_theme)
377 gui_buttonbar_set(&buttonbar, "<<<", "", "");
378 gui_buttonbar_draw(&buttonbar);
380 #endif
381 while (!done)
383 redraw_lists = false;
384 if (!hide_theme)
386 #ifdef HAVE_BUTTONBAR
387 gui_buttonbar_draw(&buttonbar);
388 #endif
390 action = get_action(CONTEXT_MAINMENU,
391 list_do_action_timeout(&lists, HZ));
392 /* HZ so the status bar redraws corectly */
394 if (menu_callback)
396 int old_action = action;
397 action = menu_callback(action, menu);
398 if (action == ACTION_EXIT_AFTER_THIS_MENUITEM)
400 action = old_action;
401 ret = MENU_SELECTED_EXIT; /* will exit after returning
402 from selection */
404 else if (action == ACTION_REDRAW)
406 action = old_action;
407 redraw_lists = true;
411 if (gui_synclist_do_button(&lists, &action, LIST_WRAP_UNLESS_HELD))
412 continue;
413 if (action == ACTION_NONE)
414 continue;
415 #ifdef HAVE_QUICKSCREEN
416 else if (action == ACTION_STD_QUICKSCREEN)
418 quick_screen_quick(action);
419 redraw_lists = true;
421 #endif
422 #ifdef HAVE_RECORDING
423 else if (action == ACTION_STD_REC)
425 ret = GO_TO_RECSCREEN;
426 done = true;
428 #endif
429 else if (action == ACTION_TREE_WPS)
431 ret = GO_TO_PREVIOUS_MUSIC;
432 done = true;
434 else if (action == ACTION_TREE_STOP)
436 redraw_lists = list_stop_handler();
438 else if (action == ACTION_STD_CONTEXT)
440 if (menu == &root_menu_)
442 ret = GO_TO_ROOTITEM_CONTEXT;
443 done = true;
445 else if (!in_stringlist)
447 int type;
448 selected = get_menu_selection(gui_synclist_get_sel_pos(&lists),menu);
449 temp = menu->submenus[selected];
450 type = (temp->flags&MENU_TYPE_MASK);
451 if ((type == MT_SETTING_W_TEXT || type == MT_SETTING))
453 #ifdef HAVE_QUICKSCREEN
454 MENUITEM_STRINGLIST(quickscreen_able_option,
455 ID2P(LANG_ONPLAY_MENU_TITLE), NULL,
456 ID2P(LANG_RESET_SETTING),
457 ID2P(LANG_TOP_QS_ITEM),
458 ID2P(LANG_LEFT_QS_ITEM),
459 ID2P(LANG_BOTTOM_QS_ITEM),
460 ID2P(LANG_RIGHT_QS_ITEM));
461 #endif
462 MENUITEM_STRINGLIST(notquickscreen_able_option,
463 ID2P(LANG_ONPLAY_MENU_TITLE), NULL,
464 ID2P(LANG_RESET_SETTING));
465 const struct menu_item_ex *menu;
466 int menu_selection = 0;
467 const struct settings_list *setting =
468 find_setting(temp->variable, NULL);
469 #ifdef HAVE_QUICKSCREEN
470 if (is_setting_quickscreenable(setting))
471 menu = &quickscreen_able_option;
472 else
473 #endif
474 menu = &notquickscreen_able_option;
475 switch (do_menu(menu, &menu_selection, NULL, false))
477 case GO_TO_PREVIOUS:
478 break;
479 case 0: /* reset setting */
480 reset_setting(setting, setting->setting);
481 break;
482 #ifdef HAVE_QUICKSCREEN
483 case 1: /* set as top QS item */
484 set_as_qs_item(setting, QUICKSCREEN_TOP);
485 break;
486 case 2: /* set as left QS item */
487 set_as_qs_item(setting, QUICKSCREEN_LEFT);
488 break;
489 case 3: /* set as bottom QS item */
490 set_as_qs_item(setting, QUICKSCREEN_BOTTOM);
491 break;
492 case 4: /* set as right QS item */
493 set_as_qs_item(setting, QUICKSCREEN_RIGHT);
494 break;
495 #endif
496 } /* swicth(do_menu()) */
497 redraw_lists = true;
499 } /* else if (!in_stringlist) */
501 else if (action == ACTION_STD_MENU)
503 if (menu != &root_menu_)
504 ret = GO_TO_ROOT;
505 else
506 ret = GO_TO_PREVIOUS;
507 done = true;
509 else if (action == ACTION_STD_CANCEL)
511 bool exiting_menu = false;
512 in_stringlist = false;
513 /* might be leaving list, so stop scrolling */
514 gui_synclist_scroll_stop(&lists);
515 if (menu_callback)
516 menu_callback(ACTION_EXIT_MENUITEM, menu);
518 if (menu->flags&MENU_EXITAFTERTHISMENU)
519 done = true;
520 else if ((menu->flags&MENU_TYPE_MASK) == MT_MENU)
521 exiting_menu = true;
522 if (stack_top > 0)
524 stack_top--;
525 menu = menu_stack[stack_top];
526 if (!exiting_menu && (menu->flags&MENU_EXITAFTERTHISMENU))
527 done = true;
528 else
529 init_menu_lists(menu, &lists,
530 menu_stack_selected_item[stack_top], false, vps);
531 /* new menu, so reload the callback */
532 get_menu_callback(menu, &menu_callback);
534 else if (menu != &root_menu_)
536 ret = GO_TO_PREVIOUS;
537 done = true;
540 else if (action == ACTION_STD_OK)
542 int type;
543 /* entering an item that may not be a list, so stop scrolling */
544 gui_synclist_scroll_stop(&lists);
545 #ifdef HAVE_BUTTONBAR
546 if (!hide_theme)
548 gui_buttonbar_unset(&buttonbar);
549 gui_buttonbar_draw(&buttonbar);
551 #endif
552 selected = get_menu_selection(gui_synclist_get_sel_pos(&lists), menu);
553 temp = menu->submenus[selected];
554 redraw_lists = true;
555 if (in_stringlist)
556 type = (menu->flags&MENU_TYPE_MASK);
557 else
559 type = (temp->flags&MENU_TYPE_MASK);
560 get_menu_callback(temp, &menu_callback);
561 if (menu_callback)
563 action = menu_callback(ACTION_ENTER_MENUITEM,temp);
564 if (action == ACTION_EXIT_MENUITEM)
565 break;
568 switch (type)
570 case MT_MENU:
571 if (stack_top < MAX_MENUS)
573 menu_stack[stack_top] = menu;
574 menu_stack_selected_item[stack_top] = selected;
575 stack_top++;
576 init_menu_lists(temp, &lists, 0, true, vps);
577 redraw_lists = false; /* above does the redraw */
578 menu = temp;
580 break;
581 case MT_FUNCTION_CALL:
583 int return_value;
584 if (temp->flags&MENU_FUNC_USEPARAM)
585 return_value = temp->function->function_w_param(
586 temp->function->param);
587 else
588 return_value = temp->function->function();
589 if (!(menu->flags&MENU_EXITAFTERTHISMENU) ||
590 (temp->flags&MENU_EXITAFTERTHISMENU))
592 init_menu_lists(menu, &lists, selected, true, vps);
594 if (temp->flags&MENU_FUNC_CHECK_RETVAL)
596 if (return_value != 0)
598 done = true;
599 ret = return_value;
602 break;
604 case MT_SETTING:
605 case MT_SETTING_W_TEXT:
607 do_setting_from_menu(temp, vps);
608 send_event(GUI_EVENT_ACTIONUPDATE, (void*)1); /* force a redraw */
609 break;
611 case MT_RETURN_ID:
612 if (in_stringlist)
614 done = true;
615 ret = selected;
617 else if (stack_top < MAX_MENUS)
619 menu_stack[stack_top] = menu;
620 menu_stack_selected_item[stack_top] = selected;
621 stack_top++;
622 menu = temp;
623 init_menu_lists(menu,&lists,0,false, vps);
624 redraw_lists = false; /* above does the redraw */
625 in_stringlist = true;
627 break;
628 case MT_RETURN_VALUE:
629 ret = temp->value;
630 done = true;
631 break;
633 if (type != MT_MENU)
635 if (menu_callback)
636 menu_callback(ACTION_EXIT_MENUITEM,temp);
638 if (current_submenus_menu != menu)
639 init_menu_lists(menu,&lists,selected,true,vps);
640 /* callback was changed, so reload the menu's callback */
641 get_menu_callback(menu, &menu_callback);
642 if ((menu->flags&MENU_EXITAFTERTHISMENU) &&
643 !(temp->flags&MENU_EXITAFTERTHISMENU))
645 done = true;
646 break;
648 #ifdef HAVE_BUTTONBAR
649 if (!hide_theme)
651 gui_buttonbar_set(&buttonbar, "<<<", "", "");
652 gui_buttonbar_draw(&buttonbar);
654 #endif
656 else if(default_event_handler(action) == SYS_USB_CONNECTED)
658 ret = MENU_ATTACHED_USB;
659 done = true;
662 if (redraw_lists && !done)
664 if (menu_callback)
665 menu_callback(ACTION_REDRAW, menu);
666 gui_synclist_draw(&lists);
667 gui_synclist_speak_item(&lists);
670 if (start_selected)
672 /* make sure the start_selected variable is set to
673 the selected item from the menu do_menu() was called from */
674 if (stack_top > 0)
676 menu = menu_stack[0];
677 init_menu_lists(menu,&lists,menu_stack_selected_item[0],true, vps);
679 *start_selected = get_menu_selection(
680 gui_synclist_get_sel_pos(&lists), menu);
682 FOR_NB_SCREENS(i)
683 viewportmanager_theme_undo(i, false);
684 return ret;