# ComfyUI-Gaffer 插件保姆级教程 ## 1. 插件简介 ComfyUI-Gaffer 是一个专门用来控制图片光照效果的插件，它基于 IC-Light 技术制作。简单来说，这个插件就像是一个专业的打光师，能够让你轻松地为图片添加各种光照效果，比如从左边打光、从右边打光，或者改变整个图片的明暗程度。 **插件地址：** https://github.com/huagetai/ComfyUI-Gaffer **主要功能：** - 给图片添加不同方向的光照效果 - 控制图片的明暗程度 - 处理前景和背景的光照关系 - 制作法线图来增强立体感 ## 2. 如何安装 ### 方法一：使用 ComfyUI Manager（推荐） 1. 打开 ComfyUI，点击 Manager 按钮 2. 搜索 "ComfyUI-Gaffer" 3. 点击安装即可 ### 方法二：手动安装 1. 打开命令行窗口 2. 进入 ComfyUI 的 custom_nodes 文件夹 3. 输入命令：`git clone https://github.com/huagetai/ComfyUI-Gaffer.git` ### 方法三：下载安装 1. 从 GitHub 下载 zip 文件 2. 解压后复制到 ComfyUI\custom_nodes 文件夹中 ### 下载模型文件 安装完插件后，还需要下载专门的模型文件： - 访问：https://huggingface.co/lllyasviel/ic-light/tree/main - 下载三个模型文件： - iclight_sd15_fc.safetensors（用于前景处理） - iclight_sd15_fcon.safetensors（用于前景处理） - iclight_sd15_fbc.safetensors（用于背景处理） - 将这些文件放到 ComfyUI/models/iclight 文件夹中 安装完成后重启 ComfyUI 即可使用。 ## 3. 节点详细解析 ### 3.1 Load ICLight Model 节点 - 加载光照模型 这个节点就像是一个模型仓库管理员，负责帮你找到并加载合适的光照处理模型。 #### 3.1.1 参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 | |:--|:--|:--|:--|:--|:--|:--| | ICLight Model | iclight_name | 字符串 | 根据需要选择 | 选择要使用的光照模型，就像选择不同的相机镜头 | 指定要加载的IC-Light模型文件名 | 如果要处理前景选择 fc 模型，处理背景选择 fbc 模型 | #### 3.1.2 输出接口 - **iclight**: 输出加载好的模型信息，就像拿到了一把专业的打光工具 ### 3.2 Apply ICLight 节点 - 应用光照效果 这个节点是整个插件的核心，就像是一个智能打光师，能够根据你的要求给图片添加光照效果。 #### 3.2.1 参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 | |:--|:--|:--|:--|:--|:--|:--| | Base Model | model | 模型对象 | 必须连接 | 基础的图像生成模型，就像画画用的画笔 | 用于图像生成的基础模型 | 连接你的 SD 模型 | | VAE | vae | VAE模型 | 必须连接 | 图像编码解码器，就像翻译官把图片转换成计算机能理解的语言 | 变分自编码器，用于图像编码解码 | 连接对应的 VAE 模型 | | ICLight Model | iclight | 光照模型 | 必须连接 | 从上面节点传来的光照处理工具 | IC-Light模型信息 | 连接 Load ICLight Model 节点的输出 | | Position Prompt | position | 文本 | 描述性文字 | 描述你想要的光照效果，就像给摄影师下指令 | 正向提示词，描述期望的光照效果 | 比如"柔和的侧光"、"明亮的顶光" | | Negative Prompt | negative | 文本 | 不想要的效果 | 描述你不想要的光照效果 | 负向提示词，描述要避免的效果 | 比如"阴影太重"、"光线刺眼" | | Foreground Image | fg_pixels | 图像 | 透明背景图片 | 前景图片，背景需要是透明的，就像抠图后的人物 | 前景图像，需要移除背景 | 上传一个背景透明的PNG图片 | | Background Image | bg_pixels | 图像 | 可选 | 背景图片，只有使用背景模型时才需要 | 背景图像，仅背景条件模型需要 | 上传一个背景图片 | | Strength | multiplier | 数值 | 0.5-1.0 | 光照效果的强度，就像调节灯光的亮度旋钮 | IC-Light模型的作用强度 | 0.8表示比较强的光照效果 | #### 3.2.2 输出接口 - **model**: 应用了光照效果的模型 - **position**: 传递的正向提示词 - **negative**: 传递的负向提示词 - **empty_latent**: 空白的潜在图像，尺寸与前景图像一致 ### 3.3 Simple Light Source 节点 - 简单光源 这个节点就像是一个可以随意移动的聚光灯，能够创建不同方向和颜色的光照效果。 #### 3.3.1 参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 | |:--|:--|:--|:--|:--|:--|:--| | Light Position | light_position | 选择列表 | 根据需要选择 | 光源位置，就像选择从哪个角度打光 | 光源的位置方向 | 选择"Left Light"表示从左侧打光 | | Strength | multiplier | 数值 | 0.5-1.0 | 光照强度，就像调节台灯的亮度 | 光照偏好的强度 | 0.7表示中等强度的光照 | | Start Color | start_color | 颜色值 | 白色或暖色 | 光源的起始颜色，就像选择灯泡颜色 | 光照渐变的起始颜色 | 选择温暖的黄色作为起始 | | End Color | end_color | 颜色值 | 与起始色协调 | 光源的结束颜色，创建渐变效果 | 光照渐变的结束颜色 | 选择较深的橙色作为结束 | | Width | width | 数值 | 与前景图同宽 | 光照图片的宽度，必须与前景图一致 | 光照偏好图像的宽度 | 如果前景图是512像素宽，这里也填512 | | Height | height | 数值 | 与前景图同高 | 光照图片的高度，必须与前景图一致 | 光照偏好图像的高度 | 如果前景图是768像素高，这里也填768 | **可选的光源位置：** - Left Light（左侧光） - Right Light（右侧光） - Top Light（顶部光） - Bottom Light（底部光） - Top Left Light（左上光） - Top Right Light（右上光） - Bottom Left Light（左下光） - Bottom Right Light（右下光） #### 3.3.2 输出接口 - **image**: 生成的光照偏好图像，就像一张光照地图 ### 3.4 Calculate Normal Map 节点 - 计算法线图 这个节点就像是一个立体感分析师，能够分析图片的凹凸信息，让光照效果更加逼真。 #### 3.4.1 参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 | |:--|:--|:--|:--|:--|:--|:--| | Input Images | images | 图像序列 | 必须连接 | 要分析的图片，就像给医生看的X光片 | 输入的图像序列 | 连接你要分析立体感的图片 | | Mask | mask | 图像 | 可选 | 遮罩图片，指定要分析的区域，就像用手遮住部分区域 | 可选的遮罩图像，指定计算区域 | 上传一个黑白图片，白色区域会被分析 | | Sigma | sigma | 数值 | 1.0-3.0 | 模糊程度，就像调节相机的对焦，数值越大越模糊 | 高斯模糊的标准差，控制平滑度 | 2.0表示中等程度的平滑 | | Input Range | center_input_range | 数值 | 1.0 | 输入范围中心化参数，就像调节图片的对比度基准 | 用于中心化输入图像的范围 | 通常保持默认值1.0 | #### 3.4.2 输出接口 - **normal**: 法线图，就像一张立体信息地图，显示每个像素的凹凸方向 ### 3.5 Gray Scaler 节点 - 灰度缩放器 这个节点就像是一个选择性的去色工具，能够根据遮罩将图片的指定区域变成灰色。 #### 3.5.1 参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 | |:--|:--|:--|:--|:--|:--|:--| | Input Image | image | 图像 | 透明背景图片 | 要处理的图片，最好是背景透明的 | 透明背景的输入图像 | 上传一个PNG格式的透明背景图片 | | Mask | mask | 图像 | 黑白遮罩 | 遮罩图片，指定哪些区域要变灰，就像用模板喷漆 | 遮罩图像，指示要转换为灰色的区域 | 上传一个黑白图片，白色区域会变灰 | | Intensity | multiplier | 数值 | 0.5-1.0 | 变灰的程度，就像调节去色的强度 | 控制灰度转换强度的数值 | 0.8表示比较强的去色效果 | #### 3.5.2 输出接口 - **image**: 处理后的图片，指定区域变成了灰色背景 ## 4. 使用技巧和建议 ### 4.1 前景处理工作流程 1. 使用 Load ICLight Model 节点加载 fc 或 fcon 模型 2. 准备一个背景透明的前景图片 3. 使用 Apply ICLight 节点处理 4. 可以配合 Simple Light Source 节点创建特定方向的光照 ### 4.2 背景处理工作流程 1. 使用 Load ICLight Model 节点加载 fbc 模型 2. 准备前景图片和背景图片，确保尺寸一致 3. 使用 Apply ICLight 节点处理 4. 背景图片会影响最终的光照效果 ### 4.3 光照强度控制 - 通过 multiplier 参数控制光照强度 - 建议从 0.5 开始测试，逐步调整 - 过高的数值可能导致过曝效果 ### 4.4 颜色搭配建议 - 暖色光源（黄色、橙色）适合营造温馨氛围 - 冷色光源（蓝色、青色）适合营造科技感 - 起始色和结束色不要反差过大 ## 5. 常见问题解答 ### Q1: 为什么我的光照效果不明显？ A: 检查以下几点： - multiplier 参数是否设置得太低 - 前景图片是否正确移除了背景 - 模型文件是否正确下载和放置 ### Q2: 处理后的图片出现奇怪的颜色 A: 可能原因： - 前景图片的背景不够干净 - 光源颜色设置不当 - 建议使用灰度背景代替透明背景 ### Q3: 提示缺少模型文件 A: 确保已经下载了对应的模型文件： - 前景处理需要 fc 或 fcon 模型 - 背景处理需要 fbc 模型 - 模型文件放置在正确的路径 ### Q4: 图片尺寸不匹配错误 A: 确保： - 前景图片和背景图片尺寸一致 - Simple Light Source 节点的宽高设置与图片一致 - 所有相关图片使用相同的长宽比 ### Q5: 内存不足错误 A: 建议： - 降低图片分辨率 - 减少同时处理的图片数量 - 关闭其他占用内存的程序 ## 6. 进阶应用 ### 6.1 动画制作 插件支持批量处理图片，可以用来制作光照变化的动画效果。将多张图片按顺序处理，就能得到光照渐变的动画序列。 ### 6.2 与其他插件配合 - 配合 ComfyUI-KJNodes 使用可以获得更好的光照偏好控制 - 可以与其他图像处理节点组合使用，创造更复杂的效果 ### 6.3 批量处理技巧 利用 ComfyUI 的批处理功能，可以一次性处理多张图片，适合制作系列作品或动画帧。 ### 6.4 专业打光技巧 - 使用多个光源节点创建复杂的光照环境 - 结合法线图获得更真实的立体感 - 通过调整颜色温度营造不同的氛围 这个插件特别适合需要精确控制光照效果的创作者，无论是静态图片还是动画制作，都能获得专业级的光照效果。记住多实验不同参数组合，找到最适合你创作风格的设置。
ComfyUI图像合并插件comfyui-merge使用教程 2025-07-03 22:44 ComfyUI 图像合并插件教程 (comfyui-merge) 1. 插件简介 这是一个专门用来合并图片的 ComfyUI 插件，就像用 PS 把多张图片叠在一起那样。它的特别之处在于你精确控制每张图片的混合方式。 GitHub 地址：https://github.com/LingSss9/com
%20(1).png)
