# 全景图立方体转换工具
> 把全景图切割成 6 面立方体贴图，或将 6 面立方体贴图合成为全景图。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/preview/cube-converter
- 所属模块：全景工具箱与预览
- 页面用途：提供两种模式的相互转换：切割模式把一张全景图切成前、后、左、右、上、下 6 个立方体面；合成模式把 6 张立方体面合成为一张全景图。处理在浏览器本地完成，支持单张下载、批量下载或压缩包下载。
- 适用用户：需要做全景图与立方体贴图互转的用户
- 访问条件：公开访问

## 2. 功能说明

- 两种模式：全景图切割 / 立方体合成
- 切割：上传全景图后自动生成 6 个立方体面，可单张或打包下载
- 合成：上传 6 张立方体面后合成为全景图，可预览与下载
- 批量上传立方体面时按文件名智能排序（前后左右上下、拼音首字、数字 1-6、front/back 等）
- 上传前校验全景图比例（约 2:1）与最小尺寸
- 支持拖拽排序调整立方体面的顺序

## 3. 业务说明

### 两种模式对比

| 模式 | 输入 | 输出 |
| --- | --- | --- |
| 全景图切割 | 一张 2:1 全景图 | 6 张立方体面图片 |
| 立方体合成 | 6 张立方体面图片 | 一张全景图 |

### 文件命名识别

批量上传立方体面时，系统会根据文件名自动判断对应面并排序，可识别中文（前/后/左/右/上/下）、英文完整词（front/back/left/right/top/bottom）、常见缩写与数字 1-6，也支持 pano_/cube_ 等导出前缀。

### 隐私说明

切割与合成均在本地浏览器完成，图片不会上传到服务器。

## 4. 使用说明

1. 选择「全景图切割」或「立方体合成」模式
2. 切割：上传全景图，等待生成 6 个面后下载；合成：上传 6 张立方体面
3. 需要时拖拽调整面的顺序
4. 下载切割结果或合成后的全景图
5. 两种模式都可在切割后用「合成全景图」把结果再合回去

## 5. 规则与限制

- 切割模式要求全景图为约 2:1 比例，比例不符会提示
- 图片文件大小限制 50MB；尺寸过小会提示建议使用更高分辨率
- 合成模式必须具备完整的 6 个面才能合成

## 6. 状态与异常

- 未上传：展示上传区域与使用指南
- 处理中：展示进度条与阶段文案
- 切割完成：展示 6 个立方体面与下载/合成操作
- 合成完成：展示合成后的全景图与预览/下载操作
- 比例不正确：提示全景图比例应为 2:1
- 尺寸过小：提示建议最小分辨率
- 文件格式不支持：提示仅支持 JPG/PNG/WebP
- 合成面数不足：提示需要 6 个立方体面

## 7. 相关文档

- [文本转图片](https://9kvr.cn/site/tour/preview/text-to-image.md)
- [全景工具箱](https://9kvr.cn/site/tour/workbench/box.md)
- [全景作品播放页](https://9kvr.cn/site/tour.md)
- 上级目录索引：[/tour](https://9kvr.cn/site/tour/llms.txt)

## 8. 文档信息

- 事实来源：芊云全景官网页面与公开产品配置
- 文档构建时间：2026-10-20 19:04:23
- 数据获取/快照时间：不适用（静态产品知识）
- 可信状态：已核验