為什么SRT白板動畫srt-whiteboard-animation畫復(fù)雜線稿不跳筆墨流聚類與密度梯度游走詳解【免費(fèi)下載鏈接】srt-whiteboard-animation將 SRT 字幕做成暖米黃紙張底的流式筆跡白板手繪動畫 skillmask 分區(qū)遮罩編排 stream 連續(xù)筆跡ink→color。項(xiàng)目地址: https://gitcode.com/gh_mirrors/sr/srt-whiteboard-animationsrt-whiteboard-animation 是一個(gè)把 SRT 字幕變成暖米黃紙張底白板手繪動畫的開源 Skill它按字幕敘事順序分區(qū)揭示畫面并用流式筆跡讓筆尖沿線稿連續(xù)滑行落墨再逐步添彩導(dǎo)出 MP4。很多人問畫面里線稿又多又碎筆尖為什么從不瞬移答案藏在渲染器的兩層算法里——墨流聚類ink stream clustering與密度梯度游走gradient walk本文帶你逐層看懂它。先認(rèn)識這張圖渲染器要解決的問題動畫的輸入就是一張手繪線稿圖加一份同名標(biāo)注文件例如 examples/scene-01-monkey-mountain-banana.annotation.json渲染核心在 scripts/stream_render.py 與 scripts/render_stream_whiteboard.py。跳筆的本質(zhì)是一個(gè)排序問題圖上有成百上千個(gè)含墨像素格如果按從上到下、從左到右機(jī)械遍歷筆尖就會在對象之間來回穿梭觀感支離破碎。srt-whiteboard-animation 的做法是把先畫哪、后畫哪交給算法先聚類成語義完整的墨流再在每條墨流內(nèi)部生成一條幾乎不折返的連續(xù)路徑。第一步把線稿量化成墨跡格在 scripts/stream_render.py 中渲染器先做三件事自適應(yīng)閾值用adaptiveThreshold把灰度圖二值化灰度低于 10 的像素判定為墨跡不受紙張底色影響網(wǎng)格量化整張圖切成 10×10 像素的格子grid_edge10只要格內(nèi)有墨跡就算活躍格背景染色采樣原圖四角顏色把接近背景的像素替換成畫布底色保證起筆與添彩階段背景一致。量化之后畫哪里從像素問題變成了格的游走問題這是后面所有算法的輸入。墨流聚類主體、文字、輪廓分開畫核心入口是cluster_ink_streamsscripts/stream_render.py它把全部活躍格聚成若干條語義完整的墨流流水線如下連通域標(biāo)記對墨跡格做 8 連通域分析_label_components每個(gè)連通域就是一塊筆畫團(tuán)細(xì)橋斷開地面橫線、箭頭這類細(xì)長筆畫會把本不相干的物體連成一大塊。_split_bridge_connected_componentscripts/stream_render.py通過垂直投影找墨跡稀疏的峽谷在最優(yōu)走廊處把弱連接切開避免筆尖在幾個(gè)物體間反復(fù)橫跳碎片歸并12 格的噪點(diǎn)碎片會被并入質(zhì)心最近的大連通域_merge_small_components防止畫一塊沒畫完就跳去補(bǔ)一個(gè)點(diǎn)語義分類classify_stroke_groupsscripts/stream_render.py把每塊團(tuán)判定為三類——主體最大連通域、文字寬高比 ≥2.2 且填充密度 ≥0.5、輪廓其余細(xì)線。繪制順序固定為主體 → 文字 → 輪廓視覺區(qū)域合并邊框、字和箭頭哪怕分屬不同連通域只要包圍盒相鄰就歸入同一區(qū)域_group_adjacent_stroke_groups保證一個(gè)視覺單元畫完再離開。區(qū)域之間怎么接算法記住每條墨流的出口下一輪總是挑入口離出口最近的墨流繼續(xù)畫若發(fā)現(xiàn)從墨流終點(diǎn)進(jìn)入更近還會把整條路徑整體反向。這一步把跨區(qū)域的跳筆壓到了最短。密度梯度游走筆尖從墨最濃處下筆單條墨流內(nèi)部的路徑由_gradient_walk生成scripts/stream_render.py思路非常像真人寫字起筆點(diǎn)_density_seed統(tǒng)計(jì)每格周圍 5×5 鄰域內(nèi)的墨跡格數(shù)量選鄰居最密的格子下筆——模擬從墨最濃處落筆走法每步在 8 個(gè)未訪問鄰居中挑局部密度最高、且與來向轉(zhuǎn)角最小的那格形成貼著墨跡走、少折返的連續(xù)軌跡斷筆兜底若四周已無可走鄰居才跳到全局最近的未訪問格繼續(xù)跳的距離天然很短肉眼幾乎不可察。對文字區(qū)域算法換成更貼近書寫的橫向按段掃描_text_scan_orderscripts/stream_render.py把字格按列切成若干段段內(nèi)沿墨跡最近鄰游走段間起點(diǎn)盡量靠近上一段的出口——觀感就像一筆一劃寫字而不是柵格式刷掃。骨架模式復(fù)雜線稿的像素級追蹤網(wǎng)格模式默認(rèn)穩(wěn)定但對線條更精細(xì)的插畫可以用--ink-path skeleton切到骨架追蹤Zhang-Suen 細(xì)化把墨跡細(xì)化到 1 像素寬的中軸線scripts/stream_render.py8 鄰接最直邊追蹤trace_8connectedscripts/stream_render.py從端點(diǎn)出發(fā)在 T 型/十字交叉處沿最直的未訪問邊繼續(xù)走用無向邊集合記賬避免交叉點(diǎn)碎成三角形小筆重采樣 Chaikin 平滑去鋸齒、去毛刺后再按弧長等距取點(diǎn)。骨架追蹤失敗時(shí)會自動回退到網(wǎng)格路徑scripts/render_stream_whiteboard.py保證任何線稿都能出片。從路徑到成片插值、抬筆與遮罩雙保險(xiǎn)拿到有序格路徑后scripts/render_stream_whiteboard.py 的_grid_plan把相鄰格中心按 2 像素間距插值成連續(xù)的筆尖坐標(biāo)遇到非相鄰格切換就標(biāo)記一個(gè)抬筆點(diǎn)跳過插值——視覺上只是短暫提筆絕非瞬移。每幀再把內(nèi)置手部素材 assets/drawing-hand.png 的筆尖錨點(diǎn)精確對齊到當(dāng)前落墨點(diǎn)強(qiáng)化筆在畫的錯覺。編排層還有一道保險(xiǎn)每個(gè)區(qū)域的允許掩碼 自身矩形區(qū)域 ? 所有后續(xù)區(qū)域 ?protectedRegionsscripts/render_stream_whiteboard.py落墨被嚴(yán)格限制在掩碼內(nèi)未開始的元素不會提前露線。這樣分區(qū)遮罩編排 流式筆跡各司其職遮罩管何時(shí)能畫聚類與游走管按什么順序畫?？焖偕鲜? 條命令驗(yàn)證效果python scripts/prepare_env.py --check # 輸出 ENV_PY解釋器路徑 python scripts/parse_srt.py 字幕.srt --target-sec 30 ENV_PY scripts/render_stream_whiteboard.py 圖片 標(biāo)注.json 輸出.mp4 assets/drawing-hand.png --ink-path grid線稿清晰的場景把--ink-path換成skeleton即可。分鏡、區(qū)域與字幕關(guān)聯(lián)可以無服務(wù)器地在瀏覽器預(yù)覽臺 assets/preview.html 中拖拽調(diào)整完整工作流見 SKILL.md多幕成片用 scripts/merge_scenes.py 合并?？偨Y(jié)不跳筆 好的排序 短兜底環(huán)節(jié)做什么對應(yīng)實(shí)現(xiàn)墨跡量化自適應(yīng)閾值 10px 網(wǎng)格_active_mask墨流聚類連通域分類 細(xì)橋斷開 碎片歸并classify_stroke_groups流間串聯(lián)出口→入口最近鄰可整條反向cluster_ink_streams流內(nèi)路徑密度種子 梯度游走文字按段掃_(dá)gradient_walk/_text_scan_order精細(xì)模式骨架細(xì)化 最直邊追蹤 平滑trace_8connected編排保險(xiǎn)允許掩碼限制落墨范圍_allowed_mask正是這套先聚類成語義墨流、再在流內(nèi)沿密度梯度連續(xù)游走的設(shè)計(jì)讓 srt-whiteboard-animation 面對復(fù)雜線稿時(shí)筆尖始終貼著畫面走跳筆只剩提筆級別的短停頓?！久赓M(fèi)下載鏈接】srt-whiteboard-animation將 SRT 字幕做成暖米黃紙張底的流式筆跡白板手繪動畫 skillmask 分區(qū)遮罩編排 stream 連續(xù)筆跡ink→color。項(xiàng)目地址: https://gitcode.com/gh_mirrors/sr/srt-whiteboard-animation創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考