mirrors/lvgl
0
0
Fork 0
mirror of https://github.com/lvgl/lvgl.git synced 2024-11-27 11:43:43 +08:00
Code Issues Packages Projects Releases Wiki Activity
656a0e5167
lvgl/demos
History
Gabriel Wang 45a39a11fe
fix(benchmark): remove redundant string for the small screens (#3335) 
* fix(benchmark): remove redundant string for the small screens (i.e. <320 in width)

* remove tail white-spaces
2022-05-07 22:14:35 +02:00
..
benchmark fix(benchmark): remove redundant string for the small screens (#3335) 2022-05-07 22:14:35 +02:00
keypad_encoder chore(style): remove the trailing space from all source files (#3188) 2022-03-21 11:25:51 +01:00
music chore(style): remove the trailing space from all source files (#3188) 2022-03-21 11:25:51 +01:00
stress chore(style): remove the trailing space from all source files (#3188) 2022-03-21 11:25:51 +01:00
widgets chore(demo): fix lv_demo_widget if THEME_DEFAULT is not enabled 2022-05-04 21:14:28 +02:00
lv_demos.h chore(format) add formatting for examples & demos, merge test config 2022-02-13 13:59:17 -05:00
lv_demos.mk fix(Makefile): compilation errors (#2944) 2022-01-10 11:17:03 +01:00
README.md chore(style): remove the trailing space from all source files (#3188) 2022-03-21 11:25:51 +01:00

README.md

Demos for LVGL

Add the examples to your projects

  1. demos can be found in the 'demos' folder once you clone the lvgl.

  2. In the lv_conf.h or equivalent places, you can find demo related macros, change its value to enable or disable specified demos:

...
/*===================
 * DEMO USAGE
 ====================*/

/*Show some widget. It might be required to increase `LV_MEM_SIZE` */
#define LV_USE_DEMO_WIDGETS        0
#if LV_USE_DEMO_WIDGETS
#define LV_DEMO_WIDGETS_SLIDESHOW  0
#endif

/*Demonstrate the usage of encoder and keyboard*/
#define LV_USE_DEMO_KEYPAD_AND_ENCODER     0

/*Benchmark your system*/
#define LV_USE_DEMO_BENCHMARK   0

/*Stress test for LVGL*/
#define LV_USE_DEMO_STRESS      0

/*Music player demo*/
#define LV_USE_DEMO_MUSIC       0
#if LV_USE_DEMO_MUSIC
# define LV_DEMO_MUSIC_SQUARE       0
# define LV_DEMO_MUSIC_LANDSCAPE    0
# define LV_DEMO_MUSIC_ROUND        0
# define LV_DEMO_MUSIC_LARGE        0
# define LV_DEMO_MUSIC_AUTO_PLAY    0
#endif
...
  1. If your development environment or toolchain does not add source files inside 'lvgl' folder automatically, ensure the demos folder is included for compilation.
  2. Include "demos/lv_demos.h" in your application source file, for example:
//! main.c
#include "lvgl.h"
#include "demos/lv_demos.h"
...

Demos

Widgets

Shows how the widgets look like out of the box using the built-in material theme.

See in widgets folder.

Basic demo to show the widgets of LVGL

For running this demo properly, please make sure LV_MEM_SIZE is at least 38KB (and 48KB is recommended):

#define LV_MEME_SIZE    (38ul * 1024ul)

Music player

The music player demo shows what kind of modern, smartphone-like user interfaces can be created on LVGL. It works the best with display with 480x272 or 272x480 resolution.

See in music folder.

Music player demo with LVGL

Keypad and encoder

LVGL allows you to control the widgets with a keypad and/or encoder without a touchpad. This demo shows how to handle buttons, drop-down lists, rollers, sliders, switches, and text inputs without touchpad. Learn more about the touchpad-less usage of LVGL here.

See in keypad_encoder folder.

Keypad and encoder navigation in LVGL embedded GUI library

Benchmark

A demo to measure the performance of LVGL or to compare different settings. See in benchmark folder. Benchmark demo with LVGL embedded GUI library

Stress

A stress test for LVGL. It contains a lot of object creation, deletion, animations, style usage, and so on. It can be used if there is any memory corruption during heavy usage or any memory leaks. See in stress folder. Stress test for LVGL

Contributing

For contribution and coding style guidelines, please refer to the file docs/CONTRIBUTING.md in the main LVGL repo:   https://github.com/lvgl/lvgl