Merge pull request #55 from Pablo2048/master

LVGL7.0.2

Author: Pablo2048

library.json

@@ -12,7 +12,7 @@
     "type": "git",
     "url": "https://github.com/lvgl/lv_arduino"
   },
-  "version": "3.0.0",
+  "version": "3.0.1",
   "license": "MIT",
   "frameworks": "arduino",
   "build": {

library.properties

@@ -1,5 +1,5 @@
 name=lv_arduino
-version=3.0.0
+version=3.0.1
 author=Gabor Kiss-Vamosi
 maintainer=Pavel Brychta <[email protected]>
 sentence=Full-featured Graphics Library for embedded systems

src/CHANGELOG.md

@@ -1,10 +1,34 @@
 # Changelog
 
-## v7.0.1 (under development)
-*Available in the `master` branch*
+
+## v7.0.2 (16.06.2020)
+
+- `lv_textarea` fix wrong cursor position when clicked after the last character
+- Change all text related indices from 16-bit to 32-bit integers throughout whole library. #1545
+- Fix gestures
+- Do not call `set_px_cb` for transparent pixel
+- Fix list button focus in material theme
+- Fix crash when the a text area is cleared with the backspace of a keyboard
+- Add version number to `lv_conf_template.h`
+- Add log in true double buffering mode with `set_px_cb`
+- `lv_dropdown`: fix missing `LV_EVENT_VALUE_CHANGED` event when used with encoder
+- `lv_tileview`: fix if not the {0;0} tile is created first
+- `lv_debug`: restructure to allow asserting in from `lv_misc` too
+- add assert if `_lv_mem_buf_get()` fails
+- `lv_textarea`: fix character delete in password mode
+- Update `LV_OPA_MIN` and `LV_OPA_MAX` to widen the opacity processed range
+- `lv_btnm` fix sending events for hidden buttons
+- `lv_gaguge` make `lv_gauge_set_angle_offset` offset the labels and needles too
+- Fix typo in the API `scrllable` -> `scrollable`
+- `tabview` by default allow auto expanding the page only to right and bottom (#1573)
+- fix crash when drawing gradient to the same color
+- chart: fix memory leak
+
+## v7.0.1 (01.06.2020)
 
 ### Bugfixes
 - Make the Microptyhon working by adding the required variables as GC_ROOT
+- Prefix some internal API functions with `_` to reduce the API of LVGL 
 - Fix built-in SimSun CJK font
 - Fix UTF-8 encoding when `LV_USE_ARABIC_PERSIAN_CHARS` is enabled
 - Fix DMA2D usage when 32 bit images directly blended
@@ -14,8 +38,8 @@
 - Improve DMA2D blending
 - Remove memcpy from `lv_ll` (caused issues with some optimization settings)
 - `lv_chart` fix X tick drawing
-- fix vertical dashed line drawing
-- some additonal minor fixes and formattings
+- Fix vertical dashed line drawing
+- Some additonal minor fixes and formattings
 
 ## v7.0.0 (18.05.2020)
 

src/README.md

@@ -1,4 +1,4 @@
-<h1 align="center"> LVGL - Little and Versatile Graphics Library</h1>
+<h1 align="center"> LVGL - Light and Versatile Graphics Library</h1>
 <p align="center">
 <a href="https://github.com/lvgl/lvgl/blob/master/LICENCE.txt"><img src="https://img.shields.io/badge/licence-MIT-blue.svg"></a>
 <a href="https://github.com/lvgl/lvgl/releases/tag/v7.0.0"><img src="https://img.shields.io/badge/version-7.0.0-blue.svg"></a>
@@ -28,6 +28,7 @@ LVGL provides everything you need to create embedded GUI with easy-to-use graphi
 - [Add LVGL to your project](#add-lvgl-to-your-project)
 - [Learn the basics](#learn-the-basics)
 - [Examples](#examples)
+- [Release policy](#release-policy)
 - [Contributing](#contributing)
 
 
@@ -49,7 +50,7 @@ LVGL provides everything you need to create embedded GUI with easy-to-use graphi
 * **Documentation** and API references
 
 ## Supported devices
-Basically, every modern controller  (which is able to drive a display( is suitable to run LVGL. The minimal requirements are:
+Basically, every modern controller  (which is able to drive a display) is suitable to run LVGL. The minimal requirements are:
 - 16, 32 or 64 bit microcontroller or processor
 - &gt; 16 MHz clock speed is recommended
 - Flash/ROM: &gt; 64 kB for the very essential components (&gt; 180 kB is recommended)
@@ -89,19 +90,19 @@ Choose a project with your favourite IDE:
 The steps below show how to setup LVGL on an embedded system with a display and a touchpad. 
 You can use the [Simulators](https://docs.lvgl.io/v7/en/html/get-started/pc-simulator) to get ready to use projects which can be run on your PC. 
 
-1. [Download](https://lvgl.com/developers) or [Clone](https://github.com/lvgl/lvgl) the library
+1. [Download](https://github.com/lvgl/lvgl/archive/master.zip) or [Clone](https://github.com/lvgl/lvgl) the library
 2. Copy the `lvgl` folder into your project
-3. Copy `lvgl/lv_conf_template.h` as `lv_conf.h` next to the `lvgl` folder and set at least `LV_HOR_RES_MAX`, `LV_VER_RES_MAX` and `LV_COLOR_DEPTH`. Don't forget to **change the `#if 0` statement near the top of the file to `#if 1`**, otherwise you will get compilation errors.
+3. Copy `lvgl/lv_conf_template.h` as `lv_conf.h` next to the `lvgl` folder, change the `#if 0` statement near the top of the file to `#if 1` and set at least `LV_HOR_RES_MAX`, `LV_VER_RES_MAX` and `LV_COLOR_DEPTH`.
 4. Include `lvgl/lvgl.h` where you need to use LVGL related functions.
-5. Call `lv_tick_inc(x)` every `x` milliseconds **in a Timer or Task** (`x` should be between 1 and 10). It is required for the internal timing of LVGL.
+5. Call `lv_tick_inc(x)` every `x` milliseconds (should be 1..10) in a Timer or Task. It is required for the internal timing of LVGL.
 6. Call `lv_init()`
 7. Create a display buffer for LVGL
 ```c
 static lv_disp_buf_t disp_buf;
 static lv_color_t buf[LV_HOR_RES_MAX * 10];                     /*Declare a buffer for 10 lines*/
 lv_disp_buf_init(&disp_buf, buf, NULL, LV_HOR_RES_MAX * 10);    /*Initialize the display buffer*/
 ```
-8. Implement and register a function which can **copy a pixel array** to an area of your display:
+8. Implement and register a function which can copy a pixel array to an area of your display:
 ```c
 lv_disp_drv_t disp_drv;               /*Descriptor of a display driver*/
 lv_disp_drv_init(&disp_drv);          /*Basic initialization*/
@@ -114,7 +115,7 @@ void my_disp_flush(lv_disp_t * disp, const lv_area_t * area, lv_color_t * color_
     int32_t x, y;
     for(y = area->y1; y <= area->y2; y++) {
         for(x = area->x1; x <= area->x2; x++) {
-            set_pixel(x, y, *color_p);  /* Put a pixel to the display.*/
+            my_set_pixel(x, y, *color_p);  /* Put a pixel to the display.*/
             color_p++;
         }
     }
@@ -123,7 +124,7 @@ void my_disp_flush(lv_disp_t * disp, const lv_area_t * area, lv_color_t * color_
 }
     
 ```
-9. Implement and register a function which can **read an input device**. E.g. for a touch pad:
+9. Implement and register a function which can read an input device. E.g. for a touch pad:
 ```c
 lv_indev_drv_init(&indev_drv);             /*Descriptor of a input device driver*/
 indev_drv.type = LV_INDEV_TYPE_POINTER;    /*Touch pad is a pointer-like device*/
@@ -132,37 +133,31 @@ lv_indev_drv_register(&indev_drv);         /*Finally register the driver*/
 
 bool my_touchpad_read(lv_indev_drv_t * indev_driver, lv_indev_data_t * data)
 {
-    static lv_coord_t last_x = 0;
-    static lv_coord_t last_y = 0;
-
-    /*Save the state and save the pressed coordinate*/
-    data->state = touchpad_is_pressed() ? LV_INDEV_STATE_PR : LV_INDEV_STATE_REL; 
-    if(data->state == LV_INDEV_STATE_PR) touchpad_get_xy(&last_x, &last_y);
-   
-    /*Set the coordinates (if released use the last pressed coordinates)*/
-    data->point.x = last_x;
-    data->point.y = last_y;
+    data->state = my_touchpad_is_pressed() ? LV_INDEV_STATE_PR : LV_INDEV_STATE_REL; 
+    if(data->state == LV_INDEV_STATE_PR) touchpad_get_xy(&data->point.x, &data->point.y);
 
     return false; /*Return `false` because we are not buffering and no more data to read*/
 }
 ```
 10. Call `lv_task_handler()` periodically every few milliseconds in the main `while(1)` loop, in Timer interrupt or in an Operation system task. 
 It will redraw the screen if required, handle input devices etc. 
 
+For more detailed desription visit the [Porting](https://docs.lvgl.io/v7/en/html/porting/index.html) section of the documentation.
 
 ## Learn the basics
 
-In this section you can ready the very basics. For a more detailed guide check the [Quick overview](https://docs.lvgl.io/v7/en/html/get-started/quick-overview.html#learn-the-basics) in the documentation. 
+In this section you can read the very basics of LVGL. 
+For a more detailed guide check the [Quick overview](https://docs.lvgl.io/v7/en/html/get-started/quick-overview.html#learn-the-basics) in the documentation. 
 
 ### Widgets (Objects)
 
-The graphical elements like Buttons, Labels, Sliders, Charts etc are called objects in LittelvGL. Go to [Object types](https://docs.lvgl.io/v7/en/html/widgets/index) to see the full list of available types.
+The graphical elements like Buttons, Labels, Sliders, Charts etc are called objects or widgets in LVGL. Go to [Widgets](https://docs.lvgl.io/v7/en/html/widgets/index) to see the full list of available types.
 
 Every object has a parent object. The child object moves with the parent and if you delete the parent the children will be deleted too. Children can be visible only on their parent.
 
 The *screen* are the "root" parents. To get the current screen call `lv_scr_act()`.
 
-You can create a new object with `lv_<type>_create(parent, obj_to_copy)`. It will return an `lv_obj_t *` variable which should be used as a reference to the object to set its parameters. 
+You can create a new object with `lv_<type>_create(parent, obj_to_copy)`. It will return an `lv_obj_t *` variable which should be used as a reference to the object to set its parameters later. 
 The first parameter is the desired *parent*, the second parameters can be an object to copy (`NULL` if unused). 
 For example:
 ```c
@@ -176,31 +171,38 @@ lv_obj_set_y(btn1, 10);
 lv_obj_set_size(btn1, 200, 50);
 ```
 
-The objects has type specific parameters too which can be set by `lv_<type>_set_<paramters_name>(obj, <value>)` functions. For example:
+The objects have type specific parameters too which can be set by `lv_<type>_set_<paramters_name>(obj, <value>)` functions. For example:
 ```c
 lv_slider_set_value(slider1, 70, LV_ANIM_ON);
 ```
 
 To see the full API visit the documentation of the object types or the related header file (e.g. `lvgl/src/lv_objx/lv_slider.h`).
 
+
+To create a new screen pass `NULL` as the fisrt paramater of a *create* function:
+```c
+lv_obj_t * scr2 = lv_obj_create(NULL, NULL);    /*Create a screen*/
+lv_scr_load(scr2);                              /*Load the new screen*/
+```
+
 ### Styles
-Widgets are created with a default appearance but it can be changed by adding new styles to the object. A new style can be created like this:
+Widgets are created with a default appearance but it can be changed by adding new styles to them. A new style can be created like this:
 ```c
 static lv_style_t style1; /*Should be static, global or dynamically allocated*/
 lv_style_init(&style1);
 lv_style_set_bg_color(&style1, LV_STATE_DEFAULT, LV_COLOR_RED);  /*Default background color*/ 
 lv_style_set_bg_color(&style1, LV_STATE_PRESSED, LV_COLOR_BLUE); /*Pressed background color*/
 ```
 
-The wigedt have *parts* which can be referenced via `LV_<TYPE>_PART_<PART_NAME>`. E.g. `LV_BRN_PART_MAIN` or `LV_SLIDER_PART_KNOB`. See the documentation of the widgets to see the exisitng parts.
+The wigedt have *parts* which can be referenced via `LV_<TYPE>_PART_<PART_NAME>`. E.g. `LV_BTN_PART_MAIN` or `LV_SLIDER_PART_KNOB`. See the documentation of the widgets to see the exisitng parts.
 
 To add the style to a button:
-```
+```c
 lv_obj_add_style(btn1, LV_BTN_PART_MAIN, &style1);
 ```
 
-To remove all styles from an object use:
-```c
+To remove all styles from a part of an object:
+```cc
 lv_obj_reset_style_list(obj, LV_OBJ_PART_MAIN);
 ```
 
@@ -210,7 +212,7 @@ Learn more in [Style overview](https://docs.lvgl.io/v7/en/html/overview/style) s
 Events are used to inform the user if something has happened with an object. You can assign a callback to an object which will be called if the object is clicked, released, dragged, being deleted etc. It should look like this: 
 
 ```c
-lv_obj_set_event_cb(btn, btn_event_cb);                 /*Assign a callback to the button*/
+lv_obj_set_event_cb(btn, btn_event_cb);     /*Assign a callback to the button*/
 
 ...
 
@@ -262,6 +264,26 @@ label.set_text("Button")
 lv.scr_load(scr)
 ```
 
+## Release policy
+LVGL follows the rules of [Semantic versioning](https://semver.org/):
+- Major versions for incompatible API changes. E.g. v5.0.0, v6.0.0
+- Minor version for new but backward-compatible functionalities. E.g. v6.1.0, v6.2.0
+- Patch version for backward-compatible bug fixes. E.g. v6.1.1, v6.1.2
+
+Branches:
+- `master` most recent version, patches are merged directly here. 
+- `dev` merge new features here until they are merged into `master`.
+- `release/vX` there is a branch for every major version to allow adding specific, not forward compatible fixes.
+
+LVGL has a monthly periodic release cycle.
+- **1st Tuesday of the month** 
+  - Make a major, minor, or patch release from `master` depending on the new features.
+  - After that merge only patches into `master` and add new features into the `dev`.
+- **3rd Tuesday of the month** 
+  - Make a patch release from `master`.
+  - After that merge the new features from the `dev` to `master` branch. 
+  - In the rest of the month merge only patches into `master` and new features into `dev` branch.
+  
 ## Contributing
 To ask questions please use the [Forum](https://forum.lvgl.io).
 For development-related things (bug reports, feature suggestions) use [GitHub's Issue tracker](https://github.com/lvgl/lvgl/issues). 

src/docs/CONTRIBUTING.md

@@ -1,9 +1,6 @@
 # Contributing to LVGL
 
-**Do you have some free time to spend with programming?
-Are you working on an embedded GUI project with LVGL?
-See how can you help to improve the graphics library and help others!**
-
+Thank you for considering contributing to LVGL. If you have some spare time to spend with programming you will certainly find a way to helpimproving LVGL. Do not afraid to take the first step! Everybody is welcome independently from gender, age, color, location, or skill level. So don't be shy, pick a point from the list below that you are interested in, and let's go! :rocket: 
 
 - [Overview](#overview)
 - [How to send a pull request?](#how-to-send-a-pull-request) 
@@ -20,7 +17,7 @@ See how can you help to improve the graphics library and help others!**
 There are many ways to join the community. If you have some time to work with us you will surely find something that fits you! You can:
 - **Help others** in the [Forum](https://forum.lvgl.io).
 - **Inspire people** by speaking about your project in [My project](https://forum.lvgl.io/c/my-projects) category in the Forum.
-- **Improve and/or translate the documentation.** Go to the [Documentation](https://github.com/lvgl/docs) repository to learn more
+- **Improve and/or translate the documentation.** Go to the [Documentation](https://github.com/lvgl/docs) repository to learn more.
 - **Write a blog post** about your experiences. See how to do it in the [Blog](https://github.com/lvgl/blog) repository
 - **Report and/or fix bugs** in [GitHub's issue tracker](https://github.com/lvgl/lvgl/issues)
 - **Help the development**. Check the [Open issues](https://github.com/lvgl/lvgl/issues) especially the ones with [Help wanted](https://github.com/lvgl/lvgl/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) label and tell your ideas about a topic or implement a feature.

src/library.json

@@ -1,6 +1,6 @@
 {
     "name": "lvgl",
-    "version": "v7.0.1",
+    "version": "v7.0.2",
     "keywords": "graphics, gui, embedded, littlevgl",
     "description": "Graphics library to create embedded GUI with easy-to-use graphical elements, beautiful visual effects and low memory footprint. It offers anti-aliasing, opacity, and animations using only one frame buffer.",
     "repository":

src/lv_conf_template.h

@@ -1,6 +1,6 @@
 /**
  * @file lv_conf.h
- *
+ * Configuration file for LVGL v7.0.2
  */
 
 /*
@@ -330,7 +330,7 @@ typedef void * lv_indev_drv_user_data_t;            /*Type of user data in the i
 
 /* The built-in fonts contains the ASCII range and some Symbols with  4 bit-per-pixel.
  * The symbols are available via `LV_SYMBOL_...` defines
- * More info about fonts: https://docs.lvgl.com/#Fonts
+ * More info about fonts: https://docs.lvgl.io/v7/en/html/overview/font.html
  * To create a new font go to: https://lvgl.com/ttf-font-to-c-array
  */
 
@@ -498,7 +498,7 @@ typedef void * lv_obj_user_data_t;
 #endif
 #endif
 
-/*1: enable `lv_obj_realaign()` based on `lv_obj_align()` parameters*/
+/*1: enable `lv_obj_realign()` based on `lv_obj_align()` parameters*/
 #define LV_USE_OBJ_REALIGN          1
 
 /* Enable to make the object clickable on a larger area.

src/lvgl.h

@@ -78,8 +78,8 @@ extern "C" {
 /*Current version of LVGL*/
 #define LVGL_VERSION_MAJOR   7
 #define LVGL_VERSION_MINOR   0
-#define LVGL_VERSION_PATCH   1
-#define LVGL_VERSION_INFO    "dev"
+#define LVGL_VERSION_PATCH   2
+#define LVGL_VERSION_INFO ""
 
 /**********************
  *      TYPEDEFS