ComfyUI Extension: ComfyUI-ImageCompositionCy

Authored by CY-CHENYUE

Created

Updated

4 stars

A powerful ComfyUI multi-image composition node that supports real-time adjustment of image position, size, and rotation angle on an interactive Canvas, with freehand drawing capabilities and real-time preview of composition effects.

Custom Nodes (0)

    README

    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
    1. 克隆本仓库：
    git clone https://github.com/CY-CHENYUE/ComfyUI-ImageCompositionCy.git
    1. 安装依赖：
    cd ComfyUI-ImageCompositionCy
pip install -r requirements.txt
    1. 重启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. 绘画技巧 - 调整透明度可以创建半透明效果

    联系我