nodes/rui40000-RUI-Nodes
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

fix: 八方向拆分不再切断角色；全仓库参数补齐中文 tooltip

Browse Source 
【修复】角色被格线切断（脚、手杖、飘起的斗篷被削掉）
新增 expand_beyond_cell（默认开启）：格子只用来判定「这是哪个方向」，
角色的实际范围由它自身的连通区域决定，按质心归属确保邻居不混入。
实测 8/8 方向的裁剪框边缘 alpha 从 1.00（内容顶到边界=被切断）
降到 0.00，S 方向高度 326→356、E 方向宽度 150→188 把缺的部分找了回来。
代价是需要两遍扫描（先求全序列并集框再提取），耗时 4.7s→14.9s。

【规则】每个参数都必须有中文 tooltip，作为以后的统一约定
全仓库 26 个节点 169 个参数，此前缺 115 个，现已 100% 覆盖。
tooltip 写「怎么调」而不只是「是什么」：给取值区间的实际影响、
推荐值与踩坑提示（如 OpenAI/ZenMux 的地址栏不能带 :// ，
素材拆分节点用于动画序列时顺序会漂移等）。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
rui40000
2026-07-29 19:07:01 +08:00
co-authored by Claude Opus 4.8
parent 28fd14aaad
commit 5d3834503e
25 changed files with 512 additions and 123 deletions
Download Patch File Download Diff File Expand all files Collapse all files
example_workflow/八方向行走动画.json
+2 -1
View File
@@ -165,6 +165,7 @@
1.0,
0.05,
true,
true,
8
],
"color": "#232",
@@ -927,7 +928,7 @@
"outputs": [],
"properties": {},
"widgets_values": [
"八方向行走动画 —— 完整管线\n\n【前置步骤（在本工作流之外完成）】\n 角色图 →(GPTimage2)→ 八方向静态图 →(Seedance 首尾帧)→ 循环行走视频\n 视频每一帧上都排布着 8 个朝向的角色。\n\n【本工作流做的事】\n ① VHS「Load Video」把视频转成序列帧\n · force_rate 就是帧率选择。设 0 用源视频帧率；\n 设 12 可减半出帧、素材更小，走路动画通常 8~12 帧一循环就够\n · frame_load_cap 可限制总帧数，先小批量试参数很有用\n ② 本仓库「八方向序列拆分」：切格 + 编号 + 按方向分组，一次给出 8 条序列\n ③ 每个方向各接一个 VHS「Video Combine」出透明 webm\n ④ 每个方向各接一个 SaveImage 出透明 PNG 序列帧\n\n【拆分节点的关键参数】\n · grid_cols / grid_rows / empty_cells\n 3×3 中间留空即 empty_cells=4。序号行优先、从 0 开始。\n · direction_names\n 按「跳过空格后的先后顺序」命名，默认对应下面这个排布：\n SW S SE ← 行1：面向观众\n W E ← 行2：侧面\n NW N NE ← 行3：背对观众\n 与你的素材不符就直接改这行，名字只影响标注不影响画面。\n · bg_mode / bg_threshold\n 白底转透明。只把「与画面边缘相连」的白色判为背景，\n 所以角色身上的白衬衫、白高光不会被掏空。\n 背景没扣净就调低阈值，角色边缘被啃就调高。\n · auto_crop\n 裁掉多余空白。裁剪框取该方向所有帧的并集，\n 因此整条序列尺寸一致（能合成视频），角色也不会在帧间跳动。\n\n【为什么不用连通区域拆分（本仓库的「素材拆分」节点）】\n 那个节点按包围盒排序，角色走动时位置浮动，一旦跨过排序行界方向就会错乱；\n 且每个 sprite 按各自 bbox 裁剪、尺寸不一，无法直接合成视频。\n 固定网格没有这两个问题 —— 但它更适合单张静态合图，两者各有用途。\n\n【webm 透明的关键】\n Video Combine 的 format 必须选 video/webm，且 pix_fmt 选 yuva420p。\n 注意：alpha 存放在 WebM 的独立边带里，所以用 ffprobe 看主流会显示\n yuv420p，这是正常的。播放器/引擎（走 libvpx 解码）能正确读到透明通道；\n 若要用 ffmpeg 自行验证，需显式加 -c:v libvpx-vp9 解码，\n 否则内置 vp9 解码器不会输出 alpha，会让人误以为透明丢了。\n\n【实测（97 帧 834×1112 的素材）】\n 拆分耗时约 4 秒，8 个方向各 97 帧，尺寸 172×370 ~ 206×327。"
"八方向行走动画 —— 完整管线\n\n【前置步骤（在本工作流之外完成）】\n 角色图 →(GPTimage2)→ 八方向静态图 →(Seedance 首尾帧)→ 循环行走视频\n 视频每一帧上都排布着 8 个朝向的角色。\n\n【本工作流做的事】\n ① VHS「Load Video」把视频转成序列帧\n · force_rate 就是帧率选择。设 0 用源视频帧率；\n 设 12 可减半出帧、素材更小，走路动画通常 8~12 帧一循环就够\n · frame_load_cap 可限制总帧数，先小批量试参数很有用\n ② 本仓库「八方向序列拆分」：切格 + 编号 + 按方向分组，一次给出 8 条序列\n ③ 每个方向各接一个 VHS「Video Combine」出透明 webm\n ④ 每个方向各接一个 SaveImage 出透明 PNG 序列帧\n\n【拆分节点的关键参数】\n · grid_cols / grid_rows / empty_cells\n 3×3 中间留空即 empty_cells=4。序号行优先、从 0 开始。\n · direction_names\n 按「跳过空格后的先后顺序」命名，默认对应下面这个排布：\n SW S SE ← 行1：面向观众\n W E ← 行2：侧面\n NW N NE ← 行3：背对观众\n 与你的素材不符就直接改这行，名字只影响标注不影响画面。\n · bg_mode / bg_threshold\n 白底转透明。只把「与画面边缘相连」的白色判为背景，\n 所以角色身上的白衬衫、白高光不会被掏空。\n 背景没扣净就调低阈值，角色边缘被啃就调高。\n · expand_beyond_cell（务必开启）\n 允许角色超出格子边界。关闭时按格线严格切分，角色只要探出格线\n 就会被切断（最典型的是脚被削掉）。开启后格子只用来判定方向，\n 实际范围由角色自身的连通区域决定。\n · auto_crop\n 裁掉多余空白。裁剪框取该方向所有帧的并集，\n 因此整条序列尺寸一致（能合成视频），角色也不会在帧间跳动。\n\n【为什么不用连通区域拆分（本仓库的「素材拆分」节点）】\n 那个节点按包围盒排序，角色走动时位置浮动，一旦跨过排序行界方向就会错乱；\n 且每个 sprite 按各自 bbox 裁剪、尺寸不一，无法直接合成视频。\n 固定网格没有这两个问题 —— 但它更适合单张静态合图，两者各有用途。\n\n【webm 透明的关键】\n Video Combine 的 format 必须选 video/webm，且 pix_fmt 选 yuva420p。\n 注意：alpha 存放在 WebM 的独立边带里，所以用 ffprobe 看主流会显示\n yuv420p，这是正常的。播放器/引擎（走 libvpx 解码）能正确读到透明通道；\n 若要用 ffmpeg 自行验证，需显式加 -c:v libvpx-vp9 解码，\n 否则内置 vp9 解码器不会输出 alpha，会让人误以为透明丢了。\n\n【实测（97 帧 834×1112 的素材）】\n 拆分耗时约 4 秒，8 个方向各 97 帧，尺寸 172×370 ~ 206×327。"
],
"color": "#432",
"bgcolor": "#653"