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