# 场景滤镜
> 为场景叠加光影、模糊、锐化三类画面滤镜并调整参数；默认只作用于当前场景。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/editor
- 所属模块：全景编辑器
- 页面用途：当需要提升画面观感（补光、做景深、增强清晰度）时使用。先在场景列表选中目标场景，进入「场景设置 → 场景滤镜」，在选择滤镜步骤点选一种滤镜（可叠加多种），再在调整参数步骤拖动对应滑杆，在预览中确认后点击「保存配置」写入作品，重新发布后对访问者生效。
- 适用用户：需要在线编辑全景作品的登录用户（作者本人）
- 访问条件：需登录后访问

## 2. 功能说明

- 三类滤镜：光影效果、模糊效果、锐化效果，可分别选用并可叠加
- 光影滤镜参数：曝光度、亮度强度、阴影强度、光影滤波、光影蒙版、光影质量
- 模糊滤镜参数：模糊度、模糊质量
- 锐化滤镜参数：锐化强度、锐化范围、锐化质量
- 每种滤镜可单独「重置效果」，也可在配置页「重置并清除效果」
- 已配置的滤镜在列表上显示「去配置」，可再次进入调整

## 3. 业务说明

### 配置区域

面板分两步：第一步「选择滤镜」以卡片网格展示三类滤镜，已选的显示「去配置」并提供「重置效果」；第二步「调整参数」按所选滤镜显示对应配置区，底部提供「重置并清除效果」。底部操作栏为「返回/返回列表」和「保存配置」。

### 字段说明

| 配置项 | 作用说明 | 类型/可选值 | 默认值/必填 |
| --- | --- | --- | --- |
| 滤镜类型 | 选择要使用的画面滤镜 | 单选卡片：光影效果 / 模糊效果 / 锐化效果 | 默认未选中 |
| 曝光度 | 调整画面整体曝光 | 滑杆 -10-10 | 默认 0 |
| 亮度强度 | 调整画面亮部强度 | 滑杆 -10-10 | 默认 0 |
| 阴影强度 | 调整画面暗部强度 | 滑杆 -10-10 | 默认 0 |
| 光影滤波 | 调整光影滤波范围 | 滑杆 1-100 | 默认 60 |
| 光影蒙版 | 调整光影蒙版强度 | 滑杆 1-10 | 默认 1 |
| 光影质量 | 调整光影处理质量 | 滑杆 1-10 | 默认 7 |
| 模糊度 | 调整画面模糊程度 | 滑杆 -10-10 | 默认 0 |
| 模糊质量 | 调整模糊处理质量 | 滑杆 1-10 | 默认 10 |
| 锐化强度 | 调整锐化强度 | 滑杆 -10-10 | 默认 0 |
| 锐化范围 | 调整锐化作用范围 | 滑杆 -10-10 | 默认 0 |
| 锐化质量 | 调整锐化处理质量 | 滑杆 1-10 | 默认 5 |

### 保存与生效

拖动滑杆会即时作用于编辑器预览，需点击「保存配置」才写入作品。每类滤镜按当前场景单独保存。选择「重置并清除效果」会删除当前场景该类滤镜的配置记录。默认只影响当前场景，重新发布作品后对访问者生效。

## 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
- 数据获取/快照时间：不适用（静态产品知识）
- 可信状态：已核验