City-Lifeline-Cockpit/public/cockpit/models/pipes

管道 glTF 标准示意素材

此目录的五份 glTF 属于四类模型：样条管体、90° 弯头、手轮阀门、支管（三通与十字变体）。素材由仓库自己的生成器制作，无外部下载模型或纹理。按项目 Apache-2.0 许可证分发。

运行 node tools/pipe-models/build-assets.mjs 可重建。每类 glTF 引用同名 .bin 几何缓冲；运行时只请求一次模板，再生成局部 TRS 实例流。同类空间批次引用稳定的几何 URL，以复用 Cesium 资源缓存，不为每个构件独立加载模型。

管体基准为直径1m、长度1m的圆柱，从glTF +Z=0到+Z=1。源/双侧推算管径仍以mm→m保存；显示横截面放大8倍并限制在1.5–3m，这只是可读性示意，长度严格沿原路径。为跟随地形，长路径在原折线上细分为最长约20m的小段，不平滑拐角、不推断安装拓扑。

颜色只遵循统一语义：燃气红、供水蓝、污水绿、雨水青、窨井紫。雨污仅对排水管按后端networkLevel（表字段network_level）区分：0为污水、1为雨水，缺失/空值默认0；其它值为灰色未分类。燃气、供水和窨井不受此字段影响；名称和备注不再用于雨污推断。模型材质不依赖太阳光，仍用表面法线提供立体明暗；CSS颜色先转线性RGB再交给Cesium材质，避免被重复提亮。

以视图模式控制遮挡：地面视图在所有距离始终保留4px同色2D导引线；管线视图只有3D实例就绪后才对近景导引线施加600m下限，远景保留导引。未就绪或失败时导引全距离显示。视图切换即时更新可见性，不重建模型批次。管线视图默认地形和建筑alpha0.18、pitch-35°、距离系数0.2；地面视图仍恢复不透明。

构件是标准示意件，最大主体跨度约 1m。它们不代表厂家型号、真实弯曲角度、安装尺寸或真实朝向。构件朝向固定，仅用于类型辨认。管段模型中心/中心线使用地表采样高程减类别虚拟埋深：燃气1.5m、供水4m、污水8m、雨水10m；非法排水等级按8m灰色占位。以上都不是后端实测埋深。

缺少管径时，先在同一行业、端点坐标完全重合且无分叉的连续链上找两侧已有管径；在两个锚点之间按缺失段路径中点的长度比例插值（同值锚点直接沿用）。这属于推算管径，仅用于模型示意，保留两侧编码/管径来源，不覆盖后端源数据；不是安装拓扑的证明。分叉、只有单侧锚点、闭环只有同一个锚点、无锚点或端点仅邻近时均不补可靠管径。此时仅为显示使用分类默认：燃气DN160、供水DN400、污水/雨水DN800；非法等级排水也使用共同DN800但保持灰色。diameterM仍为null、来源标记visual-default，单独保留visualDefaultDiameterM，再按现有8倍/1.5–3m规则得到最终显示粗度。默认尺寸不参与插值锚点，也不回写数据库。未知行业不猜，继续保留折线。

未知构件类型、地表采样失败或素材加载失败时，保留既有折线/符号。只有模型 readyEvent 后才撤下备用表达；后续资源错误恢复备用表达。临时失败可在后续刷新时按 30s 冷却重试。地下显示沿用驾驶舱现有管线视图，不额外改变地形遮挡纪律。