docs(vtk): P5 二维数据集栏渲染+天地图底图 实现计划
This commit is contained in:
gaozheng
parent
86764b0cd9
commit
cc53a74b88
|
|
@ -0,0 +1,71 @@
|
||||||
|
# P5 二维数据集栏渲染 + 底图 Implementation Plan
|
||||||
|
|
||||||
|
> 接续：三栏结构重构(已完成) + 真实 ERT 帘面(已完成)。本计划做「二维数据集」栏的真实渲染 + 天地图底图。
|
||||||
|
> GUI 渲染正确性须用户实测（Claude 不能 GUI 测；见构建铁律）。
|
||||||
|
|
||||||
|
**Goal:** 「二维数据集」栏勾选 → 在 VTK 视图的 2D 俯视面渲染：轨迹线(dd_trajectory_data)、网格面(dd_grid)，并叠加天地图底图（可切换 天地图/Google/隐藏）。
|
||||||
|
|
||||||
|
**Architecture:** 复用现有 `VtkSceneController`(已有 ViewMode::Map2D + addSurveyLine) + `GeoLocalFrame`(已重锚真实数据) + 天地图 token/WMTS(已存在于 trajectory_map.html)。新增：2D 数据异步加载(轨迹/网格) + 2D actor + 底图瓦片层(VTK)。
|
||||||
|
|
||||||
|
**已确认事实（真实 API/代码）：**
|
||||||
|
- 天地图 token：`TK=aca91d8c9f59a4f779f39061b8a07737`，WMTS XYZ：`http://t{0-7}.tianditu.gov.cn/{layer}_w/wmts?...&tileMatrixSet=w&TileMatrix={z}&TileRow={y}&TileCol={x}&style=default&format=tiles&tk=TK`（图层 `vec`街道/`img`卫星 + `cva`/`cia`注记，EPSG:3857，原生 z18）。见 `src/app/resources/map/trajectory_map.html`。
|
||||||
|
- 轨迹数据：`GET /business/dd/ert/trajectory/line?dsObjectId={id}&frontCrsCode=EPSG:4326` → `data.electrodelList`[]，每项 `{electrodeNo, electrodeCoordinate}`（经纬度）。
|
||||||
|
- 网格数据：`dd/ert/grid/rows/{id}`(GET) 实测 404 → **本计划 Task 0 先确认正确端点**（疑似 query 参数或 POST；参考 `src/app/panels/chart/GridStrategy.hpp` + `ApiDatasetRepository` 的 `gridRowsBatch`/`makeGridRows`）。
|
||||||
|
- `dimensionOf`：`dd_trajectory_data`→Dim2D（已）；`dd_grid`→当前 Other（**需加 Dim2D**）。
|
||||||
|
- col2D(`Column2DDataset`) 信号 `basemapChanged/view2DModeChanged/customZChanged/checkedDatasetsChanged` 在 main.cpp **当前未接线**(T7 留待本期)。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Task 0：确认 dd_grid 数据端点（先做，免后续返工）
|
||||||
|
读 `src/app/panels/chart/GridStrategy.hpp` + `src/data/api/ApiDatasetRepository.cpp` 的 `makeGridRows`/`gridRowsBatch`，确认 `dd_grid` 详情数据的真实端点/方法/参数（`dd/ert/grid/rows` 的正确调用形态）+ 返回字段（x/y/v? 或散点?）。产出：端点 + 字段说明，更新本计划 Task 2。
|
||||||
|
|
||||||
|
## Task 1：dimensionOf 加 dd_grid → Dim2D
|
||||||
|
- `src/data/repo/LocalSample3dRepository.cpp::dimensionOf` + `src/app/DatasetDimension.cpp::splitByDimension`：把 `dd_grid` 归 `Dim2D`（现为 Other）。
|
||||||
|
- 单测 `tests/app/test_dataset_dimension.cpp` 加 `dd_grid`→2D 用例。
|
||||||
|
- 验证：ctest 绿。
|
||||||
|
|
||||||
|
## Task 2：2D 数据异步加载（轨迹 + 网格）
|
||||||
|
在 `Api3dRepository`(真实) + `LocalSample3dRepository`(样本 stub) 加异步方法（照 `loadSection` 范式）：
|
||||||
|
- `loadTrajectory(dsId, onOk(vector<LatLon>), onErr)`：真实走 `trajectory/line`，解析 `electrodelList[].electrodeCoordinate` → 经纬序列。
|
||||||
|
- `load2dGrid(dsId, onOk(SectionData/Grid), onErr)`：按 Task 0 的端点解析网格面。
|
||||||
|
- `I3dSceneRepository` 加这两个虚方法（接口扩展，LocalSample stub 返回样本/空）。
|
||||||
|
- 验证：编译绿；FakeSceneRepo 加 override。
|
||||||
|
|
||||||
|
## Task 3：2D actor（render 层）
|
||||||
|
- 轨迹线：新增 `render/actors/TrajectoryActor`（或复用 `MapLineActor`）：经 `GeoLocalFrame.toLocal` 把经纬序列 → 局部米折线，摆在 Z=0 平面（或 2D视图 Z）。橙色（对齐轨迹详情 `#ff8c00`）。
|
||||||
|
- 网格面：复用 `MapLineActor`(俯视红线) 或 `GridContourActor`(着色面，需 frame)。
|
||||||
|
- 单测：纯几何（经纬→局部米折线点数/坐标）抽出可测。
|
||||||
|
|
||||||
|
## Task 4：VtkSceneView + Controller 接 2D 渲染
|
||||||
|
- `I3dSceneView`/`VtkSceneView` 加 `addTrajectory(...)`、`add2dGrid(...)`。
|
||||||
|
- `VtkSceneController`：Map2D 分支里，对勾选的 2D ds 按维度调 `loadTrajectory`/`load2dGrid` → addTrajectory/add2dGrid（异步 + QPointer/gen 守护，照帘面范式）。
|
||||||
|
- `setViewMode`：col2D 的「2D视图位置」(关闭/Z=0/顶部/底部/自定义Z) 控制 2D 面的 Z（自定义Z=世界绝对米，见三栏 spec）。
|
||||||
|
|
||||||
|
## Task 5：main.cpp 接 col2D 信号
|
||||||
|
- `drawer->col2D()` 的 `checkedDatasetsChanged` → 渲染 2D ds（同 col3D 模式，按维度过滤后的真实 dsId）。
|
||||||
|
- `view2DModeChanged/customZChanged` → setViewMode + 2D 面 Z。
|
||||||
|
- `basemapChanged` → Task 6 底图开关。
|
||||||
|
- 验证：编译绿 + 用户实测（勾选轨迹 ds → 俯视面出橙色测线；网格 ds → 面）。
|
||||||
|
|
||||||
|
## Task 6：天地图底图瓦片层（最复杂，可独立验证）
|
||||||
|
新增 `render/ground/TileGroundLayer`：
|
||||||
|
- 输入：当前数据地理范围（从已渲染 actor 的 lat/lon 包围盒，或 GeoLocalFrame 原点 + 视域）→ 选合适 zoom（数据跨度→z）。
|
||||||
|
- 瓦片数学：EPSG:3857 经纬→TileRow/Col（标准 Web Mercator 瓦片公式），取覆盖范围的瓦片集。
|
||||||
|
- 异步拉取：`QNetworkAccessManager` GET 天地图 WMTS URL（token/子域见上）→ QImage → vtkTexture。
|
||||||
|
- 摆放：每块瓦片的地理 bbox → 四角经纬 `GeoLocalFrame.toLocal` → 局部米 → `vtkPlaneSource` + texture，置于 Z=底图平面。
|
||||||
|
- 切换：`basemapChanged`(0天地图/1Google/2隐藏)；Google 可后置（国内可用性），先天地图 + 隐藏。
|
||||||
|
- LOD/随相机更新：本期可固定一档 zoom（覆盖数据范围），相机驱动 LOD 后置。
|
||||||
|
- **配准是精度敏感点**：3857 瓦片范围反算到 GeoLocalFrame 必须与帘面/轨迹同一 frame，否则底图与数据错位。**须用户实测对齐**（Claude 不能 GUI 测）。
|
||||||
|
- 单测：瓦片数学（经纬→z/x/y、瓦片 bbox→经纬）纯函数抽出可测。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ④ 三维分析栏交互（本期受限，附记）
|
||||||
|
- 树/右键菜单已是 UI。`detailRequested`→`detailCtrl.openDataset` 已接（T7）。`显示/隐藏` 可接 actor 可见性。
|
||||||
|
- **真切片**需 3D 体模型(dd_voxel/dd_Structual3D)，后端缺 → 受限，待后端。
|
||||||
|
- 切片 CRUD/色阶/异常 = P4，接口已留位(②a)，待后端 + 1.0 参考。
|
||||||
|
|
||||||
|
## 风险/验证
|
||||||
|
- 全部渲染须用户 `build.bat rebuild` 实测（Claude 不能 GUI 测）。
|
||||||
|
- 底图配准、2D 面 Z、轨迹/网格定位都是精度敏感点 → 小步验证。
|
||||||
|
- Task 0(grid 端点) 不明会卡 Task 2 的网格分支 → 先确认。
|
||||||
Loading…
Reference in New Issue