# 3D 图片
> 3D 图片把一张图片贴合到场景的三维空间中，可微调扭曲与深度，呈现贴在全景上的效果。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/editor
- 所属模块：全景编辑器
- 页面用途：当需要把图片以三维贴合的方式放进全景时使用。在「热点设置」中选择 3D 图片，选择图片后设置 3D 贴合与扭曲参数，再到预览区放置热点，保存后重新发布作品。
- 适用用户：需要在线编辑全景作品的登录用户（作者本人）
- 访问条件：需登录后访问

## 2. 功能说明

- 选择图片后自动读取图片比例与原始宽高
- 可开启 3D 贴合并手动微调扭曲度与深度
- 可设置图标对齐方式
- 支持清理当前图片

## 3. 业务说明

### 配置区域

面板为 3D 图片专属配置：选择图片、预览图片、3D 贴合、接收事件、图片比例、图标对齐、图片宽度/高度，以及开启 3D 贴合后的扭曲与深度参数。

### 字段说明

| 配置项 | 作用说明 | 类型/可选值 | 默认值/必填 |
| --- | --- | --- | --- |
| 选择图片 | 选择要贴合到场景中的图片 | 按钮「去选择」，已选后出现「清理」 | 必填 |
| 预览图片 | 查看已选择的图片 | 图片预览 | — |
| 3D 贴合 | 开启后可完全贴在全景某区域，并可手动微调扭曲度 | 开关 | 默认关闭 |
| 接收事件 | 开启后此元素在 3D 空间内只能查看无法选中 | 开关 | 默认关闭 |
| 图片比例 | 显示图片宽高比（只读） | 只读文本 | 随图片自动计算 |
| 图标对齐 | 设置图标的对齐方式 | 下拉：左上 / 左 / 左下 / 上 / 中间 / 下 / 右上 / 右 / 右下 | 默认中间 |
| 图片宽度 | 设置图片宽度 | 滑块，1-800 | 随图片原始宽度 |
| 图片高度 | 设置图片高度 | 滑块，1-800 | 随图片原始高度 |
| x轴扭曲 / y轴扭曲 / z轴扭曲 | 开启 3D 贴合后微调扭曲度 | 滑块，-500 至 500 | 默认 0 |
| x轴深度 / y轴深度 / z轴深度 | 开启 3D 贴合后微调深度 | 滑块，-500 至 500 | 默认 0 |

### 保存与生效

选择图片并调好参数、放置热点后点击保存，预览中立即生效；重新发布作品后对访问者生效。

## 4. 使用说明

1. 在编辑器「热点设置」中选择 3D 图片
2. 点击「去选择」选择图片
3. 视需要开启 3D 贴合并微调扭曲与深度
4. 在预览区点击要放置热点的位置
5. 保存配置并在预览确认后重新发布

## 5. 规则与限制

- 未选择图片时不能保存热点，需先选择素材图片

## 6. 状态与异常

- 未选图片：提示「请选择素材图片!」
- 已选图片：展开贴合与尺寸参数

## 7. 相关文档

- [芊云编辑器配置项总览](https://9kvr.cn/site/tour/editor/config.md)
- [热点设置（一级菜单）](https://9kvr.cn/site/tour/editor/config/hotspot.md)
- [3D 视频](https://9kvr.cn/site/tour/editor/config/hotspot/mobileStereoscopic3DVideo.md)
- [全景作品播放页](https://9kvr.cn/site/tour.md)
- 上级目录索引：[/tour](https://9kvr.cn/site/tour/llms.txt)

## 8. 文档信息

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