# lv_img_conv

**Repository Path**: clive-ccc/lv_img_conv

## Basic Information

- **Project Name**: lv_img_conv
- **Description**: 轻量版lvgl图片转换工具，依赖libjpeg、libpng、linzlip库。
- **Primary Language**: C++
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2024-01-19
- **Last Updated**: 2024-01-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# lv_img_conv

### 介绍

基于**奥大梨呀**的开源代码进行微改增加了一些功能，并迁移到Windows下进行编译使用。

> 由于将开发工作全部转到了Linux下，lvgl官网的图片转换打开太慢，离线版又需要安装一堆东西，
> 因此就自己用图片解码库和C++写了一个轻量版lvgl图片转换工具，目前主要是在命令行下使用，
> 未来可能考虑加入UI界面。


### 安装教程

#### 1.安装所需的依赖
因为此程序用到了jpg和png解码库，由于Windows下受编译链影响较多，建议使用仓库内编译好的库；为此建议使用同样的编译链进行编译。

编译链下载网址：[niXman/mingw-builds-binaries](https://github.com/niXman/mingw-builds-binaries/releases)

具体编译链版本为：[x86_64-13.1.0-release-win32-seh-ucrt-rt_v11-rev1.7z](https://github.com/niXman/mingw-builds-binaries/releases/download/13.1.0-rt_v11-rev1/x86_64-13.1.0-release-win32-seh-ucrt-rt_v11-rev1.7z)

#### 2.安装cmake
项目使用cmake构建，考虑到以后有可能的开发，因此cmake最低版本限制为3.12.4，不建议直接使用系统包管理器(e.g apt)直接安装，
因为可能会下载到较老的版本，建议去cmake官网下载最新版。
#### 3.编译
如果上面2步都没问题后，进入源码目录，依次键入以下命令即可编译完成。

Make方式：

```shell
mkdir build
cd build
cmake .. -G"Unix Makefiles"
make
```

Ninja方式：

```shell
mkdir build
cd build
cmake .. -GNinja
ninja
```

### 使用说明

#### 1.帮助信息
加入 **-h** 参数可以查看帮助信息，包括每个参数的说明
```shell
    lv_img_conv -h
```
#### 2.转换示例
将一张jpg图片转换为c数组并保存为C文件
```shell
    lv_img_conv -i img.jpg -c
```
将一张带透明通道的png图片转换为rgb565格式的bin文件
```shell
    lv_img_conv -i img.png -f rgb565 -b --alpha
```
将一张bmp图片转换为c数组并将C文件保存到指定路径下
```shell
    lv_img_conv -i img.bmp -c -o ./src/image/image.c
```

### 更新记录

***2023.08.07-v0.1版本*** 
第一个版本发布（作者：奥大梨呀）

**2023.09.28-v0.2版本**

第二个版本发布（作者：XiaoPb）

### 外部引用

[lv_img_conv: 用图片解码库和C++写的一个轻量版lvgl图片转换工具 (gitee.com)](https://gitee.com/Jumping99/lv_img_conv)