README.md 2.6 KB
管道 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的小段，不平滑拐角、不推断安装拓扑。
颜色只遵循统一语义：燃气红、供水蓝、污水绿、雨水青、窨井紫。雨污仅使用后端原样透传的remark备注，缺失或同时含雨水/污水时为灰色未分类。模型材质不依赖太阳光，仍用表面法线提供立体明暗；CSS颜色先转线性RGB再交给Cesium材质，避免被重复提亮。
600m外保留4px同色地表导引线，以免远景管体低于像素尺寸后整条路径消失；已建模近景主要显示体积管体。模型失败或尚未就绪时导引线全距离保留。管线视图默认地形和建筑alpha0.18、pitch-35°、距离系数0.2；地面视图仍恢复不透明。
构件是标准示意件，最大主体跨度约 1m。它们不代表厂家型号、真实弯曲角度、安装尺寸或真实朝向。构件朝向固定，仅用于类型辨认。模型中心/中心线使用地表采样高程减 虚拟埋深 2m；这不是后端实测埋深。
缺少管径时，先在同一行业、端点坐标完全重合且无分叉的连续链上找两侧已有管径；在两个锚点之间按缺失段路径中点的长度比例插值（同值锚点直接沿用）。这属于推算管径，仅用于模型示意，保留两侧编码/管径来源，不覆盖后端源数据；不是安装拓扑的证明。分叉、只有单侧锚点、闭环只有同一个锚点、无锚点或端点仅邻近时均不补，保留折线。
未知构件类型、地表采样失败或素材加载失败时，保留既有折线/符号。只有模型 readyEvent 后才撤下备用表达；后续资源错误恢复备用表达。临时失败可在后续刷新时按 30s 冷却重试。地下显示沿用驾驶舱现有管线视图，不额外改变地形遮挡纪律。