From 3b3ba1b5df6ec7aff5d1f179b2a4bc7e30c6a02b Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Sun, 30 Jul 2017 09:46:37 +0200 Subject: [PATCH 01/50] Create CODE_OF_CONDUCT.md --- CODE_OF_CONDUCT.md | 46 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 46 insertions(+) create mode 100644 CODE_OF_CONDUCT.md diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md new file mode 100644 index 000000000..c7d7eeb14 --- /dev/null +++ b/CODE_OF_CONDUCT.md @@ -0,0 +1,46 @@ +# Contributor Covenant Code of Conduct + +## Our Pledge + +In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation. + +## Our Standards + +Examples of behavior that contributes to creating a positive environment include: + +* Using welcoming and inclusive language +* Being respectful of differing viewpoints and experiences +* Gracefully accepting constructive criticism +* Focusing on what is best for the community +* Showing empathy towards other community members + +Examples of unacceptable behavior by participants include: + +* The use of sexualized language or imagery and unwelcome sexual attention or advances +* Trolling, insulting/derogatory comments, and personal or political attacks +* Public or private harassment +* Publishing others' private information, such as a physical or electronic address, without explicit permission +* Other conduct which could reasonably be considered inappropriate in a professional setting + +## Our Responsibilities + +Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior. + +Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful. + +## Scope + +This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers. + +## Enforcement + +Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at [atom@github.com](mailto:atom@github.com). All complaints will be reviewed and investigated and will result in a response that is deemed necessary and appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately. + +Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership. + +## Attribution + +This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version] + +[homepage]: http://contributor-covenant.org +[version]: http://contributor-covenant.org/version/1/4/ From 3bf1dde5b295c24b669cdcf425bb9dc57166ccea Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Sun, 30 Jul 2017 11:52:11 +0200 Subject: [PATCH 02/50] Create CONTRIBUTING.md --- CONTRIBUTING.md | 152 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 152 insertions(+) create mode 100644 CONTRIBUTING.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 000000000..9d4fb173a --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,152 @@ +# Contributing to Littlev Graphics Library +First of all thank you for reading these guide before contributing! + +## Who can contribute? +Basically everybody is welcome in contributing independently from skills, programming level or any personal attribute. + +There are several ways to contribute in the graphics library like: +* Report an issue +* Suggest feature +* Fix an issue +* Implement a feature + +Please, take a look at [CODE_OF_CONDUCT](https://github.com/littlevgl/lvgl/blob/master/CODE_OF_CONDUCT.md) + +## How to report an issue? +### Simple issue +If you find an issue which is very simple to fix, and you fixed it, please send a pull request. +A simple issue could be: +* Misspelled names + * Comment: misspelling or grammatical error in comments + * Variable: misspelled variable name (e.g. ***ojb**_next* instead of ***obj**_next*) + * Define: only local defines in files becuse global defines affect API + * Function: only static function name because global functions affect API +* Not handled error case: + * A parameter can be NULL (during normal usage) + * Negative index in array or over indexing + * Overflow in variable + * Anything which is local an can be fixed with a few lines of code + +### Complex issue +If you find a complex issue which: +* might be simple but you don't know its origin +* affects a whole file, module or even the architecture +* needs deeper discussion + +please create a **new issue** and describe +* what you experience +* how to reproduce the issue (maybe with example code) +* version you are using (lvgl.h) +* misc library version (misc.h) + +## How to suggest a feature? +If you have a good and useful idea you can use GitHub issues to suggest a new feature. Please note the followings on feature requests: +* What the new feature is about? +* Why/Where/In which case is it useful/helpful/relevant? +* Can you help in implementing it? + +After a discussion we figure out the specification of the new feature and the technical details/implementation possibilities. +With the knowledge of how to do it somebody can implement the new feature. + +The new feature should be in a new branch. + +Keep in mind if you wouldn't like to do the implementation there is no guarantee that it will be ready in the new future. +However if you would like to force it, take a look at this page: [Feature request service](http://www.gl.littlev.hu/services#feature) + +## Styling guide +### Git Commit Messages +* Use the present tense ("Add feature" not "Added feature") +* Use the imperative mood ("Move cursor to..." not "Moves cursor to...") +* Limit the first line to 72 characters or less +* Reference issues and pull requests liberally after the first line + +### File format +Use [misc/templ/templ.c](https://github.com/littlevgl/misc/blob/master/templ/templ.c) and [misc/templ/templ.h](https://github.com/littlevgl/misc/blob/master/templ/templ.h) + +### Function +* try to write function shorter then is 40 lines +* always shorter then 100 lines (except very straightforwards) +* in function names: + * words sperated by '_' + * only lower case letters + * only clear abbreviation (OK: *lv_xy_get_title_txt*, BAD: *lv_xy_get_ttxt*) + +#### Global functions names (API) +An example: *lv_btn_set_state()* +* starts with *lv* +* followed by module name: *btn*, *label*, *style* etc. +* followed by the action: *set*, *get*, *refr* etc. +* closed with subject: *name*, *size*, *state* etc. + * optional like in *lv_obj_del()* it is missing + * could contain more words: *long_mode*, *point_all* + +#### Static functions names +Names can be used freely. + +### Variables +* words sperated by '_' +* always lower case +* one line one declaration (BAD: char x, y;) +* use `` (*uint8_t*, *int32_t* etc) +* declare variables when needed (not all at function start) +* use the smallest required scope +* variables in a file (outside functions) are always *static* +* do not use global variables (use functions to set/get static variables) + +### Defines +* always upper case +* starts with *LV_* +* followed by the modul: *OBJ*, *BTN* etc. +* closed by the subject: *ANIM_TIME*, *VALUE_MIN*, *WIDTH_DEF* + +### Comments +Before every function have a comment like this: + +``` +/** + * Return with the screen of an object + * @param obj pointer to an object + * @return pointer to a screen + */ +lv_obj_t * lv_obj_get_scr(lv_obj_t * obj); +``` + +Always use `/* Something */` format and NOT `//Something` + +Write readable code to avoid descriptive comments like: +`x++; /* Add 1 to x */`. +The code should show clearly what you are doing. + +You should write **why** have you done this: +`x++; /*Because of closeing '\0' of the string */` + +### Formatting +Here is example to show bracket placing and using of white spaces: +``` +/** + * Set a new text for a label. Memory will be allocated to store the text by the label. + * @param label pointer to a label object + * @param text '\0' terminated character string. NULL to refresh with the current text. + */ +void lv_label_set_text(lv_obj_t * label, const char * text) +{ /*Main bracket in new line*/ + + if(label == NULL) return; /*No bracket only if the command is inline with the if statement*/ + + lv_obj_inv(label); + + lv_label_ext_t * ext = lv_obj_get_ext(label); + + /*Comment before a section */ + if(text == ext->txt || text == NULL) { /*Bracket start inline*/ + lv_label_refr_text(label); + return; + } + + . + . + . +} +``` + +Use 4 spaces indentation instead of tab. From b8226ace046b60f2dcee1d96d131560dd10a2b40 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Sun, 30 Jul 2017 12:11:41 +0200 Subject: [PATCH 03/50] Update CONTRIBUTING.md --- CONTRIBUTING.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 9d4fb173a..01edb99d6 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,6 +1,24 @@ # Contributing to Littlev Graphics Library First of all thank you for reading these guide before contributing! +In this guid you can read how can you help in developing the Littlev Graphic Library. These are not strick rules reather just suggestions. If you have a constructive idea just create pull request on this document! + +### Table Of Content +* [Who can contribute?](#who-can-contribute) +* [How to report an issue?](#how-to-report-an-issue) + * [Simple issue](#simple-issue) + * [Complex issue](#complex-issue) +* [How to suggest a feature?](#how-to-suggest-a-feature) +* [Styling guide](#styling-guide) + * [Git Commit Messages](#Git-mommit-messages) + * [File format](#file-format) + * [Function](#functions) + * [Variables](#variables) + * [Defines](#define) + * [Comments](#comments) + * [Formatting](#formatting) + + ## Who can contribute? Basically everybody is welcome in contributing independently from skills, programming level or any personal attribute. @@ -13,6 +31,7 @@ There are several ways to contribute in the graphics library like: Please, take a look at [CODE_OF_CONDUCT](https://github.com/littlevgl/lvgl/blob/master/CODE_OF_CONDUCT.md) ## How to report an issue? + ### Simple issue If you find an issue which is very simple to fix, and you fixed it, please send a pull request. A simple issue could be: @@ -54,6 +73,7 @@ Keep in mind if you wouldn't like to do the implementation there is no guarantee However if you would like to force it, take a look at this page: [Feature request service](http://www.gl.littlev.hu/services#feature) ## Styling guide + ### Git Commit Messages * Use the present tense ("Add feature" not "Added feature") * Use the imperative mood ("Move cursor to..." not "Moves cursor to...") From ec776b48d5352b95c87b8d460ac420e0f0d62468 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Sun, 30 Jul 2017 12:22:39 +0200 Subject: [PATCH 04/50] Create TODO_MAJOR.md --- TODO_MAJOR.md | 6 ++++++ 1 file changed, 6 insertions(+) create mode 100644 TODO_MAJOR.md diff --git a/TODO_MAJOR.md b/TODO_MAJOR.md new file mode 100644 index 000000000..a77ab9563 --- /dev/null +++ b/TODO_MAJOR.md @@ -0,0 +1,6 @@ +# TODOs for major versions +Major versions released typically when API changes are required + +## v5 +- [ ] *lv_ta_get_txt* rename to *lv_ta_get_text* +- [ ] btnm_action pass text instead of text_id From 31fcc7d3957b3c8d81f70c37a0548bc8a804aa53 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Sun, 30 Jul 2017 13:32:59 +0200 Subject: [PATCH 05/50] Create TODO_MINOR.md --- TODO_MINOR.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) create mode 100644 TODO_MINOR.md diff --git a/TODO_MINOR.md b/TODO_MINOR.md new file mode 100644 index 000000000..76830216a --- /dev/null +++ b/TODO_MINOR.md @@ -0,0 +1,18 @@ +# TODOs for minor versions +Minor versions released when one or more new feature is addded without changing the API + +## Ideas +- label: add a horzintal line (e.g. underline or line through). +- label long mode: dot begin +- music player app +- files app update: show content as text +- controll GUI with serial port +- automatically build GUI from file (e.g. XML, JSON or HTML) + +## v4.2 +- [x] lv_group: to control without touch pad. Issue [#14](https://github.com/littlevgl/lvgl/issues/14) +- [x] lv_page: scrl def fit modification: hor:false, ver:true, and always set width to parent width +- [x] lv_btn: add lv_btn_get_..._action +- [x] lv_list: add lv_list_get_element_label/img +- [x] style animations add +- [ ] btnm: besides 0. byte (width dsc) 1. byte: hidden (\177, 0x7F, delete) From 2846cff2d3d24311261bad7a0666d199f9792088 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Sun, 30 Jul 2017 13:35:06 +0200 Subject: [PATCH 06/50] Update TODO_MINOR.md --- TODO_MINOR.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/TODO_MINOR.md b/TODO_MINOR.md index 76830216a..f7566dd42 100644 --- a/TODO_MINOR.md +++ b/TODO_MINOR.md @@ -1,7 +1,11 @@ # TODOs for minor versions Minor versions released when one or more new feature is addded without changing the API +## Contributing +Please create an issue to suggest a new feature instead of adding pull request to this file + ## Ideas +Here are ideas whish are not assigned to a minor version yet: - label: add a horzintal line (e.g. underline or line through). - label long mode: dot begin - music player app From e65f781bbd4fcc4d6a5f7549fc90f9943c82fd80 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Sun, 30 Jul 2017 13:35:27 +0200 Subject: [PATCH 07/50] Update TODO_MINOR.md --- TODO_MINOR.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/TODO_MINOR.md b/TODO_MINOR.md index f7566dd42..bcb422731 100644 --- a/TODO_MINOR.md +++ b/TODO_MINOR.md @@ -2,7 +2,7 @@ Minor versions released when one or more new feature is addded without changing the API ## Contributing -Please create an issue to suggest a new feature instead of adding pull request to this file +Please create an issue to suggest a new feature instead of adding pull request to this file. ## Ideas Here are ideas whish are not assigned to a minor version yet: From c72c8c62debabd1fd51119ac08d315550601d03a Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Sun, 30 Jul 2017 13:35:55 +0200 Subject: [PATCH 08/50] Update TODO_MAJOR.md --- TODO_MAJOR.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/TODO_MAJOR.md b/TODO_MAJOR.md index a77ab9563..0f4c20efc 100644 --- a/TODO_MAJOR.md +++ b/TODO_MAJOR.md @@ -1,6 +1,9 @@ # TODOs for major versions Major versions released typically when API changes are required +## Contributing +Please create an issue to suggest a new feature instead of adding pull request to this file. + ## v5 - [ ] *lv_ta_get_txt* rename to *lv_ta_get_text* - [ ] btnm_action pass text instead of text_id From 7b26cdc75e1c251cbecaaf1cbf2ed942de15d4e4 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Sun, 30 Jul 2017 13:39:27 +0200 Subject: [PATCH 09/50] Create TODO_PATCH.md --- TODO_PATCH.md | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 TODO_PATCH.md diff --git a/TODO_PATCH.md b/TODO_PATCH.md new file mode 100644 index 000000000..31ccbcf97 --- /dev/null +++ b/TODO_PATCH.md @@ -0,0 +1,11 @@ +# TODOs for patch versions +Patch versions contains bugfixes without changing the API. +Bugfixes are done in `bugfix `brache` + +## Contributing +Please create an issue to introduce a buf instead of adding pull request to this file. + +## Known issues + +## v4.1.2 +- [ ] ... From 931e74e2a6b51fbe0d9969729e93d616de1b6c94 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Sun, 30 Jul 2017 13:40:36 +0200 Subject: [PATCH 10/50] Update TODO_PATCH.md --- TODO_PATCH.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/TODO_PATCH.md b/TODO_PATCH.md index 31ccbcf97..f2db7adff 100644 --- a/TODO_PATCH.md +++ b/TODO_PATCH.md @@ -1,11 +1,13 @@ # TODOs for patch versions Patch versions contains bugfixes without changing the API. -Bugfixes are done in `bugfix `brache` + +Bugfixes are done in `bugfix` branche. ## Contributing Please create an issue to introduce a buf instead of adding pull request to this file. ## Known issues +* ... ## v4.1.2 - [ ] ... From 04197a83d0b25f4bddd5d3a2ad3360f3bff3a825 Mon Sep 17 00:00:00 2001 From: Kiss-Vamosi Gabor Date: Sun, 30 Jul 2017 13:42:30 +0200 Subject: [PATCH 11/50] create docs folder and move documents there --- CODE_OF_CONDUCT.md => docs/CODE_OF_CONDUCT.md | 0 CONTRIBUTING.md => docs/CONTRIBUTING.md | 0 README.md => docs/README.md | 0 TODO_MAJOR.md => docs/TODO_MAJOR.md | 0 TODO_MINOR.md => docs/TODO_MINOR.md | 0 TODO_PATCH.md => docs/TODO_PATCH.md | 0 licence.txt => docs/licence.txt | 0 7 files changed, 0 insertions(+), 0 deletions(-) rename CODE_OF_CONDUCT.md => docs/CODE_OF_CONDUCT.md (100%) rename CONTRIBUTING.md => docs/CONTRIBUTING.md (100%) rename README.md => docs/README.md (100%) rename TODO_MAJOR.md => docs/TODO_MAJOR.md (100%) rename TODO_MINOR.md => docs/TODO_MINOR.md (100%) rename TODO_PATCH.md => docs/TODO_PATCH.md (100%) rename licence.txt => docs/licence.txt (100%) diff --git a/CODE_OF_CONDUCT.md b/docs/CODE_OF_CONDUCT.md similarity index 100% rename from CODE_OF_CONDUCT.md rename to docs/CODE_OF_CONDUCT.md diff --git a/CONTRIBUTING.md b/docs/CONTRIBUTING.md similarity index 100% rename from CONTRIBUTING.md rename to docs/CONTRIBUTING.md diff --git a/README.md b/docs/README.md similarity index 100% rename from README.md rename to docs/README.md diff --git a/TODO_MAJOR.md b/docs/TODO_MAJOR.md similarity index 100% rename from TODO_MAJOR.md rename to docs/TODO_MAJOR.md diff --git a/TODO_MINOR.md b/docs/TODO_MINOR.md similarity index 100% rename from TODO_MINOR.md rename to docs/TODO_MINOR.md diff --git a/TODO_PATCH.md b/docs/TODO_PATCH.md similarity index 100% rename from TODO_PATCH.md rename to docs/TODO_PATCH.md diff --git a/licence.txt b/docs/licence.txt similarity index 100% rename from licence.txt rename to docs/licence.txt From 81e84ed829a917c9e7c971db9eeab37aa7d4dcfb Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Sun, 30 Jul 2017 13:44:11 +0200 Subject: [PATCH 12/50] Update CONTRIBUTING.md --- docs/CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md index 01edb99d6..55a4e8c09 100644 --- a/docs/CONTRIBUTING.md +++ b/docs/CONTRIBUTING.md @@ -28,7 +28,7 @@ There are several ways to contribute in the graphics library like: * Fix an issue * Implement a feature -Please, take a look at [CODE_OF_CONDUCT](https://github.com/littlevgl/lvgl/blob/master/CODE_OF_CONDUCT.md) +Please, take a look at [CODE_OF_CONDUCT](https://github.com/littlevgl/lvgl/blob/master/docs/CODE_OF_CONDUCT.md) ## How to report an issue? From 46f51b1d67b5e35d2f47c48a2bc845c16f31a0d2 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Sun, 30 Jul 2017 13:45:06 +0200 Subject: [PATCH 13/50] Update CONTRIBUTING.md --- docs/CONTRIBUTING.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md index 55a4e8c09..676a47272 100644 --- a/docs/CONTRIBUTING.md +++ b/docs/CONTRIBUTING.md @@ -14,7 +14,7 @@ In this guid you can read how can you help in developing the Littlev Graphic Lib * [File format](#file-format) * [Function](#functions) * [Variables](#variables) - * [Defines](#define) + * [Defines](#defines) * [Comments](#comments) * [Formatting](#formatting) @@ -83,7 +83,7 @@ However if you would like to force it, take a look at this page: [Feature reques ### File format Use [misc/templ/templ.c](https://github.com/littlevgl/misc/blob/master/templ/templ.c) and [misc/templ/templ.h](https://github.com/littlevgl/misc/blob/master/templ/templ.h) -### Function +### Functions * try to write function shorter then is 40 lines * always shorter then 100 lines (except very straightforwards) * in function names: From 053e70342c2abd54474d79ae24b53eef6a65250b Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Sun, 30 Jul 2017 13:45:36 +0200 Subject: [PATCH 14/50] Update CONTRIBUTING.md --- docs/CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md index 676a47272..6b741f7fb 100644 --- a/docs/CONTRIBUTING.md +++ b/docs/CONTRIBUTING.md @@ -12,7 +12,7 @@ In this guid you can read how can you help in developing the Littlev Graphic Lib * [Styling guide](#styling-guide) * [Git Commit Messages](#Git-mommit-messages) * [File format](#file-format) - * [Function](#functions) + * [Functions](#functions) * [Variables](#variables) * [Defines](#defines) * [Comments](#comments) From 7c3263bc7b5c9456a6924c6a1766d7799b46756a Mon Sep 17 00:00:00 2001 From: Kiss-Vamosi Gabor Date: Sun, 30 Jul 2017 13:47:26 +0200 Subject: [PATCH 15/50] licence move back to root --- docs/licence.txt => licence.txt | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename docs/licence.txt => licence.txt (100%) diff --git a/docs/licence.txt b/licence.txt similarity index 100% rename from docs/licence.txt rename to licence.txt From d3a07c866f1348372cd4270040ccf12a896f38c2 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Sun, 30 Jul 2017 15:47:44 +0200 Subject: [PATCH 16/50] Update TODO_MAJOR.md --- docs/TODO_MAJOR.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/TODO_MAJOR.md b/docs/TODO_MAJOR.md index 0f4c20efc..defc4962f 100644 --- a/docs/TODO_MAJOR.md +++ b/docs/TODO_MAJOR.md @@ -4,6 +4,7 @@ Major versions released typically when API changes are required ## Contributing Please create an issue to suggest a new feature instead of adding pull request to this file. -## v5 +## v5 +- [ ] rename repository from *lvgl* to *littlevgl* - [ ] *lv_ta_get_txt* rename to *lv_ta_get_text* - [ ] btnm_action pass text instead of text_id From 2ab2a5a9738f4ca045d31ab4d8c786857950529f Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Sun, 30 Jul 2017 15:50:04 +0200 Subject: [PATCH 17/50] Update README.md --- docs/README.md | 8 +------- 1 file changed, 1 insertion(+), 7 deletions(-) diff --git a/docs/README.md b/docs/README.md index 5e3cac5cd..e1a9e41f2 100644 --- a/docs/README.md +++ b/docs/README.md @@ -74,13 +74,7 @@ If you don't have got an embedded hardware you can test the graphics library in There is a pre-configured PC project for **Eclipse CDT** in this repository: https://github.com/littlevgl/proj_pc ## Contributing -1. Fork it! -2. Create your feature branch: `git checkout -b my-new-feature` -3. Commit your changes: `git commit -am 'Add some feature'` -4. Push to the branch: `git push origin my-new-feature` -5. Submit a pull request! - -If you find an issue, please report it via GitHub! +See [CONTRIBUTING.md](https://github.com/littlevgl/lvgl/blob/master/docs/CONTRIBUTING.md) ## Donate If you are pleased with the graphics library and found it useful pleas support its further development: From 61881ca7cd9f4d2466fea83a593a03b3e8aa069c Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Sun, 30 Jul 2017 23:36:42 +0200 Subject: [PATCH 18/50] Update README.md --- docs/README.md | 22 ++++++++++------------ 1 file changed, 10 insertions(+), 12 deletions(-) diff --git a/docs/README.md b/docs/README.md index e1a9e41f2..d6792f7c3 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,40 +1,38 @@ # LittleV Graphics Libraray -![LittlevGL cover](http://www.gl.littlev.hu/home/main_cover.png) +![LittlevGL cover](http://www.gl.littlev.hu/home/main_cover_small.png) -The LittlevGL is a graphics library which allows you to create graphical user interfaces (GUI) from the most simple monochrome designs to amazing GUIs for high resolution TFTs. No double buffering is required to use transparency and smooth animations. +The LittlevGL is a graphics library to create Graphical User Unterfaces (GUI) for TFT and LCD displays. You can use Buttons, Labels, Charts etc to build up your GUI.No double buffering is required to use transparency, scrolling or smooth animations. The graphics library is written in C and it is completely hardware independent. You can even run it in a PC simulator without any embedded hardware. Visit the http://gl.littlev.hu ## Key features -* Hardware independent -* Support any modern microcontroller -* No external RAM, FPU or GPU required -* High resolution TFTs and monochrome displays are also supported -* Scalable and modular -* Clear and well-structured source code -* Color depth options: 24 bit, 16 bit, 8 bot or 1 bit +* Hardware independent, support any modern microcontroller +* High resolution TFTs, monochrome or any type of display supported (24/16/8/1 bit color depth) +* No external RAM, FPU or GPU required just optional * Build GUI from simple graphical objects * Buttons, Labels, Images * Charts, Lists, Bars, Sliders, Text areas etc. -* High level graphical features: +* High level graphical features without double buffering * Antialiassing (font or full screen) * Animations * Transparency * Gradient colors * Smooth dragging and scrolling -* Layers + * Layers * Customizable appearance with styles * Applications for complex tasks * Can run in a PC simulator +* Modular and well-structured source code * Actively developed ## Porting The following functions has to be provided * hal/disp `disp_fill(x1, y1, x2, y2, color)` to fill area with a color * hal/disp `disp_map(x1, y1, x2, y2, &color_array)` copy a color map to an area +* hal/disp `disp_color_cpy(color_t * dest, const color_t * src, uint32_t length, opa_t opa)` optional for GPU * hal/indev `indev_get(id, &x, &y)` get the *x* and *y* coordinates from an input device (e.g. touch pad) * hal/systick `systick_get()` get a system tick with 1 ms resolution * hal/systick `systick_elapse(prev_time)` get the elapsed milliseconds sience *prev_time* @@ -77,7 +75,7 @@ There is a pre-configured PC project for **Eclipse CDT** in this repository: htt See [CONTRIBUTING.md](https://github.com/littlevgl/lvgl/blob/master/docs/CONTRIBUTING.md) ## Donate -If you are pleased with the graphics library and found it useful pleas support its further development: +If you are pleased with the graphics library and found it useful please support its further development: [![Donate](https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=GJV3SC5EHDANS) From 55b7a9f5138a0696bdab69d957b0d69069163c7b Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Sun, 30 Jul 2017 23:38:13 +0200 Subject: [PATCH 19/50] Update README.md --- docs/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/README.md b/docs/README.md index d6792f7c3..fe12cb624 100644 --- a/docs/README.md +++ b/docs/README.md @@ -11,7 +11,7 @@ Visit the http://gl.littlev.hu ## Key features * Hardware independent, support any modern microcontroller * High resolution TFTs, monochrome or any type of display supported (24/16/8/1 bit color depth) -* No external RAM, FPU or GPU required just optional +* External RAM, FPU or GPU not required just optional * Build GUI from simple graphical objects * Buttons, Labels, Images * Charts, Lists, Bars, Sliders, Text areas etc. From 687dea0543982ef4191596627b9390571303c401 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Sun, 30 Jul 2017 23:44:59 +0200 Subject: [PATCH 20/50] Update README.md --- docs/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/README.md b/docs/README.md index fe12cb624..c5f8de629 100644 --- a/docs/README.md +++ b/docs/README.md @@ -32,7 +32,7 @@ Visit the http://gl.littlev.hu The following functions has to be provided * hal/disp `disp_fill(x1, y1, x2, y2, color)` to fill area with a color * hal/disp `disp_map(x1, y1, x2, y2, &color_array)` copy a color map to an area -* hal/disp `disp_color_cpy(color_t * dest, const color_t * src, uint32_t length, opa_t opa)` optional for GPU +* hal/disp `disp_color_cpy(dest, src, length, opa)` copy pixel, optional for GPU * hal/indev `indev_get(id, &x, &y)` get the *x* and *y* coordinates from an input device (e.g. touch pad) * hal/systick `systick_get()` get a system tick with 1 ms resolution * hal/systick `systick_elapse(prev_time)` get the elapsed milliseconds sience *prev_time* From 25651261c20a30783c1cc6ab4033961751fe0dfa Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Mon, 31 Jul 2017 01:14:41 +0200 Subject: [PATCH 21/50] Update TODO_MAJOR.md --- docs/TODO_MAJOR.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/TODO_MAJOR.md b/docs/TODO_MAJOR.md index defc4962f..faef14244 100644 --- a/docs/TODO_MAJOR.md +++ b/docs/TODO_MAJOR.md @@ -6,5 +6,6 @@ Please create an issue to suggest a new feature instead of adding pull request t ## v5 - [ ] rename repository from *lvgl* to *littlevgl* +- [ ] define renames: e.g. *USE_LV_BTN* to *LV_BTN_USE* - [ ] *lv_ta_get_txt* rename to *lv_ta_get_text* - [ ] btnm_action pass text instead of text_id From 22d79cd585d0683f0fd19efb06591f3cebae1671 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Mon, 31 Jul 2017 01:21:29 +0200 Subject: [PATCH 22/50] Update README.md --- docs/README.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/docs/README.md b/docs/README.md index c5f8de629..cd02c4113 100644 --- a/docs/README.md +++ b/docs/README.md @@ -2,11 +2,13 @@ ![LittlevGL cover](http://www.gl.littlev.hu/home/main_cover_small.png) -The LittlevGL is a graphics library to create Graphical User Unterfaces (GUI) for TFT and LCD displays. You can use Buttons, Labels, Charts etc to build up your GUI.No double buffering is required to use transparency, scrolling or smooth animations. +The LittlevGL is a free and open source graphics library to create Graphical User Interfaces (GUI) for TFT, LCD or monochrome displays using microcontroller based embedded systems. + +Transparency, anti-aliassing and smooth animations can be used with no double buffering so typically no external memories are required. The graphics library is written in C and it is completely hardware independent. You can even run it in a PC simulator without any embedded hardware. -Visit the http://gl.littlev.hu +Homepage: http://gl.littlev.hu ## Key features * Hardware independent, support any modern microcontroller @@ -38,6 +40,7 @@ The following functions has to be provided * hal/systick `systick_elapse(prev_time)` get the elapsed milliseconds sience *prev_time* See the [example HAL](https://github.com/littlevgl/hal) repository! +More info ## Requirements * [Misc. library](https://github.com/littlevgl/misc) is used by the graphics library From 9b5118157571ca4105b364e354dccb98cabac6ca Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Mon, 31 Jul 2017 08:25:32 +0200 Subject: [PATCH 23/50] Update TODO_MINOR.md --- docs/TODO_MINOR.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/TODO_MINOR.md b/docs/TODO_MINOR.md index bcb422731..3a9f1f560 100644 --- a/docs/TODO_MINOR.md +++ b/docs/TODO_MINOR.md @@ -19,4 +19,5 @@ Here are ideas whish are not assigned to a minor version yet: - [x] lv_btn: add lv_btn_get_..._action - [x] lv_list: add lv_list_get_element_label/img - [x] style animations add -- [ ] btnm: besides 0. byte (width dsc) 1. byte: hidden (\177, 0x7F, delete) +- [ ] lv_btnm: besides 0. byte (width dsc) 1. byte: hidden (\177, 0x7F, delete) +- [ ] lv_label: font attribut to override style's font (no extra style needed to set only different font) From e4cf96cb8185e213f9d18ec5a342d2b395432d59 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Wed, 2 Aug 2017 22:14:57 +0200 Subject: [PATCH 24/50] Update CONTRIBUTING.md --- docs/CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md index 6b741f7fb..54353a2bf 100644 --- a/docs/CONTRIBUTING.md +++ b/docs/CONTRIBUTING.md @@ -33,7 +33,7 @@ Please, take a look at [CODE_OF_CONDUCT](https://github.com/littlevgl/lvgl/blob/ ## How to report an issue? ### Simple issue -If you find an issue which is very simple to fix, and you fixed it, please send a pull request. +If you find an issue which is very simple to fix, and you fixed it, please send a pull request against `beta` branch. A simple issue could be: * Misspelled names * Comment: misspelling or grammatical error in comments From fa8846a2cebfc5f2a2c07370683a1f790d176ff6 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Wed, 2 Aug 2017 22:17:19 +0200 Subject: [PATCH 25/50] Update README.md --- docs/README.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/README.md b/docs/README.md index cd02c4113..79a387904 100644 --- a/docs/README.md +++ b/docs/README.md @@ -40,7 +40,6 @@ The following functions has to be provided * hal/systick `systick_elapse(prev_time)` get the elapsed milliseconds sience *prev_time* See the [example HAL](https://github.com/littlevgl/hal) repository! -More info ## Requirements * [Misc. library](https://github.com/littlevgl/misc) is used by the graphics library From f547a7dbc284b15227cadcd37cf74b6b189763ff Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Wed, 2 Aug 2017 22:59:24 +0200 Subject: [PATCH 26/50] Update TODO_MINOR.md --- docs/TODO_MINOR.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/TODO_MINOR.md b/docs/TODO_MINOR.md index 3a9f1f560..28b236d10 100644 --- a/docs/TODO_MINOR.md +++ b/docs/TODO_MINOR.md @@ -21,3 +21,4 @@ Here are ideas whish are not assigned to a minor version yet: - [x] style animations add - [ ] lv_btnm: besides 0. byte (width dsc) 1. byte: hidden (\177, 0x7F, delete) - [ ] lv_label: font attribut to override style's font (no extra style needed to set only different font) +- [ ] lv_label: padding enable/disable to increase size with hpad and vpad (useful with layouts) From 6e1a32e891ec6b6fd25488e822212f1cdcab5324 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Fri, 4 Aug 2017 12:46:25 +0200 Subject: [PATCH 27/50] Update TODO_PATCH.md --- docs/TODO_PATCH.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/docs/TODO_PATCH.md b/docs/TODO_PATCH.md index f2db7adff..74096ab00 100644 --- a/docs/TODO_PATCH.md +++ b/docs/TODO_PATCH.md @@ -1,13 +1,15 @@ # TODOs for patch versions -Patch versions contains bugfixes without changing the API. +Patch versions (x.y.1, x.y.2) contains bugfixes without changing the API but thay can apppear in minor (x.1.0, x.2.0) or major (1.0.0, 2.0.0) version too. Bugfixes are done in `bugfix` branche. +The bugfixes of the still not released version are in beta. + ## Contributing Please create an issue to introduce a buf instead of adding pull request to this file. ## Known issues * ... -## v4.1.2 -- [ ] ... +## v4.2 +- [x] lv_slider: don't indicator or bar to disappear because of hpad/vpad From cd15f653f6fe7a5c6a6496d9baa4b7a266e41988 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Fri, 4 Aug 2017 18:17:09 +0200 Subject: [PATCH 28/50] Update TODO_MAJOR.md --- docs/TODO_MAJOR.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/TODO_MAJOR.md b/docs/TODO_MAJOR.md index faef14244..0e10a5b7e 100644 --- a/docs/TODO_MAJOR.md +++ b/docs/TODO_MAJOR.md @@ -7,5 +7,6 @@ Please create an issue to suggest a new feature instead of adding pull request t ## v5 - [ ] rename repository from *lvgl* to *littlevgl* - [ ] define renames: e.g. *USE_LV_BTN* to *LV_BTN_USE* +- [ ] Remove LV_DOWNSCALE (LV_ANTIALIAS will be used instead) - [ ] *lv_ta_get_txt* rename to *lv_ta_get_text* - [ ] btnm_action pass text instead of text_id From 178f42b89a7ea38f6e1b3e37e2232d6670a04af6 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Fri, 4 Aug 2017 18:22:05 +0200 Subject: [PATCH 29/50] Update TODO_MINOR.md --- docs/TODO_MINOR.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/TODO_MINOR.md b/docs/TODO_MINOR.md index 28b236d10..4e288702d 100644 --- a/docs/TODO_MINOR.md +++ b/docs/TODO_MINOR.md @@ -10,10 +10,11 @@ Here are ideas whish are not assigned to a minor version yet: - label long mode: dot begin - music player app - files app update: show content as text -- controll GUI with serial port +- GUI remote control - automatically build GUI from file (e.g. XML, JSON or HTML) ## v4.2 +- [ ] Double VDB support: one for rendering, another to transfer former rendered image to frame buffer in the background (e.g. with DMA) - [x] lv_group: to control without touch pad. Issue [#14](https://github.com/littlevgl/lvgl/issues/14) - [x] lv_page: scrl def fit modification: hor:false, ver:true, and always set width to parent width - [x] lv_btn: add lv_btn_get_..._action From 958ad5f999b1ce757af9827e3cb71c3cf9597dd1 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Fri, 4 Aug 2017 18:27:20 +0200 Subject: [PATCH 30/50] Update TODO_PATCH.md --- docs/TODO_PATCH.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/TODO_PATCH.md b/docs/TODO_PATCH.md index 74096ab00..245308df0 100644 --- a/docs/TODO_PATCH.md +++ b/docs/TODO_PATCH.md @@ -1,5 +1,5 @@ # TODOs for patch versions -Patch versions (x.y.1, x.y.2) contains bugfixes without changing the API but thay can apppear in minor (x.1.0, x.2.0) or major (1.0.0, 2.0.0) version too. +Patch versions (x.y.1, x.y.2) contains bugfixes without changing the API but they can apppear in minor (x.1.0, x.2.0) or major (1.0.0, 2.0.0) version too. Bugfixes are done in `bugfix` branche. From 3a7d160bfaddd55b0049f3f54567d2d57f44bc25 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Fri, 4 Aug 2017 18:28:51 +0200 Subject: [PATCH 31/50] Update TODO_MINOR.md --- docs/TODO_MINOR.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/TODO_MINOR.md b/docs/TODO_MINOR.md index 4e288702d..d4f3eac1d 100644 --- a/docs/TODO_MINOR.md +++ b/docs/TODO_MINOR.md @@ -1,5 +1,5 @@ # TODOs for minor versions -Minor versions released when one or more new feature is addded without changing the API +Minor versions (x.1.0, x.2.0 ...) released when one or more new feature is addded without changing the API. New features can be added with major versions (1.0.0, 2.0.0 ...) too. ## Contributing Please create an issue to suggest a new feature instead of adding pull request to this file. From 1749a0e7e1ccd5ee0724135be600ed92eea9fd42 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Fri, 4 Aug 2017 18:29:49 +0200 Subject: [PATCH 32/50] Update TODO_MINOR.md --- docs/TODO_MINOR.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/TODO_MINOR.md b/docs/TODO_MINOR.md index d4f3eac1d..e0eac5d86 100644 --- a/docs/TODO_MINOR.md +++ b/docs/TODO_MINOR.md @@ -14,7 +14,7 @@ Here are ideas whish are not assigned to a minor version yet: - automatically build GUI from file (e.g. XML, JSON or HTML) ## v4.2 -- [ ] Double VDB support: one for rendering, another to transfer former rendered image to frame buffer in the background (e.g. with DMA) +- [ ] Double VDB support: one for rendering, another to transfer former rendered image to frame buffer in the background (e.g. with DMA) [#15](https://github.com/littlevgl/lvgl/issues/15) - [x] lv_group: to control without touch pad. Issue [#14](https://github.com/littlevgl/lvgl/issues/14) - [x] lv_page: scrl def fit modification: hor:false, ver:true, and always set width to parent width - [x] lv_btn: add lv_btn_get_..._action From fb5cee3b561c48867eca59972bdf4f8580ba7107 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Fri, 4 Aug 2017 19:16:46 +0200 Subject: [PATCH 33/50] Update CONTRIBUTING.md --- docs/CONTRIBUTING.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md index 54353a2bf..9b2a34820 100644 --- a/docs/CONTRIBUTING.md +++ b/docs/CONTRIBUTING.md @@ -1,7 +1,7 @@ # Contributing to Littlev Graphics Library First of all thank you for reading these guide before contributing! -In this guid you can read how can you help in developing the Littlev Graphic Library. These are not strick rules reather just suggestions. If you have a constructive idea just create pull request on this document! +In this guide you can read how can you help in developing the Littlev Graphic Library. These are not strict rules rather just suggestions. If you have a constructive idea just create pull request on this document! ### Table Of Content * [Who can contribute?](#who-can-contribute) @@ -10,7 +10,7 @@ In this guid you can read how can you help in developing the Littlev Graphic Lib * [Complex issue](#complex-issue) * [How to suggest a feature?](#how-to-suggest-a-feature) * [Styling guide](#styling-guide) - * [Git Commit Messages](#Git-mommit-messages) + * [Git Commit Messages](#Git-commit-messages) * [File format](#file-format) * [Functions](#functions) * [Variables](#variables) @@ -38,7 +38,7 @@ A simple issue could be: * Misspelled names * Comment: misspelling or grammatical error in comments * Variable: misspelled variable name (e.g. ***ojb**_next* instead of ***obj**_next*) - * Define: only local defines in files becuse global defines affect API + * Define: only local defines in files because global defines affect API * Function: only static function name because global functions affect API * Not handled error case: * A parameter can be NULL (during normal usage) @@ -87,7 +87,7 @@ Use [misc/templ/templ.c](https://github.com/littlevgl/misc/blob/master/templ/tem * try to write function shorter then is 40 lines * always shorter then 100 lines (except very straightforwards) * in function names: - * words sperated by '_' + * words sparated by '_' * only lower case letters * only clear abbreviation (OK: *lv_xy_get_title_txt*, BAD: *lv_xy_get_ttxt*) @@ -104,7 +104,7 @@ An example: *lv_btn_set_state()* Names can be used freely. ### Variables -* words sperated by '_' +* words sparated by '_' * always lower case * one line one declaration (BAD: char x, y;) * use `` (*uint8_t*, *int32_t* etc) @@ -138,7 +138,7 @@ Write readable code to avoid descriptive comments like: The code should show clearly what you are doing. You should write **why** have you done this: -`x++; /*Because of closeing '\0' of the string */` +`x++; /*Because of closing '\0' of the string */` ### Formatting Here is example to show bracket placing and using of white spaces: From 7284aa0d05d8bb4c8899cad30e6618b58df61df6 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Mon, 7 Aug 2017 23:17:21 +0200 Subject: [PATCH 34/50] Update TODO_MINOR.md --- docs/TODO_MINOR.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/TODO_MINOR.md b/docs/TODO_MINOR.md index e0eac5d86..d5b5db716 100644 --- a/docs/TODO_MINOR.md +++ b/docs/TODO_MINOR.md @@ -12,6 +12,10 @@ Here are ideas whish are not assigned to a minor version yet: - files app update: show content as text - GUI remote control - automatically build GUI from file (e.g. XML, JSON or HTML) +- lv_split: new object type, a hor. or ver. line for decoration purpose +- lv_valset: new object type, a label with "+" and "-" buttons +- lv_tabview: new object type to organise content with tabs +- lv_btngrp: new object type to display more buttons to choose an option from them ## v4.2 - [ ] Double VDB support: one for rendering, another to transfer former rendered image to frame buffer in the background (e.g. with DMA) [#15](https://github.com/littlevgl/lvgl/issues/15) From 702ba26dd8d09111c68c9f815c47945668083675 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Mon, 7 Aug 2017 23:26:36 +0200 Subject: [PATCH 35/50] Update TODO_MINOR.md --- docs/TODO_MINOR.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/TODO_MINOR.md b/docs/TODO_MINOR.md index d5b5db716..dbb07bec6 100644 --- a/docs/TODO_MINOR.md +++ b/docs/TODO_MINOR.md @@ -16,6 +16,7 @@ Here are ideas whish are not assigned to a minor version yet: - lv_valset: new object type, a label with "+" and "-" buttons - lv_tabview: new object type to organise content with tabs - lv_btngrp: new object type to display more buttons to choose an option from them +- lv_switch: new object type, turn on/off by tap (a little slider) ## v4.2 - [ ] Double VDB support: one for rendering, another to transfer former rendered image to frame buffer in the background (e.g. with DMA) [#15](https://github.com/littlevgl/lvgl/issues/15) From 305268176105f8351bcefaf34b00f051e28eefcf Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Tue, 8 Aug 2017 10:23:34 +0200 Subject: [PATCH 36/50] Update TODO_MINOR.md --- docs/TODO_MINOR.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/TODO_MINOR.md b/docs/TODO_MINOR.md index dbb07bec6..644c91b45 100644 --- a/docs/TODO_MINOR.md +++ b/docs/TODO_MINOR.md @@ -19,7 +19,7 @@ Here are ideas whish are not assigned to a minor version yet: - lv_switch: new object type, turn on/off by tap (a little slider) ## v4.2 -- [ ] Double VDB support: one for rendering, another to transfer former rendered image to frame buffer in the background (e.g. with DMA) [#15](https://github.com/littlevgl/lvgl/issues/15) +- [x] Double VDB support: one for rendering, another to transfer former rendered image to frame buffer in the background (e.g. with DMA) [#15](https://github.com/littlevgl/lvgl/issues/15) - [x] lv_group: to control without touch pad. Issue [#14](https://github.com/littlevgl/lvgl/issues/14) - [x] lv_page: scrl def fit modification: hor:false, ver:true, and always set width to parent width - [x] lv_btn: add lv_btn_get_..._action From dee00b08cc0dc815083e69c2fbebc606fc6f02d4 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Fri, 11 Aug 2017 08:11:05 +0200 Subject: [PATCH 37/50] Update TODO_PATCH.md --- docs/TODO_PATCH.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/TODO_PATCH.md b/docs/TODO_PATCH.md index 245308df0..836edb995 100644 --- a/docs/TODO_PATCH.md +++ b/docs/TODO_PATCH.md @@ -1,15 +1,15 @@ # TODOs for patch versions -Patch versions (x.y.1, x.y.2) contains bugfixes without changing the API but they can apppear in minor (x.1.0, x.2.0) or major (1.0.0, 2.0.0) version too. +Patch versions (x.y.1, x.y.2) contain bugfixes without changing the API but they can apppear in minor (x.1.0, x.2.0) or major (1.0.0, 2.0.0) versions too. Bugfixes are done in `bugfix` branche. -The bugfixes of the still not released version are in beta. +The bugfixes of the still not released version are in `beta` branche. ## Contributing -Please create an issue to introduce a buf instead of adding pull request to this file. +Please create an issue to introduce a bug instead of adding pull request to this file. ## Known issues * ... -## v4.2 -- [x] lv_slider: don't indicator or bar to disappear because of hpad/vpad +## Next release +- [x] lv_slider: don't let indicator or bar to disappear because of hpad/vpad From ff3f2ed80c3d42b9d96364e9141d5d5f14ef0172 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Fri, 11 Aug 2017 08:14:36 +0200 Subject: [PATCH 38/50] Update README.md --- docs/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/README.md b/docs/README.md index 79a387904..24d6b4f45 100644 --- a/docs/README.md +++ b/docs/README.md @@ -2,7 +2,7 @@ ![LittlevGL cover](http://www.gl.littlev.hu/home/main_cover_small.png) -The LittlevGL is a free and open source graphics library to create Graphical User Interfaces (GUI) for TFT, LCD or monochrome displays using microcontroller based embedded systems. +LittlevGL is a graphics library to create Graphical User Interfaces (GUI) on TFT, LCD or monochrome displays using microcontroller based embedded systems. Transparency, anti-aliassing and smooth animations can be used with no double buffering so typically no external memories are required. From 969640717fa39165097042a598cda0d176d7fa29 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Sat, 12 Aug 2017 11:43:21 +0200 Subject: [PATCH 39/50] Update TODO_PATCH.md --- docs/TODO_PATCH.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/docs/TODO_PATCH.md b/docs/TODO_PATCH.md index 836edb995..fea889d97 100644 --- a/docs/TODO_PATCH.md +++ b/docs/TODO_PATCH.md @@ -8,8 +8,6 @@ The bugfixes of the still not released version are in `beta` branche. ## Contributing Please create an issue to introduce a bug instead of adding pull request to this file. -## Known issues -* ... - ## Next release - [x] lv_slider: don't let indicator or bar to disappear because of hpad/vpad +- [ ] lv_ta: memory leak if deleted in password mode From 740eaa56b7faab00cc8dbad3ef3ffd3bd5d82cbc Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Sun, 13 Aug 2017 23:04:20 +0200 Subject: [PATCH 40/50] Update TODO_MINOR.md --- docs/TODO_MINOR.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/TODO_MINOR.md b/docs/TODO_MINOR.md index 644c91b45..6e3a2e414 100644 --- a/docs/TODO_MINOR.md +++ b/docs/TODO_MINOR.md @@ -5,7 +5,7 @@ Minor versions (x.1.0, x.2.0 ...) released when one or more new feature is addde Please create an issue to suggest a new feature instead of adding pull request to this file. ## Ideas -Here are ideas whish are not assigned to a minor version yet: +Here are ideas which are not assigned to a minor version yet: - label: add a horzintal line (e.g. underline or line through). - label long mode: dot begin - music player app @@ -17,6 +17,7 @@ Here are ideas whish are not assigned to a minor version yet: - lv_tabview: new object type to organise content with tabs - lv_btngrp: new object type to display more buttons to choose an option from them - lv_switch: new object type, turn on/off by tap (a little slider) +- lv_roller: new object type, a roller to select a value (like on smartphones) ## v4.2 - [x] Double VDB support: one for rendering, another to transfer former rendered image to frame buffer in the background (e.g. with DMA) [#15](https://github.com/littlevgl/lvgl/issues/15) @@ -25,6 +26,7 @@ Here are ideas whish are not assigned to a minor version yet: - [x] lv_btn: add lv_btn_get_..._action - [x] lv_list: add lv_list_get_element_label/img - [x] style animations add +- [ ] lv_bind: - [ ] lv_btnm: besides 0. byte (width dsc) 1. byte: hidden (\177, 0x7F, delete) - [ ] lv_label: font attribut to override style's font (no extra style needed to set only different font) - [ ] lv_label: padding enable/disable to increase size with hpad and vpad (useful with layouts) From b83023703bce133550f910368491540cc8b1c5c6 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Sun, 13 Aug 2017 23:11:15 +0200 Subject: [PATCH 41/50] Update CONTRIBUTING.md --- docs/CONTRIBUTING.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md index 9b2a34820..c4faaa9c8 100644 --- a/docs/CONTRIBUTING.md +++ b/docs/CONTRIBUTING.md @@ -31,6 +31,10 @@ There are several ways to contribute in the graphics library like: Please, take a look at [CODE_OF_CONDUCT](https://github.com/littlevgl/lvgl/blob/master/docs/CODE_OF_CONDUCT.md) ## How to report an issue? +There are 3 permanent branches: + * `master` for stable, released versions + * `beta` for developers, all feature branches merged here first + * `bugfix` for hotfixes, not new features ### Simple issue If you find an issue which is very simple to fix, and you fixed it, please send a pull request against `beta` branch. From 660a986e04fe06d579d0e8caed3d43d747739aee Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Mon, 14 Aug 2017 17:03:56 +0200 Subject: [PATCH 42/50] Update TODO_MINOR.md --- docs/TODO_MINOR.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/TODO_MINOR.md b/docs/TODO_MINOR.md index 6e3a2e414..74f3dc144 100644 --- a/docs/TODO_MINOR.md +++ b/docs/TODO_MINOR.md @@ -26,7 +26,7 @@ Here are ideas which are not assigned to a minor version yet: - [x] lv_btn: add lv_btn_get_..._action - [x] lv_list: add lv_list_get_element_label/img - [x] style animations add -- [ ] lv_bind: +- [ ] lv_bind: bind a variable to an object or vice versa (update value periodically) - [ ] lv_btnm: besides 0. byte (width dsc) 1. byte: hidden (\177, 0x7F, delete) - [ ] lv_label: font attribut to override style's font (no extra style needed to set only different font) - [ ] lv_label: padding enable/disable to increase size with hpad and vpad (useful with layouts) From 267d0d96afe1024c03db2b87b826d99d7f1dd2ff Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Mon, 14 Aug 2017 17:09:56 +0200 Subject: [PATCH 43/50] Update CONTRIBUTING.md --- docs/CONTRIBUTING.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md index c4faaa9c8..6fd1c1de1 100644 --- a/docs/CONTRIBUTING.md +++ b/docs/CONTRIBUTING.md @@ -20,7 +20,7 @@ In this guide you can read how can you help in developing the Littlev Graphic Li ## Who can contribute? -Basically everybody is welcome in contributing independently from skills, programming level or any personal attribute. +Everybody is welcome in contributing independently from skills, programming level or any personal attribute. There are several ways to contribute in the graphics library like: * Report an issue @@ -76,6 +76,9 @@ The new feature should be in a new branch. Keep in mind if you wouldn't like to do the implementation there is no guarantee that it will be ready in the new future. However if you would like to force it, take a look at this page: [Feature request service](http://www.gl.littlev.hu/services#feature) +## How to implement a feature? +In [docs/TODO_MINOR.md](https://github.com/littlevgl/lvgl/blob/master/docs/TODO_MINOR.md) and [docs/TODO_PATCH.md](https://github.com/littlevgl/lvgl/blob/master/docs/TODO_PATCH.md) you can see some ideas which are waiting for somebody to realize them! If want to deal with a feature from this files, please start an issue and discusse the details. + ## Styling guide ### Git Commit Messages From 317c8f40da6f072c609026f17520b4cef04106e1 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Mon, 14 Aug 2017 17:10:33 +0200 Subject: [PATCH 44/50] Update CONTRIBUTING.md --- docs/CONTRIBUTING.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md index 6fd1c1de1..38b2427ad 100644 --- a/docs/CONTRIBUTING.md +++ b/docs/CONTRIBUTING.md @@ -9,6 +9,7 @@ In this guide you can read how can you help in developing the Littlev Graphic Li * [Simple issue](#simple-issue) * [Complex issue](#complex-issue) * [How to suggest a feature?](#how-to-suggest-a-feature) +* [How to implement a feature?](#how-to-implement-a-feature) * [Styling guide](#styling-guide) * [Git Commit Messages](#Git-commit-messages) * [File format](#file-format) From 692a4b33c88d121c2bfc484392a51695f07dbcb7 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Wed, 16 Aug 2017 11:40:14 +0200 Subject: [PATCH 45/50] Update TODO_PATCH.md --- docs/TODO_PATCH.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/TODO_PATCH.md b/docs/TODO_PATCH.md index fea889d97..838cc8e85 100644 --- a/docs/TODO_PATCH.md +++ b/docs/TODO_PATCH.md @@ -10,4 +10,4 @@ Please create an issue to introduce a bug instead of adding pull request to this ## Next release - [x] lv_slider: don't let indicator or bar to disappear because of hpad/vpad -- [ ] lv_ta: memory leak if deleted in password mode +- [x] lv_ta: memory leak if deleted in password mode From 2e60555506a0c9027080fafb56ec3e25927e9309 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Wed, 16 Aug 2017 11:41:30 +0200 Subject: [PATCH 46/50] Update TODO_MINOR.md --- docs/TODO_MINOR.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/TODO_MINOR.md b/docs/TODO_MINOR.md index 74f3dc144..bc1979aff 100644 --- a/docs/TODO_MINOR.md +++ b/docs/TODO_MINOR.md @@ -25,6 +25,7 @@ Here are ideas which are not assigned to a minor version yet: - [x] lv_page: scrl def fit modification: hor:false, ver:true, and always set width to parent width - [x] lv_btn: add lv_btn_get_..._action - [x] lv_list: add lv_list_get_element_label/img +- [x] lv_ta: lv_ta_set_one_line to configure the Text area to one lined input field - [x] style animations add - [ ] lv_bind: bind a variable to an object or vice versa (update value periodically) - [ ] lv_btnm: besides 0. byte (width dsc) 1. byte: hidden (\177, 0x7F, delete) From d15980cdd34613dd4c6574044b2260a00250123c Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Wed, 16 Aug 2017 11:49:22 +0200 Subject: [PATCH 47/50] Update TODO_MINOR.md --- docs/TODO_MINOR.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/TODO_MINOR.md b/docs/TODO_MINOR.md index bc1979aff..23c2679b1 100644 --- a/docs/TODO_MINOR.md +++ b/docs/TODO_MINOR.md @@ -29,5 +29,4 @@ Here are ideas which are not assigned to a minor version yet: - [x] style animations add - [ ] lv_bind: bind a variable to an object or vice versa (update value periodically) - [ ] lv_btnm: besides 0. byte (width dsc) 1. byte: hidden (\177, 0x7F, delete) -- [ ] lv_label: font attribut to override style's font (no extra style needed to set only different font) - [ ] lv_label: padding enable/disable to increase size with hpad and vpad (useful with layouts) From 96a43ba3c5044118402f38d40d0ff5e96f843059 Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Wed, 16 Aug 2017 12:39:40 +0200 Subject: [PATCH 48/50] Update TODO_MINOR.md --- docs/TODO_MINOR.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/TODO_MINOR.md b/docs/TODO_MINOR.md index 23c2679b1..0323fc4f6 100644 --- a/docs/TODO_MINOR.md +++ b/docs/TODO_MINOR.md @@ -28,5 +28,4 @@ Here are ideas which are not assigned to a minor version yet: - [x] lv_ta: lv_ta_set_one_line to configure the Text area to one lined input field - [x] style animations add - [ ] lv_bind: bind a variable to an object or vice versa (update value periodically) -- [ ] lv_btnm: besides 0. byte (width dsc) 1. byte: hidden (\177, 0x7F, delete) -- [ ] lv_label: padding enable/disable to increase size with hpad and vpad (useful with layouts) +- [x] lv_btnm: besides 0. byte (width dsc) 1. byte: hidden (\177, 0x7F, delete) From 22dabf9c2a561a8f0ffe732d184f22ce891ed20b Mon Sep 17 00:00:00 2001 From: Gabor Kiss-Vamosi Date: Wed, 16 Aug 2017 20:06:49 +0200 Subject: [PATCH 49/50] Update TODO_MINOR.md --- docs/TODO_MINOR.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/TODO_MINOR.md b/docs/TODO_MINOR.md index 0323fc4f6..560328f7e 100644 --- a/docs/TODO_MINOR.md +++ b/docs/TODO_MINOR.md @@ -27,5 +27,4 @@ Here are ideas which are not assigned to a minor version yet: - [x] lv_list: add lv_list_get_element_label/img - [x] lv_ta: lv_ta_set_one_line to configure the Text area to one lined input field - [x] style animations add -- [ ] lv_bind: bind a variable to an object or vice versa (update value periodically) - [x] lv_btnm: besides 0. byte (width dsc) 1. byte: hidden (\177, 0x7F, delete) From 7dfb4eb374639cffe5c97f3d323b7986ea95bde2 Mon Sep 17 00:00:00 2001 From: Gabor Date: Thu, 17 Aug 2017 11:07:00 +0200 Subject: [PATCH 50/50] Release v4.2.0 --- lvgl.h | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/lvgl.h b/lvgl.h index d9502c0a2..1e1b90880 100644 --- a/lvgl.h +++ b/lvgl.h @@ -45,12 +45,12 @@ extern "C" { *********************/ /*Current version of LittlevGL*/ #define LVGL_VERSION_MAJOR 4 -#define LVGL_VERSION_MINOR 1 -#define LVGL_VERSION_PATH 1 +#define LVGL_VERSION_MINOR 2 +#define LVGL_VERSION_PATH 0 /*Required misc. library version*/ #define LV_MISC_REQ_MAJOR 4 -#define LV_MISC_REQ_MINOR 1 +#define LV_MISC_REQ_MINOR 2 #define LV_MISC_REQ_PATCH 0 #if MISC_VERSION_MAJOR != LV_MISC_REQ_MAJOR /*The version major has to match*/