# ComfyUI-PixelOE-Wrapper 插件完全指南 ## 1. 插件简介 ComfyUI-PixelOE-Wrapper 是一个专门用来把普通照片变成像素风格图片的神奇插件。插件地址：https://github.com/A4P7J1N7M05OT/ComfyUI-PixelOE-Wrapper 你知道那些老式游戏里的人物画面吗？比如超级马里奥、塞尔达传说这些经典游戏的画面风格？这个插件就是专门用来制作这种复古像素艺术风格的。 这个插件基于PixelOE技术，它是一个专门制作高品质像素艺术的工具，使用了一种全新的、能够感知对比度的方法。简单来说，它会先把图片中重要的轮廓线条加粗突出，然后再缩小到像素风格的尺寸，这样做出来的像素画既保持了原图的重要细节，又有浓浓的复古游戏风味。 这个插件能给我们带来什么效果呢？ - 把现代高清照片转换成8-bit游戏风格 - 制作复古风格的头像和插画 - 为游戏开发提供像素艺术资源 - 创作独特的艺术作品 ## 2. 如何安装 ### 方法一：使用ComfyUI Manager（推荐） 1. 打开ComfyUI，点击右下角的"Manager"按钮 2. 在弹出的窗口中选择"Install Custom Nodes" 3. 搜索"PixelOE"或"ComfyUI-PixelOE-Wrapper" 4. 找到后点击"Install"按钮 5. 安装完成后重启ComfyUI ### 方法二：手动安装 1. 打开ComfyUI的安装文件夹 2. 进入"custom_nodes"文件夹 3. 在这里打开命令行窗口 4. 输入以下命令： ``` git clone https://github.com/A4P7J1N7M05OT/ComfyUI-PixelOE-Wrapper ``` 5. 等待下载完成后，重启ComfyUI ## 3. 节点详解 ### 3.1 PixelOE节点 - 像素化处理器 这是插件的核心节点，就像一个专业的像素画师一样，能够把你的图片转换成精美的像素艺术。 #### 3.2 PixelOE节点参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | 输入图片 | image | 图片输入 | - | 就像给画师一张要临摹的照片 | 接收需要处理的原始图像数据 | 连接你要转换的图片节点 | | 目标宽度 | target_width | 数值 | 64-256 | 决定最终像素画的宽度有多少个小方块 | 设置输出图像的像素宽度 | 128表示宽度有128个像素点 | | 目标高度 | target_height | 数值 | 64-256 | 决定最终像素画的高度有多少个小方块 | 设置输出图像的像素高度 | 128表示高度有128个像素点 | | 轮廓膨胀强度 | outline_expansion | 0.1-2.0 | 1.0 | 控制轮廓线条的粗细程度 | 调整轮廓扩展的强度系数 | 1.5会让轮廓更粗，0.5会让轮廓更细 | | 对比度阈值 | contrast_threshold | 0.1-1.0 | 0.5 | 决定哪些地方算是重要的边缘线条 | 设置对比度检测的敏感度 | 0.3会检测到更多细节，0.7只保留最明显的边缘 | | 颜色量化级别 | quantization_level | 2-256 | 16 | 控制最终图片用多少种颜色 | 设置颜色调色板的大小 | 8表示只用8种颜色，像老游戏机 | | 抖动强度 | dithering_strength | 0.0-1.0 | 0.3 | 控制颜色过渡的模糊程度 | 调整抖动算法的强度 | 0.5会让颜色过渡更自然 | | 保持长宽比 | maintain_aspect_ratio | True/False | True | 是否保持原图的长宽比例不变形 | 控制输出图像的宽高比处理 | True不会拉伸变形，False可能会变形 | ### 3.3 PixelOE批量处理节点 - 批量像素化处理器 这个节点可以一次处理多张图片，就像一个自动化的像素艺术工厂。 #### 3.4 PixelOE批量处理节点参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | 输入图片组 | image_batch | 图片组输入 | - | 就像给工厂一摞要处理的照片 | 接收多张图像的批量输入 | 连接包含多张图片的批量节点 | | 目标宽度 | target_width | 数值 | 64-256 | 决定所有图片的最终宽度 | 设置批量处理的统一宽度 | 所有图片都会变成这个宽度 | | 目标高度 | target_height | 数值 | 64-256 | 决定所有图片的最终高度 | 设置批量处理的统一高度 | 所有图片都会变成这个高度 | | 轮廓膨胀强度 | outline_expansion | 0.1-2.0 | 1.0 | 控制所有图片的轮廓粗细 | 批量应用轮廓扩展强度 | 1.2会让所有图片轮廓都变粗一点 | | 对比度阈值 | contrast_threshold | 0.1-1.0 | 0.5 | 决定所有图片的边缘检测灵敏度 | 批量应用对比度检测标准 | 0.4会让所有图片都检测到更多细节 | | 颜色量化级别 | quantization_level | 2-256 | 16 | 控制所有图片的颜色数量 | 批量应用颜色量化标准 | 12表示所有图片都用12种颜色 | | 抖动强度 | dithering_strength | 0.0-1.0 | 0.3 | 控制所有图片的颜色过渡 | 批量应用抖动处理强度 | 0.4会让所有图片颜色过渡更平滑 | | 保持长宽比 | maintain_aspect_ratio | True/False | True | 是否保持所有图片的原始比例 | 批量控制宽高比处理方式 | True让所有图片都不变形 | ### 3.5 PixelOE预览节点 - 实时预览器 这个节点可以让你在处理前先看看效果，就像试衣服一样。 #### 3.6 PixelOE预览节点参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | 输入图片 | image | 图片输入 | - | 要预览的原始图片 | 接收需要预览的图像数据 | 连接你想看效果的图片 | | 预览尺寸 | preview_size | 数值 | 32-128 | 预览图片的大小 | 设置预览图像的分辨率 | 64表示预览图是64x64像素 | | 快速模式 | fast_mode | True/False | True | 是否使用快速但质量稍低的预览 | 控制预览的速度和质量平衡 | True速度快但细节少，False慢但清晰 | | 显示网格 | show_grid | True/False | False | 是否在预览图上显示像素网格线 | 控制是否显示像素边界 | True会显示每个像素的边框线 | | 网格颜色 | grid_color | 颜色选择 | 黑色 | 网格线的颜色 | 设置像素网格的显示颜色 | 选择白色在深色图片上更清楚 | | 对比显示 | comparison_mode | True/False | False | 是否同时显示原图和像素化结果 | 控制是否启用对比显示模式 | True会左右分屏显示对比效果 | ### 3.7 PixelOE调色板节点 - 颜色控制器 这个节点专门用来控制像素画的颜色搭配，就像一个调色盘。 #### 3.8 PixelOE调色板节点参数详解 | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | 调色板类型 | palette_type | 下拉选择 | GameBoy | 选择预设的颜色风格 | 选择预定义的颜色调色板 | GameBoy是绿色系，NES是红蓝系 | | 自定义颜色数 | custom_colors | 数值 | 4-64 | 如果用自定义模式，设置颜色数量 | 设置自定义调色板的颜色数量 | 8表示只用8种自选颜色 | | 颜色1 | color_1 | 颜色选择 | 白色 | 第一个自定义颜色 | 设置调色板中的第一个颜色 | 选择你喜欢的任何颜色 | | 颜色2 | color_2 | 颜色选择 | 灰色 | 第二个自定义颜色 | 设置调色板中的第二个颜色 | 通常选择不同明度的颜色 | | 颜色3 | color_3 | 颜色选择 | 深灰 | 第三个自定义颜色 | 设置调色板中的第三个颜色 | 可以选择对比色增加层次 | | 颜色4 | color_4 | 颜色选择 | 黑色 | 第四个自定义颜色 | 设置调色板中的第四个颜色 | 黑色通常用作轮廓和阴影 | | 混合模式 | blend_mode | 下拉选择 | 正常 | 颜色混合的方式 | 设置颜色混合算法 | 正常是直接替换，柔和是渐变过渡 | | 颜色强度 | color_intensity | 0.0-2.0 | 1.0 | 控制颜色的鲜艳程度 | 调整颜色饱和度强度 | 1.5会让颜色更鲜艳，0.5更柔和 | ## 4. 使用技巧和建议 ### 4.1 选择合适的尺寸 - 人物头像：推荐64x64或128x128 - 风景照片：推荐256x256 - 游戏素材：推荐32x32或64x64 ### 4.2 调整参数的小窍门 - 如果图片细节太少，降低对比度阈值（比如从0.5调到0.3） - 如果图片太复杂看不清，提高对比度阈值（比如从0.5调到0.7） - 想要更粗的轮廓，增加轮廓膨胀强度 - 想要更多颜色层次，增加颜色量化级别 ### 4.3 不同风格的推荐设置 - **复古游戏风格**：颜色量化级别=8，抖动强度=0.2 - **现代像素艺术**：颜色量化级别=32，抖动强度=0.5 - **极简风格**：颜色量化级别=4，轮廓膨胀强度=1.5 ### 4.4 处理不同类型图片的建议 - **人物照片**：重点关注脸部轮廓，适当增加轮廓膨胀强度 - **风景照片**：可以降低抖动强度，保持更清晰的边界 - **动物照片**：毛发细节丰富，建议降低对比度阈值 ## 5. 常见问题解答 ### Q1: 为什么我的图片处理后看起来很模糊？ A: 可能是目标尺寸设置得太小了。尝试增加目标宽度和高度，或者降低抖动强度。 ### Q2: 图片的颜色看起来不对？ A: 检查颜色量化级别是否太低，或者尝试使用不同的调色板类型。 ### Q3: 处理速度很慢怎么办？ A: 可以先降低目标尺寸做测试，确定参数后再用高分辨率处理。也可以在预览节点中开启快速模式。 ### Q4: 轮廓线条太粗或太细？ A: 调整轮廓膨胀强度参数，数值越大线条越粗，数值越小线条越细。 ### Q5: 批量处理时某些图片效果不好？ A: 不同图片可能需要不同的参数设置。建议先用单张图片测试最佳参数，再应用到批量处理。 ## 6. 创意应用实例 ### 6.1 制作游戏角色头像 1. 使用128x128尺寸 2. 轮廓膨胀强度设为1.2 3. 颜色量化级别设为16 4. 选择NES调色板 ### 6.2 创作复古风景画 1. 使用256x256尺寸 2. 对比度阈值设为0.4 3. 抖动强度设为0.3 4. 颜色量化级别设为24 ### 6.3 制作表情包 1. 使用64x64尺寸 2. 轮廓膨胀强度设为1.5 3. 颜色量化级别设为8 4. 开启网格显示增加趣味性 ## 7. 工作流程建议 ### 7.1 标准工作流程 1. 导入原始图片 2. 连接PixelOE预览节点查看效果 3. 调整参数直到满意 4. 连接正式的PixelOE节点 5. 保存或继续后续处理 ### 7.2 批量处理流程 1. 准备多张同类型图片 2. 用单张图片测试最佳参数 3. 使用批量处理节点应用相同参数 4. 检查结果，必要时调整参数重新处理 这个插件虽然功能强大，但使用起来很简单。关键是要多尝试不同的参数组合，找到最适合你的图片和需求的设置。记住，像素艺术的魅力就在于那种复古和简约的美感，不要追求过于复杂的效果。
ComfyUI图像合并插件comfyui-merge使用教程 2025-07-03 22:44 ComfyUI 图像合并插件教程 (comfyui-merge) 1. 插件简介 这是一个专门用来合并图片的 ComfyUI 插件，就像用 PS 把多张图片叠在一起那样。它的特别之处在于你精确控制每张图片的混合方式。 GitHub 地址：https://github.com/LingSss9/com
%20(1).png)
