# 场景修补
> 上传自定义图片素材遮挡全景中的指定区域，常见的例如补天、补地操作；默认只作用于当前场景。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/editor
- 所属模块：全景编辑器
- 页面用途：当全景画面顶部或底部有拍摄缺口、需要遮挡时使用。先在场景列表选中目标场景，再进入「场景设置 → 场景修补」，选择补天或补地并上传遮罩图片，调整宽度、高度后在预览中确认效果，点击「保存编辑」（首次插入为「插入到场景」）写入作品，重新发布后对访问者生效。
- 适用用户：需要在线编辑全景作品的登录用户（作者本人）
- 访问条件：需登录后访问

## 2. 功能说明

- 区分补天、补地两种修补类型，各自使用一份独立素材
- 支持上传自定义图片作为遮罩素材，并自动读取图片原始宽高
- 可设置是否随场景缩放、随场景扭曲、是否接受鼠标事件
- 可一键应用到所有场景，也支持把当前场景的独立修补删除
- 保存后在编辑器预览中即时生效，重新发布后对访问者生效

## 3. 业务说明

### 配置区域

面板自上而下分为三个区域：顶部为修补类型与开关的「基础配置」，中间为上传遮罩图片的「素材配置」，选择图片后才出现「尺寸调整」区域。底部操作栏提供删除素材（已存在修补时）、返回，以及「保存编辑」或「插入到场景」。

### 字段说明

| 配置项 | 作用说明 | 类型/可选值 | 默认值/必填 |
| --- | --- | --- | --- |
| 显示平台 | 设置该修补素材在哪些端展示 | 多选，必填 | 默认全部平台 |
| 修补类型 | 选择补天或补地 | 单选：补天 / 补地 | 默认补天 |
| 应用所有场景 | 开启后将应用到所有场景 | 开关 | 默认关闭 |
| 跟随场景缩放 | 修补素材随场景缩放变化 | 开关 | 默认关闭 |
| 跟随场景扭曲 | 修补素材随场景扭曲变形 | 开关 | 默认关闭 |
| 接受鼠标事件 | 关闭后用户可拖拽遮罩图片滑动全景 | 开关 | 默认开启 |
| 遮罩图片 | 上传作为遮罩的图片素材 | 图片上传 | 必填 |
| 遮罩宽度 | 设置遮罩显示宽度 | 滑杆 0-1024 | 选择图片后自动填入图片宽度 |
| 遮罩高度 | 设置遮罩显示高度 | 滑杆 0-1024 | 选择图片后自动填入图片高度 |

### 保存与生效

面板改动只会立即作用于编辑器内的预览，需点击「保存编辑」才写入作品。选择「应用所有场景」并保存时，会用这份全局素材覆盖其他场景已单独配置的素材，编辑器会二次确认。默认只影响当前场景，重新发布作品后对访问者生效。

## 4. 使用说明

1. 在场景列表选中目标场景
2. 选择「场景修补」配置
3. 选择修补类型（补天/补地）并上传遮罩图片
4. 按需调整尺寸、缩放、扭曲等选项并在预览确认
5. 保存后重新发布

## 5. 规则与限制

- 补天与补地是两份独立素材，切换类型时会分别回显各自的配置
- 默认只作用于当前场景；开启「应用所有场景」后会影响全部场景
- 同一场景可先后配置补天和补地，重新进入时回显最近一次保存的素材
- 开启「应用所有场景」若会覆盖其他场景素材，保存前需要二次确认

## 6. 状态与异常

- 未选择图片素材：尺寸调整区域不显示
- 已插入素材：可再次进入编辑或删除
- 未选择图片素材时保存：提示「请选择图片素材」

## 7. 相关文档

- [芊云编辑器配置项总览](https://9kvr.cn/site/tour/editor/config.md)
- [场景设置（一级菜单）](https://9kvr.cn/site/tour/editor/config/scene.md)
- [场景特效](https://9kvr.cn/site/tour/editor/config/scene/sceneEffects.md)
- [全景作品播放页](https://9kvr.cn/site/tour.md)
- 上级目录索引：[/tour](https://9kvr.cn/site/tour/llms.txt)

## 8. 文档信息

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