mirror of
https://github.com/lvgl/lvgl.git
synced 2026-08-17 09:42:19 +08:00
2525 lines
70 KiB
C
2525 lines
70 KiB
C
/**
|
|
* @file lv_conf.h
|
|
* Configuration file for v9.6.0
|
|
*/
|
|
|
|
/*
|
|
* Copy this file as `lv_conf.h`
|
|
* 1. simply next to `lvgl` folder
|
|
* 2. or to any other place and
|
|
* - define `LV_CONF_INCLUDE_SIMPLE`;
|
|
* - add the path as an include path.
|
|
*/
|
|
|
|
/* clang-format off */
|
|
#if 0 /* Set this to "1" to enable content */
|
|
|
|
#ifndef LV_CONF_H
|
|
#define LV_CONF_H
|
|
|
|
/* If you need to include anything here, do it inside the `__ASSEMBLY__` guard */
|
|
#if 0 && defined(__ASSEMBLY__)
|
|
#include "my_include.h"
|
|
#endif
|
|
|
|
/*============================================================================
|
|
* MEMORY AND STANDARD LIBRARY
|
|
*============================================================================*/
|
|
|
|
/** Malloc functions source
|
|
* Possible values:
|
|
* - LV_STDLIB_BUILTIN: LVGL built-in
|
|
* - LV_STDLIB_CLIB: C standard library (malloc/realloc/free)
|
|
* - LV_STDLIB_MICROPYTHON
|
|
* - LV_STDLIB_RTTHREAD
|
|
* - LV_STDLIB_CUSTOM: Custom (implemented externally)
|
|
*/
|
|
#define LV_USE_STDLIB_MALLOC LV_STDLIB_BUILTIN
|
|
|
|
/** String functions source
|
|
* Possible values:
|
|
* - LV_STDLIB_BUILTIN: LVGL built-in
|
|
* - LV_STDLIB_CLIB: C standard library (memcpy/memset/strlen/strcpy)
|
|
* - LV_STDLIB_RTTHREAD: RT-Thread (rt_memcpy/rt_memset/rt_strlen/rt_strcpy)
|
|
* - LV_STDLIB_CUSTOM: Custom (implemented externally)
|
|
*/
|
|
#define LV_USE_STDLIB_STRING LV_STDLIB_BUILTIN
|
|
|
|
/** Sprintf functions source
|
|
* Possible values:
|
|
* - LV_STDLIB_BUILTIN: LVGL built-in
|
|
* - LV_STDLIB_CLIB: C standard library (vsnprintf)
|
|
* - LV_STDLIB_RTTHREAD: RT-Thread (rt_vsnprintf)
|
|
* - LV_STDLIB_CUSTOM: Custom (implemented externally)
|
|
*/
|
|
#define LV_USE_STDLIB_SPRINTF LV_STDLIB_BUILTIN
|
|
|
|
#if LV_USE_STDLIB_MALLOC == LV_STDLIB_BUILTIN
|
|
/** Size of the pool `lv_malloc()` allocates from. Needs to be at least 2kB (2048). */
|
|
#define LV_MEM_SIZE 65536
|
|
|
|
/** Place the pool at a fixed address instead of allocating it as a normal array.
|
|
* 0: unused.
|
|
*/
|
|
#define LV_MEM_ADR 0x0
|
|
|
|
#endif /*LV_USE_STDLIB_MALLOC == LV_STDLIB_BUILTIN*/
|
|
|
|
/** Header for integer types (stdint) */
|
|
#define LV_STDINT_INCLUDE "stdint.h"
|
|
|
|
/** Header for standard definitions (stddef) */
|
|
#define LV_STDDEF_INCLUDE "stddef.h"
|
|
|
|
/** Header for boolean types (stdbool) */
|
|
#define LV_STDBOOL_INCLUDE "stdbool.h"
|
|
|
|
/** Header for fixed-width integer format macros (inttypes) */
|
|
#define LV_INTTYPES_INCLUDE "inttypes.h"
|
|
|
|
/** Header for implementation limits (limits) */
|
|
#define LV_LIMITS_INCLUDE "limits.h"
|
|
|
|
/** Header for variadic argument handling (stdarg) */
|
|
#define LV_STDARG_INCLUDE "stdarg.h"
|
|
|
|
|
|
|
|
/*============================================================================
|
|
* OPERATING SYSTEM (OS)
|
|
*============================================================================*/
|
|
|
|
/** Operating system
|
|
* Possible values:
|
|
* - LV_OS_NONE
|
|
* - LV_OS_PTHREAD: POSIX threads (pthread)
|
|
* - LV_OS_FREERTOS
|
|
* - LV_OS_CMSIS_RTOS2
|
|
* - LV_OS_RTTHREAD
|
|
* - LV_OS_WINDOWS
|
|
* - LV_OS_MQX
|
|
* - LV_OS_SDL2
|
|
* - LV_OS_CUSTOM
|
|
*/
|
|
#define LV_USE_OS LV_OS_NONE
|
|
|
|
#if LV_USE_OS == LV_OS_CUSTOM
|
|
/** Custom OS include header */
|
|
#define LV_OS_CUSTOM_INCLUDE ""
|
|
|
|
#endif /*LV_USE_OS == LV_OS_CUSTOM*/
|
|
|
|
#if LV_USE_OS == LV_OS_FREERTOS
|
|
/** Synchronize with direct task notifications instead of an intermediary object such as a
|
|
* binary semaphore: 45% faster and less RAM, but only usable when a single task can be
|
|
* the recipient of the event.
|
|
*/
|
|
#define LV_USE_FREERTOS_TASK_NOTIFY 1
|
|
|
|
/** Provide your own lv_os_get_idle_percent(). Useful on multi-core systems, where the
|
|
* default FreeRTOS implementation may not track idle time across all cores.
|
|
*/
|
|
#define LV_OS_IDLE_PERCENT_CUSTOM 0
|
|
|
|
#endif /*LV_USE_OS == LV_OS_FREERTOS*/
|
|
|
|
|
|
/*============================================================================
|
|
* RENDERING CONFIGURATION
|
|
*============================================================================*/
|
|
|
|
/** Color depth: 1 (I1), 8 (L8), 16 (RGB565), 24 (RGB888), 32 (XRGB8888) */
|
|
#define LV_COLOR_DEPTH 16
|
|
|
|
/** 0: no adjustment, get the integer part of the result (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
|
|
|
|
/** Default display refresh, input device read and animation step period. */
|
|
#define LV_DEF_REFR_PERIOD 33
|
|
|
|
/** Used to initialize default sizes such as widget sizes and style paddings. */
|
|
#define LV_DPI_DEF 130
|
|
|
|
/** Align the stride of all layers and images to this many bytes. */
|
|
#define LV_DRAW_BUF_STRIDE_ALIGN 1
|
|
|
|
/** Align the start address of draw_buf addresses to this many bytes. */
|
|
#define LV_DRAW_BUF_ALIGN 4
|
|
|
|
/** 3x3 matrix API (lv_matrix_t) for transformations. Requires floating point support.
|
|
*
|
|
* Enable: LV_USE_FLOAT
|
|
*/
|
|
#define LV_USE_MATRIX 0
|
|
|
|
#if LV_USE_MATRIX
|
|
/** The rendering engine must support 3x3 matrix transformations. */
|
|
#define LV_DRAW_TRANSFORM_USE_MATRIX 0
|
|
|
|
#endif /*LV_USE_MATRIX*/
|
|
|
|
/** Widgets with `style_opa < 255` (not `bg_opa`, `text_opa` etc) or a non-NORMAL blend mode are
|
|
* buffered into a "simple" layer in chunks of this size.
|
|
* "Transformed layers" (if `transform_angle/zoom` are set) use larger buffers and can't be chunked.
|
|
*/
|
|
#define LV_DRAW_LAYER_SIMPLE_BUF_SIZE 24576
|
|
|
|
/** Limit for simple and transformed layers together; 0 means no limit.
|
|
* Must be at least `LV_DRAW_LAYER_SIMPLE_BUF_SIZE`, and with transformed layers large enough
|
|
* for the largest widget too (width x height x 4).
|
|
*/
|
|
#define LV_DRAW_LAYER_MAX_MEMORY 0
|
|
|
|
#if LV_USE_OS != LV_OS_NONE
|
|
/** If FreeType or ThorVG is enabled, it is recommended to set it to 32KB or more. */
|
|
#define LV_DRAW_THREAD_STACK_SIZE 8192
|
|
|
|
/** Thread priority controls the relative importance of the drawing threads.
|
|
* Values correspond to lv_thread_prio_t enum in lv_os.h:
|
|
* 0: LV_THREAD_PRIO_LOWEST
|
|
* 1: LV_THREAD_PRIO_LOW
|
|
* 2: LV_THREAD_PRIO_MID (default)
|
|
* 3: LV_THREAD_PRIO_HIGH
|
|
* 4: LV_THREAD_PRIO_HIGHEST
|
|
*
|
|
* Higher priority can improve rendering performance but might cause
|
|
* starvation of lower priority tasks.
|
|
*/
|
|
#define LV_DRAW_THREAD_PRIO 3
|
|
|
|
#endif /*LV_USE_OS != LV_OS_NONE*/
|
|
|
|
/** Vector drawing API (lv_vector_dsc_*) for paths, strokes and fills.
|
|
* Needs a renderer with vector support, e.g. the SW renderer with ThorVG, or VG-Lite.
|
|
*
|
|
* Enable: LV_USE_MATRIX
|
|
*/
|
|
#define LV_USE_VECTOR_GRAPHIC 0
|
|
|
|
/** Render a widget and its children into an image buffer with lv_snapshot_take(). */
|
|
#define LV_USE_SNAPSHOT 0
|
|
|
|
/** Backend that gives the SW renderer vector graphics support. */
|
|
#define LV_USE_THORVG 0
|
|
|
|
#if LV_USE_THORVG
|
|
/** Build the ThorVG copy shipped with LVGL instead of linking an external one. */
|
|
#define LV_USE_THORVG_INTERNAL 1
|
|
|
|
#endif /*LV_USE_THORVG*/
|
|
|
|
/** Required to draw anything on the screen. */
|
|
#define LV_USE_DRAW_SW 1
|
|
|
|
#if LV_USE_DRAW_SW
|
|
/** RGB565 */
|
|
#define LV_DRAW_SW_SUPPORT_RGB565 1
|
|
|
|
/** RGB565 swapped */
|
|
#define LV_DRAW_SW_SUPPORT_RGB565_SWAPPED 1
|
|
|
|
/** RGB565A8 */
|
|
#define LV_DRAW_SW_SUPPORT_RGB565A8 1
|
|
|
|
/** RGB888 */
|
|
#define LV_DRAW_SW_SUPPORT_RGB888 1
|
|
|
|
/** XRGB8888 */
|
|
#define LV_DRAW_SW_SUPPORT_XRGB8888 1
|
|
|
|
/** ARGB8888 */
|
|
#define LV_DRAW_SW_SUPPORT_ARGB8888 1
|
|
|
|
/** ARGB8888 premultiplied */
|
|
#define LV_DRAW_SW_SUPPORT_ARGB8888_PREMULTIPLIED 1
|
|
|
|
/** L8 */
|
|
#define LV_DRAW_SW_SUPPORT_L8 1
|
|
|
|
/** AL88 */
|
|
#define LV_DRAW_SW_SUPPORT_AL88 1
|
|
|
|
/** A8 */
|
|
#define LV_DRAW_SW_SUPPORT_A8 1
|
|
|
|
/** I1 */
|
|
#define LV_DRAW_SW_SUPPORT_I1 1
|
|
|
|
#if LV_DRAW_SW_SUPPORT_I1
|
|
/** Pixels brighter than this luminance become active (set) when rendering to I1. */
|
|
#define LV_DRAW_SW_I1_LUM_THRESHOLD 127
|
|
|
|
#endif /*LV_DRAW_SW_SUPPORT_I1*/
|
|
|
|
#if LV_USE_OS != LV_OS_NONE
|
|
/** Number of threads used to render a frame in parallel */
|
|
#define LV_DRAW_SW_DRAW_UNIT_CNT 1
|
|
|
|
#endif /*LV_USE_OS != LV_OS_NONE*/
|
|
|
|
/** Requires the Arm-2D library in your project and an include path for "arm_2d.h". */
|
|
#define LV_USE_DRAW_ARM2D_SYNC 0
|
|
|
|
/** Disable to let Arm-2D work on its own (for testing only). */
|
|
#define LV_USE_NATIVE_HELIUM_ASM 0
|
|
|
|
/** Adds rounded corners, shadows, skewed lines and arcs.
|
|
* Without it only rectangles with gradients, images, texts and straight lines can be drawn.
|
|
*/
|
|
#define LV_DRAW_SW_COMPLEX 1
|
|
|
|
/** Each additional stop costs (sizeof(lv_color_t) + 1) bytes. */
|
|
#define LV_GRADIENT_MAX_STOPS 2
|
|
|
|
/** Adds linear gradients at an angle, plus radial and conical gradients. */
|
|
#define LV_USE_DRAW_SW_COMPLEX_GRADIENTS 0
|
|
|
|
#if LV_DRAW_SW_COMPLEX
|
|
/** Maximum shadow size to buffer, where shadow size is `shadow_width + radius`.
|
|
* Costs this value squared in RAM; 0 disables caching.
|
|
*/
|
|
#define LV_DRAW_SW_SHADOW_CACHE_SIZE 0
|
|
|
|
/** The circumference of a 1/4 circle is cached for anti-aliasing, costing
|
|
* radius * 4 bytes per circle. Set to 0 to disable caching.
|
|
*/
|
|
#define LV_DRAW_SW_CIRCLE_CACHE_SIZE 4
|
|
|
|
#endif /*LV_DRAW_SW_COMPLEX*/
|
|
|
|
/** SW assembly optimization
|
|
* Possible values:
|
|
* - LV_DRAW_SW_ASM_NONE
|
|
* - LV_DRAW_SW_ASM_NEON
|
|
* - LV_DRAW_SW_ASM_HELIUM
|
|
* - LV_DRAW_SW_ASM_RISCV_V: RISC-V Vector
|
|
* - LV_DRAW_SW_ASM_CUSTOM
|
|
*/
|
|
#define LV_USE_DRAW_SW_ASM LV_DRAW_SW_ASM_NONE
|
|
|
|
#if LV_USE_DRAW_SW_ASM == LV_DRAW_SW_ASM_CUSTOM
|
|
/** Custom assembly include file */
|
|
#define LV_DRAW_SW_ASM_CUSTOM_INCLUDE ""
|
|
|
|
#endif /*LV_USE_DRAW_SW_ASM == LV_DRAW_SW_ASM_CUSTOM*/
|
|
#endif /*LV_USE_DRAW_SW*/
|
|
|
|
/** Renders with a VG-Lite GPU. Requires a VG-Lite driver, or the VG-Lite simulator below.
|
|
*
|
|
* Enable: LV_USE_MATRIX
|
|
*/
|
|
#define LV_USE_DRAW_VG_LITE 0
|
|
|
|
#if LV_USE_DRAW_VG_LITE
|
|
/** Call an application-provided gpu_init() before the first use of the GPU. */
|
|
#define LV_VG_LITE_USE_GPU_INIT 0
|
|
|
|
/** Check internal VG-Lite state with LV_ASSERT(). Useful while debugging. */
|
|
#define LV_VG_LITE_USE_ASSERT 0
|
|
|
|
/** The GPU tries to batch this many draw tasks before flushing. */
|
|
#define LV_VG_LITE_FLUSH_MAX_COUNT 8
|
|
|
|
/** Usually faster, but does not match the rendering quality of the SW renderer. */
|
|
#define LV_VG_LITE_USE_BOX_SHADOW 1
|
|
|
|
/** The memory usage of a single gradient:
|
|
* linear: 4K bytes.
|
|
* radial: radius * 4K bytes.
|
|
*/
|
|
#define LV_VG_LITE_GRAD_CACHE_CNT 32
|
|
|
|
/** Stroke cache size (entries) */
|
|
#define LV_VG_LITE_STROKE_CACHE_CNT 32
|
|
|
|
/** Unaligned bitmap font cache size (entries) */
|
|
#define LV_VG_LITE_BITMAP_FONT_CACHE_CNT 256
|
|
|
|
/** Remove VLC_OP_CLOSE path instruction (Workaround for NXP) */
|
|
#define LV_VG_LITE_DISABLE_VLC_OP_CLOSE 0
|
|
|
|
/** Needed with older VG-Lite drivers that do not implement the extension. */
|
|
#define LV_VG_LITE_DISABLE_LINEAR_GRADIENT_EXT 0
|
|
|
|
/** Works around HW errors on some GPUs at the cost of extra blits. */
|
|
#define LV_VG_LITE_DISABLE_BLIT_RECT_OFFSET 0
|
|
|
|
/** Maximum path dump length (points) */
|
|
#define LV_VG_LITE_PATH_DUMP_MAX_LEN 1000
|
|
|
|
/** Build the VG-Lite driver bundled with LVGL instead of linking a vendor-provided one. */
|
|
#define LV_USE_VG_LITE_DRIVER 0
|
|
|
|
#if LV_USE_VG_LITE_DRIVER
|
|
/** VG-Lite GPU (series and revision)
|
|
* Possible values:
|
|
* - LV_VG_LITE_GPU_GC255_0X40A: GC255 (revision 0x40A)
|
|
* - LV_VG_LITE_GPU_GC355_0X0_1215: GC355 (revision 0x0_1215)
|
|
* - LV_VG_LITE_GPU_GC355_0X0_1216: GC355 (revision 0x0_1216)
|
|
* - LV_VG_LITE_GPU_GC555_0X423: GC555 (revision 0x423)
|
|
* - LV_VG_LITE_GPU_GC555_0X423_ECO: GC555 (revision 0x423 ECO)
|
|
* - LV_VG_LITE_GPU_GCNANOULTRAV_0X1003: GCNanoUltraV (revision 0x1003)
|
|
*/
|
|
#define LV_VG_LITE_GPU LV_VG_LITE_GPU_GC255_0X40A
|
|
|
|
/** GPU base address */
|
|
#define LV_VG_LITE_HAL_GPU_BASE_ADDRESS 0x40240000
|
|
|
|
#endif /*LV_USE_VG_LITE_DRIVER*/
|
|
|
|
/** Simulate VG-Lite hardware with ThorVG for debugging and testing on a PC simulator.
|
|
* Requires the internal or an external ThorVG library.
|
|
*
|
|
* Enable: LV_USE_THORVG
|
|
*/
|
|
#define LV_USE_VG_LITE_THORVG 0
|
|
|
|
#if LV_USE_VG_LITE_THORVG
|
|
/** LVGL blend modes */
|
|
#define LV_VG_LITE_THORVG_LVGL_BLEND_SUPPORT 0
|
|
|
|
/** YUV color formats */
|
|
#define LV_VG_LITE_THORVG_YUV_SUPPORT 0
|
|
|
|
/** Linear gradient extension */
|
|
#define LV_VG_LITE_THORVG_LINEAR_GRADIENT_EXT_SUPPORT 0
|
|
|
|
/** 16 pixel alignment */
|
|
#define LV_VG_LITE_THORVG_16PIXELS_ALIGN 1
|
|
|
|
/** Buffer address alignment (bytes) */
|
|
#define LV_VG_LITE_THORVG_BUF_ADDR_ALIGN 64
|
|
|
|
/** Multi-threaded rendering */
|
|
#define LV_VG_LITE_THORVG_THREAD_RENDER 0
|
|
|
|
#endif /*LV_USE_VG_LITE_THORVG*/
|
|
#endif /*LV_USE_DRAW_VG_LITE*/
|
|
|
|
/** Accelerate drawing with the Dave2D GPU found on Renesas RA platforms. */
|
|
#define LV_USE_DRAW_DAVE2D 0
|
|
|
|
/** Accelerate drawing with the Think Silicon (TSi) NemaGFX GPU library. */
|
|
#define LV_USE_NEMA_GFX 0
|
|
|
|
#if LV_USE_NEMA_GFX
|
|
/** Clean and invalidate the CPU cache around draw buffers so the GPU sees
|
|
* coherent data. Needed on cores with a data cache.
|
|
*/
|
|
#define LV_NEMA_USE_CACHE 0
|
|
|
|
#if LV_NEMA_USE_CACHE
|
|
/** Cache HAL header */
|
|
#define LV_NEMA_CACHE_HAL_INCLUDE "stm32u5xx_hal.h"
|
|
|
|
#endif /*LV_NEMA_USE_CACHE*/
|
|
|
|
/** Bundled NemaGFX library and headers to use, per target CPU core.
|
|
* None warns at build time and falls back to Cortex-M33 (Rev C).
|
|
* Possible values:
|
|
* - LV_NEMA_LIB_NONE
|
|
* - LV_NEMA_LIB_M33_REVC: Cortex-M33 (Rev C)
|
|
* - LV_NEMA_LIB_M33_NEMAPVG: Cortex-M33 (NemaPVG)
|
|
* - LV_NEMA_LIB_M55: Cortex-M55
|
|
* - LV_NEMA_LIB_M7: Cortex-M7
|
|
*/
|
|
#define LV_USE_NEMA_LIB LV_NEMA_LIB_NONE
|
|
|
|
/** STM32 uses the HAL bundled with LVGL. Custom means the application
|
|
* provides the NemaGFX HAL (nema_hal.c) itself.
|
|
* Possible values:
|
|
* - LV_NEMA_HAL_CUSTOM
|
|
* - LV_NEMA_HAL_STM32
|
|
*/
|
|
#define LV_USE_NEMA_HAL LV_NEMA_HAL_CUSTOM
|
|
|
|
#if LV_USE_NEMA_HAL == LV_NEMA_HAL_STM32
|
|
/** STM32 HAL header */
|
|
#define LV_NEMA_STM32_HAL_INCLUDE "stm32u5xx_hal.h"
|
|
|
|
/** Include the header given by LV_NEMA_CUSTOM_INCLUDE to override
|
|
* NemaGFX/STM32 HAL-specific macros such as
|
|
* LV_NEMA_STM32_HAL_ATTRIBUTE_POOL_MEM.
|
|
*/
|
|
#define LV_NEMA_USE_CUSTOM_INCLUDE 0
|
|
|
|
#endif /*LV_USE_NEMA_HAL == LV_NEMA_HAL_STM32*/
|
|
|
|
#if LV_NEMA_USE_CUSTOM_INCLUDE
|
|
/** Optional header to override NemaGFX/STM32 HAL-specific macros.
|
|
*
|
|
* LV_NEMA_STM32_HAL_ATTRIBUTE_POOL_MEM
|
|
* Attribute applied to the NemaGFX memory pool on STM32 targets.
|
|
* Used to place the pool in a specific RAM region accessible by
|
|
* the NemaGFX DMA.
|
|
* e.g. __attribute__((section(".nema_pool")))
|
|
*/
|
|
#define LV_NEMA_CUSTOM_INCLUDE ""
|
|
|
|
#endif /*LV_NEMA_USE_CUSTOM_INCLUDE*/
|
|
|
|
/** Draw vector graphics (lv_vector_dsc) with NemaVG on top of NemaGFX. */
|
|
#define LV_USE_NEMA_VG 0
|
|
|
|
/** Canvas width NemaVG is initialized for. With the vertical resolution it also
|
|
* sizes the NemaGFX memory pool on STM32 (RESX * RESY + 10KB).
|
|
*/
|
|
#define LV_NEMA_GFX_MAX_RESX 800
|
|
|
|
/** Canvas height NemaVG is initialized for. */
|
|
#define LV_NEMA_GFX_MAX_RESY 600
|
|
|
|
#endif /*LV_USE_NEMA_GFX*/
|
|
|
|
/** Accelerate blends, fills and transforms with the PXP (Pixel Pipeline)
|
|
* engine of NXP i.MX RT SoCs.
|
|
*/
|
|
#define LV_USE_DRAW_PXP 0
|
|
|
|
#if LV_USE_DRAW_PXP
|
|
/** Rotate the rendered display buffer with the PXP instead of the CPU. */
|
|
#define LV_USE_ROTATE_PXP 0
|
|
|
|
#if LV_USE_OS != LV_OS_NONE
|
|
/** Dispatch PXP operations from their own thread so the CPU can keep
|
|
* rendering in parallel. Needs an OS.
|
|
*/
|
|
#define LV_USE_PXP_DRAW_THREAD 1
|
|
|
|
#endif /*LV_USE_OS != LV_OS_NONE*/
|
|
|
|
/** Check the status of every PXP call and assert on failure. Useful while
|
|
* bringing up a board.
|
|
*/
|
|
#define LV_USE_PXP_ASSERT 0
|
|
|
|
#endif /*LV_USE_DRAW_PXP*/
|
|
|
|
/** Accelerate blends, fills and transforms with the PPA (Pixel Processing
|
|
* Accelerator) peripheral of Espressif SoCs.
|
|
*/
|
|
#define LV_USE_PPA 0
|
|
|
|
#if LV_USE_PPA
|
|
/** Let the PPA also draw images. Only simple cases qualify: unscaled,
|
|
* unrotated, fully opaque and without masks.
|
|
*/
|
|
#define LV_USE_PPA_IMG 0
|
|
|
|
#define LV_PPA_BURST_LENGTH 128
|
|
|
|
#endif /*LV_USE_PPA*/
|
|
|
|
/** Accelerate blends, fills and image decoding with the STM32 DMA2D peripheral. */
|
|
#define LV_USE_DRAW_DMA2D 0
|
|
|
|
#if LV_USE_DRAW_DMA2D
|
|
/** Header that declares the DMA2D HAL API of the target STM32 family. */
|
|
#define LV_DRAW_DMA2D_HAL_INCLUDE "stm32h7xx_hal.h"
|
|
|
|
/** Run DMA2D transfers asynchronously instead of waiting for them (needs an OS).
|
|
* Call lv_draw_dma2d_transfer_complete_interrupt_handler() from the DMA2D global ISR.
|
|
*/
|
|
#define LV_USE_DRAW_DMA2D_INTERRUPT 0
|
|
|
|
#endif /*LV_USE_DRAW_DMA2D*/
|
|
|
|
/** Offload drawing to an external EVE (FT81X/BT81X) graphics controller over SPI. */
|
|
#define LV_USE_DRAW_EVE 0
|
|
|
|
#if LV_USE_DRAW_EVE
|
|
/** Generation of the connected controller: 2 = FT81x, 3 = BT815/BT816,
|
|
* 4 = BT817/BT818. Higher generations expose more commands and registers.
|
|
*/
|
|
#define LV_DRAW_EVE_EVE_GENERATION 4
|
|
|
|
/** Bytes buffered before each SPI transmission. 0 disables buffering;
|
|
* values below 4 are treated as 0.
|
|
*/
|
|
#define LV_DRAW_EVE_WRITE_BUFFER_SIZE 2048
|
|
|
|
#endif /*LV_USE_DRAW_EVE*/
|
|
|
|
/** Accelerate blends, fills and image blits with the NXP G2D API (i.MX 2D GPU).
|
|
* Requires the g2d library and its headers.
|
|
*/
|
|
#define LV_USE_DRAW_G2D 0
|
|
|
|
#if LV_USE_DRAW_G2D
|
|
/** Maximum number of buffers mapped for the G2D draw unit, including frame
|
|
* buffers and assets. Drawing asserts once the table is full.
|
|
*/
|
|
#define LV_G2D_HASH_TABLE_SIZE 50
|
|
|
|
#if LV_USE_OS != LV_OS_NONE
|
|
/** Dispatch G2D operations from their own thread so the CPU can keep
|
|
* rendering in parallel. Needs an OS.
|
|
*/
|
|
#define LV_USE_G2D_DRAW_THREAD 1
|
|
|
|
#endif /*LV_USE_OS != LV_OS_NONE*/
|
|
|
|
/** Check the status of every G2D call and assert on failure. Useful while
|
|
* bringing up a board.
|
|
*/
|
|
#define LV_USE_G2D_ASSERT 0
|
|
|
|
#endif /*LV_USE_DRAW_G2D*/
|
|
|
|
/** Draw with the NanoVG vector library on top of OpenGL / OpenGL ES shaders.
|
|
*
|
|
* Enable: LV_USE_NANOVG, LV_USE_OPENGLES, LV_USE_MATRIX
|
|
*/
|
|
#define LV_USE_DRAW_NANOVG 0
|
|
|
|
#if LV_USE_DRAW_NANOVG
|
|
/** NanoVG shader flavor to compile. Must match the OpenGL context the
|
|
* display driver creates.
|
|
* Possible values:
|
|
* - LV_NANOVG_BACKEND_GL2: OpenGL 2.0
|
|
* - LV_NANOVG_BACKEND_GL3: OpenGL 3.0+
|
|
* - LV_NANOVG_BACKEND_GLES2: OpenGL ES 2.0
|
|
* - LV_NANOVG_BACKEND_GLES3: OpenGL ES 3.0+
|
|
*/
|
|
#define LV_NANOVG_BACKEND LV_NANOVG_BACKEND_GLES2
|
|
|
|
/** Number of decoded images kept as GPU textures. */
|
|
#define LV_NANOVG_IMAGE_CACHE_CNT 128
|
|
|
|
/** Number of rendered glyphs kept for text drawing. */
|
|
#define LV_NANOVG_LETTER_CACHE_CNT 512
|
|
|
|
#endif /*LV_USE_DRAW_NANOVG*/
|
|
|
|
/** Draw with OpenGL ES, keeping rendered widgets and images as GPU textures.
|
|
*
|
|
* Enable: LV_USE_OPENGLES
|
|
*/
|
|
#define LV_USE_DRAW_OPENGLES 0
|
|
|
|
#if LV_USE_DRAW_OPENGLES
|
|
/** Number of textures kept in the cache. More entries mean fewer redraws
|
|
* but more GPU memory.
|
|
*/
|
|
#define LV_DRAW_OPENGLES_TEXTURE_CACHE_COUNT 64
|
|
|
|
#endif /*LV_USE_DRAW_OPENGLES*/
|
|
|
|
/** Render with the SDL renderer API, caching widgets and images as SDL textures. */
|
|
#define LV_USE_DRAW_SDL 0
|
|
|
|
|
|
|
|
/*============================================================================
|
|
* INPUT DEVICES
|
|
*============================================================================*/
|
|
|
|
/** Move focus between a container's children with arrow keys, based on their position. */
|
|
#define LV_USE_GRIDNAV 0
|
|
|
|
/** Detect pinch and rotate gestures from multi-touch input. Requires float support.
|
|
*
|
|
* Enable: LV_USE_FLOAT
|
|
*/
|
|
#define LV_USE_GESTURE_RECOGNITION 0
|
|
|
|
|
|
|
|
/*============================================================================
|
|
* CORE
|
|
*============================================================================*/
|
|
|
|
/** Speed up style property lookups by adding 2 x 32 bit variables to each lv_obj_t. */
|
|
#define LV_OBJ_STYLE_CACHE 0
|
|
|
|
/** Widget names (lv_obj_set_name) */
|
|
#define LV_USE_OBJ_NAME 0
|
|
|
|
/** Widget id (lv_obj_set_id) */
|
|
#define LV_USE_OBJ_ID 0
|
|
|
|
#if LV_USE_OBJ_ID
|
|
/** Automatic ID assignment on widget creation */
|
|
#define LV_OBJ_ID_AUTO_ASSIGN 1
|
|
|
|
/** Use builtin obj ID handler functions:
|
|
* - lv_obj_assign_id: Called when a widget is created. Use a separate counter for each widget class as an ID.
|
|
* - lv_obj_id_compare: Compare the ID to decide if it matches with a requested value.
|
|
* - lv_obj_stringify_id: Return string-ified identifier, e.g. "button3".
|
|
* - lv_obj_free_id: Does nothing, as there is no memory allocation for the ID.
|
|
* When disabled these functions needs to be implemented by the user.
|
|
*/
|
|
#define LV_USE_OBJ_ID_BUILTIN 1
|
|
|
|
#endif /*LV_USE_OBJ_ID*/
|
|
|
|
/** Get and set any widget style or attribute through a single generic property ID based API. */
|
|
#define LV_USE_OBJ_PROPERTY 0
|
|
|
|
#if LV_USE_OBJ_PROPERTY
|
|
/** Add a name table to every widget class, so the property can be accessed by name.
|
|
* Note, the const table will increase flash usage.
|
|
*/
|
|
#define LV_USE_OBJ_PROPERTY_NAME 1
|
|
|
|
#endif /*LV_USE_OBJ_PROPERTY*/
|
|
|
|
/** Attach your own data plus a destructor callback to events, widgets, observers,
|
|
* animations, timers, groups, displays, input devices and themes, so your resources
|
|
* are cleaned up when LVGL frees them.
|
|
*/
|
|
#define LV_USE_EXT_DATA 0
|
|
|
|
/** Use `float` instead of `int32_t` for coordinates and values that need sub-pixel precision. */
|
|
#define LV_USE_FLOAT 0
|
|
|
|
/** Bind widgets to subject variables so they update automatically when the value changes. */
|
|
#define LV_USE_OBSERVER 1
|
|
|
|
/** Look up strings by ID for the selected language with lv_translation_get(). */
|
|
#define LV_USE_TRANSLATION 0
|
|
|
|
/** Color filter style */
|
|
#define LV_USE_COLOR_FILTER 0
|
|
|
|
|
|
|
|
/*============================================================================
|
|
* LOGGING
|
|
*============================================================================*/
|
|
|
|
/** Logging */
|
|
#define LV_USE_LOG 0
|
|
|
|
#if LV_USE_LOG
|
|
/** Default log verbosity
|
|
* Possible values:
|
|
* - LV_LOG_LEVEL_TRACE: detailed information about everything
|
|
* - LV_LOG_LEVEL_INFO: important events
|
|
* - LV_LOG_LEVEL_WARN: something unwanted happened but caused no problem
|
|
* - LV_LOG_LEVEL_ERROR: critical issues where the system may fail
|
|
* - LV_LOG_LEVEL_USER: only logs added by the user
|
|
* - LV_LOG_LEVEL_NONE: nothing is logged
|
|
*/
|
|
#define LV_LOG_LEVEL LV_LOG_LEVEL_WARN
|
|
|
|
/** If not set, the user needs to register a callback with lv_log_register_print_cb(). */
|
|
#define LV_LOG_PRINTF 0
|
|
|
|
/** Add a timestamp to each log */
|
|
#define LV_LOG_USE_TIMESTAMP 1
|
|
|
|
/** Add the file name and line number to each log */
|
|
#define LV_LOG_USE_FILE_LINE 1
|
|
|
|
/** Memory */
|
|
#define LV_LOG_TRACE_MEM 1
|
|
|
|
/** Timer */
|
|
#define LV_LOG_TRACE_TIMER 1
|
|
|
|
/** Input devices */
|
|
#define LV_LOG_TRACE_INDEV 1
|
|
|
|
/** Display refresh */
|
|
#define LV_LOG_TRACE_DISP_REFR 1
|
|
|
|
/** Events */
|
|
#define LV_LOG_TRACE_EVENT 1
|
|
|
|
/** Widget creation */
|
|
#define LV_LOG_TRACE_OBJ_CREATE 1
|
|
|
|
/** Layout */
|
|
#define LV_LOG_TRACE_LAYOUT 1
|
|
|
|
/** Animations */
|
|
#define LV_LOG_TRACE_ANIM 1
|
|
|
|
/** Cache */
|
|
#define LV_LOG_TRACE_CACHE 1
|
|
|
|
#endif /*LV_USE_LOG*/
|
|
|
|
|
|
/*============================================================================
|
|
* THEMES
|
|
*============================================================================*/
|
|
|
|
/** Full-featured theme used by LVGL's demos and examples. */
|
|
#define LV_USE_THEME_DEFAULT 1
|
|
|
|
#if LV_USE_THEME_DEFAULT
|
|
/** Dark mode */
|
|
#define LV_THEME_DEFAULT_DARK 0
|
|
|
|
/** Grow on press */
|
|
#define LV_THEME_DEFAULT_GROW 1
|
|
|
|
/** Transition time (ms) */
|
|
#define LV_THEME_DEFAULT_TRANSITION_TIME 80
|
|
|
|
#endif /*LV_USE_THEME_DEFAULT*/
|
|
|
|
/** Minimal styling, a good starting point for a custom theme. */
|
|
#define LV_USE_THEME_SIMPLE 1
|
|
|
|
/** Styling for 1-bit displays such as e-paper and dot-matrix panels. */
|
|
#define LV_USE_THEME_MONO 1
|
|
|
|
|
|
|
|
/*============================================================================
|
|
* LAYOUTS
|
|
*============================================================================*/
|
|
|
|
/** Arrange children in a row or column that wraps and grows, similar to Flexbox in CSS. */
|
|
#define LV_USE_FLEX 1
|
|
|
|
/** Arrange children in rows and columns, similar to Grid in CSS. */
|
|
#define LV_USE_GRID 1
|
|
|
|
|
|
|
|
/*============================================================================
|
|
* IMAGE SETTINGS
|
|
*============================================================================*/
|
|
|
|
/** Avoids repeatedly opening and decoding the same images, at the cost of RAM.
|
|
* Of little benefit with only the built-in image formats.
|
|
*/
|
|
#define LV_CACHE_DEF_SIZE 0
|
|
|
|
/** Avoids repeatedly reading image headers, at the cost of RAM.
|
|
* Of little benefit with only the built-in image formats.
|
|
*/
|
|
#define LV_IMAGE_HEADER_CACHE_DEF_CNT 0
|
|
|
|
/** Decoder for LVGL's run-length encoded binary image format. */
|
|
#define LV_USE_RLE 0
|
|
|
|
/** LZ4 compress/decompress functions, used by LVGL's compressed binary images. */
|
|
#define LV_USE_LZ4 0
|
|
|
|
#if LV_USE_LZ4
|
|
/** Bundled LZ4 */
|
|
#define LV_USE_LZ4_INTERNAL 1
|
|
|
|
#endif /*LV_USE_LZ4*/
|
|
|
|
/** Decode binary images to RAM */
|
|
#define LV_BIN_DECODER_RAM_LOAD 0
|
|
|
|
/** PNG decoder (LodePNG) */
|
|
#define LV_USE_LODEPNG 0
|
|
|
|
/** PNG decoder (libpng) */
|
|
#define LV_USE_LIBPNG 0
|
|
|
|
/** BMP decoder */
|
|
#define LV_USE_BMP 0
|
|
|
|
/** Also decodes split JPEG, a custom format optimized for embedded systems. */
|
|
#define LV_USE_TJPGD 0
|
|
|
|
/** High-performance decoder supporting the complete JPEG specifications. */
|
|
#define LV_USE_LIBJPEG_TURBO 0
|
|
|
|
/** WebP decoder */
|
|
#define LV_USE_LIBWEBP 0
|
|
|
|
/** SVG
|
|
*
|
|
* Enable: LV_USE_VECTOR_GRAPHIC
|
|
*/
|
|
#define LV_USE_SVG 0
|
|
|
|
#if LV_USE_SVG
|
|
/** SVG animation */
|
|
#define LV_USE_SVG_ANIMATION 0
|
|
|
|
/** SVG debug logs */
|
|
#define LV_USE_SVG_DEBUG 0
|
|
|
|
#endif /*LV_USE_SVG*/
|
|
|
|
|
|
/*============================================================================
|
|
* TEXT & FONT SETTINGS
|
|
*============================================================================*/
|
|
|
|
/** Your IDE or editor should be set to the same character encoding.
|
|
* Possible values:
|
|
* - LV_TXT_ENC_UTF8
|
|
* - LV_TXT_ENC_ASCII
|
|
*/
|
|
#define LV_TXT_ENC LV_TXT_ENC_UTF8
|
|
|
|
/** Characters to break (wrap) text on */
|
|
#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
|
|
|
|
#if LV_TXT_LINE_BREAK_LONG_LEN > 0
|
|
/** Minimum number of characters in a long word to put on a line before a break. */
|
|
#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 */
|
|
#define LV_TXT_LINE_BREAK_LONG_POST_MIN_LEN 3
|
|
|
|
#endif /*LV_TXT_LINE_BREAK_LONG_LEN > 0*/
|
|
|
|
/** Text recoloring control character */
|
|
#define LV_TXT_COLOR_CMD "#"
|
|
|
|
/** 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 0
|
|
|
|
#if LV_USE_BIDI
|
|
/** Default base direction
|
|
* Possible values:
|
|
* - LV_BASE_DIR_LTR: Left-to-Right
|
|
* - LV_BASE_DIR_RTL: Right-to-Left
|
|
* - LV_BASE_DIR_AUTO: Auto detect
|
|
*/
|
|
#define LV_BIDI_BASE_DIR_DEF LV_BASE_DIR_AUTO
|
|
|
|
#endif /*LV_USE_BIDI*/
|
|
|
|
/** In these languages characters should be replaced with
|
|
* another form based on their position in the text.
|
|
*/
|
|
#define LV_USE_ARABIC_PERSIAN_CHARS 0
|
|
|
|
/** Montserrat fonts with ASCII range and some symbols using bpp = 4
|
|
* https://fonts.google.com/specimen/Montserrat
|
|
*/
|
|
#define LV_FONT_MONTSERRAT_8 0
|
|
|
|
/** Montserrat 10 */
|
|
#define LV_FONT_MONTSERRAT_10 0
|
|
|
|
/** Montserrat 12 */
|
|
#define LV_FONT_MONTSERRAT_12 0
|
|
|
|
/** Montserrat 14 */
|
|
#define LV_FONT_MONTSERRAT_14 1
|
|
|
|
/** Montserrat 16 */
|
|
#define LV_FONT_MONTSERRAT_16 0
|
|
|
|
/** Montserrat 18 */
|
|
#define LV_FONT_MONTSERRAT_18 0
|
|
|
|
/** Montserrat 20 */
|
|
#define LV_FONT_MONTSERRAT_20 0
|
|
|
|
/** Montserrat 22 */
|
|
#define LV_FONT_MONTSERRAT_22 0
|
|
|
|
/** Montserrat 24 */
|
|
#define LV_FONT_MONTSERRAT_24 0
|
|
|
|
/** Montserrat 26 */
|
|
#define LV_FONT_MONTSERRAT_26 0
|
|
|
|
/** Montserrat 28 */
|
|
#define LV_FONT_MONTSERRAT_28 0
|
|
|
|
/** Montserrat 30 */
|
|
#define LV_FONT_MONTSERRAT_30 0
|
|
|
|
/** Montserrat 32 */
|
|
#define LV_FONT_MONTSERRAT_32 0
|
|
|
|
/** Montserrat 34 */
|
|
#define LV_FONT_MONTSERRAT_34 0
|
|
|
|
/** Montserrat 36 */
|
|
#define LV_FONT_MONTSERRAT_36 0
|
|
|
|
/** Montserrat 38 */
|
|
#define LV_FONT_MONTSERRAT_38 0
|
|
|
|
/** Montserrat 40 */
|
|
#define LV_FONT_MONTSERRAT_40 0
|
|
|
|
/** Montserrat 42 */
|
|
#define LV_FONT_MONTSERRAT_42 0
|
|
|
|
/** Montserrat 44 */
|
|
#define LV_FONT_MONTSERRAT_44 0
|
|
|
|
/** Montserrat 46 */
|
|
#define LV_FONT_MONTSERRAT_46 0
|
|
|
|
/** Montserrat 48 */
|
|
#define LV_FONT_MONTSERRAT_48 0
|
|
|
|
/** Montserrat 28 (compressed) */
|
|
#define LV_FONT_MONTSERRAT_28_COMPRESSED 0
|
|
|
|
/** Dejavu 16 (Persian, Hebrew, Arabic) */
|
|
#define LV_FONT_DEJAVU_16_PERSIAN_HEBREW 0
|
|
|
|
/** SourceHanSansSC 14 (CJK) */
|
|
#define LV_FONT_SOURCE_HAN_SANS_SC_14_CJK 0
|
|
|
|
/** SourceHanSansSC 16 (CJK) */
|
|
#define LV_FONT_SOURCE_HAN_SANS_SC_16_CJK 0
|
|
|
|
/** Pixel perfect monospaced fonts */
|
|
#define LV_FONT_UNSCII_8 0
|
|
|
|
/** UNSCII 16 */
|
|
#define LV_FONT_UNSCII_16 0
|
|
|
|
/** Include the header given by LV_FONT_CUSTOM_INCLUDE to declare custom
|
|
* fonts (LV_FONT_CUSTOM_DECLARE) or override font-related macros.
|
|
*/
|
|
#define LV_FONT_USE_CUSTOM_INCLUDE 0
|
|
|
|
#if LV_FONT_USE_CUSTOM_INCLUDE
|
|
/** Optional header to override font-related macros.
|
|
*
|
|
* Typical use is to declare extra fonts through LV_FONT_CUSTOM_DECLARE:
|
|
* #define LV_FONT_CUSTOM_DECLARE LV_FONT_DECLARE(my_font_24)
|
|
*
|
|
* It can also be used to override the default font to a custom one:
|
|
* #define LV_FONT_DEFAULT &my_font_24
|
|
*/
|
|
#define LV_FONT_CUSTOM_INCLUDE ""
|
|
|
|
#endif /*LV_FONT_USE_CUSTOM_INCLUDE*/
|
|
|
|
/** Enable this to set LV_FONT_DEFAULT to a font you define yourself
|
|
* rather than one of the built-in fonts below. When enabled, the
|
|
* built-in default-font selection is hidden, so you MUST define
|
|
* LV_FONT_DEFAULT yourself, either:
|
|
* - from the build system, e.g. -DLV_FONT_DEFAULT='&my_font_24', or
|
|
* - in the header given by LV_FONT_CUSTOM_INCLUDE, e.g.
|
|
* #define LV_FONT_CUSTOM_DECLARE LV_FONT_DECLARE(my_font_24)
|
|
* #define LV_FONT_DEFAULT &my_font_24
|
|
*
|
|
* If you do not, LV_FONT_DEFAULT falls back to a builtin font,
|
|
* which is no longer compiled in, causing a link error.
|
|
*/
|
|
#define LV_USE_CUSTOM_FONT_DEFAULT 0
|
|
|
|
#if !LV_USE_CUSTOM_FONT_DEFAULT
|
|
/** Font used by the themes and by widgets that do not set one explicitly.
|
|
* Possible values:
|
|
* - LV_FONT_DEFAULT_MONTSERRAT_8 (enable: LV_FONT_MONTSERRAT_8)
|
|
* - LV_FONT_DEFAULT_MONTSERRAT_10 (enable: LV_FONT_MONTSERRAT_10)
|
|
* - LV_FONT_DEFAULT_MONTSERRAT_12 (enable: LV_FONT_MONTSERRAT_12)
|
|
* - LV_FONT_DEFAULT_MONTSERRAT_14 (enable: LV_FONT_MONTSERRAT_14)
|
|
* - LV_FONT_DEFAULT_MONTSERRAT_16 (enable: LV_FONT_MONTSERRAT_16)
|
|
* - LV_FONT_DEFAULT_MONTSERRAT_18 (enable: LV_FONT_MONTSERRAT_18)
|
|
* - LV_FONT_DEFAULT_MONTSERRAT_20 (enable: LV_FONT_MONTSERRAT_20)
|
|
* - LV_FONT_DEFAULT_MONTSERRAT_22 (enable: LV_FONT_MONTSERRAT_22)
|
|
* - LV_FONT_DEFAULT_MONTSERRAT_24 (enable: LV_FONT_MONTSERRAT_24)
|
|
* - LV_FONT_DEFAULT_MONTSERRAT_26 (enable: LV_FONT_MONTSERRAT_26)
|
|
* - LV_FONT_DEFAULT_MONTSERRAT_28 (enable: LV_FONT_MONTSERRAT_28)
|
|
* - LV_FONT_DEFAULT_MONTSERRAT_30 (enable: LV_FONT_MONTSERRAT_30)
|
|
* - LV_FONT_DEFAULT_MONTSERRAT_32 (enable: LV_FONT_MONTSERRAT_32)
|
|
* - LV_FONT_DEFAULT_MONTSERRAT_34 (enable: LV_FONT_MONTSERRAT_34)
|
|
* - LV_FONT_DEFAULT_MONTSERRAT_36 (enable: LV_FONT_MONTSERRAT_36)
|
|
* - LV_FONT_DEFAULT_MONTSERRAT_38 (enable: LV_FONT_MONTSERRAT_38)
|
|
* - LV_FONT_DEFAULT_MONTSERRAT_40 (enable: LV_FONT_MONTSERRAT_40)
|
|
* - LV_FONT_DEFAULT_MONTSERRAT_42 (enable: LV_FONT_MONTSERRAT_42)
|
|
* - LV_FONT_DEFAULT_MONTSERRAT_44 (enable: LV_FONT_MONTSERRAT_44)
|
|
* - LV_FONT_DEFAULT_MONTSERRAT_46 (enable: LV_FONT_MONTSERRAT_46)
|
|
* - LV_FONT_DEFAULT_MONTSERRAT_48 (enable: LV_FONT_MONTSERRAT_48)
|
|
* - LV_FONT_DEFAULT_MONTSERRAT_28_COMPRESSED (enable: LV_FONT_MONTSERRAT_28_COMPRESSED)
|
|
* - LV_FONT_DEFAULT_DEJAVU_16_PERSIAN_HEBREW: Dejavu 16 (Persian, Hebrew, Arabic) (enable: LV_FONT_DEJAVU_16_PERSIAN_HEBREW)
|
|
* - LV_FONT_DEFAULT_SOURCE_HAN_SANS_SC_14_CJK (enable: LV_FONT_SOURCE_HAN_SANS_SC_14_CJK)
|
|
* - LV_FONT_DEFAULT_SOURCE_HAN_SANS_SC_16_CJK (enable: LV_FONT_SOURCE_HAN_SANS_SC_16_CJK)
|
|
* - LV_FONT_DEFAULT_UNSCII_8 (enable: LV_FONT_UNSCII_8)
|
|
* - LV_FONT_DEFAULT_UNSCII_16 (enable: LV_FONT_UNSCII_16)
|
|
*/
|
|
#define LV_FONT_DEFAULT LV_FONT_DEFAULT_MONTSERRAT_14
|
|
|
|
#endif /*!LV_USE_CUSTOM_FONT_DEFAULT*/
|
|
|
|
/** Use larger internal offsets so fonts with many glyphs stay addressable.
|
|
* The exact limit depends on font size, face and format, but enable it if
|
|
* you see issues with fonts above roughly 10,000 characters.
|
|
*/
|
|
#define LV_FONT_FMT_TXT_LARGE 0
|
|
|
|
/** Compressed fonts */
|
|
#define LV_USE_FONT_COMPRESSED 0
|
|
|
|
/** Draw a placeholder rectangle instead of nothing when a glyph is missing
|
|
* from the font.
|
|
*/
|
|
#define LV_USE_FONT_PLACEHOLDER 1
|
|
|
|
/** Load fonts by name, share them between widgets and free them by reference
|
|
* counting.
|
|
*/
|
|
#define LV_USE_FONT_MANAGER 0
|
|
|
|
#if LV_USE_FONT_MANAGER
|
|
/** Font name max length (characters) */
|
|
#define LV_FONT_MANAGER_NAME_MAX_LEN 32
|
|
|
|
#endif /*LV_USE_FONT_MANAGER*/
|
|
|
|
/** Use images as glyphs in label and span widgets, e.g. to render emojis. */
|
|
#define LV_USE_IMGFONT 0
|
|
|
|
/** FreeType */
|
|
#define LV_USE_FREETYPE 0
|
|
|
|
#if LV_USE_FREETYPE
|
|
/** When enabled, FreeType will use LVGL's memory allocator and file system
|
|
* abstraction instead of the platform defaults.
|
|
*/
|
|
#define LV_FREETYPE_USE_LVGL_PORT 0
|
|
|
|
/** Glyph cache size (glyphs) */
|
|
#define LV_FREETYPE_CACHE_FT_GLYPH_CNT 256
|
|
|
|
#if LV_USE_OS == LV_OS_NONE
|
|
/** L1 glyph metrics cache (lock-free, single-thread only) */
|
|
#define LV_FREETYPE_CACHE_FT_GLYPH_L1 1
|
|
|
|
#endif /*LV_USE_OS == LV_OS_NONE*/
|
|
#endif /*LV_USE_FREETYPE*/
|
|
|
|
/** Built-in TTF decoder */
|
|
#define LV_USE_TINY_TTF 0
|
|
|
|
#if LV_USE_TINY_TTF
|
|
/** Load TTF data from files */
|
|
#define LV_TINY_TTF_FILE_SUPPORT 0
|
|
|
|
/** Glyph cache size (glyphs) */
|
|
#define LV_TINY_TTF_CACHE_GLYPH_CNT 128
|
|
|
|
/** Kerning cache size (entries) */
|
|
#define LV_TINY_TTF_CACHE_KERNING_CNT 256
|
|
|
|
#endif /*LV_USE_TINY_TTF*/
|
|
|
|
|
|
/*============================================================================
|
|
* WIDGETS
|
|
*============================================================================*/
|
|
|
|
/** Causes these widgets to be given default values at creation time.
|
|
* - lv_buttonmatrix_t: Get default maps: {"Btn1", "Btn2", "Btn3", "\n", "Btn4", "Btn5", ""}, else map not set.
|
|
* - lv_checkbox_t : String label set to "Check box", else set to empty string.
|
|
* - lv_dropdown_t : Options set to "Option 1", "Option 2", "Option 3", else no values are set.
|
|
* - lv_roller_t : Options set to "Option 1", "Option 2", "Option 3", "Option 4", "Option 5", else no values are set.
|
|
* - lv_label_t : Text set to "Text", else empty string.
|
|
* - lv_arclabel_t : Text set to "Arced Text", else empty string.
|
|
*/
|
|
#define LV_WIDGETS_HAS_DEFAULT_VALUE 1
|
|
|
|
/** 3D texture */
|
|
#define LV_USE_3DTEXTURE 0
|
|
|
|
/** Animated image */
|
|
#define LV_USE_ANIMIMG 1
|
|
|
|
/** Arc */
|
|
#define LV_USE_ARC 1
|
|
|
|
/** Arc label */
|
|
#define LV_USE_ARCLABEL 1
|
|
|
|
/** Bar */
|
|
#define LV_USE_BAR 1
|
|
|
|
/** Generates Code 128 barcodes.
|
|
*
|
|
* Enable: LV_USE_CANVAS
|
|
*/
|
|
#define LV_USE_BARCODE 0
|
|
|
|
/** Button */
|
|
#define LV_USE_BUTTON 1
|
|
|
|
/** Button matrix */
|
|
#define LV_USE_BUTTONMATRIX 1
|
|
|
|
/** Calendar */
|
|
#define LV_USE_CALENDAR 1
|
|
|
|
#if LV_USE_CALENDAR
|
|
/** Week starts on Monday */
|
|
#define LV_CALENDAR_WEEK_STARTS_MONDAY 0
|
|
|
|
/** Shortened string for Monday */
|
|
#define LV_MONDAY_STR "Mo"
|
|
|
|
/** Shortened string for Tuesday */
|
|
#define LV_TUESDAY_STR "Tu"
|
|
|
|
/** Shortened string for Wednesday */
|
|
#define LV_WEDNESDAY_STR "We"
|
|
|
|
/** Shortened string for Thursday */
|
|
#define LV_THURSDAY_STR "Th"
|
|
|
|
/** Shortened string for Friday */
|
|
#define LV_FRIDAY_STR "Fr"
|
|
|
|
/** Shortened string for Saturday */
|
|
#define LV_SATURDAY_STR "Sa"
|
|
|
|
/** Shortened string for Sunday */
|
|
#define LV_SUNDAY_STR "Su"
|
|
|
|
/** String for January */
|
|
#define LV_JANUARY_STR "January"
|
|
|
|
/** String for February */
|
|
#define LV_FEBRUARY_STR "February"
|
|
|
|
/** String for March */
|
|
#define LV_MARCH_STR "March"
|
|
|
|
/** String for April */
|
|
#define LV_APRIL_STR "April"
|
|
|
|
/** String for May */
|
|
#define LV_MAY_STR "May"
|
|
|
|
/** String for June */
|
|
#define LV_JUNE_STR "June"
|
|
|
|
/** String for July */
|
|
#define LV_JULY_STR "July"
|
|
|
|
/** String for August */
|
|
#define LV_AUGUST_STR "August"
|
|
|
|
/** String for September */
|
|
#define LV_SEPTEMBER_STR "September"
|
|
|
|
/** String for October */
|
|
#define LV_OCTOBER_STR "October"
|
|
|
|
/** String for November */
|
|
#define LV_NOVEMBER_STR "November"
|
|
|
|
/** String for December */
|
|
#define LV_DECEMBER_STR "December"
|
|
|
|
/** Header with arrow buttons */
|
|
#define LV_USE_CALENDAR_HEADER_ARROW 1
|
|
|
|
/** Header with dropdowns */
|
|
#define LV_USE_CALENDAR_HEADER_DROPDOWN 1
|
|
|
|
/** Chinese calendar */
|
|
#define LV_USE_CALENDAR_CHINESE 0
|
|
|
|
#endif /*LV_USE_CALENDAR*/
|
|
|
|
/** Canvas
|
|
*
|
|
* Enable: LV_USE_IMAGE
|
|
*/
|
|
#define LV_USE_CANVAS 1
|
|
|
|
/** Chart */
|
|
#define LV_USE_CHART 1
|
|
|
|
/** Checkbox */
|
|
#define LV_USE_CHECKBOX 1
|
|
|
|
/** Dropdown
|
|
*
|
|
* Enable: LV_USE_LABEL
|
|
*/
|
|
#define LV_USE_DROPDOWN 1
|
|
|
|
/** Decodes images and plays videos with FFmpeg. It supports all major image
|
|
* formats, so do not enable other image decoders together with it.
|
|
*/
|
|
#define LV_USE_FFMPEG 0
|
|
|
|
#if LV_USE_FFMPEG
|
|
/** Print the input stream information to stderr and keep FFmpeg logging
|
|
* enabled (it is silenced otherwise).
|
|
*/
|
|
#define LV_FFMPEG_DUMP_FORMAT 0
|
|
|
|
/** URLs can no longer be opened once this is enabled. The FFmpeg image
|
|
* decoder always uses the LVGL file system regardless of this option.
|
|
*/
|
|
#define LV_FFMPEG_PLAYER_USE_LV_FS 0
|
|
|
|
#endif /*LV_USE_FFMPEG*/
|
|
|
|
/** GIF decoder */
|
|
#define LV_USE_GIF 0
|
|
|
|
#if LV_USE_GIF
|
|
/** Speeds up playback at the cost of an extra 16KB of RAM. */
|
|
#define LV_GIF_CACHE_DECODE_DATA 0
|
|
|
|
/** Wider GIFs are rejected; raising this value increases memory usage. */
|
|
#define LV_GIF_MAX_WIDTH 480
|
|
|
|
/** Taller GIFs are rejected; this value has no impact on memory usage. */
|
|
#define LV_GIF_MAX_HEIGHT 32768
|
|
|
|
#endif /*LV_USE_GIF*/
|
|
|
|
/** Parses and renders 3D models (.gltf/.glb).
|
|
*
|
|
* Enable: LV_USE_3DTEXTURE
|
|
*/
|
|
#define LV_USE_GLTF 0
|
|
|
|
/** Requires the gstreamer-1.0, gstreamer-video-1.0 and gstreamer-app-1.0
|
|
* development libraries.
|
|
*
|
|
* Enable: LV_USE_IMAGE
|
|
*/
|
|
#define LV_USE_GSTREAMER 0
|
|
|
|
/** Image */
|
|
#define LV_USE_IMAGE 1
|
|
|
|
/** Image button */
|
|
#define LV_USE_IMAGEBUTTON 1
|
|
|
|
/** Chinese input method that converts Pinyin typed on a keyboard widget
|
|
* into Chinese characters.
|
|
*
|
|
* Enable: LV_USE_KEYBOARD
|
|
*/
|
|
#define LV_USE_IME_PINYIN 0
|
|
|
|
#if LV_USE_IME_PINYIN
|
|
/** 9-key input mode */
|
|
#define LV_IME_PINYIN_USE_K9_MODE 1
|
|
|
|
#if LV_IME_PINYIN_USE_K9_MODE
|
|
/** Maximum number of candidate panels for 9-key input mode */
|
|
#define LV_IME_PINYIN_K9_CAND_TEXT_NUM 3
|
|
|
|
#endif /*LV_IME_PINYIN_USE_K9_MODE*/
|
|
|
|
/** Without it, a dictionary must be set with lv_ime_pinyin_set_dict()
|
|
* before the IME is used.
|
|
*/
|
|
#define LV_IME_PINYIN_USE_DEFAULT_DICT 1
|
|
|
|
/** Adjust this to the screen size, as all candidate panels must fit on it. */
|
|
#define LV_IME_PINYIN_CAND_TEXT_NUM 6
|
|
|
|
#endif /*LV_USE_IME_PINYIN*/
|
|
|
|
/** Keyboard */
|
|
#define LV_USE_KEYBOARD 1
|
|
|
|
/** Label */
|
|
#define LV_USE_LABEL 1
|
|
|
|
#if LV_USE_LABEL
|
|
/** Text selection */
|
|
#define LV_LABEL_TEXT_SELECTION 1
|
|
|
|
/** Stores 12 extra bytes per label to speed up drawing of very long texts. */
|
|
#define LV_LABEL_LONG_TXT_HINT 1
|
|
|
|
/** Gap between the end and the restart of circularly scrolled text,
|
|
* measured in space-character widths.
|
|
*/
|
|
#define LV_LABEL_WAIT_CHAR_COUNT 3
|
|
|
|
#endif /*LV_USE_LABEL*/
|
|
|
|
/** LED */
|
|
#define LV_USE_LED 1
|
|
|
|
/** Line */
|
|
#define LV_USE_LINE 1
|
|
|
|
/** List */
|
|
#define LV_USE_LIST 1
|
|
|
|
#if LV_USE_THORVG
|
|
/** Plays Lottie JSON animations using the ThorVG Lottie parser.
|
|
*
|
|
* Enable: LV_USE_VECTOR_GRAPHIC
|
|
*/
|
|
#define LV_USE_LOTTIE 0
|
|
|
|
#endif /*LV_USE_THORVG*/
|
|
|
|
/** Menu */
|
|
#define LV_USE_MENU 1
|
|
|
|
/** Message box */
|
|
#define LV_USE_MSGBOX 1
|
|
|
|
/** QR code
|
|
*
|
|
* Enable: LV_USE_CANVAS
|
|
*/
|
|
#define LV_USE_QRCODE 0
|
|
|
|
/** Legacy rlottie binding, kept for compatibility. Use LV_USE_LOTTIE instead. */
|
|
#define LV_USE_RLOTTIE 0
|
|
|
|
/** Roller
|
|
*
|
|
* Enable: LV_USE_LABEL
|
|
*/
|
|
#define LV_USE_ROLLER 1
|
|
|
|
/** Scale */
|
|
#define LV_USE_SCALE 1
|
|
|
|
/** Slider
|
|
*
|
|
* Enable: LV_USE_BAR
|
|
*/
|
|
#define LV_USE_SLIDER 1
|
|
|
|
/** Span */
|
|
#define LV_USE_SPAN 1
|
|
|
|
#if LV_USE_SPAN
|
|
/** Maximum number of span descriptors */
|
|
#define LV_SPAN_SNIPPET_STACK_SIZE 64
|
|
|
|
#endif /*LV_USE_SPAN*/
|
|
|
|
/** Spinbox */
|
|
#define LV_USE_SPINBOX 1
|
|
|
|
/** Spinner */
|
|
#define LV_USE_SPINNER 1
|
|
|
|
/** Switch */
|
|
#define LV_USE_SWITCH 1
|
|
|
|
/** Text area
|
|
*
|
|
* Enable: LV_USE_LABEL
|
|
*/
|
|
#define LV_USE_TEXTAREA 1
|
|
|
|
#if LV_USE_TEXTAREA
|
|
/** Default password show time (ms) */
|
|
#define LV_TEXTAREA_DEF_PWD_SHOW_TIME 1500
|
|
|
|
#endif /*LV_USE_TEXTAREA*/
|
|
|
|
/** Table */
|
|
#define LV_USE_TABLE 1
|
|
|
|
/** Tabview */
|
|
#define LV_USE_TABVIEW 1
|
|
|
|
/** Tileview */
|
|
#define LV_USE_TILEVIEW 1
|
|
|
|
/** Window */
|
|
#define LV_USE_WIN 1
|
|
|
|
|
|
|
|
/*============================================================================
|
|
* DRIVERS
|
|
*============================================================================*/
|
|
|
|
/** Driver for /dev/dri/card */
|
|
#define LV_USE_LINUX_DRM 0
|
|
|
|
#if LV_USE_LINUX_DRM
|
|
/** Legacy behavior, slated for removal: the backend is inferred from
|
|
* LV_USE_OPENGLES (EGL when it is enabled). Disable this and pick a backend
|
|
* explicitly in the "Rendering backend" choice.
|
|
*/
|
|
#define LV_LINUX_DRM_AUTO_BACKEND 1
|
|
|
|
/** Select how the Linux DRM driver presents rendered frames.
|
|
* Possible values:
|
|
* - LV_LINUX_DRM_BACKEND_FBDEV: Dumb buffers (no GPU)
|
|
* - LV_LINUX_DRM_BACKEND_GBM: GBM DMA buffers
|
|
* - LV_LINUX_DRM_BACKEND_EGL: EGL (OpenGL ES, hardware-accelerated) (enable: LV_USE_OPENGLES)
|
|
*/
|
|
#define LV_LINUX_DRM_BACKEND LV_LINUX_DRM_BACKEND_FBDEV
|
|
|
|
#endif /*LV_USE_LINUX_DRM*/
|
|
|
|
/** Driver for /dev/fb */
|
|
#define LV_USE_LINUX_FBDEV 0
|
|
|
|
#if LV_USE_LINUX_FBDEV
|
|
/** BSD-flavored framebuffer device */
|
|
#define LV_LINUX_FBDEV_BSD 0
|
|
|
|
/** Render mode
|
|
* Possible values:
|
|
* - LV_DISPLAY_RENDER_MODE_PARTIAL: Partial mode
|
|
* - LV_DISPLAY_RENDER_MODE_DIRECT: Direct mode
|
|
* - LV_DISPLAY_RENDER_MODE_FULL: Full mode
|
|
*/
|
|
#define LV_LINUX_FBDEV_RENDER_MODE LV_DISPLAY_RENDER_MODE_PARTIAL
|
|
|
|
#define LV_LINUX_FBDEV_BUFFER_COUNT 1
|
|
|
|
#if LV_LINUX_FBDEV_BUFFER_COUNT == 0
|
|
/** Custom partial buffer size (rows) */
|
|
#define LV_LINUX_FBDEV_BUFFER_SIZE 60
|
|
|
|
#endif /*LV_LINUX_FBDEV_BUFFER_COUNT == 0*/
|
|
|
|
/** Access the framebuffer through mmap() instead of write() calls. */
|
|
#define LV_LINUX_FBDEV_MMAP 1
|
|
|
|
#endif /*LV_USE_LINUX_FBDEV*/
|
|
|
|
/** Driver for FT81X EVE graphics controllers connected over SPI. */
|
|
#define LV_USE_FT81X 0
|
|
|
|
/** Display and touch driver built on the LovyanGFX C++ library, which must be available in the build. */
|
|
#define LV_USE_LOVYAN_GFX 0
|
|
|
|
#if LV_USE_LOVYAN_GFX
|
|
/** Header for LovyanGFX user configuration */
|
|
#define LV_LGFX_USER_INCLUDE "lv_lgfx_user.hpp"
|
|
|
|
#endif /*LV_USE_LOVYAN_GFX*/
|
|
|
|
/** Driver for LCD devices connected via SPI or parallel port.
|
|
* Use it if your LCD controller is not listed among the dedicated drivers below.
|
|
*/
|
|
#define LV_USE_GENERIC_MIPI 0
|
|
|
|
/** ST7735
|
|
*
|
|
* Enable: LV_USE_GENERIC_MIPI
|
|
*/
|
|
#define LV_USE_ST7735 0
|
|
|
|
/** ST7789
|
|
*
|
|
* Enable: LV_USE_GENERIC_MIPI
|
|
*/
|
|
#define LV_USE_ST7789 0
|
|
|
|
/** ST7796
|
|
*
|
|
* Enable: LV_USE_GENERIC_MIPI
|
|
*/
|
|
#define LV_USE_ST7796 0
|
|
|
|
/** ILI9341
|
|
*
|
|
* Enable: LV_USE_GENERIC_MIPI
|
|
*/
|
|
#define LV_USE_ILI9341 0
|
|
|
|
/** NV3007
|
|
*
|
|
* Enable: LV_USE_GENERIC_MIPI
|
|
*/
|
|
#define LV_USE_NV3007 0
|
|
|
|
/** Create a display on an already initialized NXP ELCDIF LCD controller. */
|
|
#define LV_USE_NXP_ELCDIF 0
|
|
|
|
/** Create a display driven by the Renesas GLCDC peripheral. */
|
|
#define LV_USE_RENESAS_GLCDC 0
|
|
|
|
/** Create a display bound to a layer of the ST LTDC peripheral. */
|
|
#define LV_USE_ST_LTDC 0
|
|
|
|
#if !LV_USE_DRAW_DMA2D
|
|
#if LV_USE_ST_LTDC
|
|
/** Flush partial mode LTDC displays with DMA2D, in parallel with rendering.
|
|
* Only available when the DMA2D renderer is disabled.
|
|
*/
|
|
#define LV_ST_LTDC_USE_DMA2D_FLUSH 0
|
|
|
|
#endif /*LV_USE_ST_LTDC*/
|
|
#endif /*!LV_USE_DRAW_DMA2D*/
|
|
|
|
/** Display driver built on the TFT_eSPI Arduino library, which must be available in the build. */
|
|
#define LV_USE_TFT_ESPI 0
|
|
|
|
/** Read touchscreen, mouse and keyboard input from Linux /dev/input event devices. */
|
|
#define LV_USE_EVDEV 0
|
|
|
|
/** Read pointer, touch and keyboard input through libinput, which must be available in the build. */
|
|
#define LV_USE_LIBINPUT 0
|
|
|
|
#if LV_USE_LIBINPUT
|
|
/** BSD variant of libinput */
|
|
#define LV_LIBINPUT_BSD 0
|
|
|
|
/** Map key events to characters with XKB layouts, so modifiers and non-US layouts work.
|
|
* Requires linking with -lxkbcommon.
|
|
*/
|
|
#define LV_LIBINPUT_XKB 0
|
|
|
|
#if LV_LIBINPUT_XKB
|
|
/** Run `setxkbmap -query` to find the right values for your keyboard. */
|
|
#define LV_LIBINPUT_XKB_RULES ""
|
|
|
|
/** XKB model */
|
|
#define LV_LIBINPUT_XKB_MODEL "pc101"
|
|
|
|
/** XKB layout */
|
|
#define LV_LIBINPUT_XKB_LAYOUT "us"
|
|
|
|
/** XKB variant */
|
|
#define LV_LIBINPUT_XKB_VARIANT ""
|
|
|
|
/** Pass NULL for the XKB options so the system default applies (e.g. from the
|
|
* XKB_DEFAULT_OPTIONS env var). Otherwise LV_LIBINPUT_XKB_OPTIONS is used.
|
|
*/
|
|
#define LV_LIBINPUT_XKB_OPTIONS_USE_DEFAULT 1
|
|
|
|
#if !LV_LIBINPUT_XKB_OPTIONS_USE_DEFAULT
|
|
/** XKB options */
|
|
#define LV_LIBINPUT_XKB_OPTIONS ""
|
|
|
|
#endif /*!LV_LIBINPUT_XKB_OPTIONS_USE_DEFAULT*/
|
|
#endif /*LV_LIBINPUT_XKB*/
|
|
#endif /*LV_USE_LIBINPUT*/
|
|
|
|
/** Display and input drivers for NuttX, including the /dev/fb framebuffer device. */
|
|
#define LV_USE_NUTTX 0
|
|
|
|
#if LV_USE_NUTTX
|
|
/** Allocate cached image buffers from a separate NuttX heap to keep the main heap from fragmenting. */
|
|
#define LV_USE_NUTTX_INDEPENDENT_IMAGE_HEAP 0
|
|
|
|
#if LV_USE_NUTTX_INDEPENDENT_IMAGE_HEAP
|
|
/** Independent image heap for the default draw buffer */
|
|
#define LV_NUTTX_DEFAULT_DRAW_BUF_USE_INDEPENDENT_IMAGE_HEAP 0
|
|
|
|
#endif /*LV_USE_NUTTX_INDEPENDENT_IMAGE_HEAP*/
|
|
|
|
/** Drive the LVGL timer handler and the display/input timers from a libuv loop instead of the default timer loop. */
|
|
#define LV_USE_NUTTX_LIBUV 0
|
|
|
|
/** Skip the display and input device creation in lv_nuttx_init() so the application can set them up itself. */
|
|
#define LV_USE_NUTTX_CUSTOM_INIT 0
|
|
|
|
/** Create the display on a NuttX LCD character device instead of the framebuffer device. */
|
|
#define LV_USE_NUTTX_LCD 0
|
|
|
|
#define LV_NUTTX_LCD_BUFFER_COUNT 0
|
|
|
|
#if LV_NUTTX_LCD_BUFFER_COUNT == 0
|
|
#if LV_USE_NUTTX_LCD
|
|
/** Custom partial buffer size (rows) */
|
|
#define LV_NUTTX_LCD_BUFFER_SIZE 60
|
|
|
|
#endif /*LV_USE_NUTTX_LCD*/
|
|
#endif /*LV_NUTTX_LCD_BUFFER_COUNT == 0*/
|
|
|
|
/** Touchscreen */
|
|
#define LV_USE_NUTTX_TOUCHSCREEN 0
|
|
|
|
#if LV_USE_NUTTX_TOUCHSCREEN
|
|
/** 0 disables the cursor. */
|
|
#define LV_NUTTX_TOUCHSCREEN_CURSOR_SIZE 0
|
|
|
|
#endif /*LV_USE_NUTTX_TOUCHSCREEN*/
|
|
|
|
/** Mouse */
|
|
#define LV_USE_NUTTX_MOUSE 0
|
|
|
|
#if LV_USE_NUTTX_MOUSE
|
|
/** Mouse movement step (pixels) */
|
|
#define LV_USE_NUTTX_MOUSE_MOVE_STEP 1
|
|
|
|
#endif /*LV_USE_NUTTX_MOUSE*/
|
|
|
|
#if LV_USE_PROFILER_BUILTIN
|
|
/** Write the built-in profiler output to a file instead of the console. */
|
|
#define LV_USE_NUTTX_TRACE_FILE 0
|
|
|
|
#endif /*LV_USE_PROFILER_BUILTIN*/
|
|
|
|
#if LV_USE_NUTTX_TRACE_FILE
|
|
/** Profiler trace file path */
|
|
#define LV_NUTTX_TRACE_FILE_PATH "/data/lvgl-trace.log"
|
|
|
|
#endif /*LV_USE_NUTTX_TRACE_FILE*/
|
|
#endif /*LV_USE_NUTTX*/
|
|
|
|
/** Generic OpenGL ES display driver, for embedding LVGL in another application or driving it through GLFW/EGL.
|
|
*
|
|
* Enable: LV_USE_MATRIX
|
|
*/
|
|
#define LV_USE_OPENGLES 0
|
|
|
|
#if LV_USE_OPENGLES
|
|
/** Check for an OpenGL error after every GL call and log it with the call site. */
|
|
#define LV_USE_OPENGLES_DEBUG 0
|
|
|
|
#endif /*LV_USE_OPENGLES*/
|
|
|
|
#if !LV_USE_EGL
|
|
/** Open a window on a PC desktop with GLFW and read mouse and keyboard input.
|
|
*
|
|
* Enable: LV_USE_OPENGLES
|
|
*/
|
|
#define LV_USE_GLFW 0
|
|
|
|
#endif /*!LV_USE_EGL*/
|
|
|
|
/** Create a display on a QNX Screen window and read pointer and keyboard input. */
|
|
#define LV_USE_QNX 0
|
|
|
|
#if LV_USE_QNX
|
|
/** Number of screen-sized buffers */
|
|
#define LV_QNX_BUF_COUNT 1
|
|
|
|
#endif /*LV_USE_QNX*/
|
|
|
|
/** Open a window on a PC desktop with SDL2 and read mouse and keyboard input. */
|
|
#define LV_USE_SDL 0
|
|
|
|
#if LV_USE_SDL
|
|
/** SDL include path */
|
|
#define LV_SDL_INCLUDE_PATH "SDL2/SDL.h"
|
|
|
|
/** Legacy behavior, slated for removal: EGL is inferred the legacy way
|
|
* (LV_USE_OPENGLES with an OpenGL draw unit). Disable this and pick a backend
|
|
* explicitly in the "Rendering backend" choice.
|
|
*/
|
|
#define LV_SDL_AUTO_BACKEND 1
|
|
|
|
/** Select how the SDL driver presents rendered frames.
|
|
* Possible values:
|
|
* - LV_SDL_BACKEND_SW: Software (SDL surface)
|
|
* - LV_SDL_BACKEND_TEXTURE: Cached SDL textures (enable: LV_USE_DRAW_SDL)
|
|
* - LV_SDL_BACKEND_EGL: EGL (OpenGL ES, hardware-accelerated) (requires LV_USE_DRAW_OPENGLES || LV_USE_DRAW_NANOVG)
|
|
*/
|
|
#define LV_SDL_BACKEND LV_SDL_BACKEND_SW
|
|
|
|
/** Direct mode is recommended for best performance.
|
|
* Possible values:
|
|
* - LV_DISPLAY_RENDER_MODE_PARTIAL: Partial mode
|
|
* - LV_DISPLAY_RENDER_MODE_DIRECT: Direct mode
|
|
* - LV_DISPLAY_RENDER_MODE_FULL: Full mode
|
|
*/
|
|
#define LV_SDL_RENDER_MODE LV_DISPLAY_RENDER_MODE_DIRECT
|
|
|
|
/** Number of screen-sized buffers */
|
|
#define LV_SDL_BUF_COUNT 1
|
|
|
|
/** Ask SDL for a GPU-backed renderer instead of a software one. */
|
|
#define LV_SDL_ACCELERATED 1
|
|
|
|
/** Fullscreen */
|
|
#define LV_SDL_FULLSCREEN 0
|
|
|
|
/** Exit when all windows are closed */
|
|
#define LV_SDL_DIRECT_EXIT 1
|
|
|
|
/** SDL mousewheel mode
|
|
* Possible values:
|
|
* - LV_SDL_MOUSEWHEEL_MODE_ENCODER: Encoder input device
|
|
* - LV_SDL_MOUSEWHEEL_MODE_CROWN: Smart watch crown
|
|
*/
|
|
#define LV_SDL_MOUSEWHEEL_MODE LV_SDL_MOUSEWHEEL_MODE_ENCODER
|
|
|
|
#endif /*LV_USE_SDL*/
|
|
|
|
/** Display and input drivers for UEFI firmware, based on the Graphics Output, keyboard and pointer protocols. */
|
|
#define LV_USE_UEFI 0
|
|
|
|
#if LV_USE_UEFI
|
|
/** Header wrapping the UEFI framework (EDK2, gnu-efi, ...) */
|
|
#define LV_USE_UEFI_INCLUDE "myefi.h"
|
|
|
|
/** Allocate memory with the UEFI boot services instead of the C library.
|
|
* Only takes effect with the custom stdlib malloc implementation.
|
|
*/
|
|
#define LV_UEFI_USE_MEMORY_SERVICES 0
|
|
|
|
#endif /*LV_USE_UEFI*/
|
|
|
|
/** Open a window on a Wayland compositor on Linux or BSD and read mouse, keyboard and touch input. */
|
|
#define LV_USE_WAYLAND 0
|
|
|
|
#if LV_USE_WAYLAND
|
|
/** LVGL is deinitialized before the application exits. */
|
|
#define LV_WAYLAND_DIRECT_EXIT 1
|
|
|
|
#if !LV_USE_DRAW_OPENGLES
|
|
#if !LV_USE_DRAW_NANOVG
|
|
/** Default backend, using wl_shm for double-buffered direct rendering.
|
|
* Compatible with all Wayland compositors; no special hardware required.
|
|
* Unavailable with the OpenGL ES and NanoVG renderers, which can only
|
|
* render into a GPU surface.
|
|
*/
|
|
#define LV_WAYLAND_USE_SHM 1
|
|
|
|
/** Presents software-rendered frames through linear DMA-BUFs that the
|
|
* compositor can scan out directly, saving its copy out of shared memory.
|
|
* Requires a compositor with zwp_linux_dmabuf_v1 and a gbm implementation
|
|
* able to allocate CPU-mappable buffers, plus libdrm and gbm (-ldrm -lgbm).
|
|
* Needs no GPU API: unavailable with the OpenGL ES and NanoVG renderers,
|
|
* which can only render into a GPU surface.
|
|
*/
|
|
#define LV_WAYLAND_USE_DMABUF 0
|
|
|
|
#endif /*!LV_USE_DRAW_NANOVG*/
|
|
#endif /*!LV_USE_DRAW_OPENGLES*/
|
|
|
|
/** Hardware-accelerated rendering via OpenGL ES 2.0 and EGL, compatible
|
|
* with LVGL 3D/glTF rendering. Requires OpenGL ES 2.0 on the target
|
|
* hardware and linking with wayland-egl (-lwayland-egl).
|
|
* The only backend available with the OpenGL ES and NanoVG renderers.
|
|
*
|
|
* Enable: LV_USE_OPENGLES
|
|
*/
|
|
#define LV_WAYLAND_USE_EGL 0
|
|
|
|
#if !LV_USE_DRAW_OPENGLES
|
|
#if !LV_USE_DRAW_NANOVG
|
|
/** Hardware-accelerated 2D rendering via NXP's G2D engine.
|
|
* Supports NXP i.MX6/i.MX8 platforms with G2D library installed.
|
|
* Unavailable with the OpenGL ES and NanoVG renderers, which can only
|
|
* render into a GPU surface.
|
|
*
|
|
* Enable: LV_USE_DRAW_G2D
|
|
*/
|
|
#define LV_WAYLAND_USE_G2D 0
|
|
|
|
#endif /*!LV_USE_DRAW_NANOVG*/
|
|
#endif /*!LV_USE_DRAW_OPENGLES*/
|
|
#endif /*LV_USE_WAYLAND*/
|
|
|
|
#if LV_USE_OS == LV_OS_WINDOWS
|
|
/** Open a window with the Win32 API and read mouse, touch, keyboard and mousewheel input. */
|
|
#define LV_USE_WINDOWS 0
|
|
|
|
#endif /*LV_USE_OS == LV_OS_WINDOWS*/
|
|
|
|
/** Open a window on an X11 desktop and read mouse and keyboard input. */
|
|
#define LV_USE_X11 0
|
|
|
|
#if LV_USE_X11
|
|
/** Double buffering */
|
|
#define LV_X11_DOUBLE_BUFFER 1
|
|
|
|
/** Exit when all windows are closed */
|
|
#define LV_X11_DIRECT_EXIT 1
|
|
|
|
/** Render mode
|
|
* Possible values:
|
|
* - LV_DISPLAY_RENDER_MODE_PARTIAL: Partial mode
|
|
* - LV_DISPLAY_RENDER_MODE_DIRECT: Direct mode
|
|
* - LV_DISPLAY_RENDER_MODE_FULL: Full mode
|
|
*/
|
|
#define LV_X11_RENDER_MODE LV_DISPLAY_RENDER_MODE_PARTIAL
|
|
|
|
#endif /*LV_USE_X11*/
|
|
|
|
/** Build the bundled NanoVG vector graphics library. Required by the NanoVG renderer. */
|
|
#define LV_USE_NANOVG 0
|
|
|
|
|
|
|
|
/*============================================================================
|
|
* FILE SYSTEM
|
|
*============================================================================*/
|
|
|
|
/** Setting a default drive letter allows skipping the driver
|
|
* prefix in filepaths.
|
|
*/
|
|
#define LV_FS_DEFAULT_DRIVER_LETTER 0
|
|
|
|
/** stdio */
|
|
#define LV_USE_FS_STDIO 0
|
|
|
|
#if LV_USE_FS_STDIO
|
|
/** Drive letter for stdio (65 = 'A', 0 = disabled) */
|
|
#define LV_FS_STDIO_LETTER 0
|
|
|
|
/** Working directory for stdio */
|
|
#define LV_FS_STDIO_PATH ""
|
|
|
|
/** Read cache size in bytes for stdio (0 = disabled) */
|
|
#define LV_FS_STDIO_CACHE_SIZE 0
|
|
|
|
#endif /*LV_USE_FS_STDIO*/
|
|
|
|
/** POSIX */
|
|
#define LV_USE_FS_POSIX 0
|
|
|
|
#if LV_USE_FS_POSIX
|
|
/** Drive letter for POSIX (65 = 'A', 0 = disabled) */
|
|
#define LV_FS_POSIX_LETTER 0
|
|
|
|
/** Working directory for POSIX */
|
|
#define LV_FS_POSIX_PATH ""
|
|
|
|
/** Read cache size in bytes for POSIX (0 = disabled) */
|
|
#define LV_FS_POSIX_CACHE_SIZE 0
|
|
|
|
#endif /*LV_USE_FS_POSIX*/
|
|
|
|
/** Win32 */
|
|
#define LV_USE_FS_WIN32 0
|
|
|
|
#if LV_USE_FS_WIN32
|
|
/** Drive letter for Win32 (65 = 'A', 0 = disabled) */
|
|
#define LV_FS_WIN32_LETTER 0
|
|
|
|
/** Working directory for Win32 */
|
|
#define LV_FS_WIN32_PATH ""
|
|
|
|
/** Read cache size in bytes for Win32 (0 = disabled) */
|
|
#define LV_FS_WIN32_CACHE_SIZE 0
|
|
|
|
#endif /*LV_USE_FS_WIN32*/
|
|
|
|
/** FatFS */
|
|
#define LV_USE_FS_FATFS 0
|
|
|
|
#if LV_USE_FS_FATFS
|
|
/** Drive letter for FatFS (65 = 'A', 0 = disabled) */
|
|
#define LV_FS_FATFS_LETTER 0
|
|
|
|
/** Working directory for FatFS */
|
|
#define LV_FS_FATFS_PATH ""
|
|
|
|
/** Read cache size in bytes for FatFS (0 = disabled) */
|
|
#define LV_FS_FATFS_CACHE_SIZE 0
|
|
|
|
#endif /*LV_USE_FS_FATFS*/
|
|
|
|
/** littlefs */
|
|
#define LV_USE_FS_LITTLEFS 0
|
|
|
|
#if LV_USE_FS_LITTLEFS
|
|
/** Drive letter for littlefs (65 = 'A', 0 = disabled) */
|
|
#define LV_FS_LITTLEFS_LETTER 0
|
|
|
|
/** Working directory for littlefs */
|
|
#define LV_FS_LITTLEFS_PATH ""
|
|
|
|
#endif /*LV_USE_FS_LITTLEFS*/
|
|
|
|
/** Arduino ESP littlefs */
|
|
#define LV_USE_FS_ARDUINO_ESP_LITTLEFS 0
|
|
|
|
#if LV_USE_FS_ARDUINO_ESP_LITTLEFS
|
|
/** Drive letter for Arduino ESP littlefs (65 = 'A', 0 = disabled) */
|
|
#define LV_FS_ARDUINO_ESP_LITTLEFS_LETTER 0
|
|
|
|
/** Working directory for Arduino ESP littlefs */
|
|
#define LV_FS_ARDUINO_ESP_LITTLEFS_PATH ""
|
|
|
|
#endif /*LV_USE_FS_ARDUINO_ESP_LITTLEFS*/
|
|
|
|
/** Arduino SD */
|
|
#define LV_USE_FS_ARDUINO_SD 0
|
|
|
|
#if LV_USE_FS_ARDUINO_SD
|
|
/** Drive letter for Arduino SD (65 = 'A', 0 = disabled) */
|
|
#define LV_FS_ARDUINO_SD_LETTER 0
|
|
|
|
/** Working directory for Arduino SD */
|
|
#define LV_FS_ARDUINO_SD_PATH ""
|
|
|
|
#endif /*LV_USE_FS_ARDUINO_SD*/
|
|
|
|
/** UEFI */
|
|
#define LV_USE_FS_UEFI 0
|
|
|
|
#if LV_USE_FS_UEFI
|
|
/** Drive letter for UEFI (65 = 'A', 0 = disabled) */
|
|
#define LV_FS_UEFI_LETTER 0
|
|
|
|
#endif /*LV_USE_FS_UEFI*/
|
|
|
|
/** FrogFS */
|
|
#define LV_USE_FS_FROGFS 0
|
|
|
|
#if LV_USE_FS_FROGFS
|
|
/** Drive letter for FrogFS (65 = 'A', 0 = disabled) */
|
|
#define LV_FS_FROGFS_LETTER 0
|
|
|
|
#endif /*LV_USE_FS_FROGFS*/
|
|
|
|
/** Reach data already in memory through the lv_fs API, without a real file system. */
|
|
#define LV_USE_FS_MEMFS 0
|
|
|
|
#if LV_USE_FS_MEMFS
|
|
/** Drive letter for memfs (65 = 'A', 0 = disabled) */
|
|
#define LV_FS_MEMFS_LETTER 0
|
|
|
|
#endif /*LV_USE_FS_MEMFS*/
|
|
|
|
|
|
/*============================================================================
|
|
* DEBUGGING
|
|
*============================================================================*/
|
|
|
|
/** Periodically collect CPU, FPS and memory statistics and optionally show them in an
|
|
* on-screen overlay.
|
|
*/
|
|
#define LV_USE_SYSMON 0
|
|
|
|
#if LV_USE_SYSMON
|
|
/** The port provides `lv_os_get_proc_idle_percent` a per-process idle percentage
|
|
* in addition to the system-wide one. LVGL provides a default one for linux systems.
|
|
*/
|
|
#define LV_SYSMON_PROC_IDLE_AVAILABLE 0
|
|
|
|
/** Show the CPU usage and FPS count in a label on the screen. */
|
|
#define LV_USE_PERF_MONITOR 0
|
|
|
|
#if LV_USE_PERF_MONITOR
|
|
/** Performance monitor position
|
|
* Possible values:
|
|
* - LV_ALIGN_TOP_LEFT
|
|
* - LV_ALIGN_TOP_MID: Top middle
|
|
* - LV_ALIGN_TOP_RIGHT
|
|
* - LV_ALIGN_BOTTOM_LEFT
|
|
* - LV_ALIGN_BOTTOM_MID: Bottom middle
|
|
* - LV_ALIGN_BOTTOM_RIGHT
|
|
* - LV_ALIGN_LEFT_MID: Left middle
|
|
* - LV_ALIGN_RIGHT_MID: Right middle
|
|
* - LV_ALIGN_CENTER
|
|
*/
|
|
#define LV_USE_PERF_MONITOR_POS LV_ALIGN_BOTTOM_RIGHT
|
|
|
|
/** Print the performance data to the log instead of showing the on-screen label. */
|
|
#define LV_USE_PERF_MONITOR_LOG_MODE 0
|
|
|
|
#endif /*LV_USE_PERF_MONITOR*/
|
|
|
|
#if LV_USE_STDLIB_MALLOC == LV_STDLIB_BUILTIN
|
|
/** Show the used memory and the memory fragmentation in a label on the screen. */
|
|
#define LV_USE_MEM_MONITOR 0
|
|
|
|
#endif /*LV_USE_STDLIB_MALLOC == LV_STDLIB_BUILTIN*/
|
|
|
|
#if LV_USE_MEM_MONITOR
|
|
/** Memory monitor position
|
|
* Possible values:
|
|
* - LV_ALIGN_TOP_LEFT
|
|
* - LV_ALIGN_TOP_MID: Top middle
|
|
* - LV_ALIGN_TOP_RIGHT
|
|
* - LV_ALIGN_BOTTOM_LEFT
|
|
* - LV_ALIGN_BOTTOM_MID: Bottom middle
|
|
* - LV_ALIGN_BOTTOM_RIGHT
|
|
* - LV_ALIGN_LEFT_MID: Left middle
|
|
* - LV_ALIGN_RIGHT_MID: Right middle
|
|
* - LV_ALIGN_CENTER
|
|
*/
|
|
#define LV_USE_MEM_MONITOR_POS LV_ALIGN_BOTTOM_LEFT
|
|
|
|
#endif /*LV_USE_MEM_MONITOR*/
|
|
|
|
/** Include the header given by LV_SYSMON_CUSTOM_INCLUDE to override system
|
|
* monitor macros such as LV_SYSMON_GET_IDLE.
|
|
*/
|
|
#define LV_SYSMON_USE_CUSTOM_INCLUDE 0
|
|
|
|
#if LV_SYSMON_USE_CUSTOM_INCLUDE
|
|
/** Optional header to override system monitor idle measurement macros.
|
|
*
|
|
* LV_SYSMON_GET_IDLE
|
|
* Expression returning the CPU idle percentage (0-100) since last call.
|
|
* e.g. my_rtos_get_idle_percent()
|
|
*
|
|
* LV_SYSMON_GET_PROC_IDLE
|
|
* Expression returning per-process idle percentage, if supported by
|
|
* the RTOS. Requires LV_SYSMON_PROC_IDLE_AVAILABLE to be enabled
|
|
* e.g. my_rtos_get_proc_idle_percent()
|
|
*/
|
|
#define LV_SYSMON_CUSTOM_INCLUDE ""
|
|
|
|
#endif /*LV_SYSMON_USE_CUSTOM_INCLUDE*/
|
|
#endif /*LV_USE_SYSMON*/
|
|
|
|
/** Instrument LVGL internals with trace hooks to measure runtime performance. */
|
|
#define LV_USE_PROFILER 0
|
|
|
|
/** Built-in profiler
|
|
*
|
|
* Enable: LV_USE_PROFILER
|
|
*/
|
|
#define LV_USE_PROFILER_BUILTIN 0
|
|
|
|
#if LV_USE_PROFILER_BUILTIN
|
|
/** Trace buffer size (bytes) */
|
|
#define LV_PROFILER_BUILTIN_BUF_SIZE 16384
|
|
|
|
/** Start profiling at init */
|
|
#define LV_PROFILER_BUILTIN_DEFAULT_ENABLE 1
|
|
|
|
/** POSIX port */
|
|
#define LV_USE_PROFILER_BUILTIN_POSIX 0
|
|
|
|
#endif /*LV_USE_PROFILER_BUILTIN*/
|
|
|
|
#if LV_USE_PROFILER
|
|
/** Path to a header that defines the following profiler hook macros:
|
|
*
|
|
* LV_PROFILER_BEGIN
|
|
* Called at the start of a profiled scope.
|
|
* e.g. #define LV_PROFILER_BEGIN my_profiler_begin()
|
|
*
|
|
* LV_PROFILER_END
|
|
* Called at the end of a profiled scope.
|
|
* e.g. #define LV_PROFILER_END my_profiler_end()
|
|
*
|
|
* LV_PROFILER_BEGIN_TAG(tag)
|
|
* Called at the start of a profiled scope with a string tag.
|
|
* e.g. #define LV_PROFILER_BEGIN_TAG(tag) my_profiler_begin_tag(tag)
|
|
*
|
|
* LV_PROFILER_END_TAG(tag)
|
|
* Called at the end of a profiled scope with a string tag.
|
|
* e.g. #define LV_PROFILER_END_TAG(tag) my_profiler_end_tag(tag)
|
|
*
|
|
* The default header provides these via the built-in profiler.
|
|
* Set this to your own header to use a custom profiler backend.
|
|
*/
|
|
#define LV_PROFILER_INCLUDE "lvgl/debugging/profiler/lv_profiler_builtin.h"
|
|
|
|
/** Layout */
|
|
#define LV_PROFILER_LAYOUT 1
|
|
|
|
/** Display refresh */
|
|
#define LV_PROFILER_REFR 1
|
|
|
|
/** Draw */
|
|
#define LV_PROFILER_DRAW 1
|
|
|
|
/** Input devices */
|
|
#define LV_PROFILER_INDEV 1
|
|
|
|
/** Image decoder */
|
|
#define LV_PROFILER_DECODER 1
|
|
|
|
/** Font */
|
|
#define LV_PROFILER_FONT 1
|
|
|
|
/** File system */
|
|
#define LV_PROFILER_FS 1
|
|
|
|
/** Style */
|
|
#define LV_PROFILER_STYLE 0
|
|
|
|
/** Timer */
|
|
#define LV_PROFILER_TIMER 1
|
|
|
|
/** Cache */
|
|
#define LV_PROFILER_CACHE 1
|
|
|
|
/** Events */
|
|
#define LV_PROFILER_EVENT 1
|
|
|
|
#endif /*LV_USE_PROFILER*/
|
|
|
|
/** Emulated input devices, time emulation, and screenshot compares. */
|
|
#define LV_USE_TEST 0
|
|
|
|
#if LV_USE_TEST
|
|
/** Enable `lv_test_screenshot_compare()`. Requires a few MB of extra RAM.
|
|
*
|
|
* Enable: LV_USE_LODEPNG
|
|
*/
|
|
#define LV_USE_TEST_SCREENSHOT_COMPARE 0
|
|
|
|
#if LV_USE_TEST_SCREENSHOT_COMPARE
|
|
/** When a reference image does not exist yet, create it from the rendered
|
|
* screen instead of failing the compare.
|
|
*/
|
|
#define LV_TEST_SCREENSHOT_CREATE_REFERENCE_IMAGE 1
|
|
|
|
#endif /*LV_USE_TEST_SCREENSHOT_COMPARE*/
|
|
|
|
#if LV_USE_DRAW_NANOVG
|
|
/** Render into an off-screen EGL pbuffer instead of a window and read the
|
|
* pixels back into the LVGL draw buffer, so screenshot compares work the
|
|
* same way as with the software renderer. Requires EGL and GLESv2.
|
|
*/
|
|
#define LV_USE_NANOVG_TEST_HEADLESS 0
|
|
|
|
#endif /*LV_USE_DRAW_NANOVG*/
|
|
#endif /*LV_USE_TEST*/
|
|
|
|
/** Feed random input events to the UI for stress testing. */
|
|
#define LV_USE_MONKEY 0
|
|
|
|
/** Draw random colored rectangles over the redrawn areas. */
|
|
#define LV_USE_REFR_DEBUG 0
|
|
|
|
/** Draw a red overlay over ARGB layers and a green overlay over RGB layers. */
|
|
#define LV_USE_LAYER_DEBUG 0
|
|
|
|
/** Draw an overlay in a different color for each draw unit's tasks, with the
|
|
* draw unit's index number on a white background (black for layers).
|
|
*/
|
|
#define LV_USE_PARALLEL_DRAW_DEBUG 0
|
|
|
|
|
|
|
|
/*============================================================================
|
|
* OTHERS
|
|
*============================================================================*/
|
|
|
|
/** Manage a widget subtree with its own lifecycle and back stack, similar to Android fragments. */
|
|
#define LV_USE_FRAGMENT 0
|
|
|
|
/** File explorer
|
|
*
|
|
* Enable: LV_USE_TABLE
|
|
*/
|
|
#define LV_USE_FILE_EXPLORER 0
|
|
|
|
#if LV_USE_FILE_EXPLORER
|
|
/** Maximum path length (bytes) */
|
|
#define LV_FILE_EXPLORER_PATH_MAX_LEN 128
|
|
|
|
/** Add a sidebar with shortcuts to common places. It can be hidden by clicking the
|
|
* button at the top left corner of the browsing area, which is useful on small screens.
|
|
*/
|
|
#define LV_FILE_EXPLORER_QUICK_ACCESS 1
|
|
|
|
#endif /*LV_USE_FILE_EXPLORER*/
|
|
|
|
|
|
/*============================================================================
|
|
* BUILD
|
|
*============================================================================*/
|
|
|
|
/** Include `lvgl_private.h` from `lvgl.h` so that LVGL internal data
|
|
* structures and functions are accessible by default.
|
|
*/
|
|
#define LV_USE_PRIVATE_API 0
|
|
|
|
/** By default, LVGL stores all runtime state in a single static
|
|
* 'lv_global_t' variable, sufficient for most single-display
|
|
* single-threaded applications.
|
|
*
|
|
* Enable this if you need multiple independent LVGL instances in
|
|
* the same process, for example:
|
|
* - Multiple physical displays with separate render loops
|
|
* - Per-thread LVGL contexts on an RTOS (FreeRTOS, Zephyr, etc.)
|
|
* - Hot-swappable or sandboxed UI instances
|
|
*
|
|
* When enabled, every LVGL internal access to global state goes
|
|
* through LV_GLOBAL_CUSTOM() instead of a static variable. You
|
|
* must implement 'lv_global_t *lv_global_default(void)' to return
|
|
* the correct instance for the current context (e.g. by thread-local
|
|
* storage or a guarded pointer switch).
|
|
*
|
|
* Returning NULL from that function is safe; LVGL will treat the
|
|
* library as uninitialized for that context.
|
|
*/
|
|
#define LV_ENABLE_GLOBAL_CUSTOM 0
|
|
|
|
#if LV_ENABLE_GLOBAL_CUSTOM
|
|
/** Use a custom header for the declaration of:
|
|
* lv_global_t *lv_global_default(void);
|
|
*/
|
|
#define LV_GLOBAL_USE_CUSTOM_INCLUDE 0
|
|
|
|
#if LV_GLOBAL_USE_CUSTOM_INCLUDE
|
|
/** Path to the header that declares:
|
|
* lv_global_t *lv_global_default(void);
|
|
*
|
|
* This header is included wherever LVGL needs to resolve the
|
|
* LV_GLOBAL_DEFAULT() macro. Keep it lightweight, it is included
|
|
* in performance-critical paths.
|
|
*/
|
|
#define LV_GLOBAL_CUSTOM_INCLUDE "lv_global.h"
|
|
|
|
#endif /*LV_GLOBAL_USE_CUSTOM_INCLUDE*/
|
|
#endif /*LV_ENABLE_GLOBAL_CUSTOM*/
|
|
|
|
/** NULL checks (very fast, recommended) */
|
|
#define LV_USE_ASSERT_NULL 1
|
|
|
|
/** Allocation success checks (very fast, recommended) */
|
|
#define LV_USE_ASSERT_MALLOC 1
|
|
|
|
/** Style init checks (very fast, recommended) */
|
|
#define LV_USE_ASSERT_STYLE 0
|
|
|
|
/** lv_mem integrity checks (slow) */
|
|
#define LV_USE_ASSERT_MEM_INTEGRITY 0
|
|
|
|
/** Widget validity checks (slow) */
|
|
#define LV_USE_ASSERT_OBJ 0
|
|
|
|
/** Disable warning saying `LV_ASSERT_HANDLER_INCLUDE` is deprecated.
|
|
* This setting allows you to keep using old LVGL versions which rely on
|
|
* LV_ASSERT_HANDLER_INCLUDE without triggering a compiler warning.
|
|
*
|
|
* LV_ASSERT_HANDLER_INCLUDE has been deprecated in favor of the new approach:
|
|
* define LV_ASSERT_CUSTOM_INCLUDE with the header path, and place the
|
|
* LV_ASSERT_HANDLER macro definition inside that header instead.
|
|
*
|
|
* Only enable this if you are maintaining compatibility with existing code
|
|
* that uses LV_ASSERT_HANDLER_INCLUDE and cannot migrate immediately.
|
|
* New projects should use LV_ASSERT_CUSTOM_INCLUDE and LV_ASSERT_HANDLER
|
|
* directly.
|
|
*/
|
|
#define LV_DISABLE_ASSERT_HANDLER_INCLUDE_WARNING 0
|
|
|
|
/** Include the header given by LV_ASSERT_CUSTOM_INCLUDE, which must define
|
|
* a custom LV_ASSERT_HANDLER.
|
|
*/
|
|
#define LV_ASSERT_USE_CUSTOM_INCLUDE 0
|
|
|
|
#if LV_ASSERT_USE_CUSTOM_INCLUDE
|
|
/** Optional header to override assert-related macros.
|
|
*
|
|
* LV_ASSERT_HANDLER
|
|
* Statement to execute when an assertion fails.
|
|
* e.g. #define LV_ASSERT_HANDLER my_assert_failed(__FILE__, __LINE__);
|
|
*/
|
|
#define LV_ASSERT_CUSTOM_INCLUDE ""
|
|
|
|
#endif /*LV_ASSERT_USE_CUSTOM_INCLUDE*/
|
|
|
|
/** LV_CHECK_ARG validates function arguments at runtime: a failed check
|
|
* logs a warning and executes the specified action. When disabled all
|
|
* these checks compile to nothing, which is only safe in very resource
|
|
* constrained environments where invariants are guaranteed to hold.
|
|
*/
|
|
#define LV_USE_CHECK_ARG 1
|
|
|
|
#if LV_USE_CHECK_ARG
|
|
/** Also invoke LV_ASSERT_HANDLER when an LV_CHECK_ARG check fails,
|
|
* before the action is executed.
|
|
*/
|
|
#define LV_CHECK_ARG_ASSERT_ON_FAIL 0
|
|
|
|
/** Controls what is logged when an LV_CHECK_ARG check fails.
|
|
* Minimal and Verbose require LV_USE_LOG; selecting either without it
|
|
* causes a compile-time error.
|
|
* Possible values:
|
|
* - LV_CHECK_ARG_LOG_MODE_NONE: no log output on failure
|
|
* - LV_CHECK_ARG_LOG_MODE_MINIMAL: log 'Check failed' only (file/line from LV_LOG_WARN) (requires LV_USE_LOG)
|
|
* - LV_CHECK_ARG_LOG_MODE_VERBOSE: log 'Check failed: <cond>' plus caller-supplied message (requires LV_USE_LOG)
|
|
*/
|
|
#define LV_CHECK_ARG_LOG_MODE LV_CHECK_ARG_LOG_MODE_NONE
|
|
|
|
/** LV_CHECK_OBJ verifies with lv_obj_has_class() that the object has the
|
|
* expected class. When disabled the check is skipped even if a class
|
|
* argument is supplied.
|
|
*/
|
|
#define LV_USE_CHECK_OBJ_CLASSTYPE 0
|
|
|
|
/** LV_CHECK_OBJ verifies with lv_obj_is_valid() that the object is still
|
|
* part of the widget tree. When disabled the check is skipped even if the
|
|
* associated argument is supplied.
|
|
*/
|
|
#define LV_USE_CHECK_OBJ_VALIDITY 0
|
|
|
|
#endif /*LV_USE_CHECK_ARG*/
|
|
|
|
|
|
/*============================================================================
|
|
* COMPILER SETTINGS
|
|
*============================================================================*/
|
|
|
|
/** Big endian system */
|
|
#define LV_BIG_ENDIAN_SYSTEM 0
|
|
|
|
/** Include the header given by LV_ATTRIBUTE_CUSTOM_INCLUDE to override the
|
|
* LV_ATTRIBUTE_* macros for your platform.
|
|
*/
|
|
#define LV_ATTRIBUTE_USE_CUSTOM_INCLUDE 0
|
|
|
|
#if LV_ATTRIBUTE_USE_CUSTOM_INCLUDE
|
|
/** Optional header to override LV_ATTRIBUTE_* macros for your platform.
|
|
* Leave empty to use defaults (all expand to nothing).
|
|
*
|
|
* Create a header file and set this to its path, e.g. "my_lv_attr.h".
|
|
* The following macros can be defined in it:
|
|
*
|
|
* LV_ATTRIBUTE_MEM_ALIGN
|
|
* Where memory needs to be aligned (e.g. with -Os, data may not be
|
|
* aligned to the required boundary by default).
|
|
* e.g. __attribute__((aligned(4)))
|
|
*
|
|
* LV_ATTRIBUTE_TICK_INC
|
|
* Applied to lv_tick_inc(). Often called from a timer ISR, so fast
|
|
* memory placement can reduce latency.
|
|
* e.g. __attribute__((section(".itcm"))) or __ramfunc (IAR)
|
|
*
|
|
* LV_ATTRIBUTE_TIMER_HANDLER
|
|
* Applied to lv_timer_handler().
|
|
* e.g. __attribute__((section(".itcm")))
|
|
*
|
|
* LV_ATTRIBUTE_FLUSH_READY
|
|
* Applied to lv_display_flush_ready(). Often called from a DMA or
|
|
* display ISR.
|
|
* e.g. __attribute__((section(".itcm")))
|
|
*
|
|
* LV_ATTRIBUTE_SYNC_READY
|
|
* Applied to lv_display_sync_ready(). Similar to FLUSH_READY, useful
|
|
* when called from an ISR context.
|
|
* e.g. __attribute__((section(".itcm")))
|
|
*
|
|
* LV_ATTRIBUTE_LARGE_CONST
|
|
* Applied to large read-only arrays such as font bitmaps. Use to place
|
|
* them in a specific flash region or external memory.
|
|
* e.g. __attribute__((section(".ext_flash")))
|
|
*
|
|
* LV_ATTRIBUTE_LARGE_RAM_ARRAY
|
|
* Applied to large arrays allocated in RAM.
|
|
* e.g. __attribute__((section(".ext_ram")))
|
|
*
|
|
* LV_ATTRIBUTE_FAST_MEM
|
|
* Applied to performance-critical functions to place them in faster
|
|
* memory such as ITCM or SRAM.
|
|
* e.g. __attribute__((section(".itcm"))) or __ramfunc (IAR)
|
|
*
|
|
* LV_ATTRIBUTE_EXTERN_DATA
|
|
* Prefix for all global extern data declarations. Useful for placing
|
|
* shared data in a named section or applying export attributes.
|
|
* e.g. __attribute__((section(".shared_mem")))
|
|
*
|
|
* LV_EXPORT_CONST_INT(int_value)
|
|
* Exports an integer constant to a language binding API such as
|
|
* MicroPython. Called for all constants in the form LV_<CONST>.
|
|
* Leave undefined if not using a binding.
|
|
* e.g. mp_rom_map_elem_t entry = {MP_ROM_QSTR(MP_QSTR_##int_value), MP_ROM_INT(int_value)}
|
|
*/
|
|
#define LV_ATTRIBUTE_CUSTOM_INCLUDE ""
|
|
|
|
#endif /*LV_ATTRIBUTE_USE_CUSTOM_INCLUDE*/
|
|
|
|
|
|
/*============================================================================
|
|
* EXAMPLES
|
|
*============================================================================*/
|
|
|
|
/** Build examples */
|
|
#define LV_BUILD_EXAMPLES 1
|
|
|
|
|
|
|
|
/*============================================================================
|
|
* DEMOS
|
|
*============================================================================*/
|
|
|
|
/** Build demos */
|
|
#define LV_BUILD_DEMOS 1
|
|
|
|
#if LV_BUILD_DEMOS
|
|
/** Benchmark demo
|
|
*
|
|
* Enable: LV_FONT_MONTSERRAT_14, LV_FONT_MONTSERRAT_20, LV_FONT_MONTSERRAT_24, LV_FONT_MONTSERRAT_26, LV_USE_DEMO_WIDGETS
|
|
*/
|
|
#define LV_USE_DEMO_BENCHMARK 0
|
|
|
|
#if LV_USE_DEMO_BENCHMARK
|
|
/** Use the demo's own Montserrat fonts with aligned glyph bitmaps instead
|
|
* of the LV_FONT_MONTSERRAT_* fonts.
|
|
*/
|
|
#define LV_DEMO_BENCHMARK_ALIGNED_FONTS 0
|
|
|
|
#endif /*LV_USE_DEMO_BENCHMARK*/
|
|
|
|
#if LV_USE_GLTF
|
|
/** glTF demo */
|
|
#define LV_USE_DEMO_GLTF 0
|
|
|
|
#endif /*LV_USE_GLTF*/
|
|
|
|
/** Keypad and encoder demo */
|
|
#define LV_USE_DEMO_KEYPAD_AND_ENCODER 0
|
|
|
|
/** Music player demo */
|
|
#define LV_USE_DEMO_MUSIC 0
|
|
|
|
#if LV_USE_DEMO_MUSIC
|
|
/** Square layout */
|
|
#define LV_DEMO_MUSIC_SQUARE 0
|
|
|
|
/** Landscape layout */
|
|
#define LV_DEMO_MUSIC_LANDSCAPE 0
|
|
|
|
/** Round layout */
|
|
#define LV_DEMO_MUSIC_ROUND 0
|
|
|
|
/** Large layout */
|
|
#define LV_DEMO_MUSIC_LARGE 0
|
|
|
|
/** Auto play */
|
|
#define LV_DEMO_MUSIC_AUTO_PLAY 0
|
|
|
|
#endif /*LV_USE_DEMO_MUSIC*/
|
|
|
|
/** Renders each drawing primitive for visual comparison.
|
|
* Requires a display of at least 480x272.
|
|
*
|
|
* Enable: LV_USE_GRID
|
|
*/
|
|
#define LV_USE_DEMO_RENDER 0
|
|
|
|
/** Stress demo */
|
|
#define LV_USE_DEMO_STRESS 0
|
|
|
|
/** Vector graphic demo
|
|
*
|
|
* Enable: LV_USE_VECTOR_GRAPHIC
|
|
*/
|
|
#define LV_USE_DEMO_VECTOR_GRAPHIC 0
|
|
|
|
/** Widgets demo */
|
|
#define LV_USE_DEMO_WIDGETS 0
|
|
|
|
/** Flex layout demo */
|
|
#define LV_USE_DEMO_FLEX_LAYOUT 0
|
|
|
|
/** Multi-language demo */
|
|
#define LV_USE_DEMO_MULTILANG 0
|
|
|
|
/** Smartwatch demo */
|
|
#define LV_USE_DEMO_SMARTWATCH 0
|
|
|
|
/** E-bike demo */
|
|
#define LV_USE_DEMO_EBIKE 0
|
|
|
|
#if LV_USE_DEMO_EBIKE
|
|
/** Portrait layout */
|
|
#define LV_DEMO_EBIKE_PORTRAIT 0
|
|
|
|
#endif /*LV_USE_DEMO_EBIKE*/
|
|
|
|
/** High resolution demo */
|
|
#define LV_USE_DEMO_HIGH_RES 0
|
|
|
|
#endif /*LV_BUILD_DEMOS*/
|
|
|
|
|
|
/*--END OF LV_CONF_H--*/
|
|
|
|
#endif /*LV_CONF_H*/
|
|
|
|
#endif /*End of "Content enable"*/
|