green-screen

# 绿幕抠像 / 换背景合成 > 把绿幕前景抠出来合成到新背景。全部走 `skills/shared/scripts/chromakey.py`， > **不要手拼 chromakey/overlay 滤镜**——脚本已处理抠像、溢色抑制(despill)、边缘融合、 > 背景缩放、音轨保留。 > 只改画幅见 **video-reframe**；从零 AI 生成画面见 **ai-video-gen**；通用剪辑见 **video-editing**。 ## 输入 | 字段 | 必填 | 说明 | |------|------|------| | 前景视频 | 是 | 绿幕/蓝幕拍摄的素材（没给就问） | | 背景 | 是 | 四选一：图片 / 视频 / 纯色 / 前景自身模糊 | | 幕布色 | 否 | 默认绿 `0x00ff00`；蓝幕用 `0x0000ff` | ## 输出（`outputs/主题名/`） - 合成后视频（`*-composited.mp4`） - 报告：分辨率、抠掉的颜色、所用背景 ## 执行步骤 脚本路径（相对项目根）：`skills/shared/scripts/chromakey.py`（`key -h` 看参数）。 ```bash # 合成到图片背景 python skills/shared/scripts/chromakey.py key -i <绿幕视频> \ --bg <背景图> -o outputs/主题名/<名>-composited.mp4 # 合成到视频背景（背景自动循环补足） python skills/shared/scripts/chromakey.py key -i <绿幕视频> \ --bg <背景视频> -o outputs/主题名/<名>.mp4 # 合成到纯色背景 python skills/shared/scripts/chromakey.py key -i <绿幕视频> \ --bg-color white -o outputs/主题名/<名>.mp4 # 背景=前景自身放大模糊（虚化景深感） python skills/shared/scripts/chromakey.py key -i <绿幕视频> \ --bg-blur -o outputs/主题名/<名>.mp4 ``` ## 调参（抠不干净时） - **绿边残留 / 抠不净**：调大 `--similarity`（默认 0.30，可到 0.4）。 - **主体边缘被吃 / 镂空**：调小 `--similarity`，或加大 `--blend`（默认 0.10）柔化边缘。 - **主体泛绿（溢色）**：脚本已自动 `despill`；仍明显时说明幕布打光不匀，属素材问题。 - **蓝幕**：`--color 0x0000ff`。 ## 规则 1. 幕布色默认绿；蓝幕/其它色用 `--color` 指定。 2. 背景四选一（`--bg` / `--bg-color` / `--bg-blur`），互斥。 3. 背景自动缩放裁切到前景画幅、视频背景自动循环补足到前景时长。 4. 前景音轨自动保留。 5. 抠像质量取决于素材（幕布纯净度、打光均匀度）；脚本尽力，但拍摄差无法救回。 6. 产物统一进 `outputs/主题名/`。 ## 参考来源 绿幕抠像用 ffmpeg `chromakey`（按颜色距离生成 alpha）+ `despill`（抑制主体边缘溢色）+ `overlay` 合成，是标准无 GPU 抠像方案。把颜色阈值、边缘融合、背景适配封装成确定性脚本。