新增「加载透明视频」节点：解决带 alpha 的 WebM 读入后透明通道丢失
带 alpha 的 WebM（VP8/VP9）不把透明度放在主视频流里。主流仍是 yuv420p，
alpha 被单独压成第二路藏在 Matroska 的 BlockAdditional 边带中，容器上只
留一条 alpha_mode=1 的元数据。ffmpeg 内置的 vp9/vp8 解码器不读这条边带，
只有 libvpx-vp9 / libvpx 才会——VideoHelperSuite 等常见加载节点走默认
解码器，因此每帧 alpha 恒为 255。
本节点显式指定 libvpx 系解码器并以 rgba 原始流读回，完整保留透明度
（含半透明边缘）。同一文件实测：默认解码器 alpha 全 255；libvpx-vp9
解出 alpha min=0 max=255，全透明 87.2%、半透明 2.0%。
- 自动探测 alpha_mode / pix_fmt，仅在需要时才换 libvpx（默认解码器更快）
- 解码器三档可手动覆盖，自动档失灵时可强制
- 支持强制帧率、帧数上限、跳过前N帧、间隔抽帧、等比缩放
- 输出 4 通道 rgba_image，直接接原生「保存图像」即存成 RGBA PNG 序列帧
（原生节点不做 convert("RGB")，实测落盘与内存 alpha 逐像素零误差）
- 另输出 alpha 遮罩与 3 通道 rgb_image，兼容只吃 3 通道的下游节点
- 流式读管道 + 预分配张量，达到帧数上限立即中止解码
- 全部参数带中文悬浮说明，附示例工作流
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
rui40000
co-authored by
Claude Opus 5
Claude Opus 5
parent
becde22105
commit
61129bde89
@@ -0,0 +1,222 @@
|
||||
{
|
||||
"id": "rui-load-video-alpha-demo",
|
||||
"revision": 0,
|
||||
"last_node_id": 9,
|
||||
"last_link_id": 3,
|
||||
"nodes": [
|
||||
{
|
||||
"id": 1,
|
||||
"type": "RuiLoadVideoAlpha",
|
||||
"pos": [
|
||||
-1000,
|
||||
200
|
||||
],
|
||||
"size": [
|
||||
400,
|
||||
300
|
||||
],
|
||||
"flags": {},
|
||||
"order": 0,
|
||||
"mode": 0,
|
||||
"inputs": [],
|
||||
"outputs": [
|
||||
{
|
||||
"name": "rgba_image",
|
||||
"type": "IMAGE",
|
||||
"links": [
|
||||
1,
|
||||
2
|
||||
],
|
||||
"slot_index": 0
|
||||
},
|
||||
{
|
||||
"name": "alpha",
|
||||
"type": "MASK",
|
||||
"links": [
|
||||
3
|
||||
],
|
||||
"slot_index": 1
|
||||
},
|
||||
{
|
||||
"name": "rgb_image",
|
||||
"type": "IMAGE",
|
||||
"links": null,
|
||||
"slot_index": 2
|
||||
},
|
||||
{
|
||||
"name": "帧数",
|
||||
"type": "INT",
|
||||
"links": null,
|
||||
"slot_index": 3
|
||||
},
|
||||
{
|
||||
"name": "帧率",
|
||||
"type": "FLOAT",
|
||||
"links": null,
|
||||
"slot_index": 4
|
||||
}
|
||||
],
|
||||
"properties": {
|
||||
"Node name for S&R": "RuiLoadVideoAlpha"
|
||||
},
|
||||
"title": "① 加载透明视频（保留 alpha）",
|
||||
"widgets_values": [
|
||||
"HolopixAI_00001.webm",
|
||||
0.0,
|
||||
0,
|
||||
0,
|
||||
1,
|
||||
0,
|
||||
0,
|
||||
"自动",
|
||||
""
|
||||
],
|
||||
"color": "#232",
|
||||
"bgcolor": "#353"
|
||||
},
|
||||
{
|
||||
"id": 2,
|
||||
"type": "SaveImage",
|
||||
"pos": [
|
||||
-540,
|
||||
200
|
||||
],
|
||||
"size": [
|
||||
420,
|
||||
400
|
||||
],
|
||||
"flags": {},
|
||||
"order": 1,
|
||||
"mode": 0,
|
||||
"inputs": [
|
||||
{
|
||||
"name": "images",
|
||||
"type": "IMAGE",
|
||||
"link": 1
|
||||
}
|
||||
],
|
||||
"outputs": [],
|
||||
"properties": {
|
||||
"Node name for S&R": "SaveImage"
|
||||
},
|
||||
"title": "② 保存 PNG 序列帧（带透明通道）",
|
||||
"widgets_values": [
|
||||
"透明序列帧/frame"
|
||||
],
|
||||
"color": "#223",
|
||||
"bgcolor": "#335"
|
||||
},
|
||||
{
|
||||
"id": 3,
|
||||
"type": "PreviewImage",
|
||||
"pos": [
|
||||
-540,
|
||||
640
|
||||
],
|
||||
"size": [
|
||||
420,
|
||||
400
|
||||
],
|
||||
"flags": {},
|
||||
"order": 2,
|
||||
"mode": 0,
|
||||
"inputs": [
|
||||
{
|
||||
"name": "images",
|
||||
"type": "IMAGE",
|
||||
"link": 2
|
||||
}
|
||||
],
|
||||
"outputs": [],
|
||||
"properties": {
|
||||
"Node name for S&R": "PreviewImage"
|
||||
},
|
||||
"title": "③ 预览 RGBA（预览区黑底是正常现象）",
|
||||
"color": "#223",
|
||||
"bgcolor": "#335"
|
||||
},
|
||||
{
|
||||
"id": 4,
|
||||
"type": "RuiMaskPreview",
|
||||
"pos": [
|
||||
-540,
|
||||
1080
|
||||
],
|
||||
"size": [
|
||||
420,
|
||||
400
|
||||
],
|
||||
"flags": {},
|
||||
"order": 3,
|
||||
"mode": 0,
|
||||
"inputs": [
|
||||
{
|
||||
"name": "mask",
|
||||
"type": "MASK",
|
||||
"link": 3
|
||||
}
|
||||
],
|
||||
"outputs": [],
|
||||
"properties": {
|
||||
"Node name for S&R": "RuiMaskPreview"
|
||||
},
|
||||
"title": "④ 透明通道预览（白=不透明 黑=透明）",
|
||||
"color": "#323",
|
||||
"bgcolor": "#535"
|
||||
},
|
||||
{
|
||||
"id": 9,
|
||||
"type": "Note",
|
||||
"pos": [
|
||||
-1000,
|
||||
560
|
||||
],
|
||||
"size": [
|
||||
400,
|
||||
340
|
||||
],
|
||||
"flags": {},
|
||||
"order": 4,
|
||||
"mode": 0,
|
||||
"inputs": [],
|
||||
"outputs": [],
|
||||
"properties": {},
|
||||
"title": "说明",
|
||||
"widgets_values": [
|
||||
"为什么普通加载视频节点会丢透明通道\n─────────────────────────────\n带 alpha 的 WebM 并不把透明度放在主视频流里。\n主流仍是 yuv420p，alpha 被单独压成第二路，藏在\nMatroska 的 BlockAdditional 边带中，容器上只留\n一条 alpha_mode=1 的元数据作记号。\n\nffmpeg 内置的 vp9/vp8 解码器不读这条边带，只有\nlibvpx-vp9 / libvpx 会。VideoHelperSuite 等节点\n走的是默认解码器，所以每帧 alpha 恒为 255。\n\n本节点会自动探测 alpha_mode 并换用 libvpx 解码。\n若仍然丢失，把「解码器」切到「强制 libvpx」。\n\n关于预览\n─────────────────────────────\nComfyUI 预览区不渲染透明，看到黑底属正常现象。\n以④的遮罩预览为准，或直接看存出的 PNG 文件。\n\n输出的 PNG 位于 output/透明序列帧/ 下，\n为 RGBA 模式，可直接导入 Unity / Godot / AE。"
|
||||
],
|
||||
"color": "#432",
|
||||
"bgcolor": "#653"
|
||||
}
|
||||
],
|
||||
"links": [
|
||||
[
|
||||
1,
|
||||
1,
|
||||
0,
|
||||
2,
|
||||
0,
|
||||
"IMAGE"
|
||||
],
|
||||
[
|
||||
2,
|
||||
1,
|
||||
0,
|
||||
3,
|
||||
0,
|
||||
"IMAGE"
|
||||
],
|
||||
[
|
||||
3,
|
||||
1,
|
||||
1,
|
||||
4,
|
||||
0,
|
||||
"MASK"
|
||||
]
|
||||
],
|
||||
"groups": [],
|
||||
"config": {},
|
||||
"extra": {},
|
||||
"version": 0.4
|
||||
}
|
||||
Reference in New Issue
Block a user