# LingDongGUI

**Repository Path**: gzbkey/LingDongGUI

## Basic Information

- **Project Name**: LingDongGUI
- **Description**: 灵动GUI是基于ARM-2D进行开发的GUI，极大降低ARM-2D的使用难度
- **Primary Language**: C
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 230
- **Forks**: 56
- **Created**: 2023-04-01
- **Last Updated**: 2026-01-28

## Categories & Tags

**Categories**: desktop-ui

**Tags**: ldgui, arm-2d, GUI

## README

<h4>
  <a href="README.md">中文</a> |
  <a>English</a>
</h4>

<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">LingDongGUI</h1>
<h4 align="center">A GUI based on ARM-2D</h4>
<p align="center">
	<a href="https://gitee.com/gzbkey/LingDongGUI/stargazers"><img src="https://gitee.com/gzbkey/LingDongGUI/badge/star.svg"></a>
	<a href="https://gitee.com/gzbkey/LingDongGUI/members"><img src="https://gitee.com/gzbkey/LingDongGUI/badge/fork.svg"></a>
	<a><img src="https://img.shields.io/github/license/gzbkey/LingDongGUI"></a>
	<a><img src="https://img.shields.io/badge/architecture-ARM%20|%20RISC%20V-blue"></a>	
</p>

## Features

1. **Universal chip support**
    * Supports ARM microcontrollers and RISC-V microcontrollers
    * Support simulated running on PC (SDL)

2. **Easy to use**
    * Secondary encapsulation greatly reduces the difficulty of using ARM-2D
    * Signal-slot mechanism makes many-to-many event handling effortless
    * A clean separation of UI and business logic yields crystal-clear program flow

3. **Support for Native ARM-2D APIs**
    * ARM-2D native APIs are available as needed
    * Mix LDGUI with ARM-2D for flexible hybrid development

4. **Dynamic Auto-Trimming**
    * Unused widgets auto-drop

5. **Extensible Widgets**
    * Script-generated skeletons let you focus on look and feel

6. **Built-in Functions**
    * Software timer
    * Multi-function keys: physical & touch
    * Queue
    * Color log print
7. **GUI Editor**
    * Comes with a free GUI editor

## Source Code

🏠️Gitee repo: https://gitee.com/gzbkey/LingDongGUI

🏠️Github repo: https://github.com/gzbkey/LingDongGUI

## GUI Editor

🚀GUI Editor repo: https://gitee.com/gzbkey/GuiEasyEditor

## Demo Preview

widget demo sdl
<p>
	<img src="./docs/images/widget%20demo.gif" width="400" />
</p>

## Widget List

| Status | Name | Description |
| :----:| ---- | ---- |
| ✅ | window | Layered container |
| ✅ | image | image display |
| ✅ | button | Clickable button |
| ✅ | text | text |
| ✅ | progress bar | Progress with movable-image animation |
| ✅ | check box + radio button| Check-box & radio styles with custom icons/text |
| ✅ | radia menu | Rotary selection menu |
| ✅ | label | Simple text label |
| ✅ | slider | Drag slider |
| ✅ | scroll selecter | Scroll-wheel picker |
| ✅ | date time | Digital clock & date |
| ✅ | icon slider | Sliding icon bar |
| ✅ | gauge | Circular gauge |
| ✅ | qr code | QR-code display |
| ✅ | table | Data table |
| ✅ | keyboard | On-screen keyboard |
| ✅ | line edit | Text input field |
| ✅ | graph | Waveform display |
| ✅ | combo box | Drop-down list |
| ✅ | arc bar | Circular progress ring |
| ✅ | animation | GIF-style animation |
| 🔲 | calendar | calendar |
| ✅ | message box | Pop-up message |
| 🔲 | clock | Analog clock |
| ✅ | list | Scrollable list hosting any widget |
| 🔲 | time picker | time picker |
| 🔲 | date picker | date picker |

## File Structure

|Name|Type|Description|
|---|---|---|
|docs|folder|Detailed documentation|
|examples|folder|Example projects|
|src|folder|Source code|
|tools|folder|Companion utilities and scripts|

## Tutorial

📖 [中文教程](https://ldgui-doc-cn.readthedocs.io)

## Contact Information

🐧 QQ Group：187033407

📧 E-Mail: 59935554@qq.com