Bairan.Zhang
084da5b67a
Add --frame-start / --frame-end to restrict the frame range, and --frame-step / --frame-count (mutually exclusive) to decimate within that range. Kept frames are re-numbered contiguously from 0000 so LVGL's sequential player never sees index gaps. Interactive menu gains a matching "是否抽帧" step; CLI and menu both display a human-readable sampling summary before conversion starts. Bump version to 0.3.0. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
96 lines
2.5 KiB
Markdown
96 lines
2.5 KiB
Markdown
# EmbeddedAnimPacker
|
||
|
||
把 GIF 动画拆成 PNG 帧，并逐帧调用 LVGL 的 `LVGLImage.py` 生成 BIN 文件。
|
||
|
||
## 使用
|
||
|
||
建议先创建并启用 Python 虚拟环境：
|
||
|
||
```bash
|
||
python3 -m venv .venv
|
||
. .venv/bin/activate
|
||
```
|
||
|
||
然后安装依赖（Pillow 用于读取 GIF，questionary 用于交互式菜单）：
|
||
|
||
```bash
|
||
python3 -m pip install -r requirements.txt
|
||
```
|
||
|
||
## 交互式菜单
|
||
|
||
不带任何参数运行，会进入交互式菜单：从当前目录选择源 GIF（支持**多选或一键全选**，批量转换）、逐项配置参数，最后确认并执行转换：
|
||
|
||
```bash
|
||
python3 EmbeddedAnimPacker.py
|
||
```
|
||
|
||
也可以用 `-i` / `--interactive` 显式进入菜单。菜单仅在进入时才需要 `questionary`；纯命令行用法不依赖它。
|
||
|
||
## 命令行
|
||
|
||
直接传入 GIF 文件即可（行为与以前一致）：
|
||
|
||
```bash
|
||
python3 EmbeddedAnimPacker.py boot.gif
|
||
```
|
||
|
||
默认会调用 `lvgl/scripts/LVGLImage.py`，输出到 `littlefs/anim`。
|
||
|
||
常用参数：
|
||
|
||
```bash
|
||
python3 EmbeddedAnimPacker.py boot.gif \
|
||
--lvgl-dir ./lvgl \
|
||
--output-dir ./littlefs/anim \
|
||
--cf RGB565 \
|
||
--compress RLE
|
||
```
|
||
|
||
保留中间 PNG 帧：
|
||
|
||
```bash
|
||
python3 EmbeddedAnimPacker.py boot.gif --keep-frames ./frames
|
||
```
|
||
|
||
## 抽帧 / 减帧
|
||
|
||
嵌入式场景下每一帧都是占 flash / RAM 的 `.bin`，可以用下面的选项**截取片段**或
|
||
**减少帧数**。抽帧只决定哪些帧被送去转 BIN，输出帧始终从 `0000` **连续重新编号**
|
||
（不会留空洞，方便 LVGL 顺序播放）。
|
||
|
||
| 选项 | 含义 |
|
||
| --- | --- |
|
||
| `--frame-start N` | 起始帧（含），默认 `0` |
|
||
| `--frame-end N` | 结束帧（含），默认末帧 |
|
||
| `--frame-step N` | 区间内每 N 帧取 1（隔帧减帧），默认 `1`（全保留） |
|
||
| `--frame-count N` | 区间内均匀抽 N 帧；与 `--frame-step` **互斥**，给定时优先 |
|
||
|
||
隔帧减半（12 帧 → 6 帧）：
|
||
|
||
```bash
|
||
python3 EmbeddedAnimPacker.py boot.gif --frame-step 2
|
||
```
|
||
|
||
只取前半段（第 0–11 帧）：
|
||
|
||
```bash
|
||
python3 EmbeddedAnimPacker.py boot.gif --frame-start 0 --frame-end 11
|
||
```
|
||
|
||
把任意帧数均匀抽成固定 8 帧：
|
||
|
||
```bash
|
||
python3 EmbeddedAnimPacker.py boot.gif --frame-count 8
|
||
```
|
||
|
||
组合使用，并保留抽完的 PNG 以便预览：
|
||
|
||
```bash
|
||
python3 EmbeddedAnimPacker.py boot.gif --frame-start 0 --frame-end 11 --frame-step 2 \
|
||
--keep-frames ./frames
|
||
```
|
||
|
||
> 多选 / 全选批量转换时，同一套抽帧参数会套用到所有 GIF；固定的 `--frame-end`
|
||
> 在较短的 GIF 上会自动收敛到其末帧。交互式菜单里也有对应的「是否抽帧」步骤。
|