3ditles加载器用户操作手册

快速入门

第一步：加载数据

1. 点击左侧面板 「添加数据」 按钮
2. 选择数据类型（倾斜模型、点云、正射影像等）
3. 在弹出的文件选择器中选择数据文件夹或文件
4. 等待数据缓存和加载完成

第二步：浏览与标注

• 使用鼠标拖拽旋转视角
• 使用顶部工具栏选择标注工具进行绘制
• 左侧面板管理数据源和标注

---

界面介绍

整体布局

┌─────────────────────────────────────────────────────────┐
│                      顶部工具栏                          │
├──────────┬──────────────────────────────────┬──────────┤
│          │                                  │          │
│  左侧面板 │          三维地图视图            │ 右侧面板 │
│          │                                  │ (选中时) │
│  数据/标注│                                  │          │
│          │                                  │          │
├──────────┴──────────────────────────────────┴──────────┤
│                      底部状态栏                          │
└─────────────────────────────────────────────────────────┘

顶部工具栏

工具分组	功能
选择	选择标注（点击选中，右键菜单）
点工具	点标注、图标点
线工具	线段、曲线、箭头、虚线、路径
面工具	矩形、多边形、圆形、范围圈
测量工具	测距、测面、测高
动画效果	闪烁、流动、脉冲（需先选中标注）
撤销/重做	操作历史管理
导入导出	JSON/KML 格式
样式配置	默认样式设置

左侧面板

数据标签页： - 坐标系切换（WGS84/GCJ02） - 添加数据按钮 - 数据源分类标签（模型/正射/地形） - 数据源列表（勾选显示、调整透明度、删除）

标注标签页： - 新建文件夹按钮 - 批量操作栏（全选、显示/隐藏、批量删除） - 标注树形列表（文件夹分层）

右侧面板

选中标注后显示： - 标注名称（可编辑） - 标注类型 - 所属文件夹 - 样式属性（颜色、线宽、填充等）

底部状态栏

显示信息： - 当前鼠标位置坐标（经度、纬度、海拔） - 相机姿态（方位角、俯仰角） - 比例尺 - 数据源数量、标注数量、动画数量 - 操作进度提示

---

数据加载

加载 3D Tiles 模型（倾斜摄影）

1. 点击 「添加数据」
2. 选择 「3D Tiles 模型」
3. 选择包含 tileset.json 的文件夹
4. 等待扫描和缓存完成

数据要求：

模型文件夹/
├── tileset.json    # 必须包含
├── *.b3dm          # 或 .glb/.gltf 文件
└── ...

加载 3D Tiles 点云

1. 点击 「添加数据」
2. 选择 「3D Tiles 点云」
3. 选择包含 tileset.json 和 .pnts 文件的文件夹

调整点大小： - 在数据源列表中找到该点云 - 使用「点大小」滑块调整（范围 1-20）

加载切片影像

1. 点击 「添加数据」
2. 选择 「切片影像」
3. 选择影像切片文件夹

数据要求： - 方式一：包含 meta.json 或 tilemapresource.xml - 方式二：{z}/{x}/{y}.png 目录结构（自动识别）

加载 GeoTIFF 正射影像

1. 点击 「添加数据」
2. 在「选择文件」区域点击 「正射影像」
3. 选择 .tif 或 .tiff 文件（可多选）

自动识别： - 多波段（RGB/RGBA）→ 作为正射影像加载 - 单波段 → 自动转为地形数据

加载 GeoTIFF 地形数据

1. 点击 「添加数据」
2. 在「选择文件」区域点击 「地形高程」
3. 选择单波段 GeoTIFF 文件

数据要求： - 单波段 TIFF - 每个像素值代表高程（海拔） - 包含地理参考信息（投影坐标系）

---

标注绘制

点标注

1. 点击工具栏 点标注 按钮（或按 P）
2. 在地图上点击位置
3. 标注自动创建完成

图标点

1. 点击工具栏 图标点 按钮（或按 I）
2. 在地图上点击位置
3. 创建带图标效果的点标注

线段

1. 点击工具栏 线段 按钮（或按 L）
2. 在地图上依次点击各节点
3. 双击或按 Esc 完成绘制

曲线

1. 点击工具栏 曲线 按钮（或按 C）
2. 依次点击节点
3. 自动生成平滑曲线
4. 双击完成

箭头

1. 点击工具栏 箭头 按钮（或按 A）
2. 点击起点
3. 点击终点
4. 自动添加箭头头部

虚线

1. 点击工具栏 虚线 按钮（或按 D）
2. 依次点击节点
3. 双击完成

路径

1. 点击工具栏 路径 按钮
2. 依次点击路径节点
3. 双击完成

矩形

1. 点击工具栏 矩形 按钮（或按 R）
2. 点击第一个角点
3. 点击对角点
4. 自动生成矩形

多边形

1. 点击工具栏 多边形 按钮（或按 G）
2. 依次点击各顶点
3. 双击完成（自动闭合）

圆形

1. 点击工具栏 圆形 按钮（或按 O）
2. 点击圆心位置
3. 点击边缘定义半径
4. 自动生成圆形

范围圈

1. 点击工具栏 范围圈 按钮
2. 点击中心位置
3. 点击定义半径
4. 生成同心圆范围标注

测距

1. 点击工具栏 测距 按钮（或按 M）
2. 依次点击测量点
3. 自动显示各段距离和总距离
4. 双击完成

注意： 测量结果贴合地形表面

测面

1. 点击工具栏 测面 按钮（或按 S）
2. 依次点击多边形顶点
3. 自动显示面积
4. 双击完成

测高

1. 点击工具栏 测高 按钮（或按 H）
2. 点击起点位置
3. 点击终点位置
4. 自动显示两点间的水平距离、垂直高差、空间距离

---

标注管理

选中标注

方式一：点击选择 - 使用「选择」工具（按 V） - 直接点击地图上的标注

方式二：列表选择 - 在左侧标注列表中点击标注名称

编辑标注属性

选中标注后，右侧面板显示属性： - 名称： 直接编辑 - 文件夹： 下拉选择所属文件夹 - 颜色： 点击颜色选择器 - 线宽： 滑块调整 - 填充： 是否填充、填充颜色、填充透明度

显示/隐藏标注

• 标注列表中点击 👁 图标
• 或在右侧面板取消勾选「显示」

删除标注

单个删除： - 列表中点击 ✕ 按钮 - 或选中后按 Delete 键 - 或右键菜单选择「删除」

批量删除： 1. 在标注列表中勾选多个标注 2. 点击「删除 N」按钮 3. 确认删除

移动标注位置

1. 右键点击标注
2. 选择「移动」
3. 在地图上点击新位置
4. 右键取消或点击确认

文件夹管理

新建文件夹： - 点击「+ 文件夹」按钮 - 输入文件夹名称

文件夹操作： - 点击文件夹名称选中 - 点击展开/折叠图标 - 点击 👁 显示/隐藏文件夹内所有标注 - 点击 ✕ 删除文件夹（标注移至上级）

拖拽整理： - 拖拽标注到文件夹内 - 拖拽文件夹调整层级 - 拖拽调整排序

---

数据源管理

显示/隐藏数据源

• 数据源列表中勾选/取消勾选
• 取消勾选后数据从视图中隐藏，但保留缓存

调整透明度

• 模型/影像：使用「透明度」滑块（0-100%）
• 点云：使用「点大小」滑块（1-20）

删除数据源

• 点击 ✕ 按钮
• 确认删除
• 清除缓存数据

数据源排序

• 拖拽数据源列表项调整顺序
• 影响影像叠加层级（上层的影像覆盖下层）

定位到数据源

• 点击数据源名称
• 自动飞行到该数据源位置

---

动画效果

添加动画

1. 选中一个标注（测量类标注不支持动画）
2. 点击工具栏动画按钮：
3. 闪烁： 标注周期性显示/隐藏
4. 流动： 线/面标注上的流动效果
5. 脉冲： 圆形扩散脉冲效果

取消动画

• 再次点击相同动画按钮取消
• 或在右侧面板选择「无动画」

---

导入导出

导出标注

1. 点击工具栏 导出 按钮
2. 选择格式：
3. 导出 JSON： 包含所有标注和文件夹结构
4. 导出 KML： Google Earth 格式（不含文件夹）

导入标注

1. 点击工具栏 导入 按钮
2. 选择格式：
3. 导入 JSON： 恢复标注和文件夹
4. 导入 KML： 从 KML 文件导入标注

注意： 导入会与现有标注合并，不会删除现有标注

---

快捷键

按键	功能
V	选择工具
P	点标注
I	图标点
L	线段
C	曲线
A	箭头
D	虚线
R	矩形
G	多边形
O	圆形
M	测距
S	测面
H	测高
Esc	取消当前绘制
Delete	删除选中标注
Ctrl+Z	撤销
Ctrl+Y	重做

---

常见问题

Q: 数据加载失败，提示「tileset.json 未找到」

原因： - 数据文件夹结构不正确 - 未包含 tileset.json 文件

解决： - 确认文件夹中有 tileset.json - 检查 JSON 文件格式是否正确

Q: GeoTIFF 加载后位置不对

原因： - GeoTIFF 缺少地理参考信息 - 坐标系不被支持

解决： - 确保 GeoTIFF 包含正确的投影信息 - 支持的坐标系：WGS84、UTM、Web Mercator 等

Q: 点云无地理参考，已隐藏

原因： - 点云数据缺少坐标定位信息 - boundingSphere 中心接近地球中心点

解决： - 使用有地理参考的点云数据 - 或在数据处理阶段添加坐标信息

Q: 数据加载很慢

原因： - 数据量过大 - 浏览器缓存空间不足

解决： - 清理浏览器缓存 - 分批次加载较小的数据集

Q: 页面刷新后数据消失

原因： - 浏览器清除了 Service Worker 缓存 - 文件访问权限过期

解决： - 点击数据源的显示复选框重新加载 - 或重新添加数据源

Q: 地形加载后看不到起伏

原因： - 地形 exaggeration（ exaggeration ）设置问题 - 高程范围过小

解决： - 等待地形数据完全加载 - 调整相机视角观察地形细节

Q: 坐标显示与预期不符

原因： - 坐标系设置问题

解决： - 检查左侧面板的坐标系设置（WGS84/GCJ02） - 国内地图数据可能需要 GCJ02 坐标系

---

技术支持

如有问题或建议，请联系开发团队或提交 Issue。