拆解srt-whiteboard-animation双引擎架构mask编排stream笔迹为何远比矩形揭示更真实【免费下载链接】srt-whiteboard-animation将 SRT 字幕做成暖米黄纸张底的流式笔迹白板手绘动画 skillmask 分区遮罩编排 stream 连续笔迹ink→color。项目地址: https://gitcode.com/gh_mirrors/sr/srt-whiteboard-animationsrt-whiteboard-animation是一个把 SRT 字幕变成暖米黄纸张底白板手绘动画的 Skill它用mask 分区遮罩编排决定什么时候画哪里用stream 连续笔迹决定怎么落墨最终导出 MP4。下面带你拆解这套双引擎架构看看它为什么比常见的矩形揭示效果更逼真。一、它解决什么问题从字幕到手绘视频 做知识讲解、故事口播时很多人想要白板手绘风的视频但手动一笔一笔画既慢又不跟节奏。这个项目的做法是字幕驱动——先解析 SRT 字幕、按 25–35 秒拆幕再让画面元素跟着字幕叙事顺序依次画出来。以仓库自带的猴子山抢香蕉案例为例字幕说到哪里笔就画到哪里先画假山小猴再画冲来抢香蕉的大猴最后画围观鼓掌的小朋友。原始线稿长这样由统一视觉规范生成的极简手绘风格二、双引擎架构拆解 ️项目名里的mask 编排 stream 画法对应的就是两个各司其职的引擎核心实现分别在 scripts/render_stream_whiteboard.py 和 scripts/stream_render.py 中。引擎一mask 编排——决定何时画、画哪里编排层沿用分区遮罩揭示的思路规则写在 SKILL.md 的遮罩不变量一节按叙事顺序揭示每个元素在标注 JSON 里有sequence出场顺序和startMs开始时间字幕讲到的区域才落墨允许掩码每个区域的作画范围 矩形region扣除「后续区域 protectedRegions」未开始的区域完全隐藏绝不会提前露线重叠保护主体交叠时在较早元素的protectedRegions中标出保护区避免后画的内容被抢跑。这些配置都存在annotation.json里仓库示例可参考 examples/scene-01-monkey-mountain-banana.annotation.json三个区域分别对应场景铺垫 → 动作冲突 → 反应结果。遮罩编排的效果白色揭示版演示引擎二stream 笔迹——决定怎么落墨画法层把矩形擦除换成了连贯笔迹每个区域在自己的允许掩码内笔尖沿骨架skeleton或网格grid轨迹连续滑行分三段走起笔 ink沿墨迹流铺下深色线稿添彩 color同一条轨迹回头换上原色点亮画面权重 2:1给观察笔迹留足时间凝视 gaze全部画完后停留至少 0.5 秒完整画面。渲染时还会叠加一只手部素材贴在笔尖上同步移动assets/drawing-hand.png让画面更像真人执笔最终添彩完成后的画面三、为什么比矩形揭示更真实⚖️对比维度矩形揭示mask 擦除mask 编排 stream 笔迹画面出现方式一条直线扫过区域整块亮笔尖沿线滑行逐笔落墨手绘感弱像 PPT 转场强接近真人书写节奏出场顺序也能按字幕排同样按字幕叙事且时序精确到毫秒遮挡控制依赖保护区扣除允许掩码限制落墨同样不漏线成本低需解析线稿/骨架渲染稍重关键洞察mask 解决的是纪律问题谁先谁后、谁不许提前出现stream 解决的是质感问题画面如何被人手画出来。两者组合后既有精确的叙事时序又有流动的笔触——这正是比矩形揭示更真实的答案。完整规则可查阅 SKILL.md 的时序模型与遮罩不变量章节。四、三步上手从字幕到成片 准备环境 解析字幕先跑 scripts/prepare_env.py 建好独立环境再用 scripts/parse_srt.py 把 SRT 拆成 25–35 秒/幕的分镜建议标注 预览台调整生成线稿后创建同名.annotation.json用 assets/preview.html 预览台拖拽调整区域、顺序和时序并保存渲染 合并命令行渲染单幕 MP4多幕再用 scripts/merge_scenes.py 合成一条python scripts/parse_srt.py 字幕.srt --target-sec 30 --min-sec 25 --max-sec 35 ENV_PY scripts/render_stream_whiteboard.py 场景.png 场景.annotation.json 输出.mp4 ENV_PY scripts/merge_scenes.py --inputs 幕1.mp4 幕2.mp4 --output final.mp4渲染器默认 60fps 输出--ink-path可选grid稳或skeleton贴合清晰线稿--color-fill可选contour-wipe默认或brush。五、核心文件速查 文件作用SKILL.md完整工作流、视觉规范与遮罩不变量scripts/stream_render.pystream 笔迹渲染引擎grid/skeleton、ink→color、凝视收尾scripts/render_stream_whiteboard.py整合渲染器mask 编排 stream 画法scripts/parse_srt.py字幕解析与分镜建议scripts/render_annotation_preview.py生成区域编号/方向检查图scripts/merge_scenes.py多幕 MP4 合并assets/preview.html浏览器本地编辑预览台一句话总结mask 引擎把叙事纪律写进掩码stream 引擎把手绘温度写进笔迹——双引擎各司其职才让 SRT 白板动画既跟得上字幕节奏又画得像真人执笔。【免费下载链接】srt-whiteboard-animation将 SRT 字幕做成暖米黄纸张底的流式笔迹白板手绘动画 skillmask 分区遮罩编排 stream 连续笔迹ink→color。项目地址: https://gitcode.com/gh_mirrors/sr/srt-whiteboard-animation创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
