# lvlg_image_create

**Repository Path**: GSM8988/lvlg_image_create

## Basic Information

- **Project Name**: lvlg_image_create
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-22
- **Last Updated**: 2026-03-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LVGL8 图片转数组工具

一个支持桌面端和Web端的LVGL8图片转换工具，采用扁平化设计风格。

## 功能特性

### 支持的图片格式
- PNG (推荐，支持透明通道)
- JPG / JPEG
- BMP
- GIF (自动取第一帧)
- WebP
- TIFF
- ICO

### 颜色格式
| 格式 | 位深 | 透明 | 说明 |
|------|------|------|------|
| RGB565 | 16位 | 否 | 最常用，适合大多数嵌入式屏幕 |
| RGB888 | 24位 | 否 | 真彩色，无透明 |
| ARGB8888 | 32位 | 是 | 最高质量，带透明 |
| ARGB8565 | 24位 | 是 | 平衡质量和存储空间 |
| ARGB1555 | 16位 | 是 | 1位透明 + 15位颜色 |
| ARGB4444 | 16位 | 是 | 4位透明 + 12位颜色 |
| L8 | 8位 | 否 | 8位灰度 |
| I1/I2/I4/I8 | 1-8位 | 否 | 索引颜色模式 |
| A1/A2/A4/A8 | 1-8位 | 是 | Alpha遮罩模式 |

### 输出格式
- **C数组 (.c)** - 可直接编译的C源文件
- **头文件 (.h)** - C头文件
- **二进制 (.bin)** - 二进制数据文件

## 安装

### 环境要求
- Python 3.8+
- pip

### 安装依赖
```bash
pip install -r requirements.txt
```

## 使用方法

### 一键启动 (推荐)

**Windows:**
双击运行 `start.bat`

**Linux/macOS:**
```bash
chmod +x start.sh
./start.sh
```

### 手动启动

#### 桌面端
```bash
python desktop_gui.py
```

桌面端特性：
- 扁平化Material Design风格界面
- 支持拖拽文件
- 实时预览图片
- 批量转换支持
- 进度条显示

#### Web端
```bash
python web_gui.py
```

然后打开浏览器访问 `http://localhost:7860`

Web端特性：
- 响应式设计
- 支持批量上传
- 代码高亮显示
- 文件下载功能

## 在LVGL中使用

```c
// 包含生成的头文件
#include "my_image.h"

// 创建图片对象
lv_obj_t * img = lv_img_create(lv_scr_act());
lv_img_set_src(img, &my_image);
lv_obj_align(img, LV_ALIGN_CENTER, 0, 0);
```

## 打包发布

### Windows EXE 打包

**方法一：使用批处理脚本（简单）**
```bash
build_exe.bat
```

**方法二：使用Python脚本（交互式）**
```bash
python build_exe.py
```

支持三种打包模式：
1. **单文件模式** (推荐) - 一个exe包含所有，方便分发
2. **单目录模式** - 启动更快，但文件较多
3. **调试模式** - 保留控制台窗口，方便排查问题

打包完成后，exe文件位于 `dist/` 目录下。

## 项目结构

```
lvgl8_image/
├── lvgl_converter.py    # 核心转换模块
├── desktop_gui.py       # 桌面端GUI (PyQt6)
├── web_gui.py          # Web端界面 (Gradio)
├── run.py              # 统一启动器
├── start.bat           # Windows一键启动脚本
├── start.sh            # Linux/macOS一键启动脚本
├── build_exe.bat       # Windows打包脚本
├── build_exe.py        # 交互式打包脚本
├── version.json        # 版本信息
├── requirements.txt    # 依赖列表
└── README.md          # 说明文档
```

## 界面预览

### 桌面端
- 左侧：文件选择、转换设置
- 右侧：图片预览、转换日志
- 支持拖拽文件到程序窗口

### Web端
- 标签页切换：单个转换 / 批量转换 / 帮助
- 实时预览和代码显示
- 扁平化Material Design风格

## 许可证

MIT License