ComfyUI-Fisheye-effects 插件完全新手教程

1. 插件简介

ComfyUI-Fisheye-effects 是一个专门处理鱼眼效果的插件，就像给你的照片戴上了一个特殊的镜头。这个插件能够：

给图片添加鱼眼效果：让普通的照片看起来像是用鱼眼镜头拍摄的，产生那种圆形弯曲的有趣效果
去除鱼眼效果：如果你有一张鱼眼照片，想要变回正常的样子，这个插件也能帮你搞定

插件原地址：https://github.com/Kidev/ComfyUI-Fisheye-effects

想象一下，这个插件就像一个魔法镜子，可以让你的照片在"正常样子"和"鱼眼效果"之间随意切换，创造出非常有趣的视觉效果。

2. 如何安装

方法一：通过 ComfyUI 管理器安装（推荐）

打开 ComfyUI，找到"Custom Nodes Manager"（自定义节点管理器）
搜索"ComfyUI-Fisheye-effects"
点击安装，等待完成即可

方法二：手动安装

打开你的 ComfyUI 文件夹
进入 custom_nodes 文件夹
在这里打开命令行，输入：

git clone https://github.com/Kidev/ComfyUI-Fisheye-effects

进入刚下载的插件文件夹：

cd ComfyUI-Fisheye-effects

安装需要的东西：

python install.py

重启 ComfyUI

安装完成后，你会在节点菜单的"image/processing"（图像处理）分类下看到两个新节点。

3. 节点详细解析

这个插件提供了两个主要节点，就像是一对好搭档：

3.1 Apply Fisheye Effect 节点（添加鱼眼效果）

这个节点就像是一个"鱼眼镜头模拟器"，能够把你的普通照片变成看起来像用鱼眼镜头拍摄的效果。

3.1.1 参数详解

参数名 (界面显示)	参数名 (代码中)	参数值类型	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
image	image	图片	-	这是你要处理的原图片，就像把照片放到镜头前面	输入的原始图像数据	连接一个图片加载节点或者其他输出图片的节点
mapping	mapping	下拉选择	equidistant	这是鱼眼镜头的"性格"，不同的选择会产生不同的弯曲效果	畸变映射模式，决定像素点的重新分布算法	可以选择：equidistant（等距）、equisolid（等立体角）、orthographic（正交）、stereographic（立体投影）
format	format	下拉选择	fullframe	决定最终图片是"满屏"还是"圆形"的样子	输出格式，控制图像的显示方式	fullframe（全屏显示）或 circular（圆形显示，就像透过鱼眼镜头看到的圆形画面）
fov	fov	数字	180.0	就像调节镜头的"视野宽度"，数值越大看到的范围越广，效果越夸张	视场角度，控制鱼眼效果的强度	范围 0.0-360.0 度，180度是比较自然的鱼眼效果
pfov	pfov	数字	180.0	这是"投影视野"，影响最终图片的弯曲程度	透视视场角，控制透视变换的程度	范围 0.0-360.0 度，通常和 fov 保持一致
entire_image	entire_image	真/假	True	就像"强制显示完整图片"开关，开启后无论怎么调节都能看到完整的图片	是否始终显示完整图像而不进行裁剪	True（显示完整图片）或 False（可能会裁剪掉部分内容）
wcenter	wcenter	数字	0.5	调节鱼眼效果的"左右位置"，就像移动镜头中心点	水平方向的效果中心点	范围 0.0-1.0，0.5 是正中间，0.0 是最左边，1.0 是最右边
hcenter	hcenter	数字	0.5	调节鱼眼效果的"上下位置"，就像移动镜头中心点	垂直方向的效果中心点	范围 0.0-1.0，0.5 是正中间，0.0 是最上面，1.0 是最下面

3.2 Remove Fisheye Effect 节点（去除鱼眼效果）

这个节点就像是一个"鱼眼校正器"，能够把已经有鱼眼效果的照片变回正常的样子。

3.2.1 参数详解

参数名 (界面显示)	参数名 (代码中)	参数值类型	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
image	image	图片	-	这是你要处理的鱼眼照片，就像把弯曲的照片放到校正器里	输入的鱼眼图像数据	连接一个带有鱼眼效果的图片
mapping	mapping	下拉选择	equidistant	这是原始鱼眼镜头的"性格"，要和拍摄时使用的镜头类型匹配	畸变映射模式，需要与原始鱼眼效果匹配	选择与原始鱼眼效果相同的类型：equidistant、equisolid、orthographic、stereographic
format	format	下拉选择	fullframe	决定校正后的图片是"满屏"还是保持"圆形"的样子	输出格式，控制校正后的图像显示方式	fullframe（校正成正常矩形图片）或 circular（保持圆形但去除畸变）
fov	fov	数字	180.0	原始鱼眼照片的"视野宽度"，要和拍摄时的设置匹配	原始视场角度，需要与拍摄参数匹配	范围 0.0-360.0 度，需要知道原始照片的拍摄参数
pfov	pfov	数字	180.0	原始鱼眼照片的"投影视野"，要和拍摄时的设置匹配	原始透视视场角，需要与拍摄参数匹配	范围 0.0-360.0 度，通常和 fov 保持一致
entire_image	entire_image	真/假	True	就像"强制显示完整图片"开关，开启后校正时不会丢失图片内容	是否始终显示完整图像而不进行裁剪	True（显示完整校正图片）或 False（可能会裁剪掉部分内容）
wcenter	wcenter	数字	0.5	原始鱼眼照片的"左右中心位置"，要和拍摄时的设置匹配	原始水平方向的效果中心点	范围 0.0-1.0，需要与原始照片的中心位置匹配
hcenter	hcenter	数字	0.5	原始鱼眼照片的"上下中心位置"，要和拍摄时的设置匹配	原始垂直方向的效果中心点	范围 0.0-1.0，需要与原始照片的中心位置匹配

4. 使用技巧和建议

4.1 新手推荐设置

mapping（镜头类型）：建议从 equidistant 开始试，这是最常见的鱼眼效果
format（输出格式）：
想要酷炫效果选 circular（圆形）
想要正常使用选 fullframe（全屏）
fov 和 pfov：都设置为 180.0 是比较自然的效果

4.2 创意使用技巧

制作全景效果：把 fov 调到 360 度，可以制作超广角全景效果
局部鱼眼：调节 wcenter 和 hcenter，可以让鱼眼效果偏向图片的某一边
轻微鱼眼：把 fov 调到 120-150 度，可以制作轻微的鱼眼效果，不会太夸张

4.3 参数搭配建议

自然鱼眼效果：mapping=equidistant, fov=180, format=circular
强烈鱼眼效果：mapping=stereographic, fov=220, format=circular
轻微鱼眼效果：mapping=equidistant, fov=120, format=fullframe

5. 常见问题解答

Q1: 为什么我的图片变得很奇怪？

A1: 可能是参数设置不合适。建议先用默认设置（所有参数都用建议值），然后一个一个慢慢调整。

Q2: 去除鱼眼效果时，为什么校正不准确？

A2: 去除鱼眼效果时，你需要知道原始照片的拍摄参数。如果是用这个插件添加的鱼眼效果，那么去除时要用相同的参数。

Q3: 什么时候用 fullframe，什么时候用 circular？

A3: - circular：制作酷炫效果，看起来像透过鱼眼镜头看世界 - fullframe：制作实用的鱼眼效果，整个图片都有效果但保持矩形

Q4: fov 和 pfov 有什么区别？

A4: 对于新手来说，建议把这两个参数设置成相同的值。fov 控制"看到多少"，pfov 控制"怎么投影"，通常保持一致效果最好。

Q5: entire_image 什么时候关闭？

A5: 大多数情况下建议开启（设为 True）。只有当你想要裁剪掉图片边缘，专注于中心区域时才关闭。

6. 实际应用场景

6.1 创意摄影

把普通风景照变成有趣的鱼眼全景
制作动态感强烈的人像照片
创造超现实的建筑摄影效果

6.2 视频特效

为视频添加鱼眼镜头效果
制作VR风格的内容
创建有趣的动画转场效果

6.3 修复工作

校正真实鱼眼镜头拍摄的照片
处理运动相机（如GoPro）的广角畸变
修复监控摄像头的鱼眼效果

7. 小贴士

保存好参数：如果你找到了喜欢的效果，记得把参数记录下来，下次可以直接用
批量处理：这个插件可以用在ComfyUI的批处理流程中，一次处理多张图片
预览调整：建议先用小图片测试参数，找到满意的效果后再用高清大图
备份原图：处理重要照片时，记得保留原始图片的备份

通过这个插件，你可以轻松地在普通照片和鱼眼效果之间切换，创造出各种有趣的视觉效果。记住，最好的学习方法就是多实践，不要怕调错参数，大胆尝试各种组合吧！

ComfyUI鱼眼特效插件新手入门指南