32-32.md 2.6 KB
32: 管线构件 glTF 素材与实例化渲染（样条/角/阀门/支管四类）
Type: task Status: ready-for-agent Label: ready-for-agent Category: frontend-execution
来源
票 24（前端设施点位与管线真实几何图层接线） 收口时维护者 2026-10-12 裁定另立本票。
现状事实（票 24 交付了什么、没交付什么）
票 24 已把真实几何接上图（端点 GET /api/cockpit/v1/infrastructure/geometry，由票 30 提供）：
- 管段：
polyline贴地折线，管径分档映射线宽、行业映射颜色 —— 已是真实几何； - 构件：阀门/角管道/支管管道目前用可辨识符号 + 中文标签（
point+label）表达，不是 glTF 管道模型。
票 24 明确没有拿临时符号冒充"已建成的管道模型"。本票补上素材与实例化。
交付物
- 四类构件素材（维护者 2026-10-12 裁定的建模分类）：
- 样条管道：沿路径点拉伸的管体（管段本身已有折线，本项是把它做成有管径体积的模型）；
- 角管道：预制弯头/转角构件；
- 阀门管道：含阀门结构的预制件；
- 支管管道：T 型/十字型分支构件。
- 实例化渲染：同一构件类型复用同一份 glTF，按位置/朝向实例化，不得每个构件各加载一份（真实数据 5268 条管线，构件数随行业增长，逐个加载会爆内存）。
- 朝向由真实几何决定：管段两端点可算方向；构件朝向目前无来源（
gas_pipe_point无方位字段），只能按管段方向或固定朝向摆放时必须如实说明这是近似，不得声称是真实安装朝向。 - 素材缺失时的降级：素材未就位时保持票 24 的符号表达，不得白屏或静默丢弃。
约束
- 素材放
public/cockpit/...（跟随现有资源归属约定），不进产物源码目录。 - 渲染层仍是 Cesium（ADR 0005 / 票 24 裁定）；若最终判定必须引入 Three.js，需先修订 ADR 0005。
- 与票 24 的坐标纪律一致：不可上图的构件不渲染，仍进「无地图位置」清单。
验收
浏览器实测：四类构件按素材渲染、类型可辨；大量实例下帧率可接受（给出实测读数）；无真实朝向来源的构件如实标注近似；素材缺失时降级为符号而非空白。