diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md deleted file mode 100644 index fdf9748530..0000000000 --- a/docs/ROADMAP.md +++ /dev/null @@ -1,114 +0,0 @@ -# Roadmap - -## Planned for v9 - -### Naming and API -- [x] `lv_style_set_size()` should have separate width and height parameters -- [x] Reconsider image color formats. -- [ ] More consistent names:`remove/clear/delete/del`, `offset/ofs`, `add/create/register`, `id/idx/index`, `middle/mid/center`, `img/image`, `txt/text`, `opa/opacity/alpha`, `scr/screen`, `disp, display`, `finished/complete/completed/ready`, `buf/buffer`, `..._cb`, angle, rotation`, `zoom, scale` -- [ ] Reconsider the use of `has`, `is`, `enable` "action" keywords -- [x] Update canvas API (https://github.com/lvgl/lvgl/issues/3393) -- [x] `LV_STYLE_PROP_INHERIT` -> `LV_STYLE_PROP_FLAG_INHERITABLE` [LINK](https://github.com/lvgl/lvgl/pull/3390#discussion_r885915769) -- [x] Replace `disp_drv->direct_mode/full_refresh` with enum. -- [x] Consider flat directory structure. E.g. `extra/widgets` to `widgets` -- [ ] Use `uint32_t` and `int32_t` in APIs where possible. Consider hardcoding `lv_coord_t` as `int32_t`. -- [ ] To define a new stdlib API use defines `LV_USE_CUSTOM_...` and let the user implement `lv_...` functions somewhere (instead of defining the name of the custom functions) -- [ ] Generic `lv_date_t` and `lv_time_t` -- [ ] Make layouts with an `lv_layout_dsc_t` instead of registering an ID + callback. See [here](https://github.com/lvgl/lvgl/issues/3481#issuecomment-1206434501) - -### Architecture -- [x] Consider merging `lv_disp_drv_t`, `lv_disp_t`, `lv_disp_draw_buf_t`, `lv_draw_ctx_t`, and `struct`'s from the new driver API (or only some of them) -- [x] New driver architecture #2720 -- [x] `draw_ctx->buffer_convert`? See [here](https://github.com/lvgl/lvgl/issues/3379#issuecomment-1147954592). Also remove 16 SWAPPED color format? See [here](https://github.com/lvgl/lvgl/issues/3379#issuecomment-1140886258). -- [ ] `lv_img_set_src()` use "type-aware" parameter and rework image decoders. See [here](https://github.com/lvgl/lvgl/tree/arch/img-decode-rework) -- [ ] Reconsider masks. There should be a generic high level mask API which is independent of the drawing engine. [#4059](https://github.com/lvgl/lvgl/issues/4059) -- [x] `get_glyph_bitmap` should return an a8 bitmap that can be blended immediately. -- [ ] Reconsider how themes should work. See [here](https://github.com/lvgl/lvgl/pull/3390#pullrequestreview-990710921). -- [ ] Make LVGL render independent areas in parallel. [#4016](https://github.com/lvgl/lvgl/issues/4016) -- [x] Drop `lv_mem_buf_get` as tlsf should be fast enough for normal allocations too. Fragmentation is also lower if processes can completely clean up after themselves. -- [x] More color formats: 24 bit, ARGB1555, ARGB4444 etc -- [ ] Unified caching #3116 #3415 -- [ ] Condider using `lv_color32_t` on APIs to support e.g. alpha gradient. -- [ ] Add more feature to key presses (long press, release, etc). See [here](https://forum.lvgl.io/t/keypad-input-device-why-lv-event-long-pressed-only-on-enter/10263). - -### Styles -- [ ] Make `style_bg_img` support `9patch` images -- [ ] non-uniform scale of images: scale width and height differently -- [ ] Scroll anim settings should come from styles to allow customization - -### Widgets -- [ ] `lv_img`: Reconsider image sizing models (when the image size is not content): center, top-left, zoom, tile, other? -- [ ] `lv_tabview` Replace button matrix with real buttons for more flexibility -- [ ] `lv_label` reconsider label long modes. (support min/max-width/height too) #3420 -- [ ] `lv_roller` make it more flexible #4009 -- [ ] Universal scale widget/support (see [here](https://forum.lvgl.io/t/linear-meter-bar-with-ticks/10986) and #4043) -- [ ] Improve `lv_label_align_t` #1656 -- [ ] Disabled widgets should absorb indev actions without sending events. [#3860](https://github.com/lvgl/lvgl/issues/3860) - -### Drawing and rendering -- [ ] Automatically recalculate the layout if a coordinte is get with `lv_obj_get_width/height/x/y/etc` - -### Animations -- [ ] Use `anim` events to replace many callbacks with one -- [ ] `lv_anim_time_to_speed` should work differently to remove `style_anim_speed`. E.g. on large values of anim time store the speed. Besides all widgets should use the `style_anim` property. `anim` should clamp the time if it's calculated from speed, e.g `lv_clamp(200, t, 2000)`. (maybe `a->min_time/max_time`). -- [ ] Use dedicated `lv_anim_custom_exec_cb_t`. See [here](https://forum.lvgl.io/t/custom-exec-cb-prevents-lv-anim-del-obj-null/10266). - -## Planned in general - -### CI -- [ ] Plaform independent bechmarking #3443 -- [ ] Run static analyzer -- [ ] Release script -- [ ] Unit test for all widgets #2337 -- [ ] CI test for flash/RAM usage #3127 - -### Architecture -- [ ] C++ binding: https://github.com/lvgl/lv_binding_cpp -- [ ] Markup language #2428 - -### Styles -- [ ] Hover -- [ ] Global states in selectors. E.g. `LV_STATE_PRESSED | SMALL_SCREEN` like media quarry in CSS - -### Drawing and rendering -- [ ] SW: Line drawing with image rotation -- [ ] SW: Arc drawing from small squares (16x16?) to detect transparent or solid parts -- [ ] SW: Rounded rectangle drawing from small squares (16x16?) to detect transparent or solid parts -- [ ] Different radius on each corner #2800 -- [ ] Gradient to border/outline/shadow -- [ ] Multiple shadow/border -- [ ] Perspective -- [ ] Text shadow -- [ ] Innter shadow -- [ ] ARGB image stroke/grow on the alpha map -- [ ] Real time blur -- [ ] Gradient with alpha - -### Widgets -- [ ] `lv_bar`, `lv_arc`: handle max < min for fill direction swapping #4039 - -### Others -- [ ] More grid features. E.g. repeat(auto-fill, minmax( px, 1fr)) -- [ ] Named grid cells to allow updating layouts without touching the children (like CSS `grid-template-areas`) -- [ ] Scene support. See [this comment](https://github.com/lvgl/lvgl/issues/2790#issuecomment-965100911) -- [ ] Circle layout. #2871 -- [ ] Variable binding. I.e create properties which can be bound to objects and those obejcts are notified on value change. Maybe based on `lv_msg`? -- [ ] Consider [stagger animations](https://greensock.com/docs/v3/Staggers). - -## Ideas -- Better way to reset global variables in `lv_deinit()` #3385 -- `lv_array`: replace linked lists with array where possible (arrays are faster and uses less memory) -- Reconsider how to handle UTF-8 characters (allow different encoding too) and Bidi. Maybe create an abstraction for typesetting. -- Consider direct binary font format support -- Improve groups. [Discussion](https://forum.lvgl.io/t/lv-group-tabindex/2927/3). Reconsider focusing logic. Allow having no widget selected (on web it's possible). Keep editing state in `lv_obj_t` (See [here](https://github.com/lvgl/lvgl/issues/3646)). Support slider left knob focusing (see [here](https://github.com/lvgl/lvgl/issues/3246)) -- lv_mem_alloc_aligned(size, align) -- Speed up font decompression -- Support larger images: add support for large image #1892 -- Functional programming support, pure view? See [here](https://www.freecodecamp.org/news/the-revolution-of-pure-views-aed339db7da4/) -- Style components. See [this comment](https://github.com/lvgl/lvgl/issues/2790#issuecomment-965100911) -- SVG support: integrate an SVG render library -- Support dot_begin and dot_middle long modes for labels -- Allow matrix input for image transformation? -- Radial/skew/conic gradient -- Somehow let children inherit the parent's state -- Text on path diff --git a/docs/ROADMAP.rst b/docs/ROADMAP.rst new file mode 100644 index 0000000000..189ad47588 --- /dev/null +++ b/docs/ROADMAP.rst @@ -0,0 +1,211 @@ + +.. |check| raw:: html + + + + + +.. |uncheck| raw:: html + + + + +Roadmap +======= + +Planned for v9 +-------------- + +Naming and API +~~~~~~~~~~~~~~ + +- |check| `lv_style_set_size()` should have separate width and height parameters +- |check| Reconsider image color formats. +- |uncheck| More consistent names: + + - `remove/clear/delete/del` + - `offset/ofs` + - `add/create/register` + - `id/idx/index` + - `middle/mid/center` + - `img/image` + - `txt/text` + - `opa/opacity/alpha` + - `scr/screen` + - `disp, display` + - `finished/complete/completed/ready` + - `buf/buffer` + - `..._cb` + - `angle` + - `rotation` + - `zoom` + - `scale` + +- |uncheck| Reconsider the use of `has`, `is`, `enable` “action” keywords +- |check| Update canvas API `LINK `__ +- |check| `LV_STYLE_PROP_INHERIT` -> `LV_STYLE_PROP_FLAG_INHERITABLE` + `LINK `__ +- |check| Replace `disp_drv->direct_mode/full_refresh` with enum. +- |check| Consider flat directory structure. E.g. `extra/widgets` to `widgets` +- |uncheck| Use `uint32_t` and `int32_t` in APIs where possible. Consider hardcoding `lv_coord_t` as `int32_t`. +- |uncheck| To define a new stdlib API use defines `LV_USE_CUSTOM_...` and + let the user implement `lv_...` functions somewhere (instead of defining the name of the custom functions) +- |uncheck| Generic `lv_date_t` and `lv_time_t` +- |uncheck| Make layouts with an `lv_layout_dsc_t` instead of registering an ID + callback. + (see `here `__) + +Architecture +~~~~~~~~~~~~ + +- |check| Consider merging + + - `lv_disp_drv_t` + - `lv_disp_t`, + - `lv_disp_draw_buf_t`, + - `lv_draw_ctx_t` + - `struct`\ 's + + from the new driver API (or only some of them) +- |check| New driver architecture #2720 +- |check| `draw_ctx->buffer_convert`? + (see `here `__) + Also remove 16 SWAPPED color format? + (see `here `__) +- |uncheck| `lv_img_set_src()` use “type-aware” parameter and rework image decoders. + (see `here `__) +- |uncheck| Reconsider masks. There should be a generic high level mask API which is independent of the drawing engine. + `#4059 `__ +- |check| `get_glyph_bitmap` should return an a8 bitmap that can be blended immediately. +- |uncheck| Reconsider how themes should work. + (see `here `__) +- |uncheck| Make LVGL render independent areas in parallel. + `#4016 `__ +- |check| Drop `lv_mem_buf_get` as tlsf should be fast enough for normal allocations too. + Fragmentation is also lower if processes can completely clean up after themselves. +- |check| More color formats: 24 bit, ARGB1555, ARGB4444 etc +- |uncheck| Unified caching #3116 #3415 +- |uncheck| Condider using `lv_color32_t` on APIs to support e.g. alpha gradient. +- |uncheck| Add more feature to key presses (long press, release, etc). + (see `here `__) + +Styles +~~~~~~ + +- |uncheck| Make `style_bg_img` support `9patch` images +- |uncheck| non-uniform scale of images: scale width and height differently +- |uncheck| Scroll anim settings should come from styles to allow customization + +Widgets +~~~~~~~ + +- |uncheck| `lv_img`: Reconsider image sizing models + (when the image size is not content): center, top-left, zoom, tile, other? +- |uncheck| `lv_tabview` Replace button matrix with real buttons for more flexibility +- |uncheck| `lv_label` reconsider label long modes. (support min/max-width/height too) #3420 +- |uncheck| `lv_roller` make it more flexible #4009 +- |uncheck| Universal scale widget/support + (see `here `__ and #4043) +- |uncheck| Improve `lv_label_align_t` #1656 +- |uncheck| Disabled widgets should absorb indev actions without sending events. + `#3860 `__ + +Drawing and rendering +~~~~~~~~~~~~~~~~~~~~~ + +- |uncheck| Automatically recalculate the layout if a coordinte is get with `lv_obj_get_width/height/x/y/etc` + +Animations +~~~~~~~~~~ + +- |uncheck| Use `anim` events to replace many callbacks with one +- |uncheck| `lv_anim_time_to_speed` should work differently to remove + `style_anim_speed`. E.g. on large values of anim time store the + speed. Besides all widgets should use the `style_anim` property. + `anim` should clamp the time if it's calculated from speed, e.g + `lv_clamp(200, t, 2000)`. (maybe `a->min_time/max_time`). +- |uncheck| Use dedicated `lv_anim_custom_exec_cb_t`. + See `here `__. + +Planned in general +------------------ + +CI +~~ + +- |uncheck| Plaform independent bechmarking #3443 +- |uncheck| Run static analyzer +- |uncheck| Release script +- |uncheck| Unit test for all widgets #2337 +- |uncheck| CI test for flash/RAM usage #3127 + + +Architecture +~~~~~~~~~~~~ + +- |uncheck| `C++ binding `__ +- |uncheck| Markup language #2428 + + +Styles +~~~~~~ + +- |uncheck| Hover +- |uncheck| Global states in selectors. E.g. `LV_STATE_PRESSED | SMALL_SCREEN` like media quarry in CSS + + +Drawing and rendering +~~~~~~~~~~~~~~~~~~~~~ + +- |uncheck| SW: Line drawing with image rotation +- |uncheck| SW: Arc drawing from small squares (16x16?) to detect transparent or solid parts +- |uncheck| SW: Rounded rectangle drawing from small squares (16x16?) to detect transparent or solid parts +- |uncheck| Different radius on each corner #2800 +- |uncheck| Gradient to border/outline/shadow +- |uncheck| Multiple shadow/border +- |uncheck| Perspective +- |uncheck| Text shadow +- |uncheck| Innter shadow +- |uncheck| ARGB image stroke/grow on the alpha map +- |uncheck| Real time blur +- |uncheck| Gradient with alpha + + +Widgets +~~~~~~~ + +- |uncheck| `lv_bar`, `lv_arc`: handle max < min for fill direction swapping #4039 + +Others +~~~~~~ + +- |uncheck| More grid features. E.g. repeat(auto-fill, minmax( px, 1fr)) +- |uncheck| Named grid cells to allow updating layouts without touching the children (like CSS `grid-template-areas`) +- |uncheck| Scene support. See `this comment `__ +- |uncheck| Circle layout. #2871 +- |uncheck| Variable binding. I.e create properties which can be bound to + objects and those obejcts are notified on value change. Maybe based on `lv_msg`? +- |uncheck| Consider `stagger animations `__. + +Ideas +----- + +- Better way to reset global variables in `lv_deinit()` #3385 +- `lv_array`: replace linked lists with array where possible (arrays are faster and uses less memory) +- Reconsider how to handle UTF-8 characters (allow different encoding too) and Bidi. Maybe create an abstraction for typesetting. +- Consider direct binary font format support +- Improve groups. `Discussion `__. + Reconsider focusing logic. Allow having no widget selected (on web it's possible). Keep editing state in `lv_obj_t` + (see `here `__). Support slider + left knob focusing (see `here `__) +- lv_mem_alloc_aligned(size, align) +- Speed up font decompression +- Support larger images: add support for large image #1892 +- Functional programming support, pure view? + (see `here `__) +- Style components. (see `this comment `__ +- SVG support: integrate an SVG render library +- Support dot_begin and dot_middle long modes for labels +- Allow matrix input for image transformation? +- Radial/skew/conic gradient +- Somehow let children inherit the parent's state +- Text on path diff --git a/docs/build.py b/docs/build.py index f82e9d016d..3448215107 100755 --- a/docs/build.py +++ b/docs/build.py @@ -14,6 +14,7 @@ import example_list as ex import doc_builder import shutil import tempfile +import config_builder # due to the modifications that take place to the documentation files # when the documentaation builds it is better to copy the source files to a @@ -116,6 +117,8 @@ if clean: # os.mkdir(api_path) # os.mkdir(lang) +config_builder.run() + shutil.copytree('.', temp_directory, dirs_exist_ok=True) shutil.copytree(examples_path, os.path.join(temp_directory, 'examples')) @@ -260,5 +263,7 @@ else: iter_temp(temp_directory) +config_builder.cleanup() + print('output path:', html_dst_path) print('\nFINISHED!!') diff --git a/docs/config_builder.py b/docs/config_builder.py new file mode 100644 index 0000000000..b53f4fe612 --- /dev/null +++ b/docs/config_builder.py @@ -0,0 +1,35 @@ + +import os + +base_path = os.path.dirname(__file__) +dst_config = os.path.join(base_path, 'lv_conf.h') +src_config = os.path.abspath(os.path.join( + base_path, + '..', + 'lv_conf_template.h' +)) + + +def run(): + with open(src_config, 'r') as f: + data = f.read() + + data = data.split('\n') + + for i, line in enumerate(data): + if 'LV_USE' in line or 'LV_FONT' in line: + line = [item for item in line.split(' ') if item] + for j, item in enumerate(line): + if item == '0': + line[j] = '1' + line = ' '.join(line) + data[i] = line + data = '\n'.join(data) + + with open(dst_config, 'w') as f: + f.write(data) + + +def cleanup(): + if os.path.exists(dst_config): + os.remove(dst_config) \ No newline at end of file diff --git a/docs/intro/index.rst b/docs/intro/index.rst index af6ce4ab52..29f37985bc 100644 --- a/docs/intro/index.rst +++ b/docs/intro/index.rst @@ -136,7 +136,7 @@ Starting from v8, every minor release is supported for 1 year. +---------+--------------+--------------+--------+ |v8.1 | 10 Nov, 2021 | 10 Nov, 2022 | No | +---------+--------------+--------------+--------+ -|v8.2 | 31 Jan, 2022 | 31 Jan, 2023 | No | +|v8.2 | 31 Jan, 2022 | 31 Jan, 2023 | No | +---------+--------------+--------------+--------+ |v8.3 | 6 July, 2022 | 1 Jan, 2025 | Yes | +---------+--------------+--------------+--------+ diff --git a/docs/lv_conf.h b/docs/lv_conf.h deleted file mode 100644 index 12b706da8c..0000000000 --- a/docs/lv_conf.h +++ /dev/null @@ -1,857 +0,0 @@ -/** - * @file lv_conf.h - * Configuration file for v9.0.0-dev - */ - -/* - * Copy this file as `lv_conf.h` - * 1. simply next to the `lvgl` folder - * 2. or any other places and - * - define `LV_CONF_INCLUDE_SIMPLE` - * - add the path as include path - */ - -/* clang-format off */ -#if 1 /*Set it to "1" to enable content*/ - -#ifndef LV_CONF_H -#define LV_CONF_H - -#include - -/*======================= - * Development version! - * ======================*/ - -#define LV_USE_DEV_VERSION - -/*==================== - COLOR SETTINGS - *====================*/ - -/*Color depth: 1 (1 byte per pixel), 8 (RGB332), 16 (RGB565), 24 (RGB888), 32 (ARGB8888)*/ -#ifndef LV_COLOR_DEPTH -#define LV_COLOR_DEPTH 32 -#endif - -#define LV_COLOR_CHROMA_KEY lv_color_hex(0x00ff00) - -/*========================= - STDLIB WRAPPER SETTINGS - *=========================*/ - -/*Enable and configure the built-in memory manager*/ -#define LV_USE_BUILTIN_MALLOC 1 -#if LV_USE_BUILTIN_MALLOC - /*Size of the memory available for `lv_malloc()` in bytes (>= 2kB)*/ - #define LV_MEM_SIZE (48U * 1024U) /*[bytes]*/ - - /*Size of the memory expand for `lv_malloc()` in bytes*/ - #define LV_MEM_POOL_EXPAND_SIZE 0 - - /*Set an address for the memory pool instead of allocating it as a normal array. Can be in external SRAM too.*/ - #define LV_MEM_ADR 0 /*0: unused*/ - /*Instead of an address give a memory allocator that will be called to get a memory pool for LVGL. E.g. my_malloc*/ - #if LV_MEM_ADR == 0 - #undef LV_MEM_POOL_INCLUDE - #undef LV_MEM_POOL_ALLOC - #endif -#endif /*LV_USE_BUILTIN_MALLOC*/ - -/*Enable lv_memcpy_builtin, lv_memset_builtin, lv_strlen_builtin, lv_strncpy_builtin*/ -#define LV_USE_BUILTIN_MEMCPY 1 - -/*Enable and configure the built-in (v)snprintf */ -#define LV_USE_BUILTIN_SNPRINTF 1 -#if LV_USE_BUILTIN_SNPRINTF - #define LV_SPRINTF_USE_FLOAT 1 -#endif /*LV_USE_BUILTIN_SNPRINTF*/ - -#define LV_STDLIB_INCLUDE -#define LV_STDIO_INCLUDE -#define LV_STRING_INCLUDE -#define LV_MALLOC malloc -#define LV_REALLOC realloc -#define LV_FREE free -#define LV_MEMSET memset -#define LV_MEMCPY memcpy -#define LV_SNPRINTF lv_snprintf_builtin -#define LV_VSNPRINTF lv_vsnprintf_builtin -#define LV_STRLEN strlen -#define LV_STRNCPY strncpy -#define LV_STRCPY strcpy - -#define LV_COLOR_EXTERN_INCLUDE -#define LV_COLOR_MIX lv_color_mix -#define LV_COLOR_PREMULT lv_color_premult -#define LV_COLOR_MIX_PREMULT lv_color_mix_premult - -/*==================== - HAL SETTINGS - *====================*/ - -/*Default display refresh, input device read and animation step period.*/ -#define LV_DEF_REFR_PERIOD 1 /*[ms]*/ - -/*Use a custom tick source that tells the elapsed time in milliseconds. - *It removes the need to manually update the tick with `lv_tick_inc()`)*/ -#define LV_TICK_CUSTOM 0 -#if LV_TICK_CUSTOM - #define LV_TICK_CUSTOM_INCLUDE "Arduino.h" /*Header for the system time function*/ - #define LV_TICK_CUSTOM_SYS_TIME_EXPR (millis()) /*Expression evaluating to current system time in ms*/ - /*If using lvgl as ESP32 component*/ - // #define LV_TICK_CUSTOM_INCLUDE "esp_timer.h" - // #define LV_TICK_CUSTOM_SYS_TIME_EXPR ((esp_timer_get_time() / 1000LL)) -#endif /*LV_TICK_CUSTOM*/ - -/*Default Dot Per Inch. Used to initialize default sizes such as widgets sized, style paddings. - *(Not so important, you can adjust it to modify default sizes and spaces)*/ -#define LV_DPI_DEF 130 /*[px/inch]*/ - -/*======================== - * DRAW CONFIGURATION - *========================*/ - -/*Enable the built in mask engine. - *Required to draw shadow, rounded corners, circles, arc, skew lines, or any other masks*/ -#define LV_USE_DRAW_MASKS 1 - -#define LV_USE_DRAW_SW 1 -#if LV_USE_DRAW_SW - - /*Enable complex draw engine. - *Required to draw shadow, gradient, rounded corners, circles, arc, skew lines, image transformations or any masks*/ - #define LV_DRAW_SW_COMPLEX 1 - - /* If a widget has `style_opa < 255` (not `bg_opa`, `text_opa` etc) or not NORMAL blend mode - * it is buffered into a "simple" layer before rendering. The widget can be buffered in smaller chunks. - * "Transformed layers" (if `transform_angle/zoom` are set) use larger buffers - * and can't be drawn in chunks. */ - - /*The target buffer size for simple layer chunks.*/ - #define LV_DRAW_SW_LAYER_SIMPLE_BUF_SIZE (24 * 1024) /*[bytes]*/ - - /*Used if `LV_DRAW_SW_LAYER_SIMPLE_BUF_SIZE` couldn't be allocated.*/ - #define LV_DRAW_SW_LAYER_SIMPLE_FALLBACK_BUF_SIZE (3 * 1024) /*[bytes]*/ - - /*Allow buffering some shadow calculation. - *LV_DRAW_SW_SHADOW_CACHE_SIZE is the max. shadow size to buffer, where shadow size is `shadow_width + radius` - *Caching has LV_DRAW_SW_SHADOW_CACHE_SIZE^2 RAM cost*/ - #define LV_DRAW_SW_SHADOW_CACHE_SIZE 0 - - /* Set number of maximally cached circle data. - * The circumference of 1/4 circle are saved for anti-aliasing - * radius * 4 bytes are used per circle (the most often used radiuses are saved) - * 0: to disable caching */ - #define LV_DRAW_SW_CIRCLE_CACHE_SIZE 4 - - /*Default gradient buffer size. - *When LVGL calculates the gradient "maps" it can save them into a cache to avoid calculating them again. - *LV_DRAW_SW_GRADIENT_CACHE_DEF_SIZE sets the size of this cache in bytes. - *If the cache is too small the map will be allocated only while it's required for the drawing. - *0 mean no caching.*/ - #define LV_DRAW_SW_GRADIENT_CACHE_DEF_SIZE 0 - - /*Allow dithering the gradients (to achieve visual smooth color gradients on limited color depth display) - *LV_DRAW_SW_GRADIENT_DITHER implies allocating one or two more lines of the object's rendering surface - *The increase in memory consumption is (32 bits * object width) plus 24 bits * object width if using error diffusion */ - #define LV_DRAW_SW_GRADIENT_DITHER 0 - #if LV_DRAW_SW_GRADIENT_DITHER - /*Add support for error diffusion dithering. - *Error diffusion dithering gets a much better visual result, but implies more CPU consumption and memory when drawing. - *The increase in memory consumption is (24 bits * object's width)*/ - #define LV_DRAW_SW_GRADIENT_DITHER_ERROR_DIFFUSION 0 - #endif - - /*Enable subpixel rendering*/ - #define LV_DRAW_SW_FONT_SUBPX 0 - #if LV_DRAW_SW_FONT_SUBPX - /*Set the pixel order of the display. Physical order of RGB channels. Doesn't matter with "normal" fonts.*/ - #define LV_DRAW_SW_FONT_SUBPX_BGR 0 /*0: RGB; 1:BGR order*/ - #endif -#endif - -/*Use SDL renderer API*/ -#define LV_USE_DRAW_SDL 1 -#if LV_USE_DRAW_SDL - #define LV_DRAW_SDL_INCLUDE_PATH - /*Texture cache size, 8MB by default*/ - #define LV_DRAW_SDL_LRU_SIZE (1024 * 1024 * 8) - /*Custom blend mode for mask drawing, disable if you need to link with older SDL2 lib*/ - #define LV_DRAW_SDL_CUSTOM_BLEND_MODE (SDL_VERSION_ATLEAST(2, 0, 6)) -#endif - -/*===================== - * GPU CONFIGURATION - *=====================*/ - -/*Use Arm's 2D acceleration library Arm-2D */ -#define LV_USE_GPU_ARM2D 1 - -/*Use STM32's DMA2D (aka Chrom Art) GPU*/ -#define LV_USE_GPU_STM32_DMA2D 1 -#if LV_USE_GPU_STM32_DMA2D - /*Must be defined to include path of CMSIS header of target processor - e.g. "stm32f769xx.h" or "stm32f429xx.h"*/ - #define LV_GPU_DMA2D_CMSIS_INCLUDE -#endif - -/*Use GD32 IPA GPU - * This adds support for Image Processing Accelerator on GD32F450 and GD32F470 series MCUs - * - * NOTE: IPA on GD32F450 has a bug where the fill operation overwrites data beyond the - * framebuffer. This driver works around it by saving and restoring affected memory, but - * this makes it not thread-safe. GD32F470 is not affected. */ -#define LV_USE_GPU_GD32_IPA 1 - -/*Use NXP's PXP GPU iMX RTxxx platforms*/ -#define LV_USE_GPU_NXP_PXP 1 -#if LV_USE_GPU_NXP_PXP - /*1: Add default bare metal and FreeRTOS interrupt handling routines for PXP (lv_gpu_nxp_pxp_osa.c) - * and call lv_gpu_nxp_pxp_init() automatically during lv_init(). Note that symbol SDK_OS_FREE_RTOS - * has to be defined in order to use FreeRTOS OSA, otherwise bare-metal implementation is selected. - *0: lv_gpu_nxp_pxp_init() has to be called manually before lv_init() - */ - #define LV_USE_GPU_NXP_PXP_AUTO_INIT 0 -#endif - -/*Use NXP's VG-Lite GPU iMX RTxxx platforms*/ -#define LV_USE_GPU_NXP_VG_LITE 1 - -/*Use SWM341's DMA2D GPU*/ -#define LV_USE_GPU_SWM341_DMA2D 1 -#if LV_USE_GPU_SWM341_DMA2D - #define LV_GPU_SWM341_DMA2D_INCLUDE -#endif - -/*======================= - * FEATURE CONFIGURATION - *=======================*/ - -/*------------- - * Logging - *-----------*/ - -/*Enable the log module*/ -#define LV_USE_LOG 1 -#if LV_USE_LOG - - /*How important log should be added: - *LV_LOG_LEVEL_TRACE A lot of logs to give detailed information - *LV_LOG_LEVEL_INFO Log important events - *LV_LOG_LEVEL_WARN Log if something unwanted happened but didn't cause a problem - *LV_LOG_LEVEL_ERROR Only critical issue, when the system may fail - *LV_LOG_LEVEL_USER Only logs added by the user - *LV_LOG_LEVEL_NONE Do not log anything*/ - #define LV_LOG_LEVEL LV_LOG_LEVEL_WARN - - /*1: Print the log with 'printf'; - *0: User need to register a callback with `lv_log_register_print_cb()`*/ - #define LV_LOG_PRINTF 1 - - /*1: Enable print timestamp; - *0: Disable print timestamp*/ - #define LV_LOG_USE_TIMESTAMP 1 - - /*Enable/disable LV_LOG_TRACE in modules that produces a huge number of logs*/ - #define LV_LOG_TRACE_MEM 1 - #define LV_LOG_TRACE_TIMER 1 - #define LV_LOG_TRACE_INDEV 1 - #define LV_LOG_TRACE_DISP_REFR 1 - #define LV_LOG_TRACE_EVENT 1 - #define LV_LOG_TRACE_OBJ_CREATE 1 - #define LV_LOG_TRACE_LAYOUT 1 - #define LV_LOG_TRACE_ANIM 1 - #define LV_LOG_TRACE_MSG 1 - -#endif /*LV_USE_LOG*/ - -/*------------- - * Asserts - *-----------*/ - -/*Enable asserts if an operation is failed or an invalid data is found. - *If LV_USE_LOG is enabled an error message will be printed on failure*/ -#define LV_USE_ASSERT_NULL 1 /*Check if the parameter is NULL. (Very fast, recommended)*/ -#define LV_USE_ASSERT_MALLOC 1 /*Checks is the memory is successfully allocated or no. (Very fast, recommended)*/ -#define LV_USE_ASSERT_STYLE 0 /*Check if the styles are properly initialized. (Very fast, recommended)*/ -#define LV_USE_ASSERT_MEM_INTEGRITY 0 /*Check the integrity of `lv_mem` after critical operations. (Slow)*/ -#define LV_USE_ASSERT_OBJ 0 /*Check the object's type and existence (e.g. not deleted). (Slow)*/ - -/*Add a custom handler when assert happens e.g. to restart the MCU*/ -#define LV_ASSERT_HANDLER_INCLUDE -#define LV_ASSERT_HANDLER while(1); /*Halt by default*/ - -/*------------- - * Others - *-----------*/ - -/*1: Show CPU usage and FPS count*/ -#define LV_USE_PERF_MONITOR 1 -#if LV_USE_PERF_MONITOR - #define LV_USE_PERF_MONITOR_POS LV_ALIGN_BOTTOM_RIGHT -#endif - -/*1: Show the used memory and the memory fragmentation - * Requires `LV_USE_BUILTIN_MALLOC = 1`*/ -#define LV_USE_MEM_MONITOR 1 -#if LV_USE_MEM_MONITOR - #define LV_USE_MEM_MONITOR_POS LV_ALIGN_BOTTOM_LEFT -#endif - -/*1: Draw random colored rectangles over the redrawn areas*/ -#define LV_USE_REFR_DEBUG 1 - -/*Maximum buffer size to allocate for rotation. - *Only used if software rotation is enabled in the display driver.*/ -#define LV_DISP_ROT_MAX_BUF (10*1024) - -#define LV_USE_USER_DATA 1 - -/*Garbage Collector settings - *Used if lvgl is bound to higher level language and the memory is managed by that language*/ -#define LV_ENABLE_GC 0 -#if LV_ENABLE_GC != 0 - #define LV_GC_INCLUDE "py/mpstate.h" /*Include Garbage Collector related things*/ - #define LV_GC_ROOT(x) MP_STATE_PORT(x) -#endif /*LV_ENABLE_GC*/ - -/*Default image cache size. Image caching keeps some images opened. - *If only the built-in image formats are used there is no real advantage of caching. - *With other image decoders (e.g. PNG or JPG) caching save the continuous open/decode of images. - *However the opened images consume additional RAM. - *0: to disable caching*/ -#define LV_IMG_CACHE_DEF_SIZE 1 - -/*Number of stops allowed per gradient. Increase this to allow more stops. - *This adds (sizeof(lv_color_t) + 1) bytes per additional stop*/ -#define LV_GRADIENT_MAX_STOPS 2 - -/* Adjust color mix functions rounding. GPUs might calculate color mix (blending) differently. - * 0: round down, 64: round up from x.75, 128: round up from half, 192: round up from x.25, 254: round up */ -#define LV_COLOR_MIX_ROUND_OFS 0 - -/*===================== - * COMPILER SETTINGS - *====================*/ - -/*For big endian systems set to 1*/ -#define LV_BIG_ENDIAN_SYSTEM 0 - -/*Define a custom attribute to `lv_tick_inc` function*/ -#define LV_ATTRIBUTE_TICK_INC - -/*Define a custom attribute to `lv_timer_handler` function*/ -#define LV_ATTRIBUTE_TIMER_HANDLER - -/*Define a custom attribute to `lv_disp_flush_ready` function*/ -#define LV_ATTRIBUTE_FLUSH_READY - -/*Required alignment size for buffers*/ -#define LV_ATTRIBUTE_MEM_ALIGN_SIZE 1 - -/*Will be added where memories needs to be aligned (with -Os data might not be aligned to boundary by default). - * E.g. __attribute__((aligned(4)))*/ -#define LV_ATTRIBUTE_MEM_ALIGN - -/*Attribute to mark large constant arrays for example font's bitmaps*/ -#define LV_ATTRIBUTE_LARGE_CONST - -/*Compiler prefix for a big array declaration in RAM*/ -#define LV_ATTRIBUTE_LARGE_RAM_ARRAY - -/*Place performance critical functions into a faster memory (e.g RAM)*/ -#define LV_ATTRIBUTE_FAST_MEM - - -/*Export integer constant to binding. This macro is used with constants in the form of LV_ that - *should also appear on LVGL binding API such as Micropython.*/ -#define LV_EXPORT_CONST_INT(int_value) enum {ENUM_##int_value = int_value} - -/*Extend the default -32k..32k coordinate range to -4M..4M by using int32_t for coordinates instead of int16_t*/ -#define LV_USE_LARGE_COORD 1 - -/*================== - * FONT USAGE - *===================*/ - -/*Montserrat fonts with ASCII range and some symbols using bpp = 4 - *https://fonts.google.com/specimen/Montserrat*/ -#define LV_FONT_MONTSERRAT_8 1 -#define LV_FONT_MONTSERRAT_10 1 -#define LV_FONT_MONTSERRAT_12 1 -#define LV_FONT_MONTSERRAT_14 1 -#define LV_FONT_MONTSERRAT_16 1 -#define LV_FONT_MONTSERRAT_18 1 -#define LV_FONT_MONTSERRAT_20 1 -#define LV_FONT_MONTSERRAT_22 1 -#define LV_FONT_MONTSERRAT_24 1 -#define LV_FONT_MONTSERRAT_26 1 -#define LV_FONT_MONTSERRAT_28 1 -#define LV_FONT_MONTSERRAT_30 1 -#define LV_FONT_MONTSERRAT_32 1 -#define LV_FONT_MONTSERRAT_34 1 -#define LV_FONT_MONTSERRAT_36 1 -#define LV_FONT_MONTSERRAT_38 1 -#define LV_FONT_MONTSERRAT_40 1 -#define LV_FONT_MONTSERRAT_42 1 -#define LV_FONT_MONTSERRAT_44 1 -#define LV_FONT_MONTSERRAT_46 1 -#define LV_FONT_MONTSERRAT_48 1 - -/*Demonstrate special features*/ -#define LV_FONT_MONTSERRAT_12_SUBPX 1 -#define LV_FONT_MONTSERRAT_28_COMPRESSED 1 /*bpp = 3*/ -#define LV_FONT_DEJAVU_16_PERSIAN_HEBREW 1 /*Hebrew, Arabic, Persian letters and all their forms*/ -#define LV_FONT_SIMSUN_16_CJK 1 /*1000 most common CJK radicals*/ - -/*Pixel perfect monospace fonts*/ -#define LV_FONT_UNSCII_8 1 -#define LV_FONT_UNSCII_16 1 - -/*Optionally declare custom fonts here. - *You can use these fonts as default font too and they will be available globally. - *E.g. #define LV_FONT_CUSTOM_DECLARE LV_FONT_DECLARE(my_font_1) LV_FONT_DECLARE(my_font_2)*/ -#define LV_FONT_CUSTOM_DECLARE - -/*Always set a default font*/ -#define LV_FONT_DEFAULT &lv_font_montserrat_14 - -/*Enable handling large font and/or fonts with a lot of characters. - *The limit depends on the font size, font face and bpp. - *Compiler error will be triggered if a font needs it.*/ -#define LV_FONT_FMT_TXT_LARGE 0 - -/*Enables/disables support for compressed fonts.*/ -#define LV_USE_FONT_COMPRESSED 1 - -/*Enable drawing placeholders when glyph dsc is not found*/ -#define LV_USE_FONT_PLACEHOLDER 1 - -/*================= - * TEXT SETTINGS - *=================*/ - -/** - * Select a character encoding for strings. - * Your IDE or editor should have the same character encoding - * - LV_TXT_ENC_UTF8 - * - LV_TXT_ENC_ASCII - */ -#define LV_TXT_ENC LV_TXT_ENC_UTF8 - -/*Can break (wrap) texts on these chars*/ -#define LV_TXT_BREAK_CHARS " ,.;:-_)]}" - -/*If a word is at least this long, will break wherever "prettiest" - *To disable, set to a value <= 0*/ -#define LV_TXT_LINE_BREAK_LONG_LEN 0 - -/*Minimum number of characters in a long word to put on a line before a break. - *Depends on LV_TXT_LINE_BREAK_LONG_LEN.*/ -#define LV_TXT_LINE_BREAK_LONG_PRE_MIN_LEN 3 - -/*Minimum number of characters in a long word to put on a line after a break. - *Depends on LV_TXT_LINE_BREAK_LONG_LEN.*/ -#define LV_TXT_LINE_BREAK_LONG_POST_MIN_LEN 3 - -/*The control character to use for signalling text recoloring.*/ -#define LV_TXT_COLOR_CMD "#" - -/*Support bidirectional texts. Allows mixing Left-to-Right and Right-to-Left texts. - *The direction will be processed according to the Unicode Bidirectional Algorithm: - *https://www.w3.org/International/articles/inline-bidi-markup/uba-basics*/ -#define LV_USE_BIDI 1 -#if LV_USE_BIDI - /*Set the default direction. Supported values: - *`LV_BASE_DIR_LTR` Left-to-Right - *`LV_BASE_DIR_RTL` Right-to-Left - *`LV_BASE_DIR_AUTO` detect texts base direction*/ - #define LV_BIDI_BASE_DIR_DEF LV_BASE_DIR_AUTO -#endif - -/*Enable Arabic/Persian processing - *In these languages characters should be replaced with an other form based on their position in the text*/ -#define LV_USE_ARABIC_PERSIAN_CHARS 1 - -/*================== - * WIDGETS - *================*/ - -/*Documentation of the widgets: https://docs.lvgl.io/latest/en/html/widgets/index.html*/ - -#define LV_USE_ANIMIMG 1 - -#define LV_USE_ARC 1 - -#define LV_USE_BAR 1 - -#define LV_USE_BTN 1 - -#define LV_USE_BTNMATRIX 1 - -#define LV_USE_CALENDAR 1 -#if LV_USE_CALENDAR - #define LV_CALENDAR_WEEK_STARTS_MONDAY 0 - #if LV_CALENDAR_WEEK_STARTS_MONDAY - #define LV_CALENDAR_DEFAULT_DAY_NAMES {"Mo", "Tu", "We", "Th", "Fr", "Sa", "Su"} - #else - #define LV_CALENDAR_DEFAULT_DAY_NAMES {"Su", "Mo", "Tu", "We", "Th", "Fr", "Sa"} - #endif - - #define LV_CALENDAR_DEFAULT_MONTH_NAMES {"January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"} - #define LV_USE_CALENDAR_HEADER_ARROW 1 - #define LV_USE_CALENDAR_HEADER_DROPDOWN 1 -#endif /*LV_USE_CALENDAR*/ - -#define LV_USE_CANVAS 1 - -#define LV_USE_CHART 1 - -#define LV_USE_CHECKBOX 1 - -#define LV_USE_COLORWHEEL 1 - -#define LV_USE_DROPDOWN 1 /*Requires: lv_label*/ - -#define LV_USE_IMG 1 /*Requires: lv_label*/ - -#define LV_USE_IMGBTN 1 - -#define LV_USE_KEYBOARD 1 - -#define LV_USE_LABEL 1 -#if LV_USE_LABEL - #define LV_LABEL_TEXT_SELECTION 1 /*Enable selecting text of the label*/ - #define LV_LABEL_LONG_TXT_HINT 1 /*Store some extra info in labels to speed up drawing of very long texts*/ -#endif - -#define LV_USE_LED 1 - -#define LV_USE_LINE 1 - -#define LV_USE_LIST 1 - -#define LV_USE_MENU 1 - -#define LV_USE_METER 1 - -#define LV_USE_MSGBOX 1 - -#define LV_USE_ROLLER 1 /*Requires: lv_label*/ - -#define LV_USE_SLIDER 1 /*Requires: lv_bar*/ - -#define LV_USE_SPAN 1 -#if LV_USE_SPAN - /*A line text can contain maximum num of span descriptor */ - #define LV_SPAN_SNIPPET_STACK_SIZE 64 -#endif - -#define LV_USE_SPINBOX 1 - -#define LV_USE_SPINNER 1 - -#define LV_USE_SWITCH 1 - -#define LV_USE_TEXTAREA 1 /*Requires: lv_label*/ -#if LV_USE_TEXTAREA != 0 - #define LV_TEXTAREA_DEF_PWD_SHOW_TIME 1500 /*ms*/ -#endif - -#define LV_USE_TABLE 1 - -#define LV_USE_TABVIEW 1 - -#define LV_USE_TILEVIEW 1 - -#define LV_USE_WIN 1 - -/*================== - * THEMES - *==================*/ - -/*A simple, impressive and very complete theme*/ -#define LV_USE_THEME_DEFAULT 1 -#if LV_USE_THEME_DEFAULT - - /*0: Light mode; 1: Dark mode*/ - #define LV_THEME_DEFAULT_DARK 1 - - /*1: Enable grow on press*/ - #define LV_THEME_DEFAULT_GROW 1 - - /*Default transition time in [ms]*/ - #define LV_THEME_DEFAULT_TRANSITION_TIME 80 -#endif /*LV_USE_THEME_DEFAULT*/ - -/*A very simple theme that is a good starting point for a custom theme*/ -#define LV_USE_THEME_BASIC 1 - -/*A theme designed for monochrome displays*/ -#define LV_USE_THEME_MONO 1 - -/*================== - * LAYOUTS - *==================*/ - -/*A layout similar to Flexbox in CSS.*/ -#define LV_USE_FLEX 1 - -/*A layout similar to Grid in CSS.*/ -#define LV_USE_GRID 1 - -/*==================== - * 3RD PARTS LIBRARIES - *====================*/ - -/*File system interfaces for common APIs */ - -/*API for fopen, fread, etc*/ -#define LV_USE_FS_STDIO 1 -#if LV_USE_FS_STDIO - #define LV_FS_STDIO_LETTER '\0' /*Set an upper cased letter on which the drive will accessible (e.g. 'A')*/ - #define LV_FS_STDIO_PATH "" /*Set the working directory. File/directory paths will be appended to it.*/ - #define LV_FS_STDIO_CACHE_SIZE 0 /*>0 to cache this number of bytes in lv_fs_read()*/ -#endif - -/*API for open, read, etc*/ -#define LV_USE_FS_POSIX 1 -#if LV_USE_FS_POSIX - #define LV_FS_POSIX_LETTER '\0' /*Set an upper cased letter on which the drive will accessible (e.g. 'A')*/ - #define LV_FS_POSIX_PATH "" /*Set the working directory. File/directory paths will be appended to it.*/ - #define LV_FS_POSIX_CACHE_SIZE 0 /*>0 to cache this number of bytes in lv_fs_read()*/ -#endif - -/*API for CreateFile, ReadFile, etc*/ -#define LV_USE_FS_WIN32 1 -#if LV_USE_FS_WIN32 - #define LV_FS_WIN32_LETTER '\0' /*Set an upper cased letter on which the drive will accessible (e.g. 'A')*/ - #define LV_FS_WIN32_PATH "" /*Set the working directory. File/directory paths will be appended to it.*/ - #define LV_FS_WIN32_CACHE_SIZE 0 /*>0 to cache this number of bytes in lv_fs_read()*/ -#endif - -/*API for FATFS (needs to be added separately). Uses f_open, f_read, etc*/ -#define LV_USE_FS_FATFS 1 -#if LV_USE_FS_FATFS - #define LV_FS_FATFS_LETTER '\0' /*Set an upper cased letter on which the drive will accessible (e.g. 'A')*/ - #define LV_FS_FATFS_CACHE_SIZE 0 /*>0 to cache this number of bytes in lv_fs_read()*/ -#endif - -/*PNG decoder library*/ -#define LV_USE_PNG 1 - -/*BMP decoder library*/ -#define LV_USE_BMP 1 - -/* JPG + split JPG decoder library. - * Split JPG is a custom format optimized for embedded systems. */ -#define LV_USE_SJPG 1 - -/*GIF decoder library*/ -#define LV_USE_GIF 1 - -/*QR code library*/ -#define LV_USE_QRCODE 1 - -/*Barcode code library*/ -#define LV_USE_BARCODE 1 - -/*FreeType library*/ -#ifdef MICROPY_FREETYPE - #define LV_USE_FREETYPE 1 -#else - #define LV_USE_FREETYPE 1 -#endif - -#if LV_USE_FREETYPE - /*Memory used by FreeType to cache characters [bytes]*/ - #define LV_FREETYPE_CACHE_SIZE (64 * 1024) - - /*Let FreeType to use LVGL memory and file porting*/ - #define LV_FREETYPE_USE_LVGL_PORT 0 - - /* 1: bitmap cache use the sbit cache, 0:bitmap cache use the image cache. */ - /* sbit cache:it is much more memory efficient for small bitmaps(font size < 256) */ - /* if font size >= 256, must be configured as image cache */ - #define LV_FREETYPE_SBIT_CACHE 0 - - /* Maximum number of opened FT_Face/FT_Size objects managed by this cache instance. */ - /* (0:use system defaults) */ - #define LV_FREETYPE_CACHE_FT_FACES 4 - #define LV_FREETYPE_CACHE_FT_SIZES 4 -#endif - -/* Built-in TTF decoder */ -#ifndef LV_USE_TINY_TTF -#define LV_USE_TINY_TTF 1 -#endif - -#if LV_USE_TINY_TTF - /* Enable loading TTF data from files */ - #define LV_TINY_TTF_FILE_SUPPORT 1 -#endif - -/*Rlottie library*/ -#ifdef MICROPY_RLOTTIE - #define LV_USE_RLOTTIE 1 -#else - #define LV_USE_RLOTTIE 1 -#endif - -/*FFmpeg library for image decoding and playing videos - *Supports all major image formats so do not enable other image decoder with it*/ -#ifdef MICROPY_FFMPEG - #define LV_USE_FFMPEG 1 -#else - #define LV_USE_FFMPEG 1 -#endif - -#if LV_USE_FFMPEG - /*Dump input information to stderr*/ - #define LV_FFMPEG_DUMP_FORMAT 0 -#endif - -/*================== - * OTHERS - *==================*/ - -/*1: Enable API to take snapshot for object*/ -#define LV_USE_SNAPSHOT 1 - -/*1: Enable Monkey test*/ -#define LV_USE_MONKEY 1 - -/*1: Enable grid navigation*/ -#define LV_USE_GRIDNAV 1 - -/*1: Enable lv_obj fragment*/ -#define LV_USE_FRAGMENT 1 - -/*1: Support using images as font in label or span widgets */ -#define LV_USE_IMGFONT 1 -#if LV_USE_IMGFONT - /*Imgfont image file path maximum length*/ - #define LV_IMGFONT_PATH_MAX_LEN 64 - - /*1: Use img cache to buffer header information*/ - #define LV_IMGFONT_USE_IMG_CACHE_HEADER 0 -#endif - -/*1: Enable a published subscriber based messaging system */ -#define LV_USE_MSG 1 - -/*1: Enable Pinyin input method*/ -/*Requires: lv_keyboard*/ -#define LV_USE_IME_PINYIN 1 -#if LV_USE_IME_PINYIN - /*1: Use default thesaurus*/ - /*If you do not use the default thesaurus, be sure to use `lv_ime_pinyin` after setting the thesauruss*/ - #define LV_IME_PINYIN_USE_DEFAULT_DICT 1 - /*Set the maximum number of candidate panels that can be displayed*/ - /*This needs to be adjusted according to the size of the screen*/ - #define LV_IME_PINYIN_CAND_TEXT_NUM 6 - - /*Use 9 key input(k9)*/ - #define LV_IME_PINYIN_USE_K9_MODE 1 - #if LV_IME_PINYIN_USE_K9_MODE == 1 - #define LV_IME_PINYIN_K9_CAND_TEXT_NUM 3 - #endif // LV_IME_PINYIN_USE_K9_MODE -#endif - -/*1: Enable file explorer*/ -/*Requires: lv_table*/ -#define LV_USE_FILE_EXPLORER 1 -#if LV_USE_FILE_EXPLORER - /*Maximum length of path*/ - #define LV_FILE_EXPLORER_PATH_MAX_LEN (128) - /*Quick access bar, 1:use, 0:not use*/ - /*Requires: lv_list*/ - #define LV_FILE_EXPLORER_QUICK_ACCESS 1 -#endif - -/*================== - * DEVICES - *==================*/ - -/*Use SDL to open window on PC and handle mouse and keyboard*/ - -#ifdef MICROPY_SDL - #define LV_USE_SDL 1 -#else -#ifdef CPYTHON_SDL - #define LV_USE_SDL 1 -#else - #define LV_USE_SDL 1 -#endif -#endif - -#if LV_USE_SDL - #define LV_SDL_INCLUDE_PATH - #define LV_SDL_PARTIAL_MODE 0 /*Recommended only to emulate a setup with a display controller*/ - #define LV_SDL_FULLSCREEN 0 -#endif - -/*Driver for /dev/fb*/ - -#ifdef MICROPY_FB - #define LV_USE_LINUX_FBDEV 1 -#else - #define LV_USE_LINUX_FBDEV 1 -#endif - -#if LV_USE_LINUX_FBDEV - #define LV_LINUX_FBDEV_BSD 0 -#endif - -/*Interface for TFT_eSPI*/ -#define LV_USE_TFT_ESPI 1 - -/*================== -* EXAMPLES -*==================*/ - -/*Enable the examples to be built with the library*/ -#define LV_BUILD_EXAMPLES 1 - -/*=================== - * DEMO USAGE - ====================*/ - -/*Show some widget. It might be required to increase `LV_MEM_SIZE` */ -#define LV_USE_DEMO_WIDGETS 1 -#if LV_USE_DEMO_WIDGETS - #define LV_DEMO_WIDGETS_SLIDESHOW 0 -#endif - -/*Demonstrate the usage of encoder and keyboard*/ -#define LV_USE_DEMO_KEYPAD_AND_ENCODER 0 - -/*Benchmark your system*/ -#define LV_USE_DEMO_BENCHMARK 1 -#if LV_USE_DEMO_BENCHMARK - /*Use RGB565A8 images with 16 bit color depth instead of ARGB8565*/ - #define LV_DEMO_BENCHMARK_RGB565A8 0 -#endif - -/*Stress test for LVGL*/ -#define LV_USE_DEMO_STRESS 1 - -/*Music player demo*/ -#define LV_USE_DEMO_MUSIC 1 -#if LV_USE_DEMO_MUSIC - #define LV_DEMO_MUSIC_SQUARE 1 - #define LV_DEMO_MUSIC_LANDSCAPE 1 - #define LV_DEMO_MUSIC_ROUND 1 - #define LV_DEMO_MUSIC_LARGE 1 - #define LV_DEMO_MUSIC_AUTO_PLAY 1 -#endif - -/*Flex layout demo*/ -#define LV_USE_DEMO_FLEX_LAYOUT 1 - -/*--END OF LV_CONF_H--*/ - -#endif /*LV_CONF_H*/ - -#endif /*End of "Content enable"*/ diff --git a/scripts/changelog-template.hbs b/scripts/changelog-template.hbs index 40be87056b..6a749c4a4b 100644 --- a/scripts/changelog-template.hbs +++ b/scripts/changelog-template.hbs @@ -1,122 +1,149 @@ {{#each releases}} `{{title}} <{{href}}>`__ {{niceDate}} - --------------------------------------------------------------------------------------------------- + --------------------------------------------------------------------------------------------------------------------------------------------------- Breaking Changes ~~~~~~~~~~~~~~~~ {{#commit-list merges heading='' message='BREAKING CHANGE'}} - - .. warning: {{message}} `{{id}} <{{href}}>`__ + - .. warning: {{message}} + `{{id}} <{{href}}>`__ {{/commit-list}} {{#commit-list commits heading='' message='BREAKING CHANGE'}} - - .. warning: {{subject}} `{{shorthash}} <{{href}}>`__ + - .. warning: {{subject}} + `{{shorthash}} <{{href}}>`__ {{/commit-list}} {{#commit-list fixes heading='' message='BREAKING CHANGE'}} - - **{{commit.subject}}** `{{commit.shorthash}} <{{commit.href}}>`__ + - **{{commit.subject}}** + `{{commit.shorthash}} <{{commit.href}}>`__ {{/commit-list}} Architectural ~~~~~~~~~~~~~ {{#commit-list merges heading='' message='^arch' exclude='BREAKING CHANGE'}} - - **{{message}}** `{{id}} <{{href}}>`__ + - **{{message}}** + `{{id}} <{{href}}>`__ {{/commit-list}} {{#commit-list commits heading='' message='^arch' exclude='BREAKING CHANGE'}} - - **{{subject}}** `{{shorthash}} <{{href}}>`__ + - **{{subject}}** + `{{shorthash}} <{{href}}>`__ {{/commit-list}} {{#commit-list fixes heading='' message='^arch' exclude='BREAKING CHANGE'}} - - **{{commit.subject}}** `{{commit.shorthash}} <{{commit.href}}>`__ + - **{{commit.subject}}** + `{{commit.shorthash}} <{{commit.href}}>`__ {{/commit-list}} New Features ~~~~~~~~~~~~ {{#commit-list merges heading='' message='^feat' exclude='BREAKING CHANGE'}} - - **{{message}}** `{{id}} <{{href}}>`__ + - **{{message}}** + `{{id}} <{{href}}>`__ {{/commit-list}} {{#commit-list commits heading='' message='^feat' exclude='BREAKING CHANGE'}} - - **{{subject}}** `{{shorthash}} <{{href}}>`__ + - **{{subject}}** + `{{shorthash}} <{{href}}>`__ {{/commit-list}} {{#commit-list fixes heading='' message='^feat' exclude='BREAKING CHANGE'}} - - **{{commit.subject}}** `{{commit.shorthash}} <{{commit.href}}>`__ + - **{{commit.subject}}** + `{{commit.shorthash}} <{{commit.href}}>`__ {{/commit-list}} Performance ~~~~~~~~~~~ {{#commit-list merges heading='' message='^perf' exclude='BREAKING CHANGE'}} - - **{{message}}** `{{id}} <{{href}}>`__ + - **{{message}}** + `{{id}} <{{href}}>`__ {{/commit-list}} {{#commit-list commits heading='' message='^perf' exclude='BREAKING CHANGE'}} - - **{{subject}}** `{{shorthash}} <{{href}}>`__ + - **{{subject}}** + `{{shorthash}} <{{href}}>`__ {{/commit-list}} {{#commit-list fixes heading='' message='^perf' exclude='BREAKING CHANGE'}} - - **{{commit.subject}}** `{{commit.shorthash}} <{{commit.href}}>`__ + - **{{commit.subject}}** + `{{commit.shorthash}} <{{commit.href}}>`__ {{/commit-list}} Fixes ~~~~~ {{#commit-list merges heading='' message='^fix' exclude='(^fix conflict|^fix warning|BREAKING CHANGE)'}} - - **{{message}}** `{{id}} <{{href}}>`__ + - **{{message}}** + `{{id}} <{{href}}>`__ {{/commit-list}} {{#commit-list commits heading='' message='^fix' exclude='(^fix conflict|^fix warning|BREAKING CHANGE)'}} - - **{{subject}}** `{{shorthash}} <{{href}}>`__ + - **{{subject}}** + `{{shorthash}} <{{href}}>`__ {{/commit-list}} {{#commit-list fixes heading='' message='^fix' exclude='(^fix conflict|^fix warning|BREAKING CHANGE)'}} - - **{{commit.subject}}** `{{commit.shorthash}} <{{commit.href}}>`__ + - **{{commit.subject}}** + `{{commit.shorthash}} <{{commit.href}}>`__ {{/commit-list}} Examples ~~~~~~~~ {{#commit-list merges heading='' message='^example'}} - - **{{message}}** `{{id}} <({{href}})>`__ + - **{{message}}** + `{{id}} <({{href}})>`__ {{/commit-list}} {{#commit-list commits heading='' message='^example'}} - - **{{subject}}** `{{shorthash}} <{{href}}>`__ + - **{{subject}}** + `{{shorthash}} <{{href}}>`__ {{/commit-list}} {{#commit-list fixes heading='' message='^example'}} - - **{{commit.subject}}** `{{commit.shorthash}} <{{commit.href}}>`__ + - **{{commit.subject}}** + `{{commit.shorthash}} <{{commit.href}}>`__ {{/commit-list}} Docs ~~~~ {{#commit-list merges heading='' message='^docs'}} - - **{{message}}** `{{id}} <{{href}}>`__ + - **{{message}}** + `{{id}} <{{href}}>`__ {{/commit-list}} {{#commit-list commits heading='' message='^docs'}} - - **{{subject}}** `{{shorthash}} <{{href}}>`__ + - **{{subject}}** + `{{shorthash}} <{{href}}>`__ {{/commit-list}} {{#commit-list fixes heading='' message='^docs'}} - - **{{commit.subject}}** `{{commit.shorthash}} <{{commit.href}}>`__ + - **{{commit.subject}}** + `{{commit.shorthash}} <{{commit.href}}>`__ {{/commit-list}} CI and tests ~~~~~~~~~~~~ {{#commit-list merges heading='' message='(^ci|^test)'}} - - **{{message}}** `{{id}} <{{href}}>`__ + - **{{message}}** + `{{id}} <{{href}}>`__ {{/commit-list}} {{#commit-list commits heading='' message='(^ci|^test)'}} - - **{{subject}}** `{{shorthash }} <{{href}}>`__ + - **{{subject}}** + `{{shorthash }} <{{href}}>`__ {{/commit-list}} {{#commit-list fixes heading='' message='(^ci|^test)'}} - - **{{commit.subject}}** `{{commit.shorthash}} <{{commit.href}}>`__ + - **{{commit.subject}}** + `{{commit.shorthash}} <{{commit.href}}>`__ {{/commit-list}} Others ~~~~~~ {{#commit-list merges heading='' exclude='(^fix|^feat|^perf|^docs|^example|^ci|^test)'}} - - **{{message}}** `{{id }} <{{href}}>`__ + - **{{message}}** + `{{id }} <{{href}}>`__ {{/commit-list}} {{#commit-list commits heading='' exclude='(^fix|^feat|^perf|^docs|^example|^ci|^test)'}} - - **{{subject}}** `{{shorthash }} <{{href}}>`__ + - **{{subject}}** + `{{shorthash }} <{{href}}>`__ {{/commit-list}} {{#commit-list fixes heading='' exclude='(^fix|^feat|^perf|^docs|^example|^ci|^test)'}} - - **{{commit.subject}}** `{{commit.shorthash}} <{{commit.href}}>`__ + - **{{commit.subject}}** + `{{commit.shorthash}} <{{commit.href}}>`__ {{/commit-list}} {{/each}}