Description
Schedule v6.0 has been released! Official release notes: https://github.com/littlevgl/lvgl/releases/tag/v6.0
Main new features
- Generic action handling [v6.0] Action handler issues #316
- Multi-display support with run time display parameter settings Advanced display support #329 [v6.0] Idle/shutdown control #109
- Better GPU handling [v6.0][Suggestion] Make GPU blend/fill functions 2D instead of 1D #87
- Image rotation
- Context to every callback comment
- Image caching for faster image decoding
Migrating from v5.3 to v6.0
v6.0 won't be fully compatible with v5.3 because some API changes will happen.
Changes that are either difficult for a compiler to precisely report, or may not be reported by a compiler at all are highlighted in bold. If you are experiencing bugs after migration, check these changes first.
- You must update
lv_conf.hfromlv_conf_template.h. lv_obj_set_event_cb(obj, callback)instead oflv_btn_set_action(btn, LV_BTN_ACTION_..., callback). Event callbacks are used to handle all the former actions (i.e. long pressed, released are handled by a single function). This has many advantages, one being that it allows you to detect click events on any object.- Objects now automatically detect if they've been deleted, no need for returning
LV_RES_OK/LV_RES_INVin yourlv_event_cb_t. For this reason,lv_event_cb_tfunctions returnvoid. - Dynamically changeable display config. Instead of hardcoded in
lv_conf.h. - Need to explicitly initialize your display buffer(s) and add it/them to your display driver.
LV_HOR_RESandLV_VER_RESare replaced withLV_HOR_RES_MAXandLV_VER_RES_MAX, which define the maximum horizontal and vertical resolution of your display, respectively. The old macros are still present, but will not work well with more than one display.lv_obj_get_free_ptrandlv_obj_get_free_numare replacedlv_obj_get_user_data. The type of the user data can be changed inlv_conf.h- User data is now available for some other structures as well, like driver objects.
- Driver function signatures now take an initial first parameter, the driver object itself. This allows your driver functions to work with more than one physical device without requiring two separate drivers to be written.
- (i.e.
indevcallbacks now take an initial first parameter oflv_indev_t *)
- (i.e.
disp_flushis nowflush_cb. Instead of directly taking x/y coordinates, it takes in anlv_area_twhich has fields x1, y1, x2, y2- Font system is updated and now supports kerning. You must generate your fonts again with the new converter.
- Callbacks of
lv_tasknow receive a pointer to the task itself instead of the user data. The user data can be accessed astask->user_data lv_anim_set_...(&a)function are added to replace manual initialization of ```lv_anim_t`- Renames in
lv_anim_t. - The
ready_cbnow receives the wholelv_anim_t *structure as an argument, not avoid *. lv_style_anim_tis removed. Uselv_anim_t a;andlv_style_anim_set_...(&a, ...)intstead.- All padding and fits are left, right, top, bottom instead of ver and hor.
- lv_canvas: use
lv_draw_...functions - All the macros like
USE_LV_BTNnow are likeLV_USE_BTN. - Rename symbols:
SYMBOL_HOME-->LV_SYMBOL_HOME - Rename
LV_GROUP_KEY_...toLV_KEY_... - The GPU API has changed. You will need to update any GPU drivers you may have written.
- minor function API changes...