eef8188bcb
- 跨视图色阶单一真源 DatasetViewState：2D详情/3D帘面体共用按dsId的色阶，编辑→真源 →各视图实时联动且无信号回环；散点(type1) load-then-save 回写，避免覆盖网格的 lineConfig/层级方案（共享同一条 businessCode="" 后端记录）。 - 色阶两级透明度：ColorScale.globalOpacity 独立存储不烘焙、渲染时与每色 alpha 相乘； 对话框回显真实值、单色独立；properties 补全 lvlSchemeType/logLinesCount/ equalAreaLayerCount，避免整条覆盖写清空；"整体透明度"改名"不透明度"、显示 0~100。 - 切片白化：SetWindowLevel 钉死 [vmin,vmax] + LUT 0号白化槽，哨兵真透明 （tests/spike/slice_alpha_probe.cpp 真 widget 离屏实测）；同时纠正切片颜色映射。 - 切片不透明度：与三维体解耦的独立模型(100%/三维体+50%/跟随)，默认100%；保存切片建 自己的色阶对象(颜色快照+不透明度)，已保存切片走列表右键"色阶"编辑自身。 - 三维体白化：二值 mask 真白化(NoData 排除出插值,符合 ESRI/GDAL/Surfer 标准)；改体 色阶改为原地更新传函(不重建image)，未保存切片不再被刷掉且跟随改色；GPU 探测+CPU 回退；体不透明度归一为色阶"不透明度"单一控制(去 kMaxOpacity、移除工具条"透"滑块)。 - 持久化：网格视图补 saveColorGradation；DatasetChartDto.parseColorBar 回读 opacity。 详见 docs/superpowers/specs/2026-06-27-inversion-3d-volume-surfer-method-and-gaps.md §7。 |
||
|---|---|---|
| .superpowers/sdd | ||
| cmake | ||
| docs | ||
| external/gpr3dviewer | ||
| installer | ||
| resources | ||
| scripts | ||
| spike/ela | ||
| src | ||
| tests | ||
| tools | ||
| .clang-format | ||
| .clangd | ||
| .editorconfig | ||
| .gitattributes | ||
| .gitignore | ||
| CLAUDE.md | ||
| CMakeLists.txt | ||
| CMakePresets.json | ||
| NOTICE.md | ||
| README.md | ||
| build.bat | ||
| vcpkg.json | ||
README.md
Geopro 3.0 桌面客户端
地球物理勘探数据可视化桌面客户端（Qt 6 + VTK 9，C++）。复刻 Geopro 3.0 核心「项目分析视图」。
M1 范围、架构与决策见 docs/superpowers/specs/2026-06-07-geopro-desktop-m1-design.md。 上位技术基线见 docs/Geopro3.0_技术选型与架构规约.md。 环境搭建见 docs/ENV_SETUP_Windows.md。
技术栈
Qt 6.11（QtWidgets）+ VTK 9.6 · CMake + Ninja · 官方 MSVC 预编译 Qt + vcpkg（仅非 Qt 依赖）· MSVC（VS 2022/2026）/ C++17 · ADS 停靠 · GDAL/PROJ · OpenSSL · QtKeychain。
目录（设计 §3）
src/core/ 纯业务，零 Qt/VTK
src/data/ Repository + 解析器
src/net/ ApiClient / AuthService / Credential
src/render/ VTK 场景与 actor（单一场景 + 相机预设）
src/view/ QtWidgets 面板
src/controller/ 联动编排
src/app/ 入口 + 主窗（M1 spike：Qt+VTK 冒烟程序）
tests/ gtest / Qt Test
tools/ 离线验证脚本（validate_samples.py）
docs/ 规约、API、样本数据、设计文档
构建与运行
前置：Visual Studio 2022/2026（勾选「使用 C++ 的桌面开发」工作负载，自带 CMake + Ninja）、Git、vcpkg 并设环境变量 VCPKG_ROOT。构建方案②：单一官方 MSVC 预编译 Qt（CMAKE_PREFIX_PATH → D:/Qt/6.11.1/msvc2022_64）、VTK 预编译于 external/vtk-install、ADS/QtKeychain 经 FetchContent 对接同一份 Qt、仅非 Qt 依赖（GDAL/PROJ/OpenSSL/…）走 vcpkg。详见 docs/ENV_SETUP_Windows.md。
⚠️ 本机
cmake/ninja/cl默认不在 PATH，必须在已激活 MSVC 环境的终端里构建。下面三种方式都已处理好这一点。
方式一：一键脚本（推荐）
项目根的 build.bat 自动用 vswhere 定位 VS、激活 MSVC 环境、按需配置并编译。在 cmd 里于项目根执行 build <命令>：
| 命令 | 作用 |
|---|---|
build（或 build app） |
编译主程序 geopro_desktop（默认） |
build run |
编译并运行主程序 |
build test |
编译并跑单元测试（ctest） |
build all |
编译全部目标 |
build configure |
改了 CMakeLists / 新增源文件后，强制重新配置 |
方式二：Visual Studio 打开文件夹
VS →「打开本地文件夹」→ 选仓库根 → 自动识别 CMakePresets.json → 选配置 MSVC Release → 菜单「生成 → 全部生成」；运行/调试目标选 geopro_desktop。
方式三：手动命令行
开始菜单打开「x64 Native Tools Command Prompt for VS」（已带 MSVC 环境），在仓库根（CMake 用 VS 自带的全路径，因其不在 PATH）：
set CMAKE="%VSINSTALLDIR%Common7\IDE\CommonExtensions\Microsoft\CMake\CMake\bin\cmake.exe"
%CMAKE% --preset msvc-release :: 配置（首次 / 改 CMakeLists 后）
%CMAKE% --build build/release --target geopro_desktop :: 编译主程序
build\release\src\app\geopro_desktop.exe :: 运行
%CMAKE% --build build/release --target geopro_tests :: 编译测试
ctest --test-dir build/release --output-on-failure :: 跑测试
（Debug 用 --preset msvc-debug，对应 build/debug。%VSINSTALLDIR% 在 Native Tools 提示符里已设好。）
构建目标与产物
geopro_desktop— 主程序，产物build/release/src/app/geopro_desktop.exegeopro_tests— 单元测试，配ctest- 不带
--target编译全部
改了已有
.cpp/.hpp直接--build（Ninja 增量）；改了CMakeLists.txt或新增源文件需先--preset/build configure。链接报 LNK1104（文件被占用）时，先关掉运行中的geopro_desktop.exe。
当前状态
M1 设计完成（v2，经双专家评审）。进入 spike 预研（设计 §15）：① 全 vcpkg 构建/部署 ② ADS + QVTKOpenGLStereoWidget 停靠稳定 ③ 真实样本跑通 banded contour。spike 通过后展开完整实现计划。