# 辅助标尺
> 在场景中绘制带名称和角度的辅助标尺，用于标注尺寸、方向和参考线；可按场景或全部标尺管理。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/editor
- 所属模块：全景编辑器
- 页面用途：当需要在场景中标注参考线时使用。先在场景列表选中目标场景，进入「场景设置 → 辅助标尺」，在「当前场景」标签点击「添加标尺」，拖动标尺两端控制点确定位置与角度，设置名称、颜色、旋转角度、3D 扭曲后点击「保存标尺」写入作品，重新发布后对访问者生效。
- 适用用户：需要在线编辑全景作品的登录用户（作者本人）
- 访问条件：需登录后访问

## 2. 功能说明

- 标签切换「当前场景」与「所有标尺」，分别管理当前场景和全部场景的标尺
- 标尺配置：标尺名称、颜色设置、旋转角度、3D 扭曲
- 拖动两端控制点即可调整标尺位置与角度，旋转角度自动计算
- 标尺列表支持查看、编辑、删除
- 列表展示标尺名称与角度，「所有标尺」标签下额外显示所属场景
- 空状态提示可引导创建标尺

## 3. 业务说明

### 配置区域

面板顶部为「当前场景 / 所有标尺」标签。未在编辑状态时展示标尺列表区域（标题、说明、标尺卡片、空状态）；点击「添加标尺」或列表「编辑」后进入标尺配置区域，包含「标尺配置」标题与字段表单。底部操作栏为「返回」和「添加标尺 / 保存标尺」。

### 字段说明

| 配置项 | 作用说明 | 类型/可选值 | 默认值/必填 |
| --- | --- | --- | --- |
| 标尺名称 | 设置标尺显示的文本 | 输入框，placeholder「请输入标尺名称」 | 默认「标尺」 |
| 颜色设置 | 设置标尺文本颜色等外观 | 颜色选择 | 默认文本颜色 #FFFFFF |
| 旋转角度 | 设置标尺旋转角度，也可拖动控制点自动生成 | 滑杆 -180-180 | 默认 0 |
| 3D扭曲 | 设置标尺是否随场景进行 3D 扭曲 | 开关 | 默认关闭 |
| 排序/角度 | 列表卡片展示标尺角度 | 只读展示 | 不可配置 |
| 查看/编辑/删除 | 对已有标尺执行查看定位、编辑、删除 | 按钮 | 非必填 |

### 保存与生效

新增或修改标尺后点击「保存标尺」写入作品；删除标尺会即时保存。标尺按所属场景记录，「当前场景」标签只显示当前场景的标尺。重新发布作品后对访问者生效。离开页面时未保存的标尺控制点会被清除。

## 4. 使用说明

1. 在场景列表选中目标场景
2. 选择「辅助标尺」配置
3. 点击「添加标尺」并拖动控制点确定位置与角度
4. 填写名称、颜色、旋转角度、3D 扭曲
5. 点击「保存标尺」并在列表确认
6. 保存后重新发布

## 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/walkingRun.md)
- [全景作品播放页](https://9kvr.cn/site/tour.md)
- 上级目录索引：[/tour](https://9kvr.cn/site/tour/llms.txt)

## 8. 文档信息

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