forked from linkong/planet
5.2 KiB
5.2 KiB
Earth 渲染图层顺序
本文记录当前 Earth 渲染器的图层顺序和每层意图。后续调整
renderOrder、半径偏移、深度策略或指针交互时,需要同步更新这里。
注意:图层控制面板顺序和注册 / 启动加载顺序是两套语义。
| 顺序类型 | 当前顺序 | 说明 |
|---|---|---|
| 控制面板顺序 | 海缆 → 轨迹 → 卫星 → 算力中心 → BGP → 地形 → 高清材质 → 大气云图 → 国界 → 经纬线 | 由 displayOrder 控制,按操作关注度排列。 |
| 注册 / 启动加载顺序 | 经纬线 → 国界 → 高清材质 → 大气云图 → 海缆 → 算力中心 → BGP → 卫星 | 由注册顺序和 startupPriority 控制,按地表到天空排列;轨迹和地形是依赖/可选显示层,不参与常规启动数据加载。 |
地表图层栈
| 顺序 | 图层 | 来源 | 渲染 / 半径策略 | 深度 / 交互策略 | 备注 |
|---|---|---|---|---|---|
| -1000 | 天体背景 mesh | celestial.js |
背景球 | 不参与地表拾取 | 位于所有 Earth 内容之后。 |
| -1 | Earth 遮挡球 | earth.js |
地球内侧不可见球 | 写入深度 | 遮挡地球背面的对象。 |
| 0 | Earth 基座球 | earth.js |
CONFIG.earthRadius |
地表拾取兜底目标 | 深色基座,所有可选地图层关闭时仍可见。 |
| 0.2 | 国界暗色 tint | country-boundaries.js |
tintAltitudeOffset |
禁用 raycast | 高清材质关闭时使用。 |
| 0.86 | 海陆基座填充 | country-boundaries.js |
landAltitudeOffset; 海洋 #010609,陆地 #080f1b |
禁用 raycast | 即使国界线关闭,基座地图仍保持可用。 |
| 0.96 | 高清 Earth 材质 | earth.js |
textureOverlayAltitudeOffset |
可见时作为地表拾取目标 | 高清材质始终压过海陆基座填充。 |
| 1 | 大气辉光和云图 | earth.js |
大气 / 云层球 | 不走普通对象选择路径 | 云图由“大气云图”图层开关控制。 |
| 1 | 海缆 | cables.js |
CABLE_CONFIG.line.renderOrder |
海缆拾取路径 | 保持现有海缆层级。 |
| 1.2 | 真实地形 | earth.js, terrain.js |
TERRAIN_CONFIG.baseRadiusOffset 加地形位移 |
禁用 raycast | 地形压过高清材质;高清材质关闭时临时隐藏,重新开启后恢复原状态。 |
| 2.05 | 经纬线 | earth.js |
CONFIG.earthRadius + 0.14 |
禁用 raycast | 低透明度显示在高清材质上。 |
| 2.2 | 国界线 | country-boundaries.js |
lineAltitudeOffset |
禁用 raycast | 只保证压过高清材质。 |
| 2.29 | 国界 hover 光晕 | country-boundaries.js |
hover 半径加 glow 偏移 | depthTest: false,禁用 raycast |
用 additive 光晕增强交界边和地形开启时的 hover 可见性。 |
| 2.3 | 国界 hover 实线 | country-boundaries.js |
hoverAltitudeOffset |
depthTest: false,禁用 raycast |
霓虹红橘 hover 线;中国和中国(台湾)共享高亮组。 |
| 3 | 卫星 footprint 填充 | satellites.js |
GROUND_FOOTPRINT_RENDER_ORDER |
depth-tested,Group renderOrder 保持 0 | Footprint 在国界线之上,但在算力中心和卫星之下。 |
| 3-5 | BGP 标记和覆盖层 | bgp.js |
各 marker 自身 renderOrder | BGP 拾取路径 | 保持现有 BGP 视觉层级。 |
| 4.5 | 算力中心 | compute-centers.js |
COMPUTE_CENTER_RENDER_ORDER |
算力中心拾取路径 | 地表设施,保持在卫星下方。 |
| 5 | 卫星背景点 | satellites.js |
固定 renderOrder | 屏幕空间卫星拾取 | 位于卫星点下方。 |
| 6 | 卫星点 | satellites.js |
固定 renderOrder | 屏幕空间卫星拾取 | 卫星点压过 footprint 和算力中心。 |
| 12+ | 卫星锁定 ring、halo、预测轨道 | satellites.js |
SATELLITE_CONFIG.overlayRenderOrder 及偏移 |
卫星覆盖层路径 | 用于选中 / 锁定卫星强调。 |
| 98-100 | 太阳 / 月亮 halo 和 sprite | celestial.js |
固定 renderOrder | 天体拾取禁用 | 前景天体 sprite。 |
开关联动
| 开关 | 行为 |
|---|---|
| 高清材质 off | 隐藏高清材质,启用国界 tint / 基座表面,禁用地形和昼夜开关交互,并记住地形和昼夜之前状态。 |
| 高清材质 on | 恢复高清材质,并恢复记住的地形 / 昼夜状态。 |
| 地形 on | 显示在高清材质之上,但低于国界 hover、footprint、卫星等强调层。 |
| 大气云图 | 只控制云图 mesh 显隐。 |
| 国界 | 控制国界线和 hover 线显隐;海陆基座填充独立存在,作为 Earth 基座地图使用。 |
交互规则
| 交互 | 当前规则 |
|---|---|
| Earth 坐标 hover | 高清材质可见时使用高清材质 overlay 作为地表拾取目标,否则使用 Earth 基座球。 |
| 国界 hover | 先把地表拾取坐标转成经纬度,再用 GeoJSON 点面判断;国界 hover 线本身不接收 raycast。 |
| 国界 hover 视觉 | hover 时压暗普通国界线,并绘制无深度测试的光晕和实线。 |
| 中国 / 台湾 hover | CHN 和 TWN 被归到同一个 hover 高亮组;tooltip 仍显示鼠标实际命中的 feature。 |
| 地形 | 只作为视觉层参与,terrain.raycast 已禁用。 |
| 卫星 | 使用屏幕空间卫星拾取,避免 footprint 或地表层挡住卫星点击。 |