# 配置普通相机扫描数据

Map Configurator 会直接加载从视频中解析出的画面，竖屏和横屏视频都会保留原始方向。你需要在多个画面中标记现场测量的固定角点，让地图获得正确的真实大小、原点和方向。视频不需要再次上传。

[![真实 Map Configurator 英文界面：中间保留手机竖屏画面的原始方向，一个 GCP 精确位于门框角点，底部显示视频帧，右侧显示 Points 与 Scale-bars 面板](/media/docs/standard-configurator-overview.real-ui.png)](/media/docs/standard-configurator-overview.real-ui.png)

> **GCP** 是 **Ground Control Point（地面控制点）** 的缩写。这里的“地面”是测绘术语，GCP 不必位于地板上；门框角点、墙根交点或固定构件角点都可以。一个 GCP 是画面中可重复确认、且现场 X、Y、Z 坐标已知的固定点。

手工配置至少需要 **3 个可用且不共线的 GCP**，也就是这 3 个点不能位于同一直线上。正式项目建议使用 **4–5 个 GCP**，其中至少 4 个不在同一平面，并共同覆盖左右、高低和近远三个方向。每个 GCP 都要在至少 2 个不同画面中准确标记。

## 先理解三类配置

| 类型 | 需要填写 | 用途 |
| --- | --- | --- |
| **GCP（地面控制点）** | X、Y、Z，单位米 | 定义地图的真实大小、原点和坐标方向 |
| **Tie Point（连接点）** | 不需要坐标 | 指明多个画面看到的是同一个固定角点，加强区域之间的连接 |
| **Scale Bar（距离标尺）** | 两端的实测距离，单位米 | 增加一条独立的距离校验 |

三者不能互相代替：GCP 提供完整坐标，Tie Point 只提供画面之间的对应关系，Scale Bar 只提供长度。

> **标记规则：每一个点都必须落在可重复确认的固定角点上。** GCP 与 Tie Point 应选择墙根交角、门框角、固定方体构件的角，或两条地砖填缝线的十字交点；Scale Bar 的两个端点也必须分别落在这类角点上。不要点击平整表面、纹理、阴影边缘或一段线上的任意位置。

## 1. 打开配置并选择坐标约定

1. 等待 Spatial Maps 中的地图状态变为 **Parsed（已解析）**。
2. 在地图卡片中选择 **Configure**。
3. 从底部画面列表选择一帧。中央区域会按录制方向显示当前画面；请优先选择角点清晰、无遮挡的画面进行标记。
4. 在右侧 **WORLD UP** 选择地图中代表“竖直向上”的坐标轴：AR 与实时 3D 项目通常使用 **Y**，测绘或 CAD 项目也可能使用 **Z**。
5. 确认该约定与 Space Studio 内容或已有测量坐标一致。开始标记后不要再切换。

## 2. 添加第一个 GCP

1. 在画面中找到已经测量、不会移动且边界清楚的角点，例如门框与地面的交点。
2. 右键该角点并选择 **Add Point**。
3. 在右侧填写易识别的名称，例如 `O · Entrance origin`。
4. 选择 **XYZ**，输入现场实测的 X、Y、Z；单位始终是米。
5. 核对正负号与小数点，然后选择 **Save**。

[![手机竖屏画面的门框墙根角点上打开右键菜单，Add Point 处于高亮状态](/media/docs/standard-configurator-step-gcp-add.en.jpg)](/media/docs/standard-configurator-step-gcp-add.en.jpg)

*标记必须落在真实角点上，不要选择阴影边缘、反光、高光或可移动物体。*

[![Map Configurator 英文界面为入口原点填写 X Y Z 坐标](/media/docs/standard-configurator-step-gcp-coordinates.en.jpg)](/media/docs/standard-configurator-step-gcp-coordinates.en.jpg)

*示例把入口墙根角点定义为 `O = (0, 0, 0)`。填写完整坐标后，该点类型会变为 GCP。*

### 添加多画面观测

1. 切换到另一张也能清楚看到同一角点的竖屏画面。
2. 在完全相同的物理位置右键，展开 **Add Observation**，选择已有 GCP。
3. 至少完成 2 个不同画面的观测；如果还能从另一位置清楚看到该角点，添加第 3 个画面会更稳健。
4. 展开右侧 **Obs** 逐项核对。位置不准确时删除后重标，不要把点拖到“大概相同”的位置。

[![第二张手机竖屏画面中在同一入口角点展开 Add Observation 并选择已有 GCP](/media/docs/standard-configurator-step-gcp-observations.en.jpg)](/media/docs/standard-configurator-step-gcp-observations.en.jpg)

## 3. 用 GCP 覆盖三维空间

重复创建、测量和标记 GCP。推荐用 4 个角点建立清楚的 `O-X-Y-Z` 坐标骨架：原点、一个左右方向点、一个高低方向点和一个近远方向点。不要把所有 GCP 都放在同一面墙、同一地面或同一个小区域；它们需要覆盖三维空间。

这里以 Y 轴向上为例，因此 X、Y、Z 分别表示左右、高低和近远。如果项目选择 Z 轴向上，应按项目自身的坐标约定填写，不要照抄示例坐标。

[![多张手机竖屏画面中的四个 GCP 分别覆盖入口原点、左右、高低和近远方向](/media/docs/standard-configurator-step-gcp-distribution.en.jpg)](/media/docs/standard-configurator-step-gcp-distribution.en.jpg)

每个 GCP 必须满足：

- X、Y、Z 坐标来自现场测量，单位为米；
- 在至少 2 个不同画面中可见并被准确标记；
- 所有观测指向同一个固定物理角点；
- 至少 3 个 GCP 不接近同一直线；
- 正式项目中至少 4 个 GCP 不在同一平面，并覆盖完整三维空间。

## 4. 按需添加 Tie Point

当门口、转角或相互连通的房间缺少足够的重叠画面时，Tie Point 可以加强连接。

1. 选择两侧画面都能准确确认的固定角点，例如地砖接缝十字交点、固定基座上角或门框交角。
2. 右键选择 **Add Point**，填写名称，但保持 X、Y、Z 为空。
3. 在其他画面的同一角点使用 **Add Observation** 关联这个 Tie Point。
4. 至少保留 2 个准确观测。无法确认是同一点时不要添加。

[![三张手机竖屏画面中的多个 Tie Point 精确落在固定几何角点上](/media/docs/standard-configurator-step-tie-point.en.jpg)](/media/docs/standard-configurator-step-tie-point.en.jpg)

## 5. 按需添加 Scale Bar

如果现场有一段两端清晰、距离可靠的固定线段，可以添加 Scale Bar 作为独立校验。

1. 现场测量两端之间的直线距离并记录为米。
2. 在同时看清两端的画面中右键，选择 **Add Scale-bar**。
3. 精确选择端点 A 和端点 B，并在右侧填写名称和实测长度。
4. 为两个端点补充其他画面中的对应观测。
5. 确认右侧状态为 **Ready（可用）**。

[![手机竖屏画面中一条 Scale Bar 精确连接门洞两侧固定角点，右侧状态为 Ready](/media/docs/standard-configurator-step-scale-bar.en.jpg)](/media/docs/standard-configurator-step-scale-bar.en.jpg)

## 6. 建图前检查

- [ ] 至少 3 个可用且不共线的 GCP 拥有有效 XYZ 坐标，单位为米。
- [ ] 每个 GCP 在至少 2 个不同画面中有准确观测。
- [ ] 正式项目优先使用 4–5 个覆盖三维空间的 GCP。
- [ ] 每个 Tie Point 确实表示同一个固定角点。
- [ ] 每个 Scale Bar 均显示 **Ready**，长度单位为米。
- [ ] WORLD UP 与项目坐标约定一致。
- [ ] 没有观测落在模糊、遮挡或可移动物体上。

检查通过后选择 **Build**，继续[使用普通相机视频建图](/tutorials/mapping/standard-camera-video/build)。