wuqiyang312
/
u8g2-copy
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
u8g2-copy/csrc/mui_u8g2.h

309 lines
13 KiB
C
Raw Normal View History

mui
2021-08-28 16:10:38 +08:00
/*
mui_u8g2.h
Monochrome minimal user interface: Glue code between mui and u8g2.
Universal 8bit Graphics Library (https://github.com/olikraus/u8g2/)
update pre replace
2021-09-05 17:09:02 +08:00
Copyright (c) 2021, olikraus@gmail.com
mui
2021-08-28 16:10:38 +08:00
All rights reserved.
Redistribution and use in source and binary forms, with or without modification,
are permitted provided that the following conditions are met:
* Redistributions of source code must retain the above copyright notice, this list
of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright notice, this
list of conditions and the following disclaimer in the documentation and/or other
materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
issue #2200 added NO_WRAP option
2023-06-11 18:15:54 +08:00
Reference Manual:
https://github.com/olikraus/u8g2/wiki/muiref
MUIF_U8G2_LABEL()
replacement for MUIF_LABEL(mui_u8g2_draw_text),
used by MUI_LABEL(x,y,"text")
Supports UTF8
MUIF_U8G2_FONT_STYLE(n, font)
A special u8g2 style function, which replaces MUIF_STYLE, but restricts the style change to the
specific font argument (however, this should be good enough in most cases).
As usual, the style "n" can be activated with MUI_STYLE(n) in FDS.
Example:
muif_t muif_list[] MUI_PROGMEM = {
MUIF_U8G2_LABEL(),
MUIF_U8G2_FONT_STYLE(0, u8g2_font_5x8_tr)
};
fds_t fds[] MUI_PROGMEM =
MUI_FORM(1)
MUI_STYLE(0)
MUI_LABEL(5,12, "5x8 Font")
;
mui
2021-08-28 16:10:38 +08:00
*/
some ui tests
2021-08-09 00:49:36 +08:00
mui progmem
2021-08-29 16:50:01 +08:00
#ifndef MUI_U8G2_H
#define MUI_U8G2_H
mui_u8g2.h: add u8g2.h header The mui_u8g2.h header relies on the `u8g2_uint_t` type, but without including the header the compiler errors on unknown type. I think this has generally been hidden because most users probably include "u8g2.h" before "mui_u8g2.h". But just re-ordering those includes can cause the build to fail.
2024-04-02 12:26:07 +08:00
#include "u8g2.h"
issue #1592
2021-09-20 12:41:00 +08:00
#include "mui.h"
update
2021-09-12 16:15:14 +08:00
mui progmem
2021-08-29 16:50:01 +08:00
/*==========================================*/
/* C++ compatible */
#ifdef __cplusplus
extern "C" {
#endif
some ui tests
2021-08-09 00:49:36 +08:00
update
2021-09-12 16:15:14 +08:00
#define MUI_U8G2_COMMA ,
typedef const char * (*mui_u8g2_get_list_element_cb)(void *data, uint16_t index);
typedef uint16_t (*mui_u8g2_get_list_count_cb)(void *data);
struct mui_u8g2_list_struct
{
uint16_t *selection;
void *data;
mui_u8g2_get_list_element_cb get_list_element;
mui_u8g2_get_list_count_cb get_list_count;
} MUI_PROGMEM;
typedef const struct mui_u8g2_list_struct mui_u8g2_list_t;
#if defined(__GNUC__) && defined(__AVR__)
# define mui_u8g2_list_get_selection_ptr(list) ((uint16_t *)mui_pgm_wread(&((list)->selection)))
# define mui_u8g2_list_get_data_ptr(list) ((void *)mui_pgm_wread(&((list)->data)))
# define mui_u8g2_list_get_element_cb(list) ((mui_u8g2_get_list_element_cb)mui_pgm_wread(&((list)->get_list_element)))
# define mui_u8g2_list_get_count_cb(list) ((mui_u8g2_get_list_count_cb)mui_pgm_wread(&((list)->get_list_count)))
#else
# define mui_u8g2_list_get_selection_ptr(list) ((list)->selection)
# define mui_u8g2_list_get_data_ptr(list) ((list)->data)
# define mui_u8g2_list_get_element_cb(list) ((list)->get_list_element)
# define mui_u8g2_list_get_count_cb(list) ((list)->get_list_count)
#endif
update
2021-09-11 06:32:23 +08:00
struct mui_u8g2_u8_min_max_struct
{
uint8_t *value;
uint8_t min;
uint8_t max;
update
2021-09-12 16:15:14 +08:00
} MUI_PROGMEM;
update
2021-09-11 16:27:40 +08:00
typedef const struct mui_u8g2_u8_min_max_struct mui_u8g2_u8_min_max_t;
#if defined(__GNUC__) && defined(__AVR__)
# define mui_u8g2_u8mm_get_min(u8mm) mui_pgm_read(&((u8mm)->min))
# define mui_u8g2_u8mm_get_max(u8mm) mui_pgm_read(&((u8mm)->max))
# define mui_u8g2_u8mm_get_valptr(u8mm) ((uint8_t *)mui_pgm_wread(&((u8mm)->value)))
#else
# define mui_u8g2_u8mm_get_min(u8mm) ((u8mm)->min)
# define mui_u8g2_u8mm_get_max(u8mm) ((u8mm)->max)
# define mui_u8g2_u8mm_get_valptr(u8mm) ((u8mm)->value)
#endif
update
2021-09-11 06:32:23 +08:00
update
2021-09-12 16:15:14 +08:00
update
2022-01-07 20:08:33 +08:00
struct mui_u8g2_u8_min_max_step_struct
{
uint8_t *value;
uint8_t min;
uint8_t max;
uint8_t step;
uint8_t flags;
issue #2200
2023-06-11 19:55:13 +08:00
uint8_t width; // added with issue 2200, might not be used by all bar graph functions
update
2022-01-07 20:08:33 +08:00
} MUI_PROGMEM;
typedef const struct mui_u8g2_u8_min_max_step_struct mui_u8g2_u8_min_max_step_t;
issue #2200
2023-06-11 19:55:13 +08:00
/* list of bit values for the "flags" variable */
#define MUI_MMS_2X_BAR 0x01
#define MUI_MMS_4X_BAR 0x02
#define MUI_MMS_SHOW_VALUE 0x04
#define MUI_MMS_NO_WRAP 0x08
update
2022-01-07 20:08:33 +08:00
#if defined(__GNUC__) && defined(__AVR__)
issue #2200
2023-06-11 19:55:13 +08:00
# define mui_u8g2_u8mms_get_width(u8mm) mui_pgm_read(&((u8mm)->width))
update
2022-01-07 20:08:33 +08:00
# define mui_u8g2_u8mms_get_step(u8mm) mui_pgm_read(&((u8mm)->step))
# define mui_u8g2_u8mms_get_flags(u8mm) mui_pgm_read(&((u8mm)->flags))
# define mui_u8g2_u8mms_get_min(u8mm) mui_pgm_read(&((u8mm)->min))
# define mui_u8g2_u8mms_get_max(u8mm) mui_pgm_read(&((u8mm)->max))
# define mui_u8g2_u8mms_get_valptr(u8mm) ((uint8_t *)mui_pgm_wread(&((u8mm)->value)))
#else
issue #2200
2023-06-11 19:55:13 +08:00
# define mui_u8g2_u8mms_get_width(u8mm) ((u8mm)->width)
update
2022-01-07 20:08:33 +08:00
# define mui_u8g2_u8mms_get_step(u8mm) ((u8mm)->step)
# define mui_u8g2_u8mms_get_flags(u8mm) ((u8mm)->flags)
# define mui_u8g2_u8mms_get_min(u8mm) ((u8mm)->min)
# define mui_u8g2_u8mms_get_max(u8mm) ((u8mm)->max)
# define mui_u8g2_u8mms_get_valptr(u8mm) ((u8mm)->value)
#endif
issue #2200 added NO_WRAP option
2023-06-11 18:15:54 +08:00
update
2021-08-28 18:44:34 +08:00
/* helper functions */
u8g2_uint_t mui_get_x(mui_t *ui);
u8g2_uint_t mui_get_y(mui_t *ui);
u8g2_t *mui_get_U8g2(mui_t *ui);
issue #1921
2022-09-03 22:45:10 +08:00
void mui_u8g2_draw_button_utf(mui_t *ui, u8g2_uint_t flags, u8g2_uint_t width, u8g2_uint_t padding_h, u8g2_uint_t padding_v, const char *text);
u8g2_uint_t mui_u8g2_get_pi_flags(mui_t *ui);
void mui_u8g2_draw_button_pi(mui_t *ui, u8g2_uint_t width, u8g2_uint_t padding_h, const char *text);
u8g2_uint_t mui_u8g2_get_fi_flags(mui_t *ui);
void mui_u8g2_draw_button_fi(mui_t *ui, u8g2_uint_t width, u8g2_uint_t padding_h, const char *text);
u8g2_uint_t mui_u8g2_get_pf_flags(mui_t *ui);
void mui_u8g2_draw_button_pf(mui_t *ui, u8g2_uint_t width, u8g2_uint_t padding_h, const char *text);
u8g2_uint_t mui_u8g2_get_if_flags(mui_t *ui);
void mui_u8g2_draw_button_if(mui_t *ui, u8g2_uint_t width, u8g2_uint_t padding_h, const char *text);
size optimization
2021-09-07 05:51:26 +08:00
update
2021-08-28 18:44:34 +08:00
update
2021-08-16 06:06:52 +08:00
update
2021-08-21 19:31:11 +08:00
/* ready to use field functions */
update
2021-08-15 22:23:17 +08:00
MUIF function name replacement
2021-09-05 17:20:52 +08:00
uint8_t mui_u8g2_draw_text(mui_t *ui, uint8_t msg);
mui updates
2022-01-05 06:34:16 +08:00
uint8_t mui_u8g2_btn_goto_wm_fi(mui_t *ui, uint8_t msg); /* GIF */
uint8_t mui_u8g2_btn_goto_wm_if(mui_t *ui, uint8_t msg);
uint8_t mui_u8g2_btn_goto_w2_fi(mui_t *ui, uint8_t msg); /* GIF */
uint8_t mui_u8g2_btn_goto_w2_if(mui_t *ui, uint8_t msg);
update
2021-09-26 04:59:59 +08:00
mui updates
2022-01-05 06:34:16 +08:00
uint8_t mui_u8g2_btn_goto_w1_pi(mui_t *ui, uint8_t msg); /* GIF */
uint8_t mui_u8g2_btn_goto_w1_fi(mui_t *ui, uint8_t msg); /* GIF */
update
2021-09-04 20:46:42 +08:00
mui updates
2022-01-05 06:34:16 +08:00
uint8_t mui_u8g2_btn_exit_wm_fi(mui_t *ui, uint8_t msg); /* similar to 'mui_u8g2_btn_goto_wm_fi' but will exit the menu system */
update
2021-09-05 05:25:20 +08:00
mui updates
2022-01-05 06:34:16 +08:00
uint8_t mui_u8g2_u8_chkbox_wm_pi(mui_t *ui, uint8_t msg); /* GIF, MUIF_VARIABLE, MUI_XY */
uint8_t mui_u8g2_u8_radio_wm_pi(mui_t *ui, uint8_t msg); /* GIF, MUIF_VARIABLE,MUI_XYAT */
update
2021-09-27 04:33:16 +08:00
update
2021-09-11 06:32:23 +08:00
mui updates
2022-01-05 06:34:16 +08:00
uint8_t mui_u8g2_u8_opt_line_wa_mse_pi(mui_t *ui, uint8_t msg); /* GIF, MUIF_VARIABLE,MUI_XYAT */
uint8_t mui_u8g2_u8_opt_line_wa_mse_pf(mui_t *ui, uint8_t msg); /* GIF, MUIF_VARIABLE,MUI_XYAT */
uint8_t mui_u8g2_u8_opt_line_wa_mud_pi(mui_t *ui, uint8_t msg); /* GIF, MUIF_VARIABLE,MUI_XYAT */
uint8_t mui_u8g2_u8_opt_line_wa_mud_pf(mui_t *ui, uint8_t msg); /* GIF, MUIF_VARIABLE,MUI_XYAT */
update
2021-09-04 20:46:42 +08:00
mui #1747
2022-04-03 18:12:16 +08:00
/* dropdown list / combo box */
Fix minor comment typos
2022-12-10 14:46:22 +08:00
/* The text part of the parent defines a '|' separated list of elements, which can be selected by the child. */
update
2022-01-06 07:05:50 +08:00
/* Argument is a form number where the child element is placed multiple times */
/* The child form does not require the ok button, because the child function will return to the parent with the select element */
2.32.14
2022-04-04 01:36:21 +08:00
uint8_t mui_u8g2_u8_opt_parent_wm_pi(mui_t *ui, uint8_t msg); /* GIF, MUIF_VARIABLE, MUI_XYAT */
uint8_t mui_u8g2_u8_opt_radio_child_wm_pi(mui_t *ui, uint8_t msg); /* GIF, MUIF_VARIABLE, MUI_XYA */
uint8_t mui_u8g2_u8_opt_radio_child_w1_pi(mui_t *ui, uint8_t msg); /* GIF, MUIF_VARIABLE, MUI_XYA */
uint8_t mui_u8g2_u8_opt_child_wm_pi(mui_t *ui, uint8_t msg); /* MUIF_VARIABLE, MUI_XYA */
/* Note: there is no opt_child_goto muif, because this can be done with mui_u8g2_goto_form_w1_pi */
MUI_DATA
2021-09-26 17:16:14 +08:00
mui #1747
2022-04-03 18:12:16 +08:00
/* (scrollable) jump menu */
Fix minor comment typos
2022-12-10 14:46:22 +08:00
/* The text part of the parent defines a '|' separated list of elements, which can be selected goto_form functions. */
/* Each '|' separated element must be prefixed with the form number (MUI_x) */
update
2022-01-07 20:08:33 +08:00
uint8_t mui_u8g2_goto_data(mui_t *ui, uint8_t msg); /* REF, MUIF_RO, MUI_DATA (WARNING: Must appear only once per form!!! */
2.32.14
2022-04-04 01:36:21 +08:00
uint8_t mui_u8g2_goto_form_w1_pi(mui_t *ui, uint8_t msg); /* REF, MUIF_BUTTON, MUI_XYA */
uint8_t mui_u8g2_goto_form_w1_pf(mui_t *ui, uint8_t msg); /* REF, MUIF_BUTTON, MUI_XYA */
update
2021-08-23 00:22:25 +08:00
update
2021-09-05 05:25:20 +08:00
mui #1747
2022-04-03 18:12:16 +08:00
/* character input */
update
2022-01-06 19:01:42 +08:00
uint8_t mui_u8g2_u8_char_wm_mud_pi(mui_t *ui, uint8_t msg); /* GIF, MUIF_VARIABLE,MUI_XY, usually requires a monospaced font line profont12 */
update
2021-09-05 05:25:20 +08:00
update
2021-09-12 23:05:54 +08:00
update
2022-01-09 02:51:38 +08:00
/*===== MUIF U8g2 Label =====*/
#define MUIF_U8G2_LABEL() MUIF_LABEL(mui_u8g2_draw_text)
update
2022-01-09 01:18:25 +08:00
/*===== data = u8g2 font data =====*/
//#define MUIF_U8G2_FONT_STYLE(n,font) MUIF("S" #n, 0, (void *)(font), mui_u8g2_set_font_style_function)
#define MUIF_U8G2_FONT_STYLE(n, font) { 'S', #n[0], 0, 0, (void *)(font), mui_u8g2_set_font_style_function}
uint8_t mui_u8g2_set_font_style_function(mui_t *ui, uint8_t msg);
update
2021-09-12 23:05:54 +08:00
/*===== data = mui_u8g2_u8_min_max_t* =====*/
/* gcc note: the macro uses array compound literals to extend the lifetime in C++, see last section in https://gcc.gnu.org/onlinedocs/gcc/Compound-Literals.html */
#define MUIF_U8G2_U8_MIN_MAX(id, valptr, min, max, muif) \
MUIF(id, MUIF_CFLAG_IS_CURSOR_SELECTABLE, \
(void *)((mui_u8g2_u8_min_max_t [] ) {{ (valptr) MUI_U8G2_COMMA (min) MUI_U8G2_COMMA (max)}}), \
(muif))
mui updates
2022-01-05 06:34:16 +08:00
uint8_t mui_u8g2_u8_min_max_wm_mse_pi(mui_t *ui, uint8_t msg); /* GIF, MUIF_U8G2_U8_MIN_MAX, MUI_XY */
uint8_t mui_u8g2_u8_min_max_wm_mud_pi(mui_t *ui, uint8_t msg); /* GIF, MUIF_U8G2_U8_MIN_MAX, MUI_XY */
update
2021-09-12 23:05:54 +08:00
mui updates
2022-01-05 06:34:16 +08:00
uint8_t mui_u8g2_u8_min_max_wm_mse_pf(mui_t *ui, uint8_t msg); /* GIF, MUIF_U8G2_U8_MIN_MAX, MUI_XY */
uint8_t mui_u8g2_u8_min_max_wm_mud_pf(mui_t *ui, uint8_t msg); /* GIF, MUIF_U8G2_U8_MIN_MAX, MUI_XY */
update
2021-09-12 23:05:54 +08:00
update
2022-01-07 20:08:33 +08:00
/*===== data = mui_u8g2_u8_min_max_step_t* =====*/
/* gcc note: the macro uses array compound literals to extend the lifetime in C++, see last section in https://gcc.gnu.org/onlinedocs/gcc/Compound-Literals.html */
#define MUIF_U8G2_U8_MIN_MAX_STEP(id, valptr, min, max, step, flags, muif) \
MUIF(id, MUIF_CFLAG_IS_CURSOR_SELECTABLE, \
issue #2200
2023-06-11 19:55:13 +08:00
(void *)((mui_u8g2_u8_min_max_step_t [] ) {{ (valptr) MUI_U8G2_COMMA (min) MUI_U8G2_COMMA (max) MUI_U8G2_COMMA (step) MUI_U8G2_COMMA (flags) MUI_U8G2_COMMA (0) }}), \
update
2022-01-07 20:08:33 +08:00
(muif))
uint8_t mui_u8g2_u8_bar_wm_mse_pi(mui_t *ui, uint8_t msg);
uint8_t mui_u8g2_u8_bar_wm_mud_pi(mui_t *ui, uint8_t msg);
uint8_t mui_u8g2_u8_bar_wm_mse_pf(mui_t *ui, uint8_t msg);
uint8_t mui_u8g2_u8_bar_wm_mud_pf(mui_t *ui, uint8_t msg);
issue #2200 added NO_WRAP option
2023-06-11 18:15:54 +08:00
issue #2200
2023-06-12 03:17:39 +08:00
#define MUIF_U8G2_U8_MIN_MAX_STEP_WIDTH(id, valptr, min, max, step, width, flags, muif) \
MUIF(id, MUIF_CFLAG_IS_CURSOR_SELECTABLE, \
(void *)((mui_u8g2_u8_min_max_step_t [] ) {{ (valptr) MUI_U8G2_COMMA (min) MUI_U8G2_COMMA (max) MUI_U8G2_COMMA (step) MUI_U8G2_COMMA (flags) MUI_U8G2_COMMA (width) }}), \
(muif))
uint8_t mui_u8g2_u8_fixed_width_bar_wm_mse_pi(mui_t *ui, uint8_t msg);
uint8_t mui_u8g2_u8_fixed_width_bar_wm_mud_pi(mui_t *ui, uint8_t msg);
uint8_t mui_u8g2_u8_fixed_width_bar_wm_mse_pf(mui_t *ui, uint8_t msg);
uint8_t mui_u8g2_u8_fixed_width_bar_wm_mud_pf(mui_t *ui, uint8_t msg);
issue #2200 added NO_WRAP option
2023-06-11 18:15:54 +08:00
update
2021-09-12 23:05:54 +08:00
/*===== data = mui_u8g2_list_t* =====*/
mui
2021-10-18 05:14:45 +08:00
/* similar to mui_u8g2_u8_opt_line, but u16 and dynamic list */
update
2021-09-13 05:43:19 +08:00
#define MUIF_U8G2_U16_LIST(id, valptr, dataptr, getcb, cntcb, muif) \
update
2021-09-12 16:15:14 +08:00
MUIF(id, MUIF_CFLAG_IS_CURSOR_SELECTABLE, \
update
2021-09-13 05:43:19 +08:00
(void *)((mui_u8g2_list_t [] ) {{ (valptr) MUI_U8G2_COMMA (dataptr) MUI_U8G2_COMMA (getcb) MUI_U8G2_COMMA (cntcb)}}), \
update
2021-09-12 23:05:54 +08:00
(muif))
update
2022-01-07 20:08:33 +08:00
uint8_t mui_u8g2_u16_list_line_wa_mse_pi(mui_t *ui, uint8_t msg); /* GIF, MUIF_U8G2_U16_LIST, MUI_XYA, arg=pixel fieldsize */
uint8_t mui_u8g2_u16_list_line_wa_mud_pi(mui_t *ui, uint8_t msg); /* GIF, MUIF_U8G2_U16_LIST, MUI_XYA, arg=pixel fieldsize */
update
2021-09-12 23:05:54 +08:00
update
2021-09-12 16:15:14 +08:00
mui #1747
2022-04-03 18:12:16 +08:00
/* dropdown list / combo box with 16 size and callback functions for MUIF_U8G2_U16_LIST */
2.32.14
2022-04-04 01:36:21 +08:00
uint8_t mui_u8g2_u16_list_parent_wm_pi(mui_t *ui, uint8_t msg); /* GIF, MUIF_U8G2_U16_LIST, MUI_XYA, arg=subform */
uint8_t mui_u8g2_u16_list_child_w1_pi(mui_t *ui, uint8_t msg); /* GIF, MUIF_U8G2_U16_LIST, MUI_XYA, arg=sub element number */
uint8_t mui_u8g2_u16_list_goto_w1_pi(mui_t *ui, uint8_t msg); /* REF, MUIF_U8G2_U16_LIST first char of the string denotes the target form */
update
2021-09-20 04:25:52 +08:00
update
2021-09-12 16:15:14 +08:00
mui progmem
2021-08-29 16:50:01 +08:00
#ifdef __cplusplus
}
#endif
update
2021-08-23 00:22:25 +08:00
mui progmem
2021-08-29 16:50:01 +08:00
#endif /* MUI_U8G2_H */
update
2021-08-21 04:50:29 +08:00