REVOXELSEG_DICOM/工程分析/实现方案-2026-05-20-00-19-47.md

实现方案-2026-05-20-00-19-47

实现方案文档路径

工程分析/实现方案-2026-05-20-00-19-47.md

修改目标

让右侧“逆向分割映射视图”的 Overlay Label Map 实时响应中部模型位姿，并将渲染形态从表面三角面投影升级为闭合实体 Mask 区域填充。

涉及路径

• WebSite/src/components/ReverseWorkspace.tsx
• 工程分析/需求分析-2026-05-20-00-19-47.md
• 工程分析/实现方案-2026-05-20-00-19-47.md
• 工程分析/测试方案-2026-05-20-00-19-47.md
• 工程分析/经验记录.md

技术路线

1. 在 VoxelizationMappingView 新增 modelPose 入参，父组件直接传入中部工具栏当前位姿。
2. 新增浏览器端刚性变换函数：
   • 以全局 STL bounds 中心归一化顶点。
   • 按 scale -> rotateX -> rotateY -> rotateZ -> translate 顺序变换。
   • 将变换后坐标映射到固定 DICOM Overlay 画布坐标系。
3. 将原先“靠近切片的三角面填充”改为“切片平面求交”：
   • 对每个三角面与当前 Z 平面求交。
   • 收集切面边界线段。
4. 将边界线段按扫描线射线法光栅化为实心 Mask：
   • 逐行收集边界线段与水平扫描线的交点。
   • 采用奇偶配对填充闭合区域内部像素。
   • 按构件颜色与透明度写入 Overlay ImageData，并通过离屏画布合成，避免多构件互相覆盖。
5. 对边界不完全闭合的极少数抽样场景，使用端点多边形保底填充，避免完全空白。
6. 使用 requestAnimationFrame 合并高频位姿变化，做到位姿滑条拖动时实时刷新。
7. 更新右侧状态文案，显示实心 Mask 像素数量和参与构件数量。

兼容性与回滚方案

• 不修改后端 API，不影响 DICOM preview、STL preview 和导出接口。
• 如果新填充算法异常，可回退到上一版 drawVoxelOverlayLayer。
• 如果某个构件没有形成闭合区域，只影响该构件 Overlay，不影响 Base Layer 和其他构件。

预计文件变更

• ReverseWorkspace.tsx：新增位姿变换、切面求交、Mask flood fill、Overlay rAF 重绘。
• 新增本次三份工程文档。
• 更新 经验记录.md。

提交与部署策略

• 执行 npm run lint 与 npm run build。
• 重新部署 tmux 会话 revoxelseg-dicom。
• 提交信息：2026-05-20-00-19-47 同步位姿并填充实体映射
• 使用已验证的 Gitea 临时凭据方式推送。