45 lines
2.9 KiB
Markdown
45 lines
2.9 KiB
Markdown
# 设计：Cesium 路口信号灯可视化
|
||
|
||
## 分层边界
|
||
|
||
信号锚点不是 QGIS 业务图层：它不进入 GeoPackage、场景九图层或 QGIS 工程。`intermediates`
|
||
在 `osm2streets_web_out/traffic_signals.json` 写出它；Blender 和 preview 都消费同一份文件。
|
||
|
||
Blender 的 `05_Props` 负责所有静态设施：灯杆、横杆、灯头、熄灭灯珠和倒计时牌外壳。它们
|
||
随 `.blend` 和主 GLB 导出，成为正式场景的一部分。Cesium 预览只负责动态覆盖层：当前相位的
|
||
发光灯珠、七段倒计时数字、Signals 显示开关，以及车辆在红黄灯前的等待。这样静态造型只有
|
||
一份，浏览器不再用临时 Entity 重复搭建设施。
|
||
|
||
## 锚点与几何
|
||
|
||
中间阶段已有 `vehicle_stop_lines` 和 `intersection_surface`。信号锚点生成器将停止线的
|
||
中点作为进口横向基准，依据相交路口面和停止线两端的方向判定来车朝向；灯杆置于停止线的
|
||
侧后方、道路外缘一侧，且朝向来车。没有可唯一关联的路口面、停止线过短或无法确定外侧时，
|
||
不输出锚点。
|
||
|
||
输出保存灯杆坐标、对应停止线坐标、朝向、稳定 ID 和 `layout` 几何契约，避免 Blender 或
|
||
浏览器重新解析 GeoJSON 或 OSM。`layout` 包含灯头、灯珠、横杆和倒计时牌的尺寸与偏移；
|
||
其中横向偏移以车辆行驶方向为基准，正值表示驾驶员右侧；`mastHeightMeters` 与
|
||
`headCenterHeightMeters` 是横杆和灯壳的共同中心高度。三颗灯珠相对灯壳中心排列，而倒计时牌
|
||
的垂直偏移为零、固定在横杆上。
|
||
Blender 使用
|
||
`Projector.xy((longitude, latitude))` 转成本地米制坐标，并以 `headingDegrees` 旋转；Cesium
|
||
以同一字段派生地理位置与灯面朝向。
|
||
每个路口按相对进口方向分为两组对向相位；统一循环绿、黄、全红切换。
|
||
|
||
预览将每条路线按累计米数投影到信号停止线。只有距离阈值内且行驶方向与信号进口一致的
|
||
匹配才形成停车点。车辆的累计里程由 `clock.onTick` 推进；下一停车点为红或黄时将里程夹在
|
||
停止线前，绿灯后从同一位置继续。没有停车点的路线保留原速度循环。
|
||
|
||
## 预览交互
|
||
|
||
预览加载锚点 JSON 失败时记录 warning，场景、路线与车辆仍可用。加载成功时信号灯默认显示，
|
||
并在现有 View 控件中提供独立 Signals 复选框。动态灯珠和数字以 emissive 材质区分点亮和
|
||
熄灭状态，不依赖环境光；静态部分由 GLB 的低多边形 MeshBatch 几何承载。
|
||
|
||
## 风险与回退
|
||
|
||
信号灯是示意设施，不能视为 OSM 语义。复杂交叉口或人工修补后的不完整标线宁可跳过，也不
|
||
摆放到行车道中央。回退时删除附属锚点输出、`05_Props` 信号构件和 Cesium 动态覆盖层即可；
|
||
QGIS、道路/标线和既有路线 JSON 不受影响。
|