如何让SRT白板动画上色更自然srt-whiteboard-animation的contour-wipe与brush调参指南【免费下载链接】srt-whiteboard-animation将 SRT 字幕做成暖米黄纸张底的流式笔迹白板手绘动画 skillmask 分区遮罩编排 stream 连续笔迹ink→color。项目地址: https://gitcode.com/gh_mirrors/sr/srt-whiteboard-animationsrt-whiteboard-animation 是一个把 SRT 字幕转成暖米黄纸张底白板手绘动画的 Skill。它的上色阶段提供contour-wipe轮廓扫描与brush沿轨迹刷两种风格直接决定成片看起来是颜色顺着线条蔓延还是画笔跟着笔迹涂抹。本文带你理解两种模式的工作原理并给出一份常用参数调优对照表新手也能一次调出自然的白板动画效果。一、先看效果什么是流式笔迹上色在 README.md 的案例中猴子山抢香蕉一幕会随着字幕顺序依次画出假山小猴、抢香蕉的大猴和围观的小朋友每个区域都是先ink铺线稿、再color还原原色两段时长默认按2:1分配笔尖默认使用仓库内置的手绘手部素材 assets/drawing-hand.png始终贴近正在推进的笔迹落墨点严格对齐这是自然感的第一来源。二、两种上色模式contour-wipe 与 brush 到底怎么选渲染时通过 scripts/render_stream_whiteboard.py 的--color-fill参数切换默认是contour-wipe。对比项contour-wipe默认brush上色方式一道揭示前沿自上而下扫描整块区域沿起笔阶段的同一条轨迹用圆形软边墨刷逐点涂色视觉观感颜色沿着轮廓蔓延线条处会先卡住再缓缓越过像真实涂色颜色从笔迹中心向外晕开适合素材大多数线稿尤其是轮廓清晰、留白多的手绘图粗线条、大面积实心色块或希望笔尖动线更连贯的素材可调参数趟数、阻力衰减见下节--brush-radius墨刷半径原始线稿长这样暖米黄底 深灰素描线 少量红橙蓝点缀是这类素材的标准风格contour-wipe 为什么顺在 scripts/stream_render.py 的wash_color_contourL1508-L1514中可以看到它的思路预计算一张阻力场——把墨线膨胀、模糊后让每条轮廓向下方投出指数衰减的阴影揭示前沿遇到轮廓会先被卡住再随衰减缓慢越过于是颜色看起来是沿着线长出来的而不是生硬的矩形擦除笔尖做横向来回扫动默认 18 趟模拟手在涂色的节奏。brush 为什么实brush模式复用起笔阶段的采样轨迹_wash_brush见 render_stream_whiteboard.py#L245-L264在路径上逐个盖一枚带羽化边缘的圆形墨刷颜色自然地从笔迹中心向外晕染。三、最常调的 5 个参数所有默认值集中在 scripts/stream_render.py 的Config中命令行即可覆盖参数默认值作用与调法--color-fillcontour-wipe上色风格brush更适合粗线稿与实心色块--brush-radius40墨刷半径像素。涂色显稀就调大50–60显糊就调小25–35--ink-pathgrid笔迹路径。skeleton为骨架追踪线稿清晰时笔迹更贴合线条SKILL.md 推荐搭配清晰插画使用--cap-long-edge1080输出长边上限。快速预览时调到640可大幅加速渲染--total-ms标注中的sceneDurationMs总时长兜底更常用的做法是在预览台调整各区域的开始/结束时间因为durationMs直接决定 ink 与 color 各分得多少时间 小技巧如果感觉上色太快/太慢优先在 assets/preview.html 预览台里拖动时间轴拉长对应区域的durationMs而不是只改总时长——着色时间是按区域分配的。四、三步跑起来1. 获取项目并准备环境git clone https://gitcode.com/gh_mirrors/sr/srt-whiteboard-animation cd srt-whiteboard-animation python scripts/prepare_env.py --check python scripts/prepare_env.py成功后第一条命令末行输出ENV_PY路径后续渲染都使用这个解释器依赖自动隔离在.venv。2. 渲染单幕contour-wipe 默认风格ENV_PY scripts/render_stream_whiteboard.py \ assets/whiteboard/demo/scene-01-demo.png \ assets/whiteboard/demo/scene-01-demo.annotation.json \ assets/whiteboard/demo/scene-01-demo-whiteboard.mp4 \ assets/drawing-hand.png \ --ink-path skeleton --color-fill contour-wipe同一场景的白板成片效果--color-fill contour-wipe渲染3. 多幕合并ENV_PY scripts/merge_scenes.py --inputs 幕1.mp4 幕2.mp4 --output final.mp4五、不同线稿的调参对照表线稿特征--ink-path--color-fill其他建议细线、留白多标准手绘风skeletoncontour-wipe默认参数即可粗线条、大面积色块gridbrush--brush-radius 50防露底元素相互遮挡skeletoncontour-wipe在早出现元素的protectedRegions中标出保护区示例见 examples/scene-01-monkey-mountain-banana.annotation.json快速预览/试参grid任选--cap-long-edge 640加速六、渲染后的质量自检对照 README.md 的质量检查清单重点看三帧✅ 首帧是干净的暖米黄纸张底没有任何提前露出的线条✅ 中段帧里未开始的区域、保护区不会提前出现颜色✅ 笔尖贴近正在推进的笔迹结尾至少停留 0.5 秒完整画面。如果效果不满意回到预览台调整标注区域/顺序/时序再渲染避免凭空反复出片。七、参数与源码在哪里找渲染入口与命令行参数scripts/render_stream_whiteboard.py上色算法与全部默认值scripts/stream_render.py字幕解析与分镜建议scripts/parse_srt.py完整工作流与约束说明SKILL.md【免费下载链接】srt-whiteboard-animation将 SRT 字幕做成暖米黄纸张底的流式笔迹白板手绘动画 skillmask 分区遮罩编排 stream 连续笔迹ink→color。项目地址: https://gitcode.com/gh_mirrors/sr/srt-whiteboard-animation创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考