2beb97fa73
OutOfCoreSource 实现 IVolumeRenderSource:相机选 LOD + 视锥裁剪选视野块 → BrickPager(LRU,内存恒定)→ 每块 ≤64³ vtkImageData(带世界坐标)。renderC 用 vtkMultiBlockVolumeMapper 渲染工作集,绕开 GL_MAX_3D_TEXTURE_SIZE(16384)单轴墙。 实测(单线 store nx=44476>16384,renderB INVALID): - 分块核外真渲出(非空像素,无纹理维度错),对照 renderB 整卷上传失败。 - 内存恒定:budget=64 驻留 64 块 / 220MB,与体总量无关。 - 静态工作集 9.5 fps;动态换页 1.45 fps(qUncompress 解压+每帧重建 mapper 177ms/帧, 撞墙);fps 随块数近似反比劣化(256 块 0.47 fps)。结论与缓解见 poc-results-C.md。 含单元测试(纹理安全/budget 恒定/块世界坐标)。 |
||
|---|---|---|
| .superpowers/sdd | ||
| cmake | ||
| docs | ||
| 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 通过后展开完整实现计划。