# closerAI 360° 全景查看器
ComfyUI 自定义节点：交互式 360°/180° 全景图查看器，支持 WebGL 实时渲染、镜像变换与框选截图。
## 功能特性
| 功能 | 说明 |
|------|------|
| WebGL 实时渲染 | 球体 / 圆柱两种投影模式 |
| 鼠标交互 | 拖拽旋转视角、滚轮缩放（FOV）、双击复位 |
| 镜像变换 | 水平 / 垂直 / 双向镜像翻转 |
| 框选截图 | 启用截图后在画布上框选区域，确认裁剪并导出 IMAGE 输出 |
| 自动旋转 | 可设置速度的自动旋转动画 |
| 实时信息 | 底部状态栏显示偏航角、俯仰角、视野角度 |
## 安装
### 方式一：手动安装
1. 将本文件夹复制到 ComfyUI 的 `custom_nodes` 目录下：
## 使用说明
### 基本用法
1. 在节点菜单中找到 **closerAI_360view** → **closerAI 360°全景查看器**
2. 将 **IMAGE** 类型的全景图（等距矩形格式）连接到 `image` 输入端
3. 双击节点或展开节点即可查看 360° 全景
### 参数说明
| 参数 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| 视图宽度 | INT | 1280 | 画布显示宽度（320-3840） |
| 视图高度 | INT | 720 | 画布显示高度（240-2160） |
| 视野角度 | INT | 75 | 摄像机 FOV（30-120°），可通过滚轮调整 |
| 自动旋转 | BOOLEAN | False | 开启自动绕 Y 轴旋转 |
| 旋转速度 | FLOAT | 0.5 | 自动旋转速度（0.1-3.0） |
| 投影模式 | 球体/等距矩形/圆柱 | 球体 | 3D 投影方式 |
| 启用镜像 | BOOLEAN | False | 对输入图像进行镜像翻转 |
| 镜像模式 | 水平/垂直/双向 | 水平 | 镜像方向 |
| 启用截图 | BOOLEAN | False | 开启框选截图功能 |
### 鼠标操作
| 操作 | 效果 |
|------|------|
| 左键拖拽 | 旋转视角（改变偏航/俯仰） |
| 滚轮 | 缩放（调整视野角度） |
| 双击 | 复位到初始视角 |
### 框选截图
1. 将 **启用截图** 设为 True，画布显示裁剪按钮
2. 在画布区域按住左键拖动，画出裁剪框
3. 画好后点击 **确认裁剪**（绿色按钮）或 **取消**（红色按钮）
4. 系统自动截取当前视角下的框选区域
5. 截图结果作为 **IMAGE** 输出从节点右侧端口输出，可连接后续节点
### 镜像变换
启用镜像后，输入的 equirectangular 全景图会先进行镜像翻转，再送入 WebGL 渲染。
- **水平**：左右翻转
- **垂直**：上下翻转
- **双向**：同时翻转
主题授权提示：请在后台主题设置-主题授权-激活主题的正版授权，授权购买：RiTheme官网
评论(0)