no-OS
Loading...
Searching...
No Matches
lv_conf.h File Reference

Go to the source code of this file.

Macros

#define LV_COLOR_DEPTH   1
 
#define LV_USE_STDLIB_MALLOC   LV_STDLIB_BUILTIN
 
#define LV_USE_STDLIB_STRING   LV_STDLIB_BUILTIN
 
#define LV_USE_STDLIB_SPRINTF   LV_STDLIB_BUILTIN
 
#define LV_STDINT_INCLUDE   <stdint.h>
 
#define LV_STDDEF_INCLUDE   <stddef.h>
 
#define LV_STDBOOL_INCLUDE   <stdbool.h>
 
#define LV_INTTYPES_INCLUDE   <inttypes.h>
 
#define LV_LIMITS_INCLUDE   <limits.h>
 
#define LV_STDARG_INCLUDE   <stdarg.h>
 
#define LV_MEM_SIZE   (22U * 1024U)
 
#define LV_MEM_POOL_EXPAND_SIZE   0
 
#define LV_MEM_ADR   0
 
#define LV_DEF_REFR_PERIOD   33
 
#define LV_DPI_DEF   130
 
#define LV_USE_OS   LV_OS_NONE
 
#define LV_OS_CUSTOM_INCLUDE   <stdint.h>
 
#define LV_USE_FREERTOS_TASK_NOTIFY   1
 
#define LV_DRAW_BUF_STRIDE_ALIGN   1
 
#define LV_DRAW_BUF_ALIGN   4
 
#define LV_DRAW_TRANSFORM_USE_MATRIX   0
 
#define LV_DRAW_LAYER_SIMPLE_BUF_SIZE   (8 * 1024)
 
#define LV_DRAW_LAYER_MAX_MEMORY   8 * 1024
 
#define LV_DRAW_THREAD_STACK_SIZE   (12 * 1024)
 
#define LV_USE_DRAW_SW   1
 
#define LV_USE_NEMA_GFX   0
 
#define LV_USE_DRAW_VGLITE   0
 
#define LV_USE_PXP   0
 
#define LV_USE_DRAW_G2D   0
 
#define LV_USE_DRAW_DAVE2D   0
 
#define LV_USE_DRAW_SDL   0
 
#define LV_USE_DRAW_VG_LITE   0
 
#define LV_USE_DRAW_DMA2D   0
 
#define LV_USE_DRAW_OPENGLES   0
 
#define LV_USE_LOG   0
 
#define LV_USE_ASSERT_NULL   0
 
#define LV_USE_ASSERT_MALLOC   0
 
#define LV_USE_ASSERT_STYLE   0
 
#define LV_USE_ASSERT_MEM_INTEGRITY   0
 
#define LV_USE_ASSERT_OBJ   0
 
#define LV_ASSERT_HANDLER_INCLUDE   <stdint.h>
 
#define LV_ASSERT_HANDLER   while(1);
 
#define LV_USE_REFR_DEBUG   0
 
#define LV_USE_LAYER_DEBUG   0
 
#define LV_USE_PARALLEL_DRAW_DEBUG   0
 
#define LV_ENABLE_GLOBAL_CUSTOM   0
 
#define LV_CACHE_DEF_SIZE   0
 
#define LV_IMAGE_HEADER_CACHE_DEF_CNT   0
 
#define LV_GRADIENT_MAX_STOPS   2
 
#define LV_COLOR_MIX_ROUND_OFS   0
 
#define LV_OBJ_STYLE_CACHE   0
 
#define LV_USE_OBJ_ID   0
 
#define LV_USE_OBJ_NAME   0
 
#define LV_OBJ_ID_AUTO_ASSIGN   LV_USE_OBJ_ID
 
#define LV_USE_OBJ_ID_BUILTIN   1
 
#define LV_USE_OBJ_PROPERTY   0
 
#define LV_USE_OBJ_PROPERTY_NAME   1
 
#define LV_USE_VG_LITE_THORVG   0
 
#define LV_USE_GESTURE_RECOGNITION   0
 
#define LV_BIG_ENDIAN_SYSTEM   0
 
#define LV_ATTRIBUTE_TICK_INC
 
#define LV_ATTRIBUTE_TIMER_HANDLER
 
#define LV_ATTRIBUTE_FLUSH_READY
 
#define LV_ATTRIBUTE_MEM_ALIGN_SIZE   1
 
#define LV_ATTRIBUTE_MEM_ALIGN
 
#define LV_ATTRIBUTE_LARGE_CONST
 
#define LV_ATTRIBUTE_LARGE_RAM_ARRAY
 
#define LV_ATTRIBUTE_FAST_MEM
 
#define LV_EXPORT_CONST_INT(int_value)
 
#define LV_ATTRIBUTE_EXTERN_DATA
 
#define LV_USE_FLOAT   0
 
#define LV_USE_MATRIX   0
 
#define LV_USE_PRIVATE_API   0
 
#define LV_FONT_MONTSERRAT_8   0
 
#define LV_FONT_MONTSERRAT_10   0
 
#define LV_FONT_MONTSERRAT_12   0
 
#define LV_FONT_MONTSERRAT_14   1
 
#define LV_FONT_MONTSERRAT_16   0
 
#define LV_FONT_MONTSERRAT_18   0
 
#define LV_FONT_MONTSERRAT_20   0
 
#define LV_FONT_MONTSERRAT_22   0
 
#define LV_FONT_MONTSERRAT_24   0
 
#define LV_FONT_MONTSERRAT_26   0
 
#define LV_FONT_MONTSERRAT_28   0
 
#define LV_FONT_MONTSERRAT_30   0
 
#define LV_FONT_MONTSERRAT_32   0
 
#define LV_FONT_MONTSERRAT_34   0
 
#define LV_FONT_MONTSERRAT_36   0
 
#define LV_FONT_MONTSERRAT_38   0
 
#define LV_FONT_MONTSERRAT_40   0
 
#define LV_FONT_MONTSERRAT_42   0
 
#define LV_FONT_MONTSERRAT_44   0
 
#define LV_FONT_MONTSERRAT_46   0
 
#define LV_FONT_MONTSERRAT_48   0
 
#define LV_FONT_MONTSERRAT_28_COMPRESSED   0
 
#define LV_FONT_DEJAVU_16_PERSIAN_HEBREW   0
 
#define LV_FONT_SIMSUN_14_CJK   0
 
#define LV_FONT_SIMSUN_16_CJK   0
 
#define LV_FONT_UNSCII_8   0
 
#define LV_FONT_UNSCII_16   0
 
#define LV_FONT_CUSTOM_DECLARE
 
#define LV_FONT_DEFAULT   &lv_font_montserrat_14
 
#define LV_FONT_FMT_TXT_LARGE   0
 
#define LV_USE_FONT_COMPRESSED   0
 
#define LV_USE_FONT_PLACEHOLDER   1
 
#define LV_TXT_ENC   LV_TXT_ENC_UTF8
 
#define LV_TXT_BREAK_CHARS   " ,.;:-_)]}"
 
#define LV_TXT_LINE_BREAK_LONG_LEN   0
 
#define LV_TXT_LINE_BREAK_LONG_PRE_MIN_LEN   3
 
#define LV_TXT_LINE_BREAK_LONG_POST_MIN_LEN   3
 
#define LV_USE_BIDI   0
 
#define LV_USE_ARABIC_PERSIAN_CHARS   0
 
#define LV_TXT_COLOR_CMD   "#"
 
#define LV_WIDGETS_HAS_DEFAULT_VALUE   0
 
#define LV_USE_ANIMIMG   1
 
#define LV_USE_ARC   0
 
#define LV_USE_BAR   0
 
#define LV_USE_BUTTON   0
 
#define LV_USE_BUTTONMATRIX   0
 
#define LV_USE_CALENDAR   0
 
#define LV_USE_CANVAS   0
 
#define LV_USE_CHART   0
 
#define LV_USE_CHECKBOX   0
 
#define LV_USE_DROPDOWN   0
 
#define LV_USE_IMAGE   1
 
#define LV_USE_IMAGEBUTTON   0
 
#define LV_USE_KEYBOARD   0
 
#define LV_USE_LABEL   1
 
#define LV_USE_LED   0
 
#define LV_USE_LINE   0
 
#define LV_USE_LIST   0
 
#define LV_USE_LOTTIE   0
 
#define LV_USE_MENU   0
 
#define LV_USE_MSGBOX   0
 
#define LV_USE_ROLLER   0
 
#define LV_USE_SCALE   0
 
#define LV_USE_SLIDER   0
 
#define LV_USE_SPAN   0
 
#define LV_USE_SPINBOX   0
 
#define LV_USE_SPINNER   0
 
#define LV_USE_SWITCH   0
 
#define LV_USE_TABLE   0
 
#define LV_USE_TABVIEW   0
 
#define LV_USE_TEXTAREA   0
 
#define LV_USE_TILEVIEW   0
 
#define LV_USE_WIN   0
 
#define LV_USE_THEME_DEFAULT   1
 
#define LV_USE_THEME_SIMPLE   1
 
#define LV_USE_THEME_MONO   1
 
#define LV_USE_FLEX   1
 
#define LV_USE_GRID   1
 
#define LV_FS_DEFAULT_DRIVER_LETTER   '\0'
 
#define LV_USE_FS_STDIO   0
 
#define LV_USE_FS_POSIX   0
 
#define LV_USE_FS_WIN32   0
 
#define LV_USE_FS_FATFS   0
 
#define LV_USE_FS_MEMFS   0
 
#define LV_USE_FS_LITTLEFS   0
 
#define LV_USE_FS_ARDUINO_ESP_LITTLEFS   0
 
#define LV_USE_FS_ARDUINO_SD   0
 
#define LV_USE_FS_UEFI   0
 
#define LV_USE_LODEPNG   0
 
#define LV_USE_LIBPNG   0
 
#define LV_USE_BMP   0
 
#define LV_USE_TJPGD   0
 
#define LV_USE_LIBJPEG_TURBO   0
 
#define LV_USE_GIF   0
 
#define LV_BIN_DECODER_RAM_LOAD   0
 
#define LV_USE_RLE   0
 
#define LV_USE_QRCODE   0
 
#define LV_USE_BARCODE   0
 
#define LV_USE_FREETYPE   0
 
#define LV_USE_TINY_TTF   0
 
#define LV_USE_RLOTTIE   0
 
#define LV_USE_VECTOR_GRAPHIC   0
 
#define LV_USE_THORVG_INTERNAL   0
 
#define LV_USE_THORVG_EXTERNAL   0
 
#define LV_USE_LZ4_INTERNAL   0
 
#define LV_USE_LZ4_EXTERNAL   0
 
#define LV_USE_SVG   0
 
#define LV_USE_SVG_ANIMATION   0
 
#define LV_USE_SVG_DEBUG   0
 
#define LV_USE_FFMPEG   0
 
#define LV_USE_SNAPSHOT   0
 
#define LV_USE_SYSMON   0
 
#define LV_USE_PROFILER   0
 
#define LV_USE_MONKEY   0
 
#define LV_USE_GRIDNAV   0
 
#define LV_USE_FRAGMENT   0
 
#define LV_USE_IMGFONT   0
 
#define LV_USE_OBSERVER   1
 
#define LV_USE_IME_PINYIN   0
 
#define LV_USE_FILE_EXPLORER   0
 
#define LV_USE_FONT_MANAGER   0
 
#define LV_USE_TEST   0
 
#define LV_USE_XML   0
 
#define LV_USE_COLOR_FILTER   0
 
#define LV_USE_SDL   0
 
#define LV_USE_X11   0
 
#define LV_USE_WAYLAND   0
 
#define LV_USE_LINUX_FBDEV   0
 
#define LV_USE_NUTTX   0
 
#define LV_USE_LINUX_DRM   0
 
#define LV_USE_TFT_ESPI   0
 
#define LV_USE_EVDEV   0
 
#define LV_USE_LIBINPUT   0
 
#define LV_USE_ST7735   0
 
#define LV_USE_ST7789   0
 
#define LV_USE_ST7796   0
 
#define LV_USE_ILI9341   0
 
#define LV_USE_GENERIC_MIPI   (LV_USE_ST7735 | LV_USE_ST7789 | LV_USE_ST7796 | LV_USE_ILI9341)
 
#define LV_USE_RENESAS_GLCDC   0
 
#define LV_USE_ST_LTDC   0
 
#define LV_USE_WINDOWS   0
 
#define LV_USE_UEFI   0
 
#define LV_USE_OPENGLES   0
 
#define LV_USE_QNX   0
 
#define LV_BUILD_EXAMPLES   1
 
#define LV_USE_DEMO_WIDGETS   0
 
#define LV_USE_DEMO_KEYPAD_AND_ENCODER   0
 
#define LV_USE_DEMO_BENCHMARK   0
 
#define LV_USE_DEMO_RENDER   0
 
#define LV_USE_DEMO_STRESS   0
 
#define LV_USE_DEMO_MUSIC   0
 
#define LV_USE_DEMO_FLEX_LAYOUT   0
 
#define LV_USE_DEMO_MULTILANG   0
 
#define LV_USE_DEMO_TRANSFORM   0
 
#define LV_USE_DEMO_SCROLL   0
 
#define LV_USE_DEMO_VECTOR_GRAPHIC   0
 
#define LV_USE_DEMO_EBIKE   0
 
#define LV_USE_DEMO_HIGH_RES   0
 
#define LV_USE_DEMO_SMARTWATCH   0
 

Detailed Description

Configuration file for v9.3.0-dev

Macro Definition Documentation

◆ LV_ASSERT_HANDLER

#define LV_ASSERT_HANDLER   while(1);

Halt by default

◆ LV_ASSERT_HANDLER_INCLUDE

#define LV_ASSERT_HANDLER_INCLUDE   <stdint.h>

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

◆ LV_ATTRIBUTE_EXTERN_DATA

#define LV_ATTRIBUTE_EXTERN_DATA

Prefix all global extern data with this

◆ LV_ATTRIBUTE_FAST_MEM

#define LV_ATTRIBUTE_FAST_MEM

Place performance critical functions into a faster memory (e.g RAM)

◆ LV_ATTRIBUTE_FLUSH_READY

#define LV_ATTRIBUTE_FLUSH_READY

Define a custom attribute for lv_display_flush_ready function

◆ LV_ATTRIBUTE_LARGE_CONST

#define LV_ATTRIBUTE_LARGE_CONST

Attribute to mark large constant arrays, for example for font bitmaps

◆ LV_ATTRIBUTE_LARGE_RAM_ARRAY

#define LV_ATTRIBUTE_LARGE_RAM_ARRAY

Compiler prefix for a large array declaration in RAM

◆ LV_ATTRIBUTE_MEM_ALIGN

#define LV_ATTRIBUTE_MEM_ALIGN

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)))

◆ LV_ATTRIBUTE_MEM_ALIGN_SIZE

#define LV_ATTRIBUTE_MEM_ALIGN_SIZE   1

Align VG_LITE buffers on this number of bytes.

Note
vglite_src_buf_aligned() uses this value to validate alignment of passed buffer pointers.

◆ LV_ATTRIBUTE_TICK_INC

#define LV_ATTRIBUTE_TICK_INC

Define a custom attribute for lv_tick_inc function

◆ LV_ATTRIBUTE_TIMER_HANDLER

#define LV_ATTRIBUTE_TIMER_HANDLER

Define a custom attribute for lv_timer_handler function

◆ LV_BIG_ENDIAN_SYSTEM

#define LV_BIG_ENDIAN_SYSTEM   0

For big endian systems set to 1

◆ LV_BIN_DECODER_RAM_LOAD

#define LV_BIN_DECODER_RAM_LOAD   0

Decode bin images to RAM

◆ LV_BUILD_EXAMPLES

#define LV_BUILD_EXAMPLES   1

Enable examples to be built with the library.

◆ 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_COLOR_DEPTH

#define LV_COLOR_DEPTH   1

Color depth: 1 (I1), 8 (L8), 16 (RGB565), 24 (RGB888), 32 (XRGB8888)

◆ 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_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_ALIGN

#define LV_DRAW_BUF_ALIGN   4

Align start address of draw_buf addresses to this bytes

◆ LV_DRAW_BUF_STRIDE_ALIGN

#define LV_DRAW_BUF_STRIDE_ALIGN   1

Align stride of all layers and images to this bytes

◆ LV_DRAW_LAYER_MAX_MEMORY

#define LV_DRAW_LAYER_MAX_MEMORY   8 * 1024

No limit by default [bytes]

◆ LV_DRAW_LAYER_SIMPLE_BUF_SIZE

#define LV_DRAW_LAYER_SIMPLE_BUF_SIZE   (8 * 1024)

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

◆ LV_DRAW_THREAD_STACK_SIZE

#define LV_DRAW_THREAD_STACK_SIZE   (12 * 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_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_ENABLE_GLOBAL_CUSTOM

#define LV_ENABLE_GLOBAL_CUSTOM   0

◆ LV_EXPORT_CONST_INT

#define LV_EXPORT_CONST_INT ( int_value)
Value:
struct _silence_gcc_warning

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_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_DEJAVU_16_PERSIAN_HEBREW

#define LV_FONT_DEJAVU_16_PERSIAN_HEBREW   0

Hebrew, Arabic, Persian letters and all their forms

◆ 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_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_28_COMPRESSED

#define LV_FONT_MONTSERRAT_28_COMPRESSED   0

bpp = 3

◆ 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_8

#define LV_FONT_MONTSERRAT_8   0

◆ LV_FONT_SIMSUN_14_CJK

#define LV_FONT_SIMSUN_14_CJK   0

1000 most common CJK radicals

◆ LV_FONT_SIMSUN_16_CJK

#define LV_FONT_SIMSUN_16_CJK   0

1000 most common CJK radicals

◆ LV_FONT_UNSCII_16

#define LV_FONT_UNSCII_16   0

◆ LV_FONT_UNSCII_8

#define LV_FONT_UNSCII_8   0

Pixel perfect monospaced fonts

◆ LV_FS_DEFAULT_DRIVER_LETTER

#define LV_FS_DEFAULT_DRIVER_LETTER   '\0'

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/details/main-modules/fs.html#lv-fs-identifier-letters .

◆ 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_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_INTTYPES_INCLUDE

#define LV_INTTYPES_INCLUDE   <inttypes.h>

◆ LV_LIMITS_INCLUDE

#define LV_LIMITS_INCLUDE   <limits.h>

◆ LV_MEM_ADR

#define LV_MEM_ADR   0

Set an address for the memory pool instead of allocating it as a normal array. Can be in external SRAM too. 0: unused

◆ LV_MEM_POOL_EXPAND_SIZE

#define LV_MEM_POOL_EXPAND_SIZE   0

Size of the memory expand for lv_malloc() in bytes

◆ LV_MEM_SIZE

#define LV_MEM_SIZE   (22U * 1024U)

Size of memory available for lv_malloc() in bytes (>= 2kB) [bytes]

◆ LV_OBJ_ID_AUTO_ASSIGN

#define LV_OBJ_ID_AUTO_ASSIGN   LV_USE_OBJ_ID

Automatically assign an ID when obj is created

◆ 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_OS_CUSTOM_INCLUDE

#define LV_OS_CUSTOM_INCLUDE   <stdint.h>

◆ LV_STDARG_INCLUDE

#define LV_STDARG_INCLUDE   <stdarg.h>

◆ LV_STDBOOL_INCLUDE

#define LV_STDBOOL_INCLUDE   <stdbool.h>

◆ LV_STDDEF_INCLUDE

#define LV_STDDEF_INCLUDE   <stddef.h>

◆ LV_STDINT_INCLUDE

#define LV_STDINT_INCLUDE   <stdint.h>

◆ LV_TXT_BREAK_CHARS

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

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

◆ LV_TXT_COLOR_CMD

#define LV_TXT_COLOR_CMD   "#"

◆ LV_TXT_ENC

#define LV_TXT_ENC   LV_TXT_ENC_UTF8

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_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_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_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_USE_ANIMIMG

#define LV_USE_ANIMIMG   1

◆ LV_USE_ARABIC_PERSIAN_CHARS

#define LV_USE_ARABIC_PERSIAN_CHARS   0

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

◆ LV_USE_ARC

#define LV_USE_ARC   0

◆ LV_USE_ASSERT_MALLOC

#define LV_USE_ASSERT_MALLOC   0

Checks is the memory is successfully allocated or no. (Very fast, recommended)

◆ LV_USE_ASSERT_MEM_INTEGRITY

#define LV_USE_ASSERT_MEM_INTEGRITY   0

Check the integrity of lv_mem after critical operations. (Slow)

◆ LV_USE_ASSERT_NULL

#define LV_USE_ASSERT_NULL   0

Check if the parameter is NULL. (Very fast, recommended)

◆ LV_USE_ASSERT_OBJ

#define LV_USE_ASSERT_OBJ   0

Check the object's type and existence (e.g. not deleted). (Slow)

◆ LV_USE_ASSERT_STYLE

#define LV_USE_ASSERT_STYLE   0

Check if the styles are properly initialized. (Very fast, recommended)

◆ LV_USE_BAR

#define LV_USE_BAR   0

◆ LV_USE_BARCODE

#define LV_USE_BARCODE   0

Barcode code library

◆ LV_USE_BIDI

#define LV_USE_BIDI   0

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_USE_BMP

#define LV_USE_BMP   0

BMP decoder library

◆ LV_USE_BUTTON

#define LV_USE_BUTTON   0

◆ LV_USE_BUTTONMATRIX

#define LV_USE_BUTTONMATRIX   0

◆ LV_USE_CALENDAR

#define LV_USE_CALENDAR   0

◆ LV_USE_CANVAS

#define LV_USE_CANVAS   0

◆ LV_USE_CHART

#define LV_USE_CHART   0

◆ LV_USE_CHECKBOX

#define LV_USE_CHECKBOX   0

◆ LV_USE_COLOR_FILTER

#define LV_USE_COLOR_FILTER   0

◆ LV_USE_DEMO_BENCHMARK

#define LV_USE_DEMO_BENCHMARK   0

Benchmark your system

◆ LV_USE_DEMO_EBIKE

#define LV_USE_DEMO_EBIKE   0

◆ LV_USE_DEMO_FLEX_LAYOUT

#define LV_USE_DEMO_FLEX_LAYOUT   0

Flex layout demo

◆ LV_USE_DEMO_HIGH_RES

#define LV_USE_DEMO_HIGH_RES   0

High-resolution demo

◆ LV_USE_DEMO_KEYPAD_AND_ENCODER

#define LV_USE_DEMO_KEYPAD_AND_ENCODER   0

Demonstrate usage of encoder and keyboard.

◆ LV_USE_DEMO_MULTILANG

#define LV_USE_DEMO_MULTILANG   0

Smart-phone like multi-language demo

◆ LV_USE_DEMO_MUSIC

#define LV_USE_DEMO_MUSIC   0

Music player demo

◆ LV_USE_DEMO_RENDER

#define LV_USE_DEMO_RENDER   0

Render test for each primitive.

  • Requires at least 480x272 display.

◆ LV_USE_DEMO_SCROLL

#define LV_USE_DEMO_SCROLL   0

Demonstrate scroll settings

◆ LV_USE_DEMO_SMARTWATCH

#define LV_USE_DEMO_SMARTWATCH   0

◆ LV_USE_DEMO_STRESS

#define LV_USE_DEMO_STRESS   0

Stress test for LVGL

◆ LV_USE_DEMO_TRANSFORM

#define LV_USE_DEMO_TRANSFORM   0

Widget transformation demo

◆ LV_USE_DEMO_VECTOR_GRAPHIC

#define LV_USE_DEMO_VECTOR_GRAPHIC   0

Vector graphic demo

◆ LV_USE_DEMO_WIDGETS

#define LV_USE_DEMO_WIDGETS   0

Show some widgets. This might be required to increase LV_MEM_SIZE.

◆ LV_USE_DRAW_DAVE2D

#define LV_USE_DRAW_DAVE2D   0

Use Renesas Dave2D on RA platforms.

◆ LV_USE_DRAW_DMA2D

#define LV_USE_DRAW_DMA2D   0

Accelerate blends, fills, etc. with STM32 DMA2D

◆ LV_USE_DRAW_G2D

#define LV_USE_DRAW_G2D   0

Use NXP's G2D on MPU platforms.

◆ LV_USE_DRAW_OPENGLES

#define LV_USE_DRAW_OPENGLES   0

Draw using cached OpenGLES textures

◆ LV_USE_DRAW_SDL

#define LV_USE_DRAW_SDL   0

Draw using cached SDL textures

◆ LV_USE_DRAW_SW

#define LV_USE_DRAW_SW   1

◆ LV_USE_DRAW_VG_LITE

#define LV_USE_DRAW_VG_LITE   0

Use VG-Lite GPU.

◆ LV_USE_DRAW_VGLITE

#define LV_USE_DRAW_VGLITE   0

Use NXP's VG-Lite GPU on iMX RTxxx platforms.

◆ LV_USE_DROPDOWN

#define LV_USE_DROPDOWN   0

Requires: lv_label

◆ LV_USE_EVDEV

#define LV_USE_EVDEV   0

Driver for evdev input devices

◆ LV_USE_FFMPEG

#define LV_USE_FFMPEG   0

FFmpeg library for image decoding and playing videos. Supports all major image formats so do not enable other image decoder with it.

◆ LV_USE_FILE_EXPLORER

#define LV_USE_FILE_EXPLORER   0

1: Enable file explorer.

  • Requires: lv_table

◆ LV_USE_FLEX

#define LV_USE_FLEX   1

A layout similar to Flexbox in CSS.

◆ LV_USE_FLOAT

#define LV_USE_FLOAT   0

Use float as lv_value_precise_t

◆ LV_USE_FONT_COMPRESSED

#define LV_USE_FONT_COMPRESSED   0

Enables/disables support for compressed fonts.

◆ LV_USE_FONT_MANAGER

#define LV_USE_FONT_MANAGER   0

1: Enable freetype font manager

  • Requires: LV_USE_FREETYPE

◆ LV_USE_FONT_PLACEHOLDER

#define LV_USE_FONT_PLACEHOLDER   1

Enable drawing placeholders when glyph dsc is not found.

◆ LV_USE_FRAGMENT

#define LV_USE_FRAGMENT   0

1: Enable lv_obj fragment logic

◆ LV_USE_FREERTOS_TASK_NOTIFY

#define LV_USE_FREERTOS_TASK_NOTIFY   1

◆ LV_USE_FREETYPE

#define LV_USE_FREETYPE   0

FreeType library

◆ LV_USE_FS_ARDUINO_ESP_LITTLEFS

#define LV_USE_FS_ARDUINO_ESP_LITTLEFS   0

API for Arduino LittleFs.

◆ LV_USE_FS_ARDUINO_SD

#define LV_USE_FS_ARDUINO_SD   0

API for Arduino Sd.

◆ LV_USE_FS_FATFS

#define LV_USE_FS_FATFS   0

API for FATFS (needs to be added separately). Uses f_open, f_read, etc.

◆ LV_USE_FS_LITTLEFS

#define LV_USE_FS_LITTLEFS   0

API for LittleFs.

◆ LV_USE_FS_MEMFS

#define LV_USE_FS_MEMFS   0

API for memory-mapped file access.

◆ LV_USE_FS_POSIX

#define LV_USE_FS_POSIX   0

API for open, read, etc.

◆ LV_USE_FS_STDIO

#define LV_USE_FS_STDIO   0

API for fopen, fread, etc.

◆ LV_USE_FS_UEFI

#define LV_USE_FS_UEFI   0

API for UEFI

◆ LV_USE_FS_WIN32

#define LV_USE_FS_WIN32   0

API for CreateFile, ReadFile, etc.

◆ LV_USE_GENERIC_MIPI

#define LV_USE_GENERIC_MIPI   (LV_USE_ST7735 | LV_USE_ST7789 | LV_USE_ST7796 | LV_USE_ILI9341)

◆ LV_USE_GESTURE_RECOGNITION

#define LV_USE_GESTURE_RECOGNITION   0

◆ LV_USE_GIF

#define LV_USE_GIF   0

GIF decoder library

◆ LV_USE_GRID

#define LV_USE_GRID   1

A layout similar to Grid in CSS.

◆ LV_USE_GRIDNAV

#define LV_USE_GRIDNAV   0

1: Enable grid navigation

◆ LV_USE_ILI9341

#define LV_USE_ILI9341   0

◆ LV_USE_IMAGE

#define LV_USE_IMAGE   1

Requires: lv_label

◆ LV_USE_IMAGEBUTTON

#define LV_USE_IMAGEBUTTON   0

◆ LV_USE_IME_PINYIN

#define LV_USE_IME_PINYIN   0

1: Enable Pinyin input method

  • Requires: lv_keyboard

◆ LV_USE_IMGFONT

#define LV_USE_IMGFONT   0

1: Support using images as font in label or span widgets

◆ LV_USE_KEYBOARD

#define LV_USE_KEYBOARD   0

◆ LV_USE_LABEL

#define LV_USE_LABEL   1

◆ LV_USE_LAYER_DEBUG

#define LV_USE_LAYER_DEBUG   0

1: Draw a red overlay for ARGB layers and a green overlay for RGB layers

◆ LV_USE_LED

#define LV_USE_LED   0

◆ LV_USE_LIBINPUT

#define LV_USE_LIBINPUT   0

Driver for libinput input devices

◆ LV_USE_LIBJPEG_TURBO

#define LV_USE_LIBJPEG_TURBO   0

libjpeg-turbo decoder library.

  • Supports complete JPEG specifications and high-performance JPEG decoding.

◆ LV_USE_LIBPNG

#define LV_USE_LIBPNG   0

PNG decoder(libpng) library

◆ LV_USE_LINE

#define LV_USE_LINE   0

◆ LV_USE_LINUX_DRM

#define LV_USE_LINUX_DRM   0

Driver for /dev/dri/card

◆ LV_USE_LINUX_FBDEV

#define LV_USE_LINUX_FBDEV   0

Driver for /dev/fb

◆ LV_USE_LIST

#define LV_USE_LIST   0

◆ LV_USE_LODEPNG

#define LV_USE_LODEPNG   0

LODEPNG decoder library

◆ LV_USE_LOG

#define LV_USE_LOG   0

Enable log module

◆ LV_USE_LOTTIE

#define LV_USE_LOTTIE   0

Requires: lv_canvas, thorvg

◆ LV_USE_LZ4_EXTERNAL

#define LV_USE_LZ4_EXTERNAL   0

Use external LZ4 library

◆ LV_USE_LZ4_INTERNAL

#define LV_USE_LZ4_INTERNAL   0

Use lvgl built-in LZ4 lib

◆ LV_USE_MATRIX

#define LV_USE_MATRIX   0

Enable matrix support

  • Requires LV_USE_FLOAT = 1

◆ LV_USE_MENU

#define LV_USE_MENU   0

◆ LV_USE_MONKEY

#define LV_USE_MONKEY   0

1: Enable Monkey test

◆ LV_USE_MSGBOX

#define LV_USE_MSGBOX   0

◆ LV_USE_NEMA_GFX

#define LV_USE_NEMA_GFX   0

◆ LV_USE_NUTTX

#define LV_USE_NUTTX   0

Use Nuttx to open window and handle touchscreen

◆ LV_USE_OBJ_ID

#define LV_USE_OBJ_ID   0

Add id field to lv_obj_t

◆ LV_USE_OBJ_ID_BUILTIN

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

◆ LV_USE_OBJ_NAME

#define LV_USE_OBJ_NAME   0

Enable support widget names

◆ LV_USE_OBJ_PROPERTY

#define LV_USE_OBJ_PROPERTY   0

Use obj property set/get API.

◆ LV_USE_OBJ_PROPERTY_NAME

#define LV_USE_OBJ_PROPERTY_NAME   1

Enable property name support.

◆ LV_USE_OBSERVER

#define LV_USE_OBSERVER   1

1: Enable an observer pattern implementation

◆ LV_USE_OPENGLES

#define LV_USE_OPENGLES   0

Use OpenGL to open window on PC and handle mouse and keyboard

◆ LV_USE_OS

#define LV_USE_OS   LV_OS_NONE

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

◆ LV_USE_PARALLEL_DRAW_DEBUG

#define LV_USE_PARALLEL_DRAW_DEBUG   0

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_USE_PRIVATE_API

#define LV_USE_PRIVATE_API   0

Include lvgl_private.h in lvgl.h to access internal data and functions by default

◆ LV_USE_PROFILER

#define LV_USE_PROFILER   0

1: Enable runtime performance profiler

◆ LV_USE_PXP

#define LV_USE_PXP   0

Use NXP's PXP on iMX RTxxx platforms.

◆ LV_USE_QNX

#define LV_USE_QNX   0

QNX Screen display and input drivers

◆ LV_USE_QRCODE

#define LV_USE_QRCODE   0

QR code library

◆ LV_USE_REFR_DEBUG

#define LV_USE_REFR_DEBUG   0

1: Draw random colored rectangles over the redrawn areas.

◆ LV_USE_RENESAS_GLCDC

#define LV_USE_RENESAS_GLCDC   0

Driver for Renesas GLCD

◆ LV_USE_RLE

#define LV_USE_RLE   0

RLE decompress library

◆ LV_USE_RLOTTIE

#define LV_USE_RLOTTIE   0

Rlottie library

◆ LV_USE_ROLLER

#define LV_USE_ROLLER   0

Requires: lv_label

◆ LV_USE_SCALE

#define LV_USE_SCALE   0

◆ LV_USE_SDL

#define LV_USE_SDL   0

Use SDL to open window on PC and handle mouse and keyboard.

◆ LV_USE_SLIDER

#define LV_USE_SLIDER   0

Requires: lv_bar

◆ LV_USE_SNAPSHOT

#define LV_USE_SNAPSHOT   0

1: Enable API to take snapshot for object

◆ LV_USE_SPAN

#define LV_USE_SPAN   0

◆ LV_USE_SPINBOX

#define LV_USE_SPINBOX   0

◆ LV_USE_SPINNER

#define LV_USE_SPINNER   0

◆ LV_USE_ST7735

#define LV_USE_ST7735   0

◆ LV_USE_ST7789

#define LV_USE_ST7789   0

◆ LV_USE_ST7796

#define LV_USE_ST7796   0

◆ LV_USE_ST_LTDC

#define LV_USE_ST_LTDC   0

Driver for ST LTDC

◆ LV_USE_STDLIB_MALLOC

#define LV_USE_STDLIB_MALLOC   LV_STDLIB_BUILTIN

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_USE_STDLIB_SPRINTF

#define LV_USE_STDLIB_SPRINTF   LV_STDLIB_BUILTIN

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_USE_STDLIB_STRING

#define LV_USE_STDLIB_STRING   LV_STDLIB_BUILTIN

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_USE_SVG

#define LV_USE_SVG   0

◆ LV_USE_SVG_ANIMATION

#define LV_USE_SVG_ANIMATION   0

◆ LV_USE_SVG_DEBUG

#define LV_USE_SVG_DEBUG   0

◆ LV_USE_SWITCH

#define LV_USE_SWITCH   0

◆ LV_USE_SYSMON

#define LV_USE_SYSMON   0

1: Enable system monitor component

◆ LV_USE_TABLE

#define LV_USE_TABLE   0

◆ LV_USE_TABVIEW

#define LV_USE_TABVIEW   0

◆ LV_USE_TEST

#define LV_USE_TEST   0

Enable emulated input devices, time emulation, and screenshot compares.

◆ LV_USE_TEXTAREA

#define LV_USE_TEXTAREA   0

Requires: lv_label

◆ LV_USE_TFT_ESPI

#define LV_USE_TFT_ESPI   0

Interface for TFT_eSPI

◆ LV_USE_THEME_DEFAULT

#define LV_USE_THEME_DEFAULT   1

A simple, impressive and very complete theme

◆ LV_USE_THEME_MONO

#define LV_USE_THEME_MONO   1

A theme designed for monochrome displays

◆ LV_USE_THEME_SIMPLE

#define LV_USE_THEME_SIMPLE   1

A very simple theme that is a good starting point for a custom theme

◆ LV_USE_THORVG_EXTERNAL

#define LV_USE_THORVG_EXTERNAL   0

Enable ThorVG by assuming that its installed and linked to the project

◆ LV_USE_THORVG_INTERNAL

#define LV_USE_THORVG_INTERNAL   0

Enable ThorVG (vector graphics library) from the src/libs folder

◆ LV_USE_TILEVIEW

#define LV_USE_TILEVIEW   0

◆ LV_USE_TINY_TTF

#define LV_USE_TINY_TTF   0

Built-in TTF decoder

◆ LV_USE_TJPGD

#define LV_USE_TJPGD   0

JPG + split JPG decoder library. Split JPG is a custom format optimized for embedded systems.

◆ LV_USE_UEFI

#define LV_USE_UEFI   0

LVGL UEFI backend

◆ LV_USE_VECTOR_GRAPHIC

#define LV_USE_VECTOR_GRAPHIC   0

Enable Vector Graphic APIs

  • Requires LV_USE_MATRIX = 1

◆ LV_USE_VG_LITE_THORVG

#define LV_USE_VG_LITE_THORVG   0

◆ LV_USE_WAYLAND

#define LV_USE_WAYLAND   0

Use Wayland to open a window and handle input on Linux or BSD desktops

◆ LV_USE_WIN

#define LV_USE_WIN   0

◆ LV_USE_WINDOWS

#define LV_USE_WINDOWS   0

LVGL Windows backend

◆ LV_USE_X11

#define LV_USE_X11   0

Use X11 to open window on Linux desktop and handle mouse and keyboard

◆ LV_USE_XML

#define LV_USE_XML   0

Enable loading XML UIs runtime

◆ LV_WIDGETS_HAS_DEFAULT_VALUE

#define LV_WIDGETS_HAS_DEFAULT_VALUE   0

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.