3ditles加载器用户操作手册
当前版本: 1.0.0
快速入门
第一步:加载数据
- 点击左侧面板 「添加数据」 按钮
- 选择数据类型(倾斜模型、点云、正射影像等)
- 在弹出的文件选择器中选择数据文件夹或文件
- 等待数据缓存和加载完成
第二步:浏览与标注
- 使用鼠标拖拽旋转视角
- 使用顶部工具栏选择标注工具进行绘制
- 左侧面板管理数据源和标注
界面介绍
整体布局
┌─────────────────────────────────────────────────────────┐
│ 顶部工具栏 │
├──────────┬──────────────────────────────────┬──────────┤
│ │ │ │
│ 左侧面板 │ 三维地图视图 │ 右侧面板 │
│ │ │ (选中时) │
│ 数据/标注│ │ │
│ │ │ │
├──────────┴──────────────────────────────────┴──────────┤
│ 底部状态栏 │
└─────────────────────────────────────────────────────────┘
顶部工具栏
| 工具分组 | 功能 |
|---|---|
| 选择 | 选择标注(点击选中,右键菜单) |
| 点工具 | 点标注、图标点 |
| 线工具 | 线段、曲线、箭头、虚线、路径 |
| 面工具 | 矩形、多边形、圆形、范围圈 |
| 测量工具 | 测距、测面、测高 |
| 动画效果 | 闪烁、流动、脉冲(需先选中标注) |
| 撤销/重做 | 操作历史管理 |
| 导入导出 | JSON/KML 格式 |
| 样式配置 | 默认样式设置 |
左侧面板
数据标签页: - 坐标系切换(WGS84/GCJ02) - 添加数据按钮 - 数据源分类标签(模型/正射/地形) - 数据源列表(勾选显示、调整透明度、删除)
标注标签页: - 新建文件夹按钮 - 批量操作栏(全选、显示/隐藏、批量删除) - 标注树形列表(文件夹分层)
右侧面板
选中标注后显示: - 标注名称(可编辑) - 标注类型 - 所属文件夹 - 样式属性(颜色、线宽、填充等)
底部状态栏
显示信息: - 当前鼠标位置坐标(经度、纬度、海拔) - 相机姿态(方位角、俯仰角) - 比例尺 - 数据源数量、标注数量、动画数量 - 操作进度提示
数据加载
加载 3D Tiles 模型(倾斜摄影)
- 点击 「添加数据」
- 选择 「3D Tiles 模型」
- 选择包含
tileset.json的文件夹 - 等待扫描和缓存完成
数据要求:
模型文件夹/
├── tileset.json # 必须包含
├── *.b3dm # 或 .glb/.gltf 文件
└── ...
加载 3D Tiles 点云
- 点击 「添加数据」
- 选择 「3D Tiles 点云」
- 选择包含
tileset.json和.pnts文件的文件夹
调整点大小: - 在数据源列表中找到该点云 - 使用「点大小」滑块调整(范围 1-20)
加载切片影像
- 点击 「添加数据」
- 选择 「切片影像」
- 选择影像切片文件夹
数据要求:
- 方式一:包含 meta.json 或 tilemapresource.xml
- 方式二:{z}/{x}/{y}.png 目录结构(自动识别)
加载 GeoTIFF 正射影像
- 点击 「添加数据」
- 在「选择文件」区域点击 「正射影像」
- 选择
.tif或.tiff文件(可多选)
自动识别: - 多波段(RGB/RGBA)→ 作为正射影像加载 - 单波段 → 自动转为地形数据
加载 GeoTIFF 地形数据
- 点击 「添加数据」
- 在「选择文件」区域点击 「地形高程」
- 选择单波段 GeoTIFF 文件
数据要求: - 单波段 TIFF - 每个像素值代表高程(海拔) - 包含地理参考信息(投影坐标系)
标注绘制
点标注
- 点击工具栏 点标注 按钮(或按
P) - 在地图上点击位置
- 标注自动创建完成
图标点
- 点击工具栏 图标点 按钮(或按
I) - 在地图上点击位置
- 创建带图标效果的点标注
线段
- 点击工具栏 线段 按钮(或按
L) - 在地图上依次点击各节点
- 双击或按
Esc完成绘制
曲线
- 点击工具栏 曲线 按钮(或按
C) - 依次点击节点
- 自动生成平滑曲线
- 双击完成
箭头
- 点击工具栏 箭头 按钮(或按
A) - 点击起点
- 点击终点
- 自动添加箭头头部
虚线
- 点击工具栏 虚线 按钮(或按
D) - 依次点击节点
- 双击完成
路径
- 点击工具栏 路径 按钮
- 依次点击路径节点
- 双击完成
矩形
- 点击工具栏 矩形 按钮(或按
R) - 点击第一个角点
- 点击对角点
- 自动生成矩形
多边形
- 点击工具栏 多边形 按钮(或按
G) - 依次点击各顶点
- 双击完成(自动闭合)
圆形
- 点击工具栏 圆形 按钮(或按
O) - 点击圆心位置
- 点击边缘定义半径
- 自动生成圆形
范围圈
- 点击工具栏 范围圈 按钮
- 点击中心位置
- 点击定义半径
- 生成同心圆范围标注
测距
- 点击工具栏 测距 按钮(或按
M) - 依次点击测量点
- 自动显示各段距离和总距离
- 双击完成
注意: 测量结果贴合地形表面
测面
- 点击工具栏 测面 按钮(或按
S) - 依次点击多边形顶点
- 自动显示面积
- 双击完成
测高
- 点击工具栏 测高 按钮(或按
H) - 点击起点位置
- 点击终点位置
- 自动显示两点间的水平距离、垂直高差、空间距离
标注管理
选中标注
方式一:点击选择
- 使用「选择」工具(按 V)
- 直接点击地图上的标注
方式二:列表选择 - 在左侧标注列表中点击标注名称
编辑标注属性
选中标注后,右侧面板显示属性: - 名称: 直接编辑 - 文件夹: 下拉选择所属文件夹 - 颜色: 点击颜色选择器 - 线宽: 滑块调整 - 填充: 是否填充、填充颜色、填充透明度
显示/隐藏标注
- 标注列表中点击 👁 图标
- 或在右侧面板取消勾选「显示」
删除标注
单个删除:
- 列表中点击 ✕ 按钮
- 或选中后按 Delete 键
- 或右键菜单选择「删除」
批量删除: 1. 在标注列表中勾选多个标注 2. 点击「删除 N」按钮 3. 确认删除
移动标注位置
- 右键点击标注
- 选择「移动」
- 在地图上点击新位置
- 右键取消或点击确认
文件夹管理
新建文件夹: - 点击「+ 文件夹」按钮 - 输入文件夹名称
文件夹操作: - 点击文件夹名称选中 - 点击展开/折叠图标 - 点击 👁 显示/隐藏文件夹内所有标注 - 点击 ✕ 删除文件夹(标注移至上级)
拖拽整理: - 拖拽标注到文件夹内 - 拖拽文件夹调整层级 - 拖拽调整排序
数据源管理
显示/隐藏数据源
- 数据源列表中勾选/取消勾选
- 取消勾选后数据从视图中隐藏,但保留缓存
调整透明度
- 模型/影像:使用「透明度」滑块(0-100%)
- 点云:使用「点大小」滑块(1-20)
删除数据源
- 点击 ✕ 按钮
- 确认删除
- 清除缓存数据
数据源排序
- 拖拽数据源列表项调整顺序
- 影响影像叠加层级(上层的影像覆盖下层)
定位到数据源
- 点击数据源名称
- 自动飞行到该数据源位置
动画效果
添加动画
- 选中一个标注(测量类标注不支持动画)
- 点击工具栏动画按钮:
- 闪烁: 标注周期性显示/隐藏
- 流动: 线/面标注上的流动效果
- 脉冲: 圆形扩散脉冲效果
取消动画
- 再次点击相同动画按钮取消
- 或在右侧面板选择「无动画」
导入导出
导出标注
- 点击工具栏 导出 按钮
- 选择格式:
- 导出 JSON: 包含所有标注和文件夹结构
- 导出 KML: Google Earth 格式(不含文件夹)
导入标注
- 点击工具栏 导入 按钮
- 选择格式:
- 导入 JSON: 恢复标注和文件夹
- 导入 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。
文档持续更新中,如有问题请联系 技术支持:13305108038