diff --git a/docs/superpowers/specs/2026-06-30-vtk-merged-dataset-column-refactor-design.md b/docs/superpowers/specs/2026-06-30-vtk-merged-dataset-column-refactor-design.md index a050a37..b66f0b7 100644 --- a/docs/superpowers/specs/2026-06-30-vtk-merged-dataset-column-refactor-design.md +++ b/docs/superpowers/specs/2026-06-30-vtk-merged-dataset-column-refactor-design.md @@ -70,7 +70,7 @@ ## 6. 响应式图标工具条(新建 `SectionIconBar`) -- 段头右侧承载图标工具条:**默认最多显示 3 个图标**;图标总数超 3,或段宽被挤压放不下时,**右侧图标依次收进末尾「…」下拉菜单**。`resizeEvent` 动态重算可见数。 +- 段头右侧承载图标工具条:**默认最多显示 3 个图标**;图标总数超 3,**或段宽被挤压放不下时**,**右侧图标依次收进末尾「…」下拉菜单**。`resizeEvent` 动态重算可见数 —— 这是**必须实现并可验证**的行为:即使图标 ≤3,当栏位宽度收窄到放不下时,右侧图标也要实时折进「…」,栏位变宽再弹回。 - 每个图标 = `QToolButton`(autoRaise + glyph + tooltip),点击触发对应操作(部分弹 popup)。 - 各维度图标集: | 段 | 图标(左→右,右侧优先收进…) | @@ -78,7 +78,7 @@ | 3D 反演(电阻率/视电阻率/瞬变) | `新增三维体`、`筛选` | | 3D 三维体 | `筛选` | | 2D 轨迹 | `z值`、`筛选`、`底图` | -- 注:当前各段图标 ≤3,「…」折叠为**前瞻能力**(后续图标会增加),需实现但当前不触发。 +- 注:当前各段图标 ≤3,「数量超 3」分支暂不触发,但**「宽度挤压」分支必须工作**(窄栏即折叠);两个分支都要实现(后续图标会增加,数量分支随之生效)。 --- @@ -117,9 +117,11 @@ ### 8.2 2D 按类型平面(需求 5) - 同一 2D 类型(段)勾选的全部 ds 投影到**一块平面**: - - 平面 z = 该类型**第一个被勾选 ds** 的 z(首个勾选时确定;该 ds 取消后平面 z 保持,由 z 滑块掌控)。 + - 平面 z = 该类型**第一个被勾选 ds** 的 z(首个勾选时确定后**固定不变**,仅由 z 滑块整体升降)。 - 平面**纯平、不渲染高程**。 - - 同类型其余 ds 的折线全部落在此平面 z(覆盖现有逐 ds 全局 Z;逐 ds 拖动偏移 `mapLineZOffset_` 的取舍见 §11)。 + - 同类型其余 ds 的折线全部落在此平面 z。 +- **平面生命周期**:该类型**首个 ds 被勾选** → 创建平面(定 z)+ 创建其平面底图(§9.2);期间 z 固定;该类型**全部 ds 取消勾选** → 平面**与其底图一并销毁**。 +- 逐 ds 独立拖动 Z(旧 `nudgeSelectedMapLinesZ` / `mapLineZOffset_`)**废弃**,统一到类型平面 z。 - 渲染复用 `MapLineActor`(折线几何不变),仅 Z 落点改为「所属类型平面 z」。 --- @@ -129,10 +131,17 @@ ### 9.1 3D 共享底图(1 个) - 沿用 `TileBasemap` 单例(带高程地形,Z=0)。透明度参数化(默认 0.5,由 §7.5 popup 调);支持隐藏。瓦片范围规则不变。 -### 9.2 2D 平面底图(N 个,每类型一块) -- 每个 2D 类型一块**纯平矢量底图**:复用天地图矢量图层 `vec_w` + `buildFlat`,贴在该类型平面 z(§8.2)上。 -- 瓦片范围**复用** `dataHorizontalRadius()×10` 钳 `[2000,30000]m` 规则。 -- 实现选型(实现期定):把 `TileBasemap` 参数化(z + 强制 flat + 图层 + opacity + 实例 id)以支持多实例;或抽出轻量 `PlaneBasemap`。优先参数化复用,避免瓦片下载/坐标对齐逻辑重复。 +### 9.2 2D 平面底图(N 个,每类型一块)—— 实现选型已定 +- **决策:参数化 `TileBasemap` 支持多实例**(不另抽 `PlaneBasemap`)。依据:`TileBasemap` 的「相机驱动 LOD + 四叉树细分 + 视锥剔除 + 限并发下载 + GeoLocalFrame 配准」正是平面底图所需,且其状态全为 per-instance(无全局/静态状态,`tileKey` 为纯函数),多实例天然可行。新抽类要么重写数百行 LOD/网络逻辑,要么退化成单层无 LOD 大平面(缩放发虚、且违背「瓦片范围参考三维规则」)。 +- **需改的 3 处硬编码**: + | 改动 | 现状 | 改为 | + |---|---|---| + | 地面 Z | `kGroundZ=0` 常量 | 构造/setter 传 `groundZ`(2D 平面 = 类型平面 z) | + | 透明度 | `kTerrainOpacity=0.55` 固定 | 参数化,默认 0.5 可调 | + | 平面/矢量模式 | 由 `Kind` 隐含 | 复用 `Street`(vec_w)+`buildFlat`(已是纯平矢量路径,跳过 DEM/warp) | +- **最终布局**:1 个 `TileBasemap`(3D,Satellite/带高程,Z=0,§9.1)+ N 个 `TileBasemap`(每 2D 类型一个,Street/纯平矢量,`groundZ`=平面 z)。共享同一 `Scene` / `GeoLocalFrame`。 +- **生命周期管理器**(挂 `VtkSceneController`):按 2D 类型持有 N 个实例 + 各自平面 z;该类型首勾 → 建实例(§8.2 定 z);该类型全消 → 销毁实例(连同折线平面)。 +- 瓦片范围**复用** `dataHorizontalRadius()×10` 钳 `[2000,30000]m` 规则(各实例共享同一 `dataRadiusProvider`)。 - 坐标对齐沿用 `GeoLocalFrame`(经纬→局部);frame 重锚逻辑不变。 --- @@ -146,7 +155,7 @@ ## 11. 迁移说明 / 取舍 / 待定 -- **替代 2026-06-26 spec**:该 spec 的「一场景两相机 + 按维度显隐 + 高程拖动分层」中,**相机锁定 + 维度显隐被本 spec 推翻**(改单一自由场景共存)。其「2D 沿 Z 拖动分离」语义改由「按类型平面 + z 滑块」承担——逐 ds 独立拖动 `nudgeSelectedMapLinesZ` / `mapLineZOffset_` 是否保留待定:默认**退役**(统一到类型平面 z),若实测需要单条微调再议。 +- **替代 2026-06-26 spec**:该 spec 的「一场景两相机 + 按维度显隐 + 高程拖动分层」中,**相机锁定 + 维度显隐被本 spec 推翻**(改单一自由场景共存)。其「2D 沿 Z 拖动分离」语义改由「按类型平面 + z 滑块」承担——逐 ds 独立拖动 `nudgeSelectedMapLinesZ` / `mapLineZOffset_`(及拾取拖动浮层读数)**废弃移除**,统一到类型平面 z。 - **`dd_raster`** 仍未接(2026-06-26 §6 遗留),本 spec 不含;后续作为新的 2D 类型段加入时复用 §8.2/§9.2 平面+底图机制。 - **3D 反演段 vs 三维体段**:均为 D3,但 3D 反演段渲染为帘面、三维体段为体素/雷达体——共用 3D 底图与自由场景,无需区分。 - **责任拆分**:`SectionIconBar` 响应式工具条、`TileBasemap` 多实例参数化、`DatasetColumn` 动态显隐 三块相互独立,可分别实现与测试。 @@ -159,7 +168,7 @@ 2. 段**动态显隐**:无对应数据的段不显示;面板全空时显示居中占位提示。 3. 段头操作为**图标工具条**:默认最多 3 个,超出/挤压时右侧收进「…」下拉。3D 反演段含「新增三维体/筛选」,2D 轨迹段含「z值/筛选/底图」。 4. 「筛选」图标可**展开/收起**段内筛选行(默认折叠)。 -5. 勾选 2D 轨迹:同类型 ds 投影到**一块纯平平面**,平面 z = 首个勾选 ds 的 z;「z值」滑块整体升降该平面;「底图」popup 可换矢量平面底图/无 + 调透明度(默认 50%)。 +5. 勾选 2D 轨迹:同类型 ds 投影到**一块纯平平面**,平面 z = 首个勾选 ds 的 z(之后固定);「z值」滑块整体升降该平面;「底图」popup 可换矢量平面底图/无 + 调透明度(默认 50%)。该类型**全部取消勾选 → 平面与其底图一并消失**。 6. 3D 与 2D 数据在**同一自由透视场景**同时可见,可自由旋转(无锁定俯视、无 tab 切换)。 7. 渲染区工具栏 Gear 下方新增「地图」按钮,控制全局 3D 底图(天地图/无 + 透明度默认 50%)。 8. 「导入雷达」入口出现在顶部「设备」菜单;三维体段头不再有该按钮。