%20(1).png)
ComfyUI-PanoCard 插件完全新手教程
1. 插件简介
ComfyUI-PanoCard 是一个专门用来制作 360 度全景图的神奇插件！插件地址：https://github.com/Gue-e/ComfyUI-PanoCard
想象一下，你用手机拍了一张普通的照片，这个插件就能把它变成像 VR 游戏里那样可以 360 度旋转观看的全景图！就像把一张平面的世界地图变成了一个可以转动的地球仪一样。
这个插件能帮你做什么？
- 把普通的平面照片变成 360 度全景图（就像把一张纸卷成圆筒）
- 把全景图重新变回平面图片
- 把一张图片拉伸成弧形（像把纸张弯曲成扇形）
- 把一张图片切成 6 个面，然后重新组合成全景图（就像把魔方的 6 个面分开再组装）
- 利用文字描述来生成不同区域的全景图
2. 如何安装
方法一：使用 ComfyUI Manager（推荐，最简单）
- 打开 ComfyUI，点击右侧的 "Manager" 按钮
- 在搜索框里输入 "PanoCard"
- 找到 "ComfyUI-PanoCard" 插件，点击 "Install" 安装
- 等待安装完成后，重启 ComfyUI
方法二：手动安装
- 找到你的 ComfyUI 安装文件夹
- 进入
custom_nodes文件夹 - 在这里打开命令行，输入：
git clone https://github.com/Gue-e/ComfyUI-PanoCard.git - 重启 ComfyUI
重要提醒：
- 这个插件需要搭配 ComfyUI-Impact-Pack 一起使用，记得也要安装这个插件！
3. 节点详细解析
基于插件的功能描述，这个插件主要包含以下几类节点：
3.1 平面图转全景图节点 (Flat to Panoramic)
这个节点就像一个神奇的"卷纸机"，能把平面图片卷成 360 度全景图。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图像 | input_image | 图像 | - | 要变成全景图的原始照片 | 待转换的平面图像输入 | 拖入一张风景照片 |
| 转换模式 | conversion_mode | 选择项 | auto | 选择怎样把平面图变成全景图 | 图像投影转换的算法模式 | 选择"自动"让系统自己判断 |
| 拉伸强度 | stretch_intensity | 0.0-2.0 | 1.0 | 图片拉伸的程度，像拉橡皮筋一样 | 图像变形的强度系数 | 设置1.0为标准拉伸 |
3.2 全景图转平面图节点 (Panoramic to Flat)
这个节点就像"展开卷纸"，能把 360 度全景图重新变回平面图片。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图像 | input_image | 图像 | - | 要变回平面图的全景图 | 待转换的全景图像输入 | 拖入一张 360 度全景图 |
| 展开方式 | unfold_method | 选择项 | equirectangular | 选择怎样把全景图展开成平面 | 图像投影展开的算法方式 | 选择"等距圆柱投影"最常用 |
| 输出尺寸 | output_size | 数字 | 1024 | 展开后图片的大小 | 输出图像的像素尺寸 | 设置1024获得高质量图片 |
3.3 图像弧形拉伸节点 (Arc Stretch)
这个节点像一个"弯曲器"，能把直的图片变成弧形，就像把直尺弯成扇形一样。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图像 | input_image | 图像 | - | 要弯曲的原始图片 | 待变形的图像输入 | 拖入一张直线排列的图片 |
| 弧度角度 | arc_angle | 0-360 | 180 | 弯曲的角度，像量角器一样 | 弧形变换的角度参数 | 设置180度弯成半圆 |
| 弯曲方向 | bend_direction | 选择项 | horizontal | 选择往哪个方向弯曲 | 变形的方向轴设置 | 选择"水平"向左右弯曲 |
| 弯曲强度 | bend_strength | 0.0-2.0 | 1.0 | 弯曲的厉害程度 | 变形的强度系数 | 设置1.0为标准弯曲 |
3.4 极轴变换节点 (Polar Transform)
这个节点像一个"旋转魔法师"，能把图片从中心点开始旋转变形。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图像 | input_image | 图像 | - | 要旋转变形的图片 | 待变换的图像输入 | 拖入一张圆形图案 |
| 变换方式 | transform_type | 选择项 | to_polar | 选择变换的方式 | 极坐标转换的类型 | 选择"转极坐标"创建漩涡效果 |
| 中心点X | center_x | 0-1 | 0.5 | 旋转中心的左右位置 | 变换中心点的X坐标 | 设置0.5让中心在图片正中间 |
| 中心点Y | center_y | 0-1 | 0.5 | 旋转中心的上下位置 | 变换中心点的Y坐标 | 设置0.5让中心在图片正中间 |
3.5 图像6面切割节点 (Split to 6 Faces)
这个节点像一个"切蛋糕机"，能把一张图片切成 6 个面，就像切蛋糕一样。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图像 | input_image | 图像 | - | 要切割的原始图片 | 待分割的图像输入 | 拖入一张全景图 |
| 切割方式 | split_method | 选择项 | cube_faces | 选择怎样切割图片 | 图像分割的算法方式 | 选择"立方体面"切成6个面 |
| 面的尺寸 | face_size | 数字 | 512 | 每个切出来的小图片大小 | 每个面的像素尺寸 | 设置512获得合适大小 |
3.6 6面图像合并节点 (Merge 6 Faces)
这个节点像一个"拼图机"，能把 6 张小图片拼成一张大的全景图。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 前面 | front_image | 图像 | - | 前面的图片 | 立方体前面的图像 | 拖入前方视角的图片 |
| 后面 | back_image | 图像 | - | 后面的图片 | 立方体后面的图像 | 拖入后方视角的图片 |
| 左面 | left_image | 图像 | - | 左面的图片 | 立方体左面的图像 | 拖入左侧视角的图片 |
| 右面 | right_image | 图像 | - | 右面的图片 | 立方体右面的图像 | 拖入右侧视角的图片 |
| 上面 | top_image | 图像 | - | 上面的图片 | 立方体上面的图像 | 拖入上方视角的图片 |
| 下面 | bottom_image | 图像 | - | 下面的图片 | 立方体下面的图像 | 拖入下方视角的图片 |
| 拼接方式 | merge_method | 选择项 | seamless | 选择怎样把图片拼在一起 | 图像融合的算法方式 | 选择"无缝拼接"避免接缝 |
3.7 区域提示词生成节点 (Region Prompt Generator)
这个节点像一个"智能画家"，能根据你的文字描述来生成不同区域的全景图。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 前方提示词 | front_prompt | 文本 | - | 描述前方应该有什么 | 前方区域的文本描述 | 输入"山脉和森林" |
| 后方提示词 | back_prompt | 文本 | - | 描述后方应该有什么 | 后方区域的文本描述 | 输入"城市和建筑" |
| 左侧提示词 | left_prompt | 文本 | - | 描述左侧应该有什么 | 左侧区域的文本描述 | 输入"海洋和沙滩" |
| 右侧提示词 | right_prompt | 文本 | - | 描述右侧应该有什么 | 右侧区域的文本描述 | 输入"草原和牛群" |
| 上方提示词 | top_prompt | 文本 | - | 描述上方应该有什么 | 上方区域的文本描述 | 输入"蓝天白云" |
| 下方提示词 | bottom_prompt | 文本 | - | 描述下方应该有什么 | 下方区域的文本描述 | 输入"石头地面" |
| 生成强度 | generation_strength | 0.0-1.0 | 0.8 | 生成效果的强弱程度 | 生成算法的强度系数 | 设置0.8获得较强效果 |
3.8 全景图查看器节点 (PanoCard Viewer)
这个节点像一个"VR 眼镜"，让你能在 ComfyUI 里直接查看 360 度全景图效果。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图像 | input_image | 图像 | - | 要预览的全景图 | 待显示的全景图像 | 拖入生成的360度图片 |
| 显示模式 | display_mode | 选择项 | interactive | 选择怎样显示全景图 | 查看器的显示方式 | 选择"交互式"可以拖拽查看 |
| 初始视角 | initial_view | 0-360 | 0 | 开始查看时的方向 | 初始视角的角度设置 | 设置0从正前方开始看 |
| 缩放级别 | zoom_level | 0.1-3.0 | 1.0 | 放大缩小的程度 | 视图的缩放倍数 | 设置1.0为原始大小 |
4. 使用技巧和建议
新手必看的使用技巧：
-
从简单开始：建议先试试平面图转全景图的功能，拿一张风景照片练练手。
-
图片质量很重要：输入的图片越清晰，生成的全景图效果越好。就像做菜一样，原料好菜才香！
-
参数慢慢调：不要一次性把所有参数调到最大，先用默认值试试，再慢慢微调。
-
多试试不同的模式：每种转换模式都有不同的效果，就像滤镜一样，多试试找到最适合的。
-
保存中间结果：生成过程中的中间图片也可以保存，有时候会有意想不到的效果。
进阶使用建议：
-
组合使用节点：把多个节点连接起来，创建复杂的全景图处理流程。
-
利用区域提示词：用文字描述来生成不同区域的内容，让全景图更有故事性。
-
调整接缝处理：如果拼接的图片有明显接缝，试试调整拼接方式参数。
5. 常见问题解答
Q：为什么生成的全景图看起来很扭曲？
A：这是正常的！全景图在平面上显示时会看起来扭曲，就像世界地图一样。用查看器节点就能看到正常的 360 度效果。
Q：我的图片切割后只有 5 个面，第 6 个面是黑的怎么办？
A：这通常是因为原图不是标准的全景图格式。试试调整输入图片的尺寸比例。
Q：生成的全景图文件很大，怎么办？
A：可以在各个节点中调整输出尺寸参数，设置小一点的数值来减少文件大小。
Q：区域提示词节点不工作？
A：确保你已经安装了 ComfyUI-Impact-Pack 插件，这个是必需的依赖。
Q：查看器节点显示不出来？
A：检查浏览器是否支持 WebGL，老旧的浏览器可能无法显示 360 度效果。
6. 创意应用实例
实用场景举例：
-
房地产展示：把室内照片制作成 360 度全景图，让客户身临其境。
-
旅游纪念：把风景照片变成全景图，制作独特的旅游纪念品。
-
艺术创作：利用不同的变换效果，创作抽象艺术作品。
-
教育展示：制作教学用的 360 度展示材料。
-
游戏开发：为游戏创建背景天空盒和环境贴图。
创意组合技巧：
- 先用弧形拉伸节点创建有趣的变形效果，再转换成全景图
- 把多张不同风格的图片分别用在 6 个面上，创造超现实效果
- 利用极轴变换创建漩涡效果，再转换成全景图
记住，这个插件就像一个魔法工具箱，每个节点都是不同的魔法道具。多试试不同的组合，你会发现更多有趣的效果！
最重要的是要有耐心，就像学骑自行车一样，多练习几次就熟练了。祝你玩得开心！