lv_conf_internal.h

LV_OS_NONE

#define LV_OS_NONE 0

LV_OS_PTHREAD

#define LV_OS_PTHREAD 1

LV_OS_FREERTOS

#define LV_OS_FREERTOS 2

LV_OS_CMSIS_RTOS2

#define LV_OS_CMSIS_RTOS2 3

LV_OS_RTTHREAD

#define LV_OS_RTTHREAD 4

LV_OS_WINDOWS

#define LV_OS_WINDOWS 5

LV_OS_MQX

#define LV_OS_MQX 6

LV_OS_SDL2

#define LV_OS_SDL2 7

LV_OS_CUSTOM

#define LV_OS_CUSTOM 255

LV_STDLIB_BUILTIN

#define LV_STDLIB_BUILTIN 0

LV_STDLIB_CLIB

#define LV_STDLIB_CLIB 1

LV_STDLIB_MICROPYTHON

#define LV_STDLIB_MICROPYTHON 2

LV_STDLIB_RTTHREAD

#define LV_STDLIB_RTTHREAD 3

LV_STDLIB_CUSTOM

#define LV_STDLIB_CUSTOM 255

LV_DRAW_SW_ASM_NONE

#define LV_DRAW_SW_ASM_NONE 0

LV_DRAW_SW_ASM_NEON

#define LV_DRAW_SW_ASM_NEON 1

LV_DRAW_SW_ASM_HELIUM

#define LV_DRAW_SW_ASM_HELIUM 2

LV_DRAW_SW_ASM_RISCV_V

#define LV_DRAW_SW_ASM_RISCV_V 3

LV_DRAW_SW_ASM_CUSTOM

#define LV_DRAW_SW_ASM_CUSTOM 255

LV_NEMA_LIB_NONE

#define LV_NEMA_LIB_NONE 0

LV_NEMA_LIB_M33_REVC

#define LV_NEMA_LIB_M33_REVC 1

LV_NEMA_LIB_M33_NEMAPVG

#define LV_NEMA_LIB_M33_NEMAPVG 2

LV_NEMA_LIB_M55

#define LV_NEMA_LIB_M55 3

LV_NEMA_LIB_M7

#define LV_NEMA_LIB_M7 4

LV_NEMA_HAL_CUSTOM

#define LV_NEMA_HAL_CUSTOM 0

LV_NEMA_HAL_STM32

#define LV_NEMA_HAL_STM32 1

LV_NANOVG_BACKEND_GL2

#define LV_NANOVG_BACKEND_GL2 1

LV_NANOVG_BACKEND_GL3

#define LV_NANOVG_BACKEND_GL3 2

LV_NANOVG_BACKEND_GLES2

#define LV_NANOVG_BACKEND_GLES2 3

LV_NANOVG_BACKEND_GLES3

#define LV_NANOVG_BACKEND_GLES3 4

LV_COLOR_DEPTH

#define LV_COLOR_DEPTH 16

Handle special Kconfig options. Color depth: 1 (I1), 8 (L8), 16 (RGB565), 24 (RGB888), 32 (XRGB8888)

LV_STDINT_INCLUDE

#define LV_STDINT_INCLUDE <stdint.h>

Possible values

• LV_STDLIB_BUILTIN: LVGL's built in implementation
• LV_STDLIB_CLIB: Standard C functions, like malloc, strlen, etc
• LV_STDLIB_MICROPYTHON: MicroPython implementation
• LV_STDLIB_RTTHREAD: RT-Thread implementation
• LV_STDLIB_CUSTOM: Implement the functions externally Possible values
• LV_STDLIB_BUILTIN: LVGL's built in implementation
• LV_STDLIB_CLIB: Standard C functions, like malloc, strlen, etc
• LV_STDLIB_MICROPYTHON: MicroPython implementation
• LV_STDLIB_RTTHREAD: RT-Thread implementation
• LV_STDLIB_CUSTOM: Implement the functions externally Possible values
• LV_STDLIB_BUILTIN: LVGL's built in implementation
• LV_STDLIB_CLIB: Standard C functions, like malloc, strlen, etc
• LV_STDLIB_MICROPYTHON: MicroPython implementation
• LV_STDLIB_RTTHREAD: RT-Thread implementation
• LV_STDLIB_CUSTOM: Implement the functions externally

LV_STDDEF_INCLUDE

#define LV_STDDEF_INCLUDE <stddef.h>

LV_STDBOOL_INCLUDE

#define LV_STDBOOL_INCLUDE <stdbool.h>

LV_INTTYPES_INCLUDE

#define LV_INTTYPES_INCLUDE <inttypes.h>

LV_LIMITS_INCLUDE

#define LV_LIMITS_INCLUDE <limits.h>

LV_STDARG_INCLUDE

#define LV_STDARG_INCLUDE <stdarg.h>

LV_DEF_REFR_PERIOD

#define LV_DEF_REFR_PERIOD 33

Default display refresh, input device read and animation step period. [ms]

LV_DPI_DEF

#define LV_DPI_DEF 130

Default Dots 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.) [px/inch]

LV_DRAW_BUF_STRIDE_ALIGN

#define LV_DRAW_BUF_STRIDE_ALIGN 1

Select operating system to use. Possible options:

• LV_OS_NONE
• LV_OS_PTHREAD
• LV_OS_FREERTOS
• LV_OS_CMSIS_RTOS2
• LV_OS_RTTHREAD
• LV_OS_WINDOWS
• LV_OS_MQX
• LV_OS_SDL2
• LV_OS_CUSTOM Align stride of all layers and images to this bytes

LV_DRAW_BUF_ALIGN

#define LV_DRAW_BUF_ALIGN 4

Align start address of draw_buf addresses to this bytes

LV_DRAW_TRANSFORM_USE_MATRIX

#define LV_DRAW_TRANSFORM_USE_MATRIX 0

Using matrix for transformations. Requirements:

• LV_USE_MATRIX = 1.
• Rendering engine needs to support 3x3 matrix transformations.

LV_DRAW_LAYER_SIMPLE_BUF_SIZE

#define LV_DRAW_LAYER_SIMPLE_BUF_SIZE (24 * 1024)

The target buffer size for simple layer chunks. [bytes]

LV_DRAW_LAYER_MAX_MEMORY

#define LV_DRAW_LAYER_MAX_MEMORY 0

No limit by default [bytes]

LV_DRAW_THREAD_STACK_SIZE

#define LV_DRAW_THREAD_STACK_SIZE (8 * 1024)

Stack size of drawing thread. NOTE: If FreeType or ThorVG is enabled, it is recommended to set it to 32KB or more. [bytes]

LV_DRAW_THREAD_PRIO

#define LV_DRAW_THREAD_PRIO LV_THREAD_PRIO_HIGH

Thread priority of the drawing task. Higher values mean higher priority. Can use values from lv_thread_prio_t enum in lv_os.h: LV_THREAD_PRIO_LOWEST, LV_THREAD_PRIO_LOW, LV_THREAD_PRIO_MID, LV_THREAD_PRIO_HIGH, LV_THREAD_PRIO_HIGHEST Make sure the priority value aligns with the OS-specific priority levels. On systems with limited priority levels (e.g., FreeRTOS), a higher value can improve rendering performance but might cause other tasks to starve.

LV_DRAW_SW_SUPPORT_RGB565

#define LV_DRAW_SW_SUPPORT_RGB565 1

LV_DRAW_SW_SUPPORT_RGB565_SWAPPED

#define LV_DRAW_SW_SUPPORT_RGB565_SWAPPED 1

LV_DRAW_SW_SUPPORT_RGB565A8

#define LV_DRAW_SW_SUPPORT_RGB565A8 1

LV_DRAW_SW_SUPPORT_RGB888

#define LV_DRAW_SW_SUPPORT_RGB888 1

LV_DRAW_SW_SUPPORT_XRGB8888

#define LV_DRAW_SW_SUPPORT_XRGB8888 1

LV_DRAW_SW_SUPPORT_ARGB8888

#define LV_DRAW_SW_SUPPORT_ARGB8888 1

LV_DRAW_SW_SUPPORT_ARGB8888_PREMULTIPLIED

#define LV_DRAW_SW_SUPPORT_ARGB8888_PREMULTIPLIED 1

LV_DRAW_SW_SUPPORT_L8

#define LV_DRAW_SW_SUPPORT_L8 1

LV_DRAW_SW_SUPPORT_AL88

#define LV_DRAW_SW_SUPPORT_AL88 1

LV_DRAW_SW_SUPPORT_A8

#define LV_DRAW_SW_SUPPORT_A8 1

LV_DRAW_SW_SUPPORT_I1

#define LV_DRAW_SW_SUPPORT_I1 1

LV_DRAW_SW_I1_LUM_THRESHOLD

#define LV_DRAW_SW_I1_LUM_THRESHOLD 127

LV_DRAW_SW_DRAW_UNIT_CNT

#define LV_DRAW_SW_DRAW_UNIT_CNT 1

Set number of draw units.

• > 1 requires operating system to be enabled in LV_USE_OS.
• > 1 means multiple threads will render the screen in parallel.

LV_DRAW_SW_COMPLEX

#define LV_DRAW_SW_COMPLEX 1

Use Arm-2D to accelerate software (sw) rendering. Enable native helium assembly to be compiled.

• 0: Use a simple renderer capable of drawing only simple rectangles with gradient, images, text, and straight lines only.
• 1: Use a complex renderer capable of drawing rounded corners, shadow, skew lines, and arcs too.

LV_DRAW_SW_SHADOW_CACHE_SIZE

#define LV_DRAW_SW_SHADOW_CACHE_SIZE 0

Allow buffering some shadow calculation. LV_DRAW_SW_SHADOW_CACHE_SIZE is the maximum shadow size to buffer, where shadow size is shadow_width + radius. Caching has LV_DRAW_SW_SHADOW_CACHE_SIZE^2 RAM cost.

LV_DRAW_SW_CIRCLE_CACHE_SIZE

#define LV_DRAW_SW_CIRCLE_CACHE_SIZE 4

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: disables caching

LV_USE_NEMA_HAL

#define LV_USE_NEMA_HAL LV_NEMA_HAL_CUSTOM

Enable drawing complex gradients in software: linear at an angle, radial or conical Select which NemaGFX static library headers to use. Possible options:

• LV_NEMA_LIB_NONE an alias of LV_NEMA_LIB_M33_REVC
• LV_NEMA_LIB_M33_REVC
• LV_NEMA_LIB_M33_NEMAPVG
• LV_NEMA_LIB_M55
• LV_NEMA_LIB_M7 You must also take care to link the correct corresponding static library in libs/nema_gfx/lib/core/ Select which NemaGFX HAL to use. Possible options:
• LV_NEMA_HAL_CUSTOM
• LV_NEMA_HAL_STM32

LV_NEMA_GFX_MAX_RESX

#define LV_NEMA_GFX_MAX_RESX 800

LV_NEMA_GFX_MAX_RESY

#define LV_NEMA_GFX_MAX_RESY 600

LV_USE_PXP_DRAW_THREAD

#define LV_USE_PXP_DRAW_THREAD 1

Use NXP's PXP on iMX RTxxx platforms. Use PXP for drawing. Use PXP to rotate display. Use additional draw thread for PXP processing.

LV_USE_DRAW_G2D

#define LV_USE_DRAW_G2D 1

Enable PXP asserts. Use NXP's G2D on MPU platforms. Use G2D for drawing.

LV_G2D_HASH_TABLE_SIZE

#define LV_G2D_HASH_TABLE_SIZE 50

Maximum number of buffers that can be stored for G2D draw unit. Includes the frame buffers and assets.

LV_USE_G2D_DRAW_THREAD

#define LV_USE_G2D_DRAW_THREAD 1

Use additional draw thread for G2D processing.

LV_VG_LITE_USE_GPU_INIT

#define LV_VG_LITE_USE_GPU_INIT 0

Enable G2D asserts. Use Renesas Dave2D on RA platforms. Draw using cached SDL textures Use VG-Lite GPU. Enable VG-Lite custom external 'gpu_init()' function

LV_VG_LITE_USE_ASSERT

#define LV_VG_LITE_USE_ASSERT 0

Enable VG-Lite assert.

LV_VG_LITE_FLUSH_MAX_COUNT

#define LV_VG_LITE_FLUSH_MAX_COUNT 8

VG-Lite flush commit trigger threshold. GPU will try to batch these many draw tasks.

LV_VG_LITE_USE_BOX_SHADOW

#define LV_VG_LITE_USE_BOX_SHADOW 1

Enable border to simulate shadow. NOTE: which usually improves performance, but does not guarantee the same rendering quality as the software.

LV_VG_LITE_GRAD_CACHE_CNT

#define LV_VG_LITE_GRAD_CACHE_CNT 32

VG-Lite gradient maximum cache number.

LV_VG_LITE_STROKE_CACHE_CNT

#define LV_VG_LITE_STROKE_CACHE_CNT 32

VG-Lite stroke maximum cache number.

LV_VG_LITE_BITMAP_FONT_CACHE_CNT

#define LV_VG_LITE_BITMAP_FONT_CACHE_CNT 256

VG-Lite unaligned bitmap font maximum cache number.

LV_VG_LITE_DISABLE_VLC_OP_CLOSE

#define LV_VG_LITE_DISABLE_VLC_OP_CLOSE 0

Remove VLC_OP_CLOSE path instruction (Workaround for NXP)

LV_VG_LITE_DISABLE_BLIT_RECT_OFFSET

#define LV_VG_LITE_DISABLE_BLIT_RECT_OFFSET 0

Disable blit rectangular offset to resolve certain hardware errors.

LV_VG_LITE_DISABLE_LINEAR_GRADIENT_EXT

#define LV_VG_LITE_DISABLE_LINEAR_GRADIENT_EXT 0

Disable linear gradient extension for some older versions of drivers.

LV_VG_LITE_PATH_DUMP_MAX_LEN

#define LV_VG_LITE_PATH_DUMP_MAX_LEN 1000

Maximum path dump print length (in points)

LV_VG_LITE_HAL_GPU_SERIES

#define LV_VG_LITE_HAL_GPU_SERIES gc255

Enable usage of the LVGL's built-in vg_lite driver Used to pick the correct GPU series folder valid options are gc255, gc355 and gc555

LV_VG_LITE_HAL_GPU_REVISION

#define LV_VG_LITE_HAL_GPU_REVISION 0x40

Used to pick the correct GPU revision header it depends on the vendor

LV_VG_LITE_HAL_GPU_BASE_ADDRESS

#define LV_VG_LITE_HAL_GPU_BASE_ADDRESS 0x40240000

Base memory address of the GPU IP it depends on SoC, default value is for NXP based devices

LV_VG_LITE_THORVG_LVGL_BLEND_SUPPORT

#define LV_VG_LITE_THORVG_LVGL_BLEND_SUPPORT 0

Use ThorVG (a software vector library) as VG-Lite driver to allow testing VGLite on PC Requires: LV_USE_THORVG_INTERNAL or LV_USE_THORVG_EXTERNAL Enable LVGL's blend mode support

LV_VG_LITE_THORVG_YUV_SUPPORT

#define LV_VG_LITE_THORVG_YUV_SUPPORT 0

Enable YUV color format support

LV_VG_LITE_THORVG_LINEAR_GRADIENT_EXT_SUPPORT

#define LV_VG_LITE_THORVG_LINEAR_GRADIENT_EXT_SUPPORT 0

Enable Linear gradient extension support

LV_VG_LITE_THORVG_16PIXELS_ALIGN

#define LV_VG_LITE_THORVG_16PIXELS_ALIGN 1

Enable alignment on 16 pixels

LV_VG_LITE_THORVG_BUF_ADDR_ALIGN

#define LV_VG_LITE_THORVG_BUF_ADDR_ALIGN 64

Buffer address alignment

LV_VG_LITE_THORVG_THREAD_RENDER

#define LV_VG_LITE_THORVG_THREAD_RENDER 0

Enable multi-thread render

LV_DRAW_DMA2D_HAL_INCLUDE

#define LV_DRAW_DMA2D_HAL_INCLUDE "stm32h7xx_hal.h"

Accelerate blends, fills, etc. with STM32 DMA2D

LV_DRAW_OPENGLES_TEXTURE_CACHE_COUNT

#define LV_DRAW_OPENGLES_TEXTURE_CACHE_COUNT 64

Draw using cached OpenGLES textures. Requires LV_USE_OPENGLES

LV_USE_PPA_IMG

#define LV_USE_PPA_IMG 0

Draw using espressif PPA accelerator

LV_PPA_BURST_LENGTH

#define LV_PPA_BURST_LENGTH 128

LV_DRAW_EVE_EVE_GENERATION

#define LV_DRAW_EVE_EVE_GENERATION 4

LV_DRAW_EVE_WRITE_BUFFER_SIZE

#define LV_DRAW_EVE_WRITE_BUFFER_SIZE 2048

LV_NANOVG_BACKEND

#define LV_NANOVG_BACKEND LV_NANOVG_BACKEND_GLES2

Use NanoVG Renderer

• Requires LV_USE_NANOVG, LV_USE_MATRIX. Select OpenGL backend for NanoVG:
• 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+

LV_NANOVG_IMAGE_CACHE_CNT

#define LV_NANOVG_IMAGE_CACHE_CNT 128

Draw image texture cache count.

LV_NANOVG_LETTER_CACHE_CNT

#define LV_NANOVG_LETTER_CACHE_CNT 512

Draw letter texture cache count.

LV_LOG_LEVEL

#define LV_LOG_LEVEL LV_LOG_LEVEL_WARN

Enable log module Set value to one of the following levels of logging detail:

• LV_LOG_LEVEL_TRACE Log 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 Log only critical issues, when system may fail.
• LV_LOG_LEVEL_USER Log only custom log messages added by the user.
• LV_LOG_LEVEL_NONE Do not log anything.

LV_LOG_PRINTF

#define LV_LOG_PRINTF 0

• 1: Print log with 'printf';
• 0: User needs to register a callback with lv_log_register_print_cb().

LV_LOG_USE_TIMESTAMP

#define LV_LOG_USE_TIMESTAMP 1

Set callback to print logs. E.g my_print. The prototype should be void my_print(lv_log_level_t level, const char * buf). Can be overwritten by lv_log_register_print_cb.

• 1: Enable printing timestamp;
• 0: Disable printing timestamp.

LV_LOG_USE_FILE_LINE

#define LV_LOG_USE_FILE_LINE 1

• 1: Print file and line number of the log;
• 0: Do not print file and line number of the log.

LV_LOG_TRACE_MEM

#define LV_LOG_TRACE_MEM 1

Enable/disable trace logs in memory operations.

LV_LOG_TRACE_TIMER

#define LV_LOG_TRACE_TIMER 1

Enable/disable trace logs in timer operations.

LV_LOG_TRACE_INDEV

#define LV_LOG_TRACE_INDEV 1

Enable/disable trace logs in input device operations.

LV_LOG_TRACE_DISP_REFR

#define LV_LOG_TRACE_DISP_REFR 1

Enable/disable trace logs in display re-draw operations.

LV_LOG_TRACE_EVENT

#define LV_LOG_TRACE_EVENT 1

Enable/disable trace logs in event dispatch logic.

LV_LOG_TRACE_OBJ_CREATE

#define LV_LOG_TRACE_OBJ_CREATE 1

Enable/disable trace logs in object creation (core obj creation plus every widget).

LV_LOG_TRACE_LAYOUT

#define LV_LOG_TRACE_LAYOUT 1

Enable/disable trace logs in flex- and grid-layout operations.

LV_LOG_TRACE_ANIM

#define LV_LOG_TRACE_ANIM 1

Enable/disable trace logs in animation logic.

LV_LOG_TRACE_CACHE

#define LV_LOG_TRACE_CACHE 1

Enable/disable trace logs in cache operations.

LV_ASSERT_HANDLER_INCLUDE

#define LV_ASSERT_HANDLER_INCLUDE <stdint.h>

Add a custom handler when assert happens e.g. to restart MCU.

LV_ASSERT_HANDLER

#define LV_ASSERT_HANDLER while(1);

Halt by default

LV_USE_CHECK_ARG

#define LV_USE_CHECK_ARG 1

Enable LV_CHECK_ARG macro to validate function arguments at runtime. When enabled, failed checks log a warning and execute the specified action. 0: Disable all LV_CHECK_ARG checks (checks compile to nothing) 1: Enable LV_CHECK_ARG checks

LV_CHECK_ARG_ASSERT_ON_FAIL

#define LV_CHECK_ARG_ASSERT_ON_FAIL 0

If enabled, also call LV_ASSERT_HANDLER when an LV_CHECK_ARG check fails. Requires LV_USE_CHECK_ARG to be enabled.

LV_ENABLE_GLOBAL_CUSTOM

#define LV_ENABLE_GLOBAL_CUSTOM 0

1: Draw random colored rectangles over the redrawn areas. 1: Draw a red overlay for ARGB layers and a green overlay for RGB layers 1: Adds the following behaviors for debugging:

• Draw overlays with different colors for each draw_unit's tasks.
• Draw index number of draw unit on white background.
• For layers, draws index number of draw unit on black background.

LV_CACHE_DEF_SIZE

#define LV_CACHE_DEF_SIZE 0

Default cache size in bytes. Used by image decoders such as lv_lodepng to keep the decoded image in memory. If size is not set to 0, the decoder will fail to decode when the cache is full. If size is 0, the cache function is not enabled and the decoded memory will be released immediately after use.

LV_IMAGE_HEADER_CACHE_DEF_CNT

#define LV_IMAGE_HEADER_CACHE_DEF_CNT 0

Default number of image header cache entries. The cache is used to store the headers of images The main logic is like LV_CACHE_DEF_SIZE but for image headers.

LV_GRADIENT_MAX_STOPS

#define LV_GRADIENT_MAX_STOPS 2

Number of stops allowed per gradient. Increase this to allow more stops. This adds (sizeof(lv_color_t) + 1) bytes per additional stop.

LV_COLOR_MIX_ROUND_OFS

#define LV_COLOR_MIX_ROUND_OFS 0

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

LV_OBJ_STYLE_CACHE

#define LV_OBJ_STYLE_CACHE 0

Add 2 x 32-bit variables to each lv_obj_t to speed up getting style properties

LV_OBJ_ID_AUTO_ASSIGN

#define LV_OBJ_ID_AUTO_ASSIGN LV_USE_OBJ_ID

Add id field to lv_obj_t Enable support widget names Automatically assign an ID when obj is created

LV_BIG_ENDIAN_SYSTEM

#define LV_BIG_ENDIAN_SYSTEM 0

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. Use obj property set/get API. Enable property name support. For big endian systems set to 1

LV_ATTRIBUTE_SYNC_READY

#define LV_ATTRIBUTE_SYNC_READY

Define a custom attribute for lv_tick_inc function Define a custom attribute for lv_timer_handler function Define a custom attribute for lv_display_flush_ready function Define a custom attribute for lv_display_sync_ready function

LV_ATTRIBUTE_MEM_ALIGN_SIZE

#define LV_ATTRIBUTE_MEM_ALIGN_SIZE 1

Align VG_LITE buffers on this number of bytes.

LV_EXPORT_CONST_INT

#define LV_EXPORT_CONST_INT(int_value) \
    struct _silence_gcc_warning

Will be added where memory needs to be aligned (with -Os data might not be aligned to boundary by default). E.g. attribute((aligned(4))) Attribute to mark large constant arrays, for example for font bitmaps Compiler prefix for a large array declaration in RAM Place performance critical functions into a faster memory (e.g RAM) Export integer constant to binding. This macro is used with constants in the form of LV_<CONST> that should also appear on LVGL binding API such as MicroPython. The default value just prevents GCC warning

LV_FONT_MONTSERRAT_8

#define LV_FONT_MONTSERRAT_8 0

Prefix all global extern data with this Use float as lv_value_precise_t Enable matrix support

• Requires LV_USE_FLOAT = 1 Include lvgl_private.h in lvgl.h to access internal data and functions by default

LV_FONT_MONTSERRAT_10

#define LV_FONT_MONTSERRAT_10 0

LV_FONT_MONTSERRAT_12

#define LV_FONT_MONTSERRAT_12 0

LV_FONT_MONTSERRAT_14

#define LV_FONT_MONTSERRAT_14 1

LV_FONT_MONTSERRAT_16

#define LV_FONT_MONTSERRAT_16 0

LV_FONT_MONTSERRAT_18

#define LV_FONT_MONTSERRAT_18 0

LV_FONT_MONTSERRAT_20

#define LV_FONT_MONTSERRAT_20 0

LV_FONT_MONTSERRAT_22

#define LV_FONT_MONTSERRAT_22 0

LV_FONT_MONTSERRAT_24

#define LV_FONT_MONTSERRAT_24 0

LV_FONT_MONTSERRAT_26

#define LV_FONT_MONTSERRAT_26 0

LV_FONT_MONTSERRAT_28

#define LV_FONT_MONTSERRAT_28 0

LV_FONT_MONTSERRAT_30

#define LV_FONT_MONTSERRAT_30 0

LV_FONT_MONTSERRAT_32

#define LV_FONT_MONTSERRAT_32 0

LV_FONT_MONTSERRAT_34

#define LV_FONT_MONTSERRAT_34 0

LV_FONT_MONTSERRAT_36

#define LV_FONT_MONTSERRAT_36 0

LV_FONT_MONTSERRAT_38

#define LV_FONT_MONTSERRAT_38 0

LV_FONT_MONTSERRAT_40

#define LV_FONT_MONTSERRAT_40 0

LV_FONT_MONTSERRAT_42

#define LV_FONT_MONTSERRAT_42 0

LV_FONT_MONTSERRAT_44

#define LV_FONT_MONTSERRAT_44 0

LV_FONT_MONTSERRAT_46

#define LV_FONT_MONTSERRAT_46 0

LV_FONT_MONTSERRAT_48

#define LV_FONT_MONTSERRAT_48 0

LV_FONT_MONTSERRAT_28_COMPRESSED

#define LV_FONT_MONTSERRAT_28_COMPRESSED 0

bpp = 3

LV_FONT_DEJAVU_16_PERSIAN_HEBREW

#define LV_FONT_DEJAVU_16_PERSIAN_HEBREW 0

Hebrew, Arabic, Persian letters and all their forms

LV_FONT_SOURCE_HAN_SANS_SC_14_CJK

#define LV_FONT_SOURCE_HAN_SANS_SC_14_CJK 0

1338 most common CJK radicals

LV_FONT_SOURCE_HAN_SANS_SC_16_CJK

#define LV_FONT_SOURCE_HAN_SANS_SC_16_CJK 0

1338 most common CJK radicals

LV_FONT_UNSCII_8

#define LV_FONT_UNSCII_8 0

Pixel perfect monospaced fonts

LV_FONT_UNSCII_16

#define LV_FONT_UNSCII_16 0

LV_FONT_CUSTOM_DECLARE

#define LV_FONT_CUSTOM_DECLARE

Optionally declare custom fonts here.

You can use any of these fonts as the default font too and they will be available globally. Example:

#define LV_FONT_CUSTOM_DECLARE   LV_FONT_DECLARE(my_font_1) LV_FONT_DECLARE(my_font_2)

LV_FONT_DEFAULT

#define LV_FONT_DEFAULT &lv_font_montserrat_14

Always set a default font

LV_FONT_FMT_TXT_LARGE

#define LV_FONT_FMT_TXT_LARGE 0

Enable handling large font and/or fonts with a lot of characters. The limit depends on the font size, font face and bpp. A compiler error will be triggered if a font needs it.

LV_TXT_ENC

#define LV_TXT_ENC LV_TXT_ENC_UTF8

Enables/disables support for compressed fonts. Enable drawing placeholders when glyph dsc is not found. Select a character encoding for strings. Your IDE or editor should have the same character encoding.

• LV_TXT_ENC_UTF8
• LV_TXT_ENC_ASCII

LV_TXT_BREAK_CHARS

#define LV_TXT_BREAK_CHARS " ,.;:-_)]}"

While rendering text strings, break (wrap) text on these chars.

LV_TXT_LINE_BREAK_LONG_LEN

#define LV_TXT_LINE_BREAK_LONG_LEN 0

If a word is at least this long, will break wherever "prettiest". To disable, set to a value <= 0.

LV_TXT_LINE_BREAK_LONG_PRE_MIN_LEN

#define LV_TXT_LINE_BREAK_LONG_PRE_MIN_LEN 3

Minimum number of characters in a long word to put on a line before a break. Depends on LV_TXT_LINE_BREAK_LONG_LEN.

LV_TXT_LINE_BREAK_LONG_POST_MIN_LEN

#define LV_TXT_LINE_BREAK_LONG_POST_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.

LV_BIDI_BASE_DIR_DEF

#define LV_BIDI_BASE_DIR_DEF LV_BASE_DIR_AUTO

Support bidirectional text. Allows mixing Left-to-Right and Right-to-Left text. The direction will be processed according to the Unicode Bidirectional Algorithm: https://www.w3.org/International/articles/inline-bidi-markup/uba-basics

LV_TXT_COLOR_CMD

#define LV_TXT_COLOR_CMD "#"

Enable Arabic/Persian processing In these languages characters should be replaced with another form based on their position in the text

LV_WIDGETS_HAS_DEFAULT_VALUE

#define LV_WIDGETS_HAS_DEFAULT_VALUE 1

1: 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.

LV_CALENDAR_WEEK_STARTS_MONDAY

#define LV_CALENDAR_WEEK_STARTS_MONDAY 0

LV_CALENDAR_DEFAULT_DAY_NAMES

#define LV_CALENDAR_DEFAULT_DAY_NAMES {"Su", "Mo", "Tu", "We", "Th", "Fr", "Sa"}

LV_CALENDAR_DEFAULT_MONTH_NAMES

#define LV_CALENDAR_DEFAULT_MONTH_NAMES {"January", "February", "March",  "April", "May",  "June", "July", "August", "September", "October", "November", "December"}

LV_LABEL_TEXT_SELECTION

#define LV_LABEL_TEXT_SELECTION 1

Enable selecting text of the label

LV_LABEL_LONG_TXT_HINT

#define LV_LABEL_LONG_TXT_HINT 1

Store some extra info in labels to speed up drawing of very long text

LV_LABEL_WAIT_CHAR_COUNT

#define LV_LABEL_WAIT_CHAR_COUNT 3

The count of wait chart

LV_SPAN_SNIPPET_STACK_SIZE

#define LV_SPAN_SNIPPET_STACK_SIZE 64

A line of text can contain this maximum number of span descriptors.

LV_TEXTAREA_DEF_PWD_SHOW_TIME

#define LV_TEXTAREA_DEF_PWD_SHOW_TIME 1500

[ms]

LV_THEME_DEFAULT_DARK

#define LV_THEME_DEFAULT_DARK 0

A simple, impressive and very complete theme 0: Light mode; 1: Dark mode

LV_THEME_DEFAULT_GROW

#define LV_THEME_DEFAULT_GROW 1

1: Enable grow on press

LV_THEME_DEFAULT_TRANSITION_TIME

#define LV_THEME_DEFAULT_TRANSITION_TIME 80

Default transition time in ms.

LV_FS_DEFAULT_DRIVER_LETTER

#define LV_FS_DEFAULT_DRIVER_LETTER '\0'

A very simple theme that is a good starting point for a custom theme A theme designed for monochrome displays A layout similar to Flexbox in CSS. A layout similar to Grid in CSS. Setting a default driver letter allows skipping the driver prefix in filepaths. Documentation about how to use the below driver-identifier letters can be found at https://docs.lvgl.io/master/main-modules/fs.html#lv-fs-identifier-letters .

LV_FS_STDIO_LETTER

#define LV_FS_STDIO_LETTER '\0'

API for fopen, fread, etc. Set an upper-case driver-identifier letter for this driver (e.g. 'A').

LV_FS_STDIO_PATH

#define LV_FS_STDIO_PATH ""

Set the working directory. File/directory paths will be appended to it.

LV_FS_STDIO_CACHE_SIZE

#define LV_FS_STDIO_CACHE_SIZE 0

>0 to cache this number of bytes in lv_fs_read()

LV_FS_POSIX_LETTER

#define LV_FS_POSIX_LETTER '\0'

API for open, read, etc. Set an upper-case driver-identifier letter for this driver (e.g. 'A').

LV_FS_POSIX_PATH

#define LV_FS_POSIX_PATH ""

Set the working directory. File/directory paths will be appended to it.

LV_FS_POSIX_CACHE_SIZE

#define LV_FS_POSIX_CACHE_SIZE 0

>0 to cache this number of bytes in lv_fs_read()

LV_FS_WIN32_LETTER

#define LV_FS_WIN32_LETTER '\0'

API for CreateFile, ReadFile, etc. Set an upper-case driver-identifier letter for this driver (e.g. 'A').

LV_FS_WIN32_PATH

#define LV_FS_WIN32_PATH ""

Set the working directory. File/directory paths will be appended to it.

LV_FS_WIN32_CACHE_SIZE

#define LV_FS_WIN32_CACHE_SIZE 0

>0 to cache this number of bytes in lv_fs_read()

LV_FS_FATFS_LETTER

#define LV_FS_FATFS_LETTER '\0'

API for FATFS (needs to be added separately). Uses f_open, f_read, etc. Set an upper-case driver-identifier letter for this driver (e.g. 'A').

LV_FS_FATFS_PATH

#define LV_FS_FATFS_PATH ""

Set the working directory. File/directory paths will be appended to it.

LV_FS_FATFS_CACHE_SIZE

#define LV_FS_FATFS_CACHE_SIZE 0

>0 to cache this number of bytes in lv_fs_read()

LV_FS_MEMFS_LETTER

#define LV_FS_MEMFS_LETTER '\0'

API for memory-mapped file access. Set an upper-case driver-identifier letter for this driver (e.g. 'A').

LV_FS_LITTLEFS_LETTER

#define LV_FS_LITTLEFS_LETTER '\0'

API for LittleFs. Set an upper-case driver-identifier letter for this driver (e.g. 'A').

LV_FS_LITTLEFS_PATH

#define LV_FS_LITTLEFS_PATH ""

Set the working directory. File/directory paths will be appended to it.

LV_FS_ARDUINO_ESP_LITTLEFS_LETTER

#define LV_FS_ARDUINO_ESP_LITTLEFS_LETTER '\0'

API for Arduino LittleFs. Set an upper-case driver-identifier letter for this driver (e.g. 'A').

LV_FS_ARDUINO_ESP_LITTLEFS_PATH

#define LV_FS_ARDUINO_ESP_LITTLEFS_PATH ""

Set the working directory. File/directory paths will be appended to it.

LV_FS_ARDUINO_SD_LETTER

#define LV_FS_ARDUINO_SD_LETTER '\0'

API for Arduino Sd. Set an upper-case driver-identifier letter for this driver (e.g. 'A').

LV_FS_ARDUINO_SD_PATH

#define LV_FS_ARDUINO_SD_PATH ""

Set the working directory. File/directory paths will be appended to it.

LV_FS_UEFI_LETTER

#define LV_FS_UEFI_LETTER '\0'

API for UEFI Set an upper-case driver-identifier letter for this driver (e.g. 'A').

LV_FS_FROGFS_LETTER

#define LV_FS_FROGFS_LETTER '\0'

LV_GIF_CACHE_DECODE_DATA

#define LV_GIF_CACHE_DECODE_DATA 0

LODEPNG decoder library PNG decoder(libpng) library BMP decoder library JPG + split JPG decoder library. Split JPG is a custom format optimized for embedded systems. libjpeg-turbo decoder library.

• Supports complete JPEG specifications and high-performance JPEG decoding. WebP decoder library GIF decoder library GIF decoder accelerate

LV_BIN_DECODER_RAM_LOAD

#define LV_BIN_DECODER_RAM_LOAD 0

GStreamer library Decode bin images to RAM

LV_FREETYPE_USE_LVGL_PORT

#define LV_FREETYPE_USE_LVGL_PORT 0

RLE decompress library QR code library Barcode code library FreeType library Let FreeType use LVGL memory and file porting

LV_FREETYPE_CACHE_FT_GLYPH_CNT

#define LV_FREETYPE_CACHE_FT_GLYPH_CNT 256

Cache count of glyphs in FreeType, i.e. number of glyphs that can be cached. The higher the value, the more memory will be used.

LV_FREETYPE_CACHE_FT_GLYPH_L1

#define LV_FREETYPE_CACHE_FT_GLYPH_L1 1

Enable L1 glyph metrics cache for FreeType. A per-font, lock-free, 2-way set-associative cache that accelerates repeated glyph metric lookups. Automatically disabled when an OS is configured (LV_USE_OS != LV_OS_NONE) because the cache is not thread-safe.

LV_TINY_TTF_FILE_SUPPORT

#define LV_TINY_TTF_FILE_SUPPORT 0

Built-in TTF decoder

LV_TINY_TTF_CACHE_GLYPH_CNT

#define LV_TINY_TTF_CACHE_GLYPH_CNT 128

LV_TINY_TTF_CACHE_KERNING_CNT

#define LV_TINY_TTF_CACHE_KERNING_CNT 256

LV_FFMPEG_DUMP_FORMAT

#define LV_FFMPEG_DUMP_FORMAT 0

Rlottie library Requires LV_USE_3DTEXTURE = 1 Enable Vector Graphic APIs Requires LV_USE_MATRIX = 1 and a rendering engine supporting vector graphics, e.g. (LV_USE_DRAW_SW and LV_USE_THORVG) or LV_USE_DRAW_VG_LITE or LV_USE_NEMA_VG. Enable ThorVG (vector graphics library) from the src/libs folder. Requires LV_USE_VECTOR_GRAPHIC Enable ThorVG by assuming that its installed and linked to the project Requires LV_USE_VECTOR_GRAPHIC Enable NanoVG (vector graphics library) Use lvgl built-in LZ4 lib Use external LZ4 library FFmpeg library for image decoding and playing videos. Supports all major image formats so do not enable other image decoder with it. Dump input information to stderr

LV_FFMPEG_PLAYER_USE_LV_FS

#define LV_FFMPEG_PLAYER_USE_LV_FS 0

Use lvgl file path in FFmpeg Player widget You won't be able to open URLs after enabling this feature. Note that FFmpeg image decoder will always use lvgl file system.

LV_SYSMON_GET_IDLE

#define LV_SYSMON_GET_IDLE lv_os_get_idle_percent

1: Enable API to take snapshot for object 1: Enable system monitor component Get the idle percentage. E.g. uint32_t my_get_idle(void);

LV_SYSMON_PROC_IDLE_AVAILABLE

#define LV_SYSMON_PROC_IDLE_AVAILABLE 0

1: Enable usage of lv_os_get_proc_idle_percent.

LV_USE_PERF_MONITOR_POS

#define LV_USE_PERF_MONITOR_POS LV_ALIGN_BOTTOM_RIGHT

1: Show CPU usage and FPS count.

• Requires LV_USE_SYSMON = 1

LV_USE_PERF_MONITOR_LOG_MODE

#define LV_USE_PERF_MONITOR_LOG_MODE 0

0: Displays performance data on the screen; 1: Prints performance data using log.

LV_USE_MEM_MONITOR_POS

#define LV_USE_MEM_MONITOR_POS LV_ALIGN_BOTTOM_LEFT

1: Show used memory and memory fragmentation.

• Requires LV_USE_STDLIB_MALLOC = LV_STDLIB_BUILTIN
• Requires LV_USE_SYSMON = 1

LV_PROFILER_BUILTIN_BUF_SIZE

#define LV_PROFILER_BUILTIN_BUF_SIZE (16 * 1024)

1: Enable runtime performance profiler 1: Enable the built-in profiler Default profiler trace buffer size [bytes]

LV_PROFILER_BUILTIN_DEFAULT_ENABLE

#define LV_PROFILER_BUILTIN_DEFAULT_ENABLE 1

LV_PROFILER_INCLUDE

#define LV_PROFILER_INCLUDE "lvgl/src/misc/lv_profiler_builtin.h"

Header to include for profiler

LV_PROFILER_BEGIN

#define LV_PROFILER_BEGIN LV_PROFILER_BUILTIN_BEGIN

Profiler start point function

LV_PROFILER_END

#define LV_PROFILER_END LV_PROFILER_BUILTIN_END

Profiler end point function

LV_PROFILER_BEGIN_TAG

#define LV_PROFILER_BEGIN_TAG LV_PROFILER_BUILTIN_BEGIN_TAG

Profiler start point function with custom tag

LV_PROFILER_END_TAG

#define LV_PROFILER_END_TAG LV_PROFILER_BUILTIN_END_TAG

Profiler end point function with custom tag

LV_PROFILER_LAYOUT

#define LV_PROFILER_LAYOUT 1

LV_PROFILER_REFR

#define LV_PROFILER_REFR 1

LV_PROFILER_DRAW

#define LV_PROFILER_DRAW 1

LV_PROFILER_INDEV

#define LV_PROFILER_INDEV 1

LV_PROFILER_DECODER

#define LV_PROFILER_DECODER 1

LV_PROFILER_FONT

#define LV_PROFILER_FONT 1

LV_PROFILER_FS

#define LV_PROFILER_FS 1

LV_PROFILER_STYLE

#define LV_PROFILER_STYLE 0

LV_PROFILER_TIMER

#define LV_PROFILER_TIMER 1

LV_PROFILER_CACHE