113 lines
7.0 KiB
Markdown
113 lines
7.0 KiB
Markdown
# GuiLite - The smallest GUI library
|
||
    
|
||
- [中文](README_zh.md)
|
||
- [Features](#Features)
|
||
- [Start with Demo](#Start-with-Demo)
|
||
- [Documents](#Documents)
|
||
- [How to Learn?](#How-to-Learn)
|
||
- [Videos](#Videos)
|
||
- [🙏Thanks & ❤️Charity](#Thanks-and-Charity)
|
||
***
|
||
## Introduction
|
||
- GuiLite is the smallest GUI library with 5000 lines of C++ code, it runs on **all platforms**(e.g, iOS, Android, Linux, Windows, macOS, Docker and **MCU with or without OS**).
|
||
- GuiLite is embeddable, it runs inside other UI frameworks(e.g, Qt, MFC, Winform, Cocoa). You could use GuiLite features and host UI features simultaneously.
|
||
- GuiLite render UI by itself, independent of OS & Graphic library.
|
||
- GuiLite could work with many languages(e.g. Swift, Java, C#, Golang).
|
||
- 🔧We want people to customize GuiLite.
|
||
- ⚙️We hope GuiLite is small enough to help you understand how UI works.
|
||
- 👑You should be the master of your UI and not be tied to a specific framework.
|
||
|
||
## 🔥New feature:3D
|
||

|
||
|
||
Hello 3D has only [100+ lines code](https://github.com/idea4good/GuiLiteSamples/blob/master/Hello3D/UIcode/UIcode.cpp) for beginner, showing you how to build pseudo 3D App with GuiLite. You can run it on Windows, Linux and MCU.
|
||
|
||
## Features
|
||
### Cross platform
|
||
| ARM Linux | STM32 Without OS |
|
||
| --- | --- |
|
||
|  |   |
|
||
|
||
| Windows Mixed Reality | Android |
|
||
| --- | --- |
|
||
|  |  |
|
||
|
||
| macOS | iOS |
|
||
| --- | --- |
|
||
|  |  |
|
||
***
|
||
### GuiLite previewer(WYSIWYG extension for GuiLite)
|
||
[GuiLite Previewer](https://github.com/idea4good/GuiLitePreviewer) is a Visual Studio Code extension, could extract GUI information from C++ code and preview GUI at preview page(What you see is what you get)
|
||

|
||
***
|
||
### Support Docker Container
|
||
We build GuiLite demo as docker image, you can update/deploy/run the latest GuiLite demo on your device with single command below:
|
||
- `sudo docker run -it --privileged -v /dev:/dev-share idea4good/gui-lite:latest bash /run.sh`
|
||
***
|
||
### Easy customization
|
||

|
||
***
|
||
### Multi-language:
|
||

|
||
***
|
||
### Multi-theme
|
||

|
||
***
|
||
### IoT Solution & Code Telemetry
|
||
- Report build activities to cloud:<br>
|
||
- Sync running data to cloud:<br>
|
||
***
|
||
## Start with Demo
|
||
GuiLite is only a framework, could not create UI by itself. In order to show how to build UI App with it, We provide some samples for you.
|
||
- Sample code [here](https://github.com/idea4good/GuiLiteSamples).
|
||
- Sample introduction:
|
||
|
||
| Sample name | Platform | Description | Build guidance | Diffculty level |
|
||
| --- | --- | --- | --- | --- |
|
||
| HelloParticle | Windows, Linux, STM32F103, STM32F429 | Show how to develop particle effect | [Build](https://github.com/idea4good/GuiLiteSamples/blob/master/HelloParticle/README.md) | ★ |
|
||
| HelloStar | Windows, Linux, STM32F103, STM32F429 | Show how to develop star field effect | [Build](https://github.com/idea4good/GuiLiteSamples/blob/master/HelloStar/README.md) | ★ |
|
||
| Hello3D | Windows, Linux, STM32F103 | Show how to build physics App with GuiLite | [Build](https://github.com/idea4good/GuiLiteSamples/blob/master/Hello3D/README.md) | ★★ |
|
||
| HelloGuiLite | Windows, Linux | Show how to Initialize UI, load resource, layout UI | [Build](https://github.com/idea4good/GuiLiteSamples/blob/master/HelloGuiLite/README.md) | ★★ |
|
||
| HelloWidgets | Windows, Linux | Show how to use GuiLite widgets | [Build](https://github.com/idea4good/GuiLiteSamples/blob/master/HelloWidgets/README.md) | ★★ |
|
||
| HelloMario | Windows, Linux, STM32F103, STM32F429 | Show how to develop multi-layer UI system | [Build](https://github.com/idea4good/GuiLiteSamples/blob/master/HelloMario/README.md) | ★★ |
|
||
| HelloNavigation | Windows, Linux, STM32F103, STM32F429 | Show how to navigate/click widgets by hard button in non-touch GUI scenario | [Build](https://github.com/idea4good/GuiLiteSamples/blob/master/HelloNavigation/README.md) | ★★|
|
||
| HelloFont | Windows, Linux | Show how to use multi-language feature(UTF-8) | [Build](https://github.com/idea4good/GuiLiteSamples/blob/master/HelloFont/README.md) | ★★ |
|
||
| HelloAnimation | Windows, Linux | Show how to make animation | [Build](https://github.com/idea4good/GuiLiteSamples/blob/master/HelloAnimation/README.md) | ★★ |
|
||
| HelloSlide | Windows, Linux | Show how to use sliding pages | [Build](https://github.com/idea4good/GuiLiteSamples/blob/master/HelloSlide/README.md) | ★★★ |
|
||
| HelloWave | Windows, Linux, STM32F103, STM32F429 | Show how to use wave widget | [Build](https://github.com/idea4good/GuiLiteSamples/blob/master/HelloWave/README.md) | ★★★ |
|
||
| HostMonitor | iOS, Mac, Android, Windows, Linux | Show how to build complex UI for all platforms | [Build](https://github.com/idea4good/GuiLiteSamples/blob/master/HostMonitor/README.md) | ★★★★ |
|
||
|
||
## Documents
|
||
GuiLite is the smallest and simplest GUI library.
|
||
1. Just 5,000 line C++ code
|
||
2. Only use basic C++ feature(class, virtual function), no complex syntax
|
||
3. All rendering base on draw_pixel, no algorithm
|
||
4. Full documents and small live demos for reference
|
||
- [Design specification](doc/HowToWork.md)
|
||
- [How to build?](doc/HowToBuild.md)
|
||
- [How to Layout widgets?](doc/HowLayoutWork.md)
|
||
- [How to build unicode font/bitmap resource?](https://github.com/idea4good/GuiLiteToolkit)
|
||
- [How to switch theme?](https://github.com/idea4good/GuiLiteSamples/blob/master/HostMonitor/UIcode/source/resource/resource.cpp)
|
||
- [How to dispatch messages?](doc/HowMessageWork.md)
|
||
- [UML chart of GuiLite core](doc/UML.md)
|
||
|
||
## How to learn?
|
||
1. Build/Run GuiLite library
|
||
2. Build/Run HelloXXX demos
|
||
3. Read/Modify `HelloXXX/UIcode/UIcode.cpp` code
|
||
4. Read/Modify `gui` code
|
||
5. Read/Modify `core` code
|
||
6. Build your UI framework
|
||
|
||
## Videos
|
||
- [GuiLite introduction](https://www.youtube.com/watch?v=grqXEz3bdC0)
|
||
- [3D GuiLite](https://v.youku.com/v_show/id_XMzYxNTE3MTI0MA)
|
||
- [GuiLite + STM32](https://v.youku.com/v_show/id_XNDAwNzM5MTM3Ng)
|
||
|
||
## Mirror repository
|
||
[Gitee in China](https://gitee.com/idea4good/GuiLite)
|
||
|
||
## Thanks and Charity
|
||
- Thanks for the help from QQ group, you guys make GuiLite better! And welcome new friend to join us.<br>[<img src="doc/qq.group.jpg">](https://jq.qq.com/?_wv=1027&k=5EO8D9i)
|
||
- [Sponsor & Help sick kids](https://idea4good.github.io)
|