v1.0.0 · 流式笔迹白板动画首个正式版

流式笔迹白板动画 v1.0.0

把一张插图渲染为连续落笔、逐步上色、最后停留展示的白板手绘动画，并导出 H.264 MP4。适合故事绘本、知识讲解、课程配图和短视频素材。

核心特征：笔尖沿一条连续的笔迹滑行，边走边落墨，而不是一格一格地跳变揭墨。动画分三段——起笔（线稿）→ 添彩（还原原色）→ 凝视（完整画面停留）。

✨ 主要特性

• 连续笔迹：笔尖沿实际绘制轨迹移动，而不是逐帧跳变
• 三段式节奏：起笔（线稿）→ 添彩（回填）→ 凝视（完整画面停留）
• 两种笔迹路径：稳定的 grid 网格路径，或更贴合线条的 skeleton 骨架路径
• 两种添彩方式：contour-wipe 轮廓感知扫色与 brush 沿轨迹刷色
• 单图 / 队列双模式：支持单张图直接渲染，也支持批量渲染多张图并按顺序合并为一条完整视频
• 零系统依赖：通过 PyAV 输出 H.264，无需安装系统级 FFmpeg；安装 FFmpeg 后可获得更灵活的处理能力
• 默认叠加手部/笔尖，也支持关闭或替换为自定义素材

🎬 演示效果

场景：猴子山抢香蕉 —— 画面先连续绘制深色线稿，再以原图颜色回填，最后停留展示完整画面。

📦 安装

git clone https://github.com/geeklee/whiteboard-stream-animation.git
cd whiteboard-stream-animation
python scripts/prepare_env.py

安装脚本会创建 .venv 并安装所需依赖（opencv-python、numpy、av）。完成后会在终端输出 ENV_PY，后续命令使用该 Python 路径即可。

🚀 快速开始

单图渲染：

<ENV_PY> scripts/stream_render.py ./photo.png --out-dir ./out --total-ms 12000

批量渲染并合并：

<ENV_PY> scripts/queue_render.py   --images ./scene-01.png ./scene-02.png   --durations 15000 14000   --out-dir ./out --merge

📁 包含内容

• 完整 Agent 工作流（SKILL.md）与使用文档（README.md）
• Codex 元数据（agents/openai.yaml）
• 环境检测与依赖自动安装脚本（prepare_env.py）
• 单图流式渲染器（stream_render.py，grid/skeleton 笔迹 + contour-wipe/brush 上色）
• 批量渲染与合并器（queue_render.py）
• 渲染测试（test_stream_render.py）
• 默认手部素材与猴子山演示图、视频
• MIT 许可证

📝 许可证

MIT License — 可自由使用、修改和分发。

---

作者： 江哥是老登啊 · 抖音、B站、公众号：江哥是老登啊