https://github.com/hubmartin/menu_library_v2
https://github.com/hubmartin/menu_library_v2
Last synced: 4 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/hubmartin/menu_library_v2
- Owner: hubmartin
- Created: 2020-02-22T17:33:48.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2020-02-22T17:37:26.000Z (over 5 years ago)
- Last Synced: 2025-07-04T15:37:46.248Z (4 months ago)
- Language: C
- Size: 675 KB
- Stars: 2
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Menu library
Improved and more advanced menu for small embedded systems.
### Features
* Simple implementation on character or graphic displays
* Multilanguage support
* Checkbox items
* Items with displayed parameters: integer, string
* Automatic transparent update of menu and parameters on the screen in time
* Callbacks for every item
* Scrolling with cursor and selected item in the middle on the screen, so you won't accidentaly skip item that you're looking for
### Demo
https://www.youtube.com/watch?v=H0bVR4JFMfw
### Simple example
```
#include "m2lib/m2.h"
// Simple menu
MenuItem menuItem0 = {{"First"}};
MenuItem menuItem1 = {{"Second"}};
Menu simpleMenu = {{"Simple Menu"}, .items = {&menuItem0, &menuItem1, 0}};
void m2Test()
{
unsigned char ret;
// Simple menu
// return value is index of the selected item
ret = menu2(&simpleMenu);
}
```
### Advanced menu example
```
//
// Advanced menu definitions
//
// Items
MenuItem item0 = {{"Tick"}, callback, MENU_PARAMETER_IS_NUMBER | MENU_CALLBACK_IS_FUNCTION, (int)&msTick};
MenuItem item1 = {{"Lang SubMnu"}, (void*)&subMenu, MENU_CALLBACK_IS_SUBMENU, 0};
MenuItem itemTime = {{"Time"}, callback, MENU_PARAMETER_IS_STRING | MENU_CALLBACK_IS_FUNCTION, (int)"12:05"};
MenuItem item2 = {{"Count"}, callback, MENU_ITEM_IS_CHECKBOX | MENU_ITEM_IS_CHECKED | MENU_CALLBACK_IS_FUNCTION};
MenuItem item3 = {{"Lights"}, callback, MENU_ITEM_IS_CHECKBOX };
MenuItem item4 = {{"Sound"}, callback, MENU_ITEM_IS_CHECKBOX | MENU_ITEM_IS_CHECKED };
MenuItem item5 = {{"Fan"}, callback, MENU_ITEM_IS_CHECKBOX };
MenuItem item6 = {{"Buzzer"}, callback, MENU_ITEM_IS_CHECKBOX | MENU_ITEM_IS_CHECKED };
MenuItem item7 = {{"Last check"}, callback, MENU_ITEM_IS_CHECKBOX };
// Menu
// Notice that some items are duplicated, the same menuItem can be used in multiple menus or in thee same menu
Menu menu = {
{"Menu ver2"},
.items = {&item0, &item1, &itemTime, &item2, &item3, &item2, &item5, &item6, &item7, &item3, &item4, 0},
.refresh = 200
};
void m2Test()
{
// Advanced menu
menu2(&menu);
}
// Callback
void callback(void *m)
{
Menu* menu = ((Menu*)m);
MenuItem *selectedItem = menu->items[menu->selectedIndex];
// Increment value in second menu item
if(selectedItem == &item2)
{
selectedItem->flags |= MENU_PARAMETER_IS_NUMBER;
selectedItem->parameter = (int)&testVal;
testVal++;
return;
}
displayClear();
displayString("Item callback", 0, ROW(0));
displayString("Index:", 0, ROW(1));
displayNumber(menu->selectedIndex, COL(8), ROW(1));
displayString("Item name:", 0, ROW(2));
displayString(selectedItem->text[menuLanguage], 0, ROW(3));
displayDraw();
while(evtGet() == 0);
}
```
### Multilanguage menu example
```
//
// Submenu definitions, multilanguage menu
//
// Items
MenuItem aa = {{"Prvni", "First"}, 0, MENU_PARAMETER_IS_NUMBER, (int)&msTick};
MenuItem bb = {{"Druha", "Second"}, 0, MENU_PARAMETER_IS_NUMBER, (int)&testVal};
MenuItem cc = {{"Zmen jazyk", "Change lang"}, switchLanguage, MENU_CALLBACK_IS_FUNCTION};
// Menu
Menu subMenu = {{"Czech Menu", "English Menu"}, .items = {&aa, &bb, &cc, 0}, .refresh = 1000};
// Simple switching between two languages
void switchLanguage(void *m)
{
menuLanguage = menuLanguage == LANGUAGE_CZECH ? LANGUAGE_ENGLISH : LANGUAGE_CZECH;
}
```