lvgl-rs/README.md

40 lines
1.2 KiB
Markdown
Raw Normal View History

2020-04-12 07:58:01 +00:00
<h1 align="center"> LittlevGL - Open-source Embedded GUI Library in Rust</h1>
2020-04-12 10:32:18 +00:00
<p align="center">
<img src="https://littlevgl.com/github/cover_ori_reduced_2.gif">
</p>
2020-04-12 07:58:01 +00:00
<p align="center">
LittlevGL provides everything you need to create a Graphical User Interface (GUI) on embedded systems with easy-to-use graphical elements, beautiful visual effects and low memory footprint.
2020-04-12 08:03:02 +00:00
</p>
<p align="center">
2020-04-12 08:10:04 +00:00
LittlevGL is compatible with <samp>#![no_std]</samp> environments by default.
2020-04-12 07:58:01 +00:00
</p>
<h4 align="center">
2020-04-12 08:03:02 +00:00
<a href="https://littlevgl.com">Official LittlevGL Website </a> &middot;
2020-04-12 10:32:18 +00:00
<a href="https://github.com/littlevgl/lvgl">C library repository</a> &middot;
2020-04-12 08:08:55 +00:00
<a href="https://littlevgl.com/live-demo">Live demo</a>
2020-04-12 07:58:01 +00:00
</h4>
---
2020-04-12 10:34:03 +00:00
![Rust bindings usage demo code.](demo.png)
2020-04-12 18:37:26 +00:00
## Usage
Edit your `Cargo.toml` file dependencies with:
```
$ cargo add lvgl
```
The build requires the environment variable bellow to be set:
- `DEP_LV_CONFIG_PATH`: Path to the directory containing the `lv_conf.h` header file used for configuration of LittlevGL library.
We recommend the `lv_conf.h` file to be in your project's root directory. If so, the command to build your project would be:
```shell script
$ DEP_LV_CONFIG_PATH=`pwd` cargo build
```