ComfyUI-ImageCompositionCy

ComfyUI-ImageCompositionCy

中文 | English

一个强大的ComfyUI多图实时合成节点，支持在交互式Canvas画布上自由调整图片位置、大小和旋转角度，并支持自由绘画功能，实时预览合成效果。

✨ 主要特性

• 🎨 实时预览 - 在Canvas上即时查看合成效果，无需运行工作流
• 🖱️ 直观操作 - 拖拽移动、缩放、旋转图片，所见即所得
• ✏️ 绘画功能 - 支持在画布上自由绘画，包括画笔、橡皮擦等工具
• 📐 精确控制 - 支持输入精确数值调整位置和尺寸
• 🎭 图层管理 - 调整图片层级，控制遮挡关系
• 🎨 绘画工具 - 颜色选择器、画笔大小和透明度调节
• 🔀 透明度支持 - 完整保留和处理PNG图片的透明通道
• 💾 参数保存 - 自动保存布局配置和绘画内容到工作流

📦 安装

方法一：通过 ComfyUI Manager 安装（推荐）

1. 在ComfyUI中打开 ComfyUI Manager
2. 搜索 "ImageCompositionCy" 或 "Image Compositor"
3. 点击 Install 安装
4. 重启ComfyUI

方法二：手动安装

1. 进入ComfyUI的 custom_nodes 目录：

cd ComfyUI/custom_nodes

2. 克隆本仓库：

git clone https://github.com/CY-CHENYUE/ComfyUI-ImageCompositionCy.git

3. 安装依赖：

cd ComfyUI-ImageCompositionCy
pip install -r requirements.txt

4. 重启ComfyUI

🎯 使用方法

基础使用

1. 在ComfyUI中添加 Image Compositor 节点
2. 连接底图到 background_image 输入（可选）
3. 连接要合成的图片到 overlay_image_* 输入
4. 在节点的Canvas画布上进行编辑

编辑模式

在编辑模式下，你可以：

• 拖拽图片调整位置
• 拖拽角点缩放图片
• 使用旋转手柄旋转图片
• 右键菜单管理图层

绘画模式

点击工具栏的铅笔图标或按 D 键切换到绘画模式：

• 使用画笔在画布上自由绘画
• 选择橡皮擦工具擦除绘画内容
• 调整颜色、画笔大小和透明度
• 清除所有绘画内容

⌨️ 快捷键

通用快捷键

• D - 切换编辑/绘画模式

编辑模式快捷键

• Ctrl+A - 全选所有图片
• ↑↓←→ - 微调选中图片位置（1px）
• [ - 下移一层
• ] - 上移一层
• Shift+[ - 移到最底层
• Shift+] - 移到最顶层

绘画模式快捷键

• B - 选择画笔工具
• E - 选择橡皮擦工具
• C - 打开颜色选择器

🛠️ 高级功能

图层管理

• 置顶/置底
• 上移/下移一层
• 通过右键菜单访问图层选项

绘画工具

• 画笔 - 自由绘画工具
• 橡皮擦 - 擦除绘画内容
• 颜色选择器 - 选择绘画颜色
• 画笔大小 - 调节画笔粗细（1-50像素）
• 透明度 - 调节绘画透明度（0-100%）
• 清除 - 一键清除所有绘画内容

工具栏

• 紧凑的浮动工具栏设计
• 可折叠以节省空间
• 位于画布右上角，不遮挡内容

透明度处理

本节点集提供了两个专门用于处理图片透明度的辅助节点：

Load Image (Alpha) 🖼️

专门用于加载并保留PNG图片透明通道的节点。

特点：

• 完整保留PNG图片的透明信息
• 输出4通道RGBA图像
• 直接兼容Image Compositor节点

使用场景：

• 需要保留原始透明背景的PNG图片
• 制作需要透明通道的合成效果

Combine Image Alpha 🔀

将标准LoadImage节点的RGB图像和蒙版组合成带透明度的图像。

特点：

• 接收RGB图像和MASK输入
• 输出带透明通道的RGBA图像
• 与ComfyUI标准节点完全兼容

使用场景：

• 使用标准LoadImage节点但需要透明度
• 从其他节点获取蒙版并应用为透明通道
• 动态生成透明度效果

工作流程示例：

LoadImage → [IMAGE] → Combine Image Alpha → [RGBA] → Image Compositor
      └─→ [MASK] ─→ ┘

📖 节点参数

Image Compositor 节点

输入

• input_count (INT) - 叠加图片数量（1-20）
• background_image (IMAGE) - 底图，决定画布尺寸（可选）
• overlay_image_* (IMAGE) - 叠加图片（根据input_count动态显示）
• composition_data (STRING) - JSON格式的布局配置（自动管理）

输出

• composite (IMAGE) - 合成后的图片（包含绘画内容）
• mask (MASK) - 透明通道蒙版

Load Image (Alpha) 节点

输入

• image - 要加载的图片文件

输出

• IMAGE - 带透明通道的RGBA图像

Combine Image Alpha 节点

输入

• image (IMAGE) - RGB图像
• mask (MASK) - Alpha蒙版

输出

• image (IMAGE) - 组合后的RGBA图像

🎨 界面说明

Canvas画布

• 支持高DPI显示器
• 自适应图片尺寸
• 实时渲染预览

绘画层

• 独立的绘画层，不影响图片编辑
• 绘画内容会保存并合成到最终输出
• 支持透明度混合

💡 使用技巧

1. 模式切换 - 使用 D 键快速切换编辑和绘画模式
2. 精确定位 - 使用方向键进行像素级微调
3. 图层管理 - 使用快捷键快速调整图层顺序
4. 绘画技巧 - 调整透明度可以创建半透明效果

联系我

• X (Twitter): @cychenyue
• TikTok: @cychenyue
• YouTube: @CY-CHENYUE
• BiliBili: @CY-CHENYUE
• 小红书: @CY-CHENYUE