geopro/.superpowers/sdd/task-9c-report.md

Task 9c 报告：POC-B 离屏 GPU 渲染基准

状态：DONE（闸门通过；真实基准实测完成；关键发现如实记录，无任何编造 fps）

执行机：Windows 11，MSVC（VS18 Community）+ Ninja，Release；GPU = NVIDIA RTX 3060 Laptop GPU，OpenGL 4.5.0 NVIDIA 555.97。 日期：2026-06-23。

---

1. 交付物

• tools/gpr_poc/main.cpp：新增两个子命令
  • gpr_poc offscreen-smoke —— 最小离屏渲染冒烟（闸门），打印 OK/FAIL + GL 能力。
  • gpr_poc renderB <storeDir> [--frames 120] —— 离屏体绘制 + 切片扫描 fps 基准。
• tools/gpr_poc/CMakeLists.txt：补 VTK 组件（RenderingVolume / RenderingVolumeOpenGL2 / ImagingCore / InteractionStyle）。
• docs/superpowers/plans/poc-results-B.md：新增「§4 离屏 GPU 渲染基准」段（闸门 + 真实指标 + 关键发现 + 结论）。
• build/_t9c_build.bat：本任务用的 gpr_poc 单 target 构建脚本（vcvars64 直驱 cmake）。

2. 闸门结果 —— OK

offscreen-smoke：离屏 vtkRenderWindow（SetOffScreenRendering+SetShowWindow(false)）→ cube actor → Render() → GetRGBACharPixelData 读回 65536 像素，非背景 28224。GL vendor=NVIDIA，硬件加速 True。离屏 GL 可用，继续真实基准。

3. 真实 GPU 指标（line 001, cellXY=0.05, cellZ=0.05）

• 体维度：44476 × 29 × 162；体素数 ≈2.09 亿；整卷字节 398.54 MB（int16）。
• 体绘制 fps：INVALID —— 整卷 X 维 44476 超 GL_MAX_3D_TEXTURE_SIZE=16384， vtkVolumeTexture 报 Invalid texture dimensions [44476,29,162]，未真正绘出体数据。 raw_fps=295.6 是空纹理假帧率，已显式标 INVALID，不作为体绘制性能上报。
• 切片扫描 fps：54.6 fps（120 帧沿 Z 扫整卷，vtkImageReslice 2D 切面 + 2D 纹理；不受 3D 纹理上限约束）。≥30fps 目标达成。
• 是否进显存：否（瓶颈是单轴纹理维度上限 16384，非显存字节；整卷 398 MB << RTX 3060 6GB 显存）。
• GPU 显存（NVX）：N/A（随包 VTK 安装未带 GLEW 头，无法链 GL loader 直查；GL 扩展列表确认机器支持 NVX_gpu_memory_info）。
• 进程峰值内存：≈509 MB（加载整卷 398 MB + 渲染管线）。
• build 峰值内存：4830 MB（装配阶段 double survey 主导，与 §2 一致）；无 OOM，cellXY=0.05 一次通过。

4. concerns

1. 整卷朴素体绘制对长测线根本不可行：X=44476 撞 OpenGL 单轴 3D 纹理上限 16384。 与显存容量无关，是硬限制。任何「整卷一次性 3D 纹理」方案对长测线都会撞墙。 这是 Task 12（核外 / 分块 LOD / 体纹理分区 vtkOpenGLGPUVolumeRayCastMapper::SetPartitions） 的硬性依据。本任务按约束未做核外，仅如实记录。
2. SmartVolumeMapper 报 GPURenderMode=2 但纹理上传失败——GetLastUsedRenderMode() 不能单独作为 「真的渲染出来了」的判据；renderB 已加 OutputWindow 捕获 + 维度超限双判据才下 INVALID 结论。
3. GPU 显存读数缺失（N/A）：仅因 VTK 安装未带 GLEW 头；若需要可后续单独链 GL loader 调 NVX 枚举。