# 3D 阳光
> 在当前场景叠加太阳光源与光照、镜头光晕效果的热点类型。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/editor
- 所属模块：全景编辑器
- 页面用途：需要给某个场景加上太阳光、方向光和镜头光晕时使用。进入该配置后开启阳光，调整太阳位置与各类光照强度，面板会实时预览效果；点击「保存配置」写入当前场景，未保存直接关闭会恢复到打开前的状态。
- 适用用户：需要在线编辑全景作品的登录用户（作者本人）
- 访问条件：需登录后访问

## 2. 功能说明

- 在当前场景开启或关闭 3D 阳光
- 可拖拽太阳位置，也可用方位角/仰角精确设置
- 分别调整主光、环境光、天空光的基础光照强度
- 可调整镜头光晕的透明度、尺寸、鬼影、星芒与颜色
- 可做曝光、高光、阴影的光照增强
- 改动实时预览，未保存关闭会回滚

## 3. 业务说明

### 配置区域

面板为单页折叠式，分为「基础设置」「位置设置」「基础光照」「镜头光晕」「光照增强」五个分区，底部按钮为「保存配置」。除「基础设置」的开启开关外，其余参数在未开启阳光时不可调整。

### 字段说明

| 配置项 | 作用说明 | 类型/可选值 | 默认值/必填 |
| --- | --- | --- | --- |
| 开启阳光 | 是否在当前场景启用阳光效果 | 开关 | 未确认 |
| 当前场景 | 显示当前配置生效的场景名 | 只读 | — |
| 允许拖拽 | 是否允许在场景中直接拖动太阳位置 | 开关 | 未确认 |
| 太阳方位(ath) | 太阳在水平方向的角度 | 滑块 -180 ~ 180 | 未确认 |
| 太阳仰角(atv) | 太阳在垂直方向的角度 | 滑块 -89 ~ 89 | 未确认 |
| 拖拽命中半径 | 拖动太阳时的命中范围 | 滑块 20 ~ 240 | 未确认 |
| 使用当前视角 | 把当前观察方向写入太阳方位与仰角 | 按钮 | — |
| 主光强度 | 主光源的强度 | 滑块 0 ~ 300 | 未确认 |
| 环境光强 | 环境光强度 | 滑块 0 ~ 200 | 未确认 |
| 天空光强 | 天空光强度 | 滑块 0 ~ 200 | 未确认 |
| 光晕透明度 | 镜头光晕的整体透明度 | 滑块 0 ~ 100 | 未确认 |
| 眩光尺寸 | 眩光的大小 | 滑块 0 ~ 200 | 未确认 |
| 核心尺寸 | 光晕核心的大小 | 滑块 0 ~ 100 | 未确认 |
| 鬼影比例 | 镜头鬼影的强度 | 滑块 0 ~ 200 | 未确认 |
| 星芒强度 | 星芒效果强度 | 滑块 0 ~ 100 | 未确认 |
| 光晕颜色 | 镜头光晕的颜色 | 颜色选择器 | 未确认 |
| 曝光补偿 | 整体曝光补偿 | 滑块 -100 ~ 200 | 未确认 |
| 高光增益 | 高光区域的增益 | 滑块 0 ~ 300 | 未确认 |
| 阴影增益 | 阴影区域的增益 | 滑块 0 ~ 300 | 未确认 |

### 保存与生效

面板内的改动会实时作用于编辑器预览；点击「保存配置」把当前参数写入该场景。已保存后关闭不回滚；未保存且有改动时关闭，会恢复到打开面板时的状态。

## 4. 使用说明

1. 在编辑器「热点设置」中进入 3D 阳光配置
2. 在「基础设置」开启阳光
3. 在「位置设置」用拖拽或方位角/仰角定位太阳
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/3dModel.md)
- [全景作品播放页](https://9kvr.cn/site/tour.md)
- 上级目录索引：[/tour](https://9kvr.cn/site/tour/llms.txt)

## 8. 文档信息

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