Comfyui-Ycanvas

Comfyui-Ycanvas
★ 111

画布节点多图层编辑钢笔抠图AI抠图
为 ComfyUI 提供可调画布、多图层、钢笔路径与AI抠图等图像编辑与合成功能，优化大幅面渲染与工作流效率。
💡 在 ComfyUI 中进行精细抠图、分层合成与大尺寸画布编辑
🍴 4 Forks💻 JavaScript🔄 2025-07-28
📦
网盘下载
复制链接后前往夸克网盘下载
https://pan.quark.cn/s/a9fb3a59e10c
📦 requirements.txt
torch
torchvision
transformers
aiohttp
numpy
tqdm
Pillow
📄 README

ComfyUI-Ycanvas 插件

📝 简介

2025/07/02 更新了画布，在原有的一键自动抠图基础上，增加了套索工具抠图和钢笔路径抠图，总共有三种抠图模式。

钢笔路径模式下，按d可以回退节点，按e进去编辑模式

https://github.com/user-attachments/assets/b2c9941e-1252-40fa-a9fa-30f0897a27c3

ComfyUI-Ycanvas 是一个功能强大的 ComfyUI 画布节点插件，提供了完整的图像编辑和合成功能。该插件集成了多种图像处理工具，包括高级套索工具、钢笔路径抠图、AI 抠图、图层管理等，特别适用于图像合成、编辑和工作流处理。

✨ 主要特性

🎨 画布功能

  • 可调节画布尺寸：支持 1×1 到 2048×2048 像素的自定义画布尺寸
  • 多图层支持：无限制的图层数量，支持图层重排序和透明度调节
  • 高性能渲染：针对大尺寸画布优化的渲染引擎，支持离屏渲染

    • 🖱️ 图像操作

  • 导入图片：支持使用按钮添加
  • 精确变换：旋转、缩放、镜像、移动等基础变换操作
  • 快捷键支持：
  • 鼠标滚轮：缩放图像
  • Shift + 鼠标滚轮：旋转图像
  • 自由变形

    • 🔧 高级套索工具

  • 多种模式：
  • 新建：创建新的选区遮罩
  • 添加：向现有遮罩添加区域
  • 减去：从现有遮罩减去区域 必需有新建后才能用这个功能
  • 恢复原图：一键恢复到原始状态
  • 性能优化：针对大尺寸画布的点抽样和渲染优化
  • 实时预览：绘制过程中的绿色虚线预览
  • 撤销功能：保存原始状态，支持快速恢复

    • 🤖 AI 抠图功能

  • BiRefNet 模型：集成先进的 AI 抠图算法
  • 自动下载：首次使用时自动下载所需模型
  • 高质量结果：支持细节保留和边缘优化
  • 批处理支持：可处理多个图层

    • 🚀 安装说明

    方法：自动安装

  • 克隆仓库到 ComfyUI 的 custom_nodes 目录：
    • cd ComfyUI/custom_nodes
git clone https://github.com/your-repo/Comfyui-Ycanvas.git

  • 安装依赖：
    • cd Comfyui-Ycanvas
pip install -r requirements.txt

  • 重启 ComfyUI

    • 模型下载

    插件会自动下载所需的 BiRefNet 模型。如果自动下载失败，可手动下载：

    模型名称：BiRefNet

    下载链接：

  • 百度网盘：https://pan.baidu.com/s/1PiZvuHcdlcZGoL7WDYnMkA?pwd=nt76
  • Google Drive：https://drive.google.com/drive/folders/1BCLInCLH89fmTpYoP8Sgs_Eqww28f_wq

    • 安装路径：ComfyUI/models/BiRefNet/

    📖 使用指南

    基础操作

    1. 添加图像

  • Add Image：点击按钮选择本地图片文件
  • Import Input：导入从其他节点传递的图像数据 必须执行一次，才能点击导入
  • 支持拖拽多个图片同时添加

    • 2. 画布操作

  • Canvas Size：调整画布尺寸（建议尺寸：512×512 到 2048×2048）
  • 选择图像：单击图像进行选择
  • 取消选择：双击图像或点击空白区域

    • 3. 图像变换

  • 旋转：Rotate +90° 按钮或 Shift + 鼠标滚轮
  • 缩放：Scale +5%/-5% 按钮或鼠标滚轮
  • 镜像：Mirror H（水平）/ Mirror V（垂直）按钮
  • 移动：直接拖拽图像

    • 4. 图层管理

  • Layer Up/Down：调整图层顺序
  • Remove Layer：删除选中图层
  • 支持多图层叠加和混合

    • 高级功能

    套索工具使用

  • 选择要编辑的图层
  • 点击 “套索工具” 激活
  • 选择模式：
  • 新建：创建全新选区
  • 添加：扩展现有选区
  • 减去：缩小现有选区
  • 恢复原图：撤销所有修改
  • 在图像上绘制选区路径
  • 完成绘制后自动应用遮罩
  • 绘制后，不要移动图层，否则会丢失选区，导致图片遮罩错误合成。

    • AI 抠图功能

  • 选择需要抠图的图层
  • 点击 “Matting” 按钮
  • 等待 AI 处理完成
  • 系统会创建新的透明背景图层

    • ⚙️ 技术特性

    性能优化

  • 大画布支持：针对 1024×1024 以上画布的专项优化
  • 内存管理：智能缓存机制，减少内存占用
  • 渲染优化：离屏渲染技术，提升绘制性能
  • 事件节流：防止频繁操作导致的性能问题

    • 兼容性

  • ComfyUI 版本：支持最新版本的 ComfyUI
  • 操作系统：Windows、macOS、Linux
  • GPU 支持：NVIDIA CUDA、AMD ROCm
  • 数据格式：支持标准的 IMAGE 和 MASK 张量格式

    • 扩展性

  • 插件架构：模块化设计，易于扩展
  • API 接口：提供丰富的 REST API
  • 事件系统：支持自定义事件处理
  • 配置选项：灵活的参数配置

    • 🔧 配置选项

    画布设置

  • canvas_image：输出文件名
  • trigger：触发器参数（用于工作流同步）
  • output_switch：输出开关
  • cache_enabled：缓存启用开关

    • 输入接口

  • input_image：可选的输入图像
  • input_mask：可选的输入遮罩

    • 输出接口

  • image：处理后的图像张量
  • mask：生成的遮罩张量

    • 🐛 故障排除

    常见问题

    Q: 套索工具绘制时出现虚线消失

    A: 这通常发生在大尺寸画布上。请确保：

  • 绘制速度不要过快
  • 避免快速移动鼠标
  • 使用较小的画布尺寸进行测试

    • Q: AI 抠图功能无法使用

    A: 请检查：

  • 模型是否正确下载到 models/BiRefNet/ 目录
  • 是否有足够的 GPU 内存
  • 网络连接是否正常

    • Q: 画布显示异常或消失

    A: 尝试：

  • 重新调整节点大小
  • 刷新浏览器页面
  • 检查浏览器控制台错误信息

    • 性能建议

  • 推荐画布尺寸：512×512 到 1024×1024
  • 图层数量：建议不超过 20 个图层
  • 内存使用：大画布时建议关闭不必要的功能
  • 浏览器优化：使用 Chrome 或 Edge 浏览器以获得最佳性能

    • 📄 许可证

    本项目采用 MIT 许可证。详见 LICENSE 文件。

    🙏 致谢

  • ComfyUI – 强大的 AI 图像生成界面
  • BiRefNet – 高质量图像抠图模型
  • Comfyui_three_js – 基于这个原始3d模型展示画布进行改造，感谢作者
  • 所有贡献者和用户的支持