核心:InteractionManager 单 image_ → 按 volumeDsId 的多体 map;各切片附着到各自体的 image。 - issue2 选第二个体→第一个体切片消失:setVolumeImage 不再 closeAll 全部切片;改 upsert 某体(同体重建 才关该体切片)。syncSlices 改为「勾选 + 父体已渲染」即显示(不再限当前体)→ 多体切片并存 - ③ 右键体却建到 current 体:sliceRequested 带目标体 dsId;addSlice(axis,volumeDsId) 用该体 image; 保存切片/创建异常的 volumeDsId 改用 selectedSliceVolumeDsId(选中切片所属体)而非 currentVolume - 反向② VTK→树:InteractionManager.onSliceSelectionChanged(selectByTool/onPicked 触发)→ CategorySection::selectItem 程序化选中(屏蔽信号防环路) - VtkSceneView 按 dsId 存 volumes_(image/cs/vmin/vmax);addVolume 登记/removeDataset 移除并回退 current/clear 清空;volume(dsId) 取指定体→色阶编辑支持非当前体;SliceTool 加 volumeDsId 标签 - nearestSlice 阈值/onWheel 步长/导出上色 改用切片所属体的 bounds/色阶 未解:④ 切片拾取串选(nearestSlice 启发式,VTK9.6 不暴露切片 actor 难精确化;widget 交互选中是精确的) 构建:app 链接通过;434/434 测试通过 |
||
|---|---|---|
| .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 通过后展开完整实现计划。