%20(1).png)
ComfyUI_preview360panorama 插件超详细新手教程
1. 插件简介
插件地址： https://github.com/ProGamerGov/ComfyUI_preview360panorama
这个插件就像给你的ComfyUI装了一个超级酷炫的VR眼镜！它可以让你在ComfyUI里面直接查看360度全景图片，就像站在图片中心往四周看一样。
它能干什么？ - 把平面的360度全景图变成可以互动的球形视图 - 用鼠标拖拽就能环顾四周，滚轮缩放远近 - 检查全景图的接缝处有没有问题 - 预览VR图片、天空盒、球形图片等各种360度内容
想象一下，你有一张360度全景照片，平时看起来是一张拉伸变形的长方形图片。这个插件就像魔法一样，把这张"摊平"的图片重新包成一个球，让你可以像在现实中一样转头看各个方向！
2. 如何安装
方法一：ComfyUI管理器安装（推荐）
- 打开ComfyUI
- 点击右下角的"Manager"按钮
- 选择"Install Custom Nodes"
- 搜索"preview360panorama"或者直接粘贴这个链接：https://github.com/ProGamerGov/ComfyUI_preview360panorama
- 点击安装，等待完成后重启ComfyUI
方法二：手动下载安装
- 下载插件压缩包
- 解压到ComfyUI的custom_nodes文件夹里
- 重启ComfyUI
安装成功后，你会在节点列表的"pytorch360convert"分类下找到"Preview 360 Panorama"节点。
3. 节点详解
3.1 Preview 360 Panorama 节点
这个节点就像一个专门的360度照片查看器，它能把你的全景图片变成一个可以互动的球形世界。
3.2 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :— | :— | :— | :— | :— | :— | :— | | images | images | 图像数据 | 无 | 这就是你要看的360度图片，就像给照片查看器喂图片一样 | 输入的图像张量数据，支持批量处理和单张图片 | 把你的全景图片连接到这个输入口，节点会自动处理 | | max_width | max_width | 整数 | 4096 | 控制图片显示的最大宽度，就像调节电视机的分辨率 | 图像缩放的最大宽度限制，用于性能优化 | 如果图片太大加载慢，可以设小一点比如2048；如果想看原始画质，设成-1 |
3.3 输入输出说明
输入接口： - images（图片）：这里接你的360度全景图片。可以是单张图片，也可以是一批图片（会自动选第一张）。就像给相机胶卷装胶卷一样简单。
输出接口： - ui（界面显示）：这个不用你管，它会自动在ComfyUI界面上显示一个可以互动的360度查看器。
4. 使用技巧和建议
4.1 基本操作技巧
- 环顾四周：按住鼠标左键拖拽，就像转动脑袋看四周
- 放大缩小：滚动鼠标滚轮，就像用望远镜看远近
- 重置视角：刷新浏览器页面可以回到初始视角
4.2 性能优化建议
- 如果你的电脑配置不高，把max_width设成2048或更小
- 如果图片加载很慢，可能是图片太大了，试试降低分辨率
- 如果要看最清晰的效果，把max_width设成-1（不限制大小）
4.3 最佳实践
- 检查接缝：生成全景图后，用这个节点检查左右边缘接合处是否自然
- 预览效果：在最终导出前，先用这个节点预览一下360度效果
- 批量处理：如果有多张图片，节点会自动选择第一张，想看其他的需要单独处理
5. 常见问题解答
Q1：图片显示不出来怎么办？
A1： 确保你的图片是正确的全景格式（等矩形投影）。就像买鞋要买对尺码一样，这个节点专门处理360度全景图片。
Q2：查看器很卡，转动不流畅怎么办？
A2： 试试把max_width调小一点，比如从4096改到2048。这就像调低游戏画质来提高帧率一样。
Q3：鼠标控制不响应怎么办？
A3： 检查一下鼠标是否正常工作，或者刷新一下浏览器页面重新加载。
Q4：可以处理黑白图片吗？
A4： 可以！节点会自动把黑白图片转换成彩色格式，你不用担心。
Q5：一次可以查看多张图片吗？
A5： 节点会自动选择第一张图片显示。如果要查看其他图片，需要单独连接处理。
6. 进阶使用技巧
6.1 配合其他节点使用
- 与AI生成结合：可以把AI生成的360度图片直接连接到这个节点预览
- 与图片处理结合：对全景图片进行处理后，用这个节点检查效果
- 与批量处理结合：虽然一次只能预览一张，但可以在工作流中设置多个预览节点
6.2 文件格式支持
- 支持常见的图片格式（PNG、JPG等）
- 自动处理不同的颜色通道（黑白、RGB、RGBA）
- 兼容ComfyUI的图片数据格式
6.3 性能调优
- 高配置电脑：max_width设为-1，享受最佳画质
- 中等配置：max_width设为4096（默认值）
- 低配置电脑：max_width设为2048或1024
这个插件就像给你的ComfyUI装了一个专业的VR查看器，让你能够真正"身临其境"地检查和欣赏360度全景作品。记住，好的工具配合正确的使用方法，才能发挥最大的效果！