Files
planet/docs/technical/zh/earth-layer-style-reference.md
T

29 KiB
Raw Blame History

智能星球图层样式属性索引

EARTH_MATERIAL_CONFIG.surface.night 集中夜侧纹理对比(detailGamma=0.55)及海陆各自的 tint/ambient 参数。它只参与夜侧混合,不调整日面曝光;沿用现有地理遮罩,无新增贴图或 Draw Call。

现代物件视觉

  • 地表:EARTH_MATERIAL_CONFIG.surface 集中 exposure=0.9、landSaturation=0.9、oceanAbsorption=0.36、oceanDeepColor=[0.004,0.012,0.032]、夜面保留与 Fresnel 参数;atmosphere 集中单壳半径、颜色和强度。低清基座及地形关闭镜面高光。
  • 海缆:常态冷色与原分类色混合,图例与线路保持一致;选中后参考流光沿真实线路累计长度移动,6 个周期、速度 4.5。复用同一批量 draw,绘制材质不写深度;原 Line 对象、cableId、选中逻辑不变。
  • 登陆点:marker-landing-point.svg 为 128×128 琥珀微核单色源,取代带高光的程序球;Sprite 拾取和 billboard 批量绘制保持原尺寸逻辑。
  • 算力:三个规范 SVG 只负责内置符号;marker-badges.js 与 interactable.js 共同绘制渐变方块底板、浅色边圈、上沿高光与投影。GPU/AI 使用电紫堆叠层,超算使用电紫芯片,数据中心/基础设施使用青绿机柜。估算标志和原拾取/联动保留。
  • 卫星:真实倾角分类与图例、预测轨道共享鲜明类别色;普通态使用原型硬边圆盘,无衬边或球面明暗,默认不呼吸。覆盖统一蓝色,日照只改变透明度。

本文记录当前 Earth 前端各图层的材质、颜色、透明度、线宽、半径偏移和 renderOrder 等样式属性。层级关系请配合 智能星球渲染图层顺序 查看。

命名约定

类别 约定 示例
全局配置对象 *_CONFIG COUNTRY_BOUNDARY_CONFIG
图层半径偏移 *AltitudeOffset / radiusOffset lineAltitudeOffset, GRID_CONFIG.radiusOffset
透明度 *Opacity hoverLineOpacity
渲染顺序 *RenderOrder textureOverlayRenderOrder
颜色 *Color,十六进制数字或 CSS 色值 lineColor, colors.supercomputer
线宽 lineWidth / *LineWidth GRID_CONFIG.lineWidth

Earth 基座与高清材质

正式名称 变量名 当前值 使用位置 / 说明
智能星球基座半径 CONFIG.earthRadius 100 earth.js:createEarth()
智能星球基座颜色 EARTH_MATERIAL_CONFIG.color 0x010609 MeshPhongMaterial.color
智能星球基座 emissive EARTH_MATERIAL_CONFIG.emissive 0x010609 MeshPhongMaterial.emissive
智能星球基座 specular EARTH_MATERIAL_CONFIG.specular 0x000000 MeshPhongMaterial.specular
智能星球基座 shininess EARTH_MATERIAL_CONFIG.shininess 0 MeshPhongMaterial.shininess
智能星球基座 opacity EARTH_MATERIAL_CONFIG.opacity 1 MeshPhongMaterial.opacity
高清材质半径偏移 EARTH_MATERIAL_CONFIG.textureOverlayAltitudeOffset 0.48 独立高清材质球半径;必须与海陆基座和地球基座保持足够深度间距,避免远距 z-fighting
高清材质 renderOrder EARTH_MATERIAL_CONFIG.textureOverlayRenderOrder 0.96 _earthTextureOverlay.renderOrder

Earth 遮挡与昼夜

正式名称 变量名 当前值 使用位置 / 说明
遮挡球半径系数 EARTH_MATERIAL_CONFIG.occluderRadiusFactor 0.999 深度遮挡球半径
遮挡球分段 EARTH_MATERIAL_CONFIG.occluderSegments 48 遮挡球几何分段
遮挡球 renderOrder inline 0.5 occluder.renderOrder
昼夜太阳方向 EARTH_MATERIAL_CONFIG.dayNight.sunDirection { x: 1, y: 0.2, z: 0.4 } 自定义 day/night shader
夜侧最低亮度 EARTH_MATERIAL_CONFIG.dayNight.nightFloor 0.24 shader uniform
日侧增强 EARTH_MATERIAL_CONFIG.dayNight.dayBoost 1.12 shader uniform
暮光宽度 EARTH_MATERIAL_CONFIG.dayNight.twilightWidth 0.2 shader uniform
暮光强度 EARTH_MATERIAL_CONFIG.dayNight.twilightIntensity 0.14 shader uniform
暮光颜色 EARTH_MATERIAL_CONFIG.dayNight.twilightColor 0x4ea0ff shader uniform
夜侧 tint 颜色 EARTH_MATERIAL_CONFIG.dayNight.nightTintColor 0x0b1830 shader uniform
夜侧 tint 强度 EARTH_MATERIAL_CONFIG.dayNight.nightTintIntensity 0.08 shader uniform

大气辉光与云图

正式名称 变量名 当前值 使用位置 / 说明
大气辉光 blending inline THREE.AdditiveBlending ShaderMaterial.blending
无高清材质边缘光 depthTest inline false 避免被海陆基座或地表填充遮住
云图半径偏移 CLOUD_LAYER_CONFIG.radiusOffset 3 云层球半径
云图分段 CLOUD_LAYER_CONFIG.widthSegments / heightSegments 64 / 64 云层球几何分段
云图透明度 CLOUD_LAYER_CONFIG.opacity 0.15 MeshBasicMaterial.opacity
云图贴图 CLOUD_LAYER_CONFIG.textureUrl "./assets/earth_clouds_1024.png" 云层贴图
云图 blending inline THREE.AdditiveBlending MeshBasicMaterial.blending

海陆基座与国界

海陆基座是 Earth 的底图资产,随启动预加载;图层面板里的“国界线”只控制普通国界线、hover 线和可交互 hover。

正式名称 变量名 当前值 使用位置 / 说明
国界瓦片 manifest COUNTRY_BOUNDARY_CONFIG.tileManifestPath "/earth/data/boundaries/v1/manifest.json" 高精 PMTiles manifest;缺失时使用低精度 fallback
国界瓦片 provider COUNTRY_BOUNDARY_CONFIG.tileProvider "auto" 优先高精 PMTiles/MVT,缺失时降级到 legacy GeoJSON
PMTiles 产物路径 COUNTRY_BOUNDARY_CONFIG.pmtilesPath "/earth/data/boundaries/earth-boundaries-china-pov-v1.pmtiles" 生产单文件 PMTiles/MVT artifact
低精度 fallback COUNTRY_BOUNDARY_CONFIG.legacyFallbackPath "/earth/data/countries-admin0.min.geojson" 本地未构建高精国界时的缺省海陆基座和 hover 数据
MVT 图层名 COUNTRY_BOUNDARY_CONFIG.mvtLayerNames boundary_admin0 / boundary_disputed_internal / coastline / claim_line PMTiles provider 解码时读取的固定 layer 名
国界瓦片基础路径 COUNTRY_BOUNDARY_CONFIG.tileBasePath "/earth/data/boundaries/v1/" PMTiles manifest 基础路径
国界瓦片缩放阈值 COUNTRY_BOUNDARY_CONFIG.tileZoomThresholds 1.6 -> z5, 2.8 -> z6, 3.4 -> z7, 4.0 -> z8, 4.6 -> z9, 5.2 -> z10 生产 PMTiles zoom 选择
国界瓦片缓存上限 COUNTRY_BOUNDARY_CONFIG.tileCacheLimit 150 前端已加载瓦片几何的 LRU 缓存条目数
国界瓦片 debounce COUNTRY_BOUNDARY_CONFIG.tileDebounceMs 180 视野变化后请求可见瓦片前的防抖时间
海洋填充色 local OCEAN_HEX 0x010609 海陆基座 canvas 背景
陆地填充色 COUNTRY_BOUNDARY_CONFIG.landColor 0x080f1b 海陆基座 canvas 陆地
海陆基座透明度 COUNTRY_BOUNDARY_CONFIG.landOpacity 1.0 MeshBasicMaterial.opacity
海陆基座半径偏移 COUNTRY_BOUNDARY_CONFIG.landAltitudeOffset 0.32 country-land-ocean 半径;与地球基座拉开以避免 50% 缩放时雪花/黑块闪烁
海陆基座 renderOrder COUNTRY_BOUNDARY_CONFIG.landRenderOrder 0.86 country-land-ocean.renderOrder
海陆 mask 尺寸 landMaskWidth / landMaskHeight 2048 / 1024 canvas / DataTexture 尺寸
国界 tint 颜色 COUNTRY_BOUNDARY_CONFIG.tintColor 0x0b1830 高清材质关闭时 tint
国界 tint 半径偏移 COUNTRY_BOUNDARY_CONFIG.tintAltitudeOffset 0.32 country-tint 半径
国界 tint renderOrder COUNTRY_BOUNDARY_CONFIG.tintRenderOrder 0.2 country-tint.renderOrder
国界线颜色 COUNTRY_BOUNDARY_CONFIG.lineColor 0x7fc7ff 普通国界线
国界线透明度 COUNTRY_BOUNDARY_CONFIG.lineOpacity 0.58 普通国界线 opacity
国界线 hover 时压暗透明度 COUNTRY_BOUNDARY_CONFIG.dimmedLineOpacity 0.18 hover 时普通国界线 opacity
国界线半径偏移 COUNTRY_BOUNDARY_CONFIG.lineAltitudeOffset 0.115 普通国界线半径;线层靠 renderOrder 和独立 geometry 叠加,不作为整球基座深度间距参考
国界线 renderOrder COUNTRY_BOUNDARY_CONFIG.lineRenderOrder 2.2 普通国界线层级
国界 hover 颜色 COUNTRY_BOUNDARY_CONFIG.hoverLineColor 0xff3b1f 霓虹红橘
国界 hover 透明度 COUNTRY_BOUNDARY_CONFIG.hoverLineOpacity 1.0 hover 实线 opacity
国界 hover 半径偏移 COUNTRY_BOUNDARY_CONFIG.hoverAltitudeOffset 0.115 hover 实线半径;与普通国界线同源几何对齐,避免高亮切换时出现重影
国界 hover renderOrder COUNTRY_BOUNDARY_CONFIG.hoverLineRenderOrder 2.3 hover 实线层级
国界 hover glow 透明度 COUNTRY_BOUNDARY_CONFIG.hoverGlowOpacity 0.38 glow 线 opacity
国界 hover glow 线宽 COUNTRY_BOUNDARY_CONFIG.hoverGlowLineWidth 3 glow LineBasicMaterial.linewidth
国界 hover glow 层级偏移 COUNTRY_BOUNDARY_CONFIG.hoverGlowRenderOrderOffset 0.01 glow renderOrder = 2.29
国界 hover glow 半径偏移 COUNTRY_BOUNDARY_CONFIG.hoverGlowRadiusOffset 0 glow 与 hover 实线共用半径,避免海岸细节处双线错位

真实地形

正式名称 变量名 当前值 使用位置 / 说明
地形 tile size TERRAIN_CONFIG.tileSize 256 Terrarium tile 读取
地形 base zoom TERRAIN_CONFIG.baseZoom 4 地形采样 zoom
地形几何分段 geometryWidthSegments / geometryHeightSegments 320 / 320 地形球几何
地形基准半径偏移 TERRAIN_CONFIG.baseRadiusOffset 0.16 地形压过高清材质
地形夸张系数 TERRAIN_CONFIG.exaggeration 34 海拔转世界单位
地形陆地淡入高度 TERRAIN_CONFIG.landRevealFadeMeters 220 顶点 alpha
地形透明度 TERRAIN_CONFIG.opacity 0.68 MeshPhongMaterial.opacity
地形颜色 TERRAIN_CONFIG.color 0x8aa884 MeshPhongMaterial.color
地形 emissive TERRAIN_CONFIG.emissive 0x030704 降低自发光,恢复地形明暗层次
地形 specular TERRAIN_CONFIG.specular 0x000000 给地形局部光泽,不抬高高清贴图直射亮度
地形 shininess TERRAIN_CONFIG.shininess 0 关闭镜面高光
地形 renderOrder inline 1.2 terrain.renderOrder
地形 polygonOffset inline factor -1, units -1 降低贴近球面时的闪烁

经纬线

正式名称 变量名 当前值 使用位置 / 说明
经纬线半径偏移 GRID_CONFIG.radiusOffset 0.14 经纬线球面半径
经纬线颜色 GRID_CONFIG.color 0xc0e0ff LineBasicMaterial.color
经纬线透明度 GRID_CONFIG.opacity 0.08 LineBasicMaterial.opacity
经纬线线宽 GRID_CONFIG.lineWidth 1 LineBasicMaterial.linewidth
经纬线 renderOrder GRID_CONFIG.renderOrder 2.05 经纬线层级
纬线间隔 GRID_CONFIG.latitudeStep 15 纬线生成步长
经线间隔 GRID_CONFIG.longitudeStep 30 经线生成步长
线段采样步长 GRID_CONFIG.segmentStep 5 经纬线采样步长

海缆与登陆点

cable-batches.js 将海缆线与登陆点分别合批绘制。下表的 Sprite 材质和尺寸仍属于 cables.js 中的拾取、选择代理;每帧把颜色、透明度、缩放和可见性同步到样式纹理或实例属性。实际绘制使用 LineSegments 和实例化 billboard,沿用原纹理、色彩、层级与球体遮挡规则。

正式名称 变量名 当前值 使用位置 / 说明
默认海缆颜色 CABLE_COLORS.default 0xffff44 无数据颜色时使用
海缆半径偏移 CABLE_CONFIG.line.altitudeOffset 0.48 海缆线半径
海缆线宽 CABLE_CONFIG.line.lineWidth 1 LineBasicMaterial.linewidth
海缆透明度 CABLE_CONFIG.line.opacity 1.0 海缆线 opacity
海缆 renderOrder CABLE_CONFIG.line.renderOrder 1 海缆线层级
登陆点半径偏移 CABLE_CONFIG.landingPoint.altitudeOffset 0.48 与海缆线同层贴地,避免凌空
登陆点 sprite 高度 local LANDING_POINT_SPRITE_HEIGHT 3 THREE.Sprite 基准高度
登陆点缩放参考 FOV local LANDING_POINT_SIZE_REFERENCE_FOV 75 与当前 Earth 相机 FOV 一致
登陆点缩放下限 local LANDING_POINT_SIZE_SCALE_MIN 0.16 地球放到 200% 之后的最小倍率,限制高倍 zoom 下的屏幕占比;3 * 0.16 = 0.48
登陆点缩放上限 local LANDING_POINT_SIZE_SCALE_MAX 3 远距离时的最大倍率;当前最小缩放约只能到 2.50
登陆点 atlas 尺寸 local LANDING_POINT_ATLAS_CELL_SIZE 128 canvas 扁平立体球纹理尺寸
登陆点颜色 CABLE_CONFIG.landingPoint.color 0xffaa00 SpriteMaterial.color
登陆点透明度 CABLE_CONFIG.landingPoint.opacity 1.0 SpriteMaterial.opacity
登陆点 renderOrder CABLE_CONFIG.landingPoint.renderOrder 1 与海缆线同层;depthTest: false 保持球体完整,背面通过相机到球心的球体遮挡判断隐藏
登陆点 dim 亮度系数 landingPointVisual.dimBrightness 0.62 dim 状态颜色乘数
关联登陆点光晕范围 landingPointVisual.related.haloScale / haloFalloff 1.65 / 8 仅扩大光晕画布,圆点大小和颜色不变
非相关登陆点颜色 landingPointVisual.dimmed.colorRGB { r: 180, g: 116, b: 28 } dim 状态颜色,避免黑色基座透出成暗洞
非相关登陆点 opacity landingPointVisual.dimmed.opacity 0.78 dim 状态透明度,不再用低 alpha 混黑底

卫星、轨迹和 footprint

正式名称 变量名 当前值 使用位置 / 说明
卫星 fallback 半径偏移 SATELLITE_CONFIG.fallbackAltitudeOffset 8 关闭真实高度或 TLE 传播失败时的旧版同层球面位置
卫星真实高度压缩尺度 SATELLITE_CONFIG.altitudeCompressionKm 1200 TLE/SGP4 高度压缩映射,数值越大高轨差异越温和
卫星真实高度上限 SATELLITE_CONFIG.maxDisplayAltitudeKm 40000 压缩映射的高度截断,覆盖 GEO 附近高度
卫星真实高度显示偏移范围 minRealAltitudeOffset / maxRealAltitudeOffset 4 / 25 压缩后映射到 CONFIG.earthRadius + offset;25 约为当前地球半径 100 的四分之一,用于保留高轨分层同时避免 GEO/MEO 轨迹离主体过远
卫星点基础像素大小 SATELLITE_CONFIG.dotBaseSize 2.2 旧交互命中半径计算基准;不控制视觉尺寸
卫星点透明度范围 dotOpacityMin / dotOpacityMax 0.72 / 1.0 选中点呼吸动画;普通点默认不呼吸
卫星点透明度 inline 1.0 硬边圆盘普通态
卫星点 renderOrder inline 6 satellitePoints.renderOrder
卫星轨迹长度 SATELLITE_CONFIG.trailLength 10 trail buffer
卫星轨迹线宽 SATELLITE_CONFIG.trailLineWidth 3(上限) 实际宽度同时限制为点径的 60%,保留渐细短拖尾
选中 ring 大小 SATELLITE_CONFIG.ringSize 0.07 hover / locked ring sprite
卫星覆盖层 renderOrder SATELLITE_CONFIG.overlayRenderOrder 12 locked ring / halo / orbit
自发光选中点颜色 inline default "#ffd25a" showSelfGlowStyle()
自发光选中点透明度 inline 0.96 locked dot material
footprint renderOrder local GROUND_FOOTPRINT_RENDER_ORDER 3 Starlink footprint fill 和 Iridium coverage ring;必须高于地表 land / texture / terrain 层
footprint group renderOrder inline 0 避免 Group 排序盖过卫星点

AIS 船只

正式名称 变量名 当前值 使用位置 / 说明
船只半径偏移 VESSEL_CONFIG.altitudeOffset 0.2 普通 marker 位置,贴近真实地形基础层
船只轨迹半径偏移 VESSEL_CONFIG.track.altitudeOffset 0.2 选中船只轨迹线,与船只 marker 同一半径;前端会把轨迹末端锚到当前 marker 位置
船只 renderOrder local VESSEL_RENDER_ORDER 4.4 普通 marker 和交互 overlay
船只轨迹 renderOrder VESSEL_RENDER_ORDER - 0.1 4.3 低于船只 marker
船只点像素尺寸 local VESSEL_POINT_SIZE 34 普通 marker 与 hover / locked overlay 共享尺寸
船只默认渲染上限 VESSEL_CONFIG.maxRenderedMarkers 3000 前端请求全局当前状态快照时传给 /api/v1/vessels/snapshot 的默认 limit;后端上限仍为 5000
船只纹理画布尺寸 local VESSEL_ATLAS_CELL_SIZE 128 canvas 点纹理
航向分桶数 local VESSEL_COURSE_BINS 32 moving 船只按 COG 分桶,降低 draw call 同时保留方向
船只 hover 拾取节流 local VESSEL_HOVER_PICK_INTERVAL_MS 100 main.js hover picking
船只屏幕命中半径 local VESSEL_POINTER_RADIUS_PX 22 main.js 屏幕空间 picking
普通船只透明度 VESSEL_CONFIG.marker.baseOpacity 0.88 普通 PointsMaterial.opacity
dimmed 船只透明度 VESSEL_CONFIG.marker.dimmedOpacity 0.26 锁定某艘船后其他批次透明度
hover 船只透明度 inline 0.98 hover overlay
locked 船只透明度 inline 1 locked overlay
船型颜色 VESSEL_CONFIG.colors.* cargo / tanker / passenger / fishing / military / other PointsMaterial.vertexColors 和 overlay texture

AIS 船只普通态使用批量 THREE.Points,不是逐船 THREE.Sprite。航行船只保持三角形,停泊或低速船只保持圆点;普通态不带 glow,hover / locked 时在同一屏幕尺寸上叠加带 glow 的单点 overlay。AIS 航向按 course / cog 从正北顺时针解释,普通态和交互态必须使用同一套 canvas 旋转规则。船只显式关闭 cluster 和 avoidance,密集区域可以重叠,不能重新接入动态屏幕聚类。

船型颜色和详情卡船型文本必须来自同一套归一化结果:vessels.js 同时读取后端 vessel_type_name 和 AIS 数字 vessel_type,先得到颜色用的 type,再生成 vessel_type_display 给详情卡、hover 和搜索使用。

算力中心

正式名称 变量名 当前值 使用位置 / 说明
算力中心半径偏移 COMPUTE_CENTER_CONFIG.altitudeOffset 0.48 marker 位置
算力中心点像素尺寸 local COMPUTE_CENTER_POINT_SIZE 36 Interactable 普通 marker 与 hover / locked overlay 共享基准尺寸
算力中心 asset fit size local COMPUTE_CENTER_ICON_FIT_SIZE 60 SVG asset 在 128x128 atlas canvas 内的最大绘制尺寸,由 icon.fitSize 控制
算力中心基础透明度 COMPUTE_CENTER_CONFIG.marker.baseOpacity 0.88 普通 PointsMaterial.opacity
超算 marker 缩放 COMPUTE_CENTER_CONFIG.marker.supercomputerScale 12 旧 Sprite 缩放参数;当前 Interactable 路径不再直接使用
GPU 集群 marker 缩放 COMPUTE_CENTER_CONFIG.marker.gpuClusterScale 12 旧 Sprite 缩放参数;当前 Interactable 路径不再直接使用
hover 缩放 COMPUTE_CENTER_CONFIG.marker.hoverScale 1.16 hover overlay 尺寸倍率
locked 缩放 COMPUTE_CENTER_CONFIG.marker.lockedScale 1.22 locked overlay 尺寸倍率,并叠加 pulse
dimmed 缩放 / 透明度 dimmedScale / dimmedOpacity 0.82 / 0.34 dim 状态
超算颜色 COMPUTE_CENTER_CONFIG.colors.supercomputer "#a855f7" marker texture
GPU 集群颜色 COMPUTE_CENTER_CONFIG.colors.gpu_cluster "#a855f7" marker texture
关联颜色 COMPUTE_CENTER_CONFIG.colors.linked "#f8fafc" 关联态
算力中心 renderOrder local COMPUTE_CENTER_RENDER_ORDER 4.5 地表设施低于卫星点

BGP 观测

正式名称 变量名 当前值 使用位置 / 说明
BGP 事件半径偏移 BGP_CONFIG.altitudeOffset 0.48 BGP 事件 Interactable marker
BGP collector 半径偏移 BGP_CONFIG.collectorAltitudeOffset 0.2 BGP 观测站 Interactable marker,与船只同层贴地
BGP 事件点像素尺寸 local BGP_EVENT_POINT_SIZE 34 事件 icon 的 Interactable 基准尺寸,按严重级别通过 getPointSizeMultiplier() 调整
BGP 事件符号绘制尺寸 local BGP_EVENT_SYMBOL_SIZE 60 事件 canvas 符号在 128x128 atlas 中的绘制尺寸
BGP collector 点像素尺寸 local BGP_COLLECTOR_POINT_SIZE 36 观测站 Interactable 基准尺寸,按活跃度通过 getPointSizeMultiplier() 调整
BGP collector asset fit size local BGP_COLLECTOR_ICON_FIT_SIZE 60 bgp-broadcast-pin.svg 在 atlas canvas 内的最大绘制尺寸
事件基础缩放 BGP_CONFIG.marker.eventBaseScale 6.2 事件扩散圈锚点
collector 基础缩放 BGP_CONFIG.marker.collectorBaseScale 7.4 观测站 halo / 覆盖动画锚点
hover / dim 缩放 hoverScale / dimmedScale 1.16 / 0.92 交互状态
普通事件透明度 BGP_CONFIG.opacity.normal 0.78 BGP 事件 Interactable 普通态
hover 透明度 BGP_CONFIG.opacity.hover 1.0 hover 状态
dimmed 透明度 BGP_CONFIG.opacity.dimmed 0.24 dim 状态
collector 透明度 BGP_CONFIG.opacity.collector 0.62 collector 状态
critical 颜色 BGP_CONFIG.severityColors.critical 0xff4d4f 严重事件
high 颜色 BGP_CONFIG.severityColors.high 0xff9f43 高危事件
medium 颜色 BGP_CONFIG.severityColors.medium 0xffd166 中危事件
low 颜色 BGP_CONFIG.severityColors.low 0x4dabf7 低危事件
collector 基础色 BGP_CONFIG.collectorColor 0x6db7ff collector 默认色
BGP 光晕浅色基准 BGP_CONFIG.halo.tintNeutralColor 0xffffff 面状 halo 先取对应事件/collector 图标色,再向该中性色混合,保持同色调但不完全同色
BGP 光晕图标色混合比例 BGP_CONFIG.halo.tintBlend 0.72 值越高越接近图标色;当前用于事件区域 halo、collector coverage halo 和 collector radar pulse
region 色 BGP_CONFIG.regionColor 0x2dd4bf 区域覆盖旧基准;新的面状 BGP halo 优先从事件或 collector 图标色派生
BGP ring 缩放 BGP_CONFIG.ring.scaleA / scaleB 2.5 / 3.4 anomaly ring
BGP ring 透明度 BGP_CONFIG.ring.opacity 0.5 anomaly ring
collector marker renderOrder local BGP_COLLECTOR_RENDER_ORDER 4.4 观测站主图标,与船只同层
anomaly marker renderOrder local BGP_EVENT_RENDER_ORDER 4.5 BGP 事件主图标,与算力中心同层

天体与星空

正式名称 变量名 当前值 使用位置 / 说明
天球半径 CELESTIAL_CONFIG.skyRadius 2600 天体背景
天球透明度 CELESTIAL_CONFIG.skyOpacity 1 背景材质
太阳距离 / 缩放 sunDistance / sunScale 2150 / 78 太阳 sprite
月亮距离 / 缩放 moonDistance / moonScale 2050 / 38 月亮 sprite
太阳 halo 缩放 CELESTIAL_CONFIG.sunHaloScale 136 太阳 halo
月亮 halo 缩放 CELESTIAL_CONFIG.moonHaloScale 62 月亮 halo
太阳光颜色 / 强度 sunLightColor / sunLightIntensity 0xfff4df / 1.02 scene light
背光颜色 / 强度 backLightColor / backLightIntensity 0x2b4c78 / 0.3 scene light
星空半径范围 minRadius + radiusJitter 800 + 200 随机分布

方块徽标分类与配色

类型 主色 内置图标
数据中心/基础设施 青绿 #14b8a6 → #0d9488,边框 #5eead4 服务器机柜
GPU/AI 电紫 #a855f7 → #7e22ce,边框 #d8b4fe 堆叠算力层
超级计算机 同一电紫 芯片
海缆登陆点 琥珀 #f59e0b,浅金 #fef3c7 边圈 发光圆核
BGP 观测站 蓝色及原活动热度色 圆角矩形底板内置广播塔
BGP 事件 低/中/高/严重:蓝/琥珀/橙/红 不规则扁平符号(三角、感叹号、波动、爆发、泄漏),不使用方块
船舶 货轮蓝、油轮橙、客船青绿、渔船琥珀、军舰靛紫、其他银灰 独立航向箭头,无徽标底板;停泊为圆点,悬停/选中发光
自定义标记 地点绿、备注黄、告警红、默认蓝 地点针、备注页、告警三角

BGP 变化事件保持不规则扁平符号作为唯一例外,观测站使用圆角徽标;其他有限地表物件使用缓存的徽标纹理,不为每个图标新增 DOM 或独立绘制对象。船舶继续按航向分桶,以顶点色区分船型,不将船型与航向相乘扩张批次数。卫星使用参考的鲜明类别色与无衬边硬圆盘;轨道和覆盖计算不变。低缩放圆点的设置、持久化字段和绘制/拾取分支已删除。

卫星统一色板

参考 satellitemap.space 的类别色;本地 3d.html 中的模拟壳层与数量不作为项目分类依据。当前项目仍按真实轨道倾角分类:0–30° 蓝 #3399ff、30–60° 橙 #ff801a、60–90° 绿 #00e680、90–120° 紫 #cc33ff、120–180° 玫红 #ff3366,未知灰 #94a3b8。同一颗卫星跨昼夜保持同一颜色,预测轨道不再使用无关的黄紫渐变。

覆盖统一 #3399ff,opacity=0.34,日侧透明度增益=1.65。普通点不带深色衬边,单批 PointsMaterial 使用 alphaTest=0.5;视觉尺寸由 satellitePixelSize() 在 2.4–8.0 之间平滑变化。

选中轨道与面板轮廓

预测轨道绘制完整周期的开放曲线,不追加首点,不截短采样范围或隐藏端部;按累计弧长沿未来采样方向推进亮色流光,复用同一 Line 绘制。电视与通用 HUD 外壳恢复方角,播放器裁剪区域同样为方角;不改变窗口尺寸与拖拽。发布代码移除临时逐帧性能统计,不保留只用于验收的 DOM 诊断接口。

登陆点、侧面徽标与星空微调

海缆与登陆点共用 R+0.48、renderOrder=1,均通过 cable-surface.js 的地表三角网格坐标生成,避免理想球与实际地表之间的端点视差。普通点为黄色实心圆与浅色圈,不带常驻光晕;只有 related 点在原有合批 Shader 中产生轻微脉动光晕,其他点变暗,取消高亮恢复普通黄色点。

圆角徽标改为锚点遮挡:surface-marker-occlusion.js 在 GPU 判断锚点是否被球体挡住,正面徽标整块显示、背面整块隐藏;屏幕拾取复用相同判断。仅徽标层关闭逐像素深度裁切;BGP 变化事件保持原扁平符号与深度行为,观测站保留活动热度色并使用圆角底板。悬停、选中和聚合徽标使用同一遮挡路径。

星空纹理材质独立使用 CELESTIAL_CONFIG.skyBrightness = 1.0;不改变地球曝光、天体灯光或业务图层亮度。

船只为独立移动对象,恢复徽标改造前的航向箭头、停泊圆点和悬停/选中光晕,不接入固定地表物件的圆角底板及整块徽标遮挡路径。

登陆点普通态和关联态均保持橙色内芯、黄色外圈;关联态只扩大外侧柔光区域并脉动,不改变核心颜色、透明度或尺寸。取消关联后光晕归零;非关联点继续使用暗态。

星空颜色输出

星空贴图按 sRGB 解码;celestial.js 通过共享 preserveTextureOutput() 仅为星空材质补齐屏幕 sRGB 输出。Three.js r128 的全局 renderer 仍保持既有线性输出,避免改变地球、卫星及其他图层。skyBrightness=1.0 表示原图亮度;缺少输出编码时,解码后的暗部会再次以线性数值显示,不能靠提高倍率修正。验证应固定星图、相机与视角,对比渲染像素和 1.0/1.5 两档响应,不能只检查加载成功。

卫星 hover 小圈直接使用当前卫星的倾角类别色,与粒子和图例一致;切换悬停对象时重新取色,位置更新不覆盖颜色。

所有地表卡片统一使用根 HUD DPI 比例。新闻区域卡片与巡航新闻复用标题图标、配色、字号及内边距;区域版只精简元信息字段并增加独立轮播控件。算力指标数字、趋势图及标题图标不再使用未缩放的固定像素。欧洲使用小型 EU 字标,其他区域使用受同一比例约束的代表 emoji。

算力图标按五类选择:超算芯片、GPU 层叠、数据中心机柜、云计算云朵、边缘节点连接。几何分别来自 compute-supercomputer.svg、compute-gpu-cluster.svg、compute-hdd-network.svg、compute-cloud.svg、compute-edge.svg,保持算力图层紫色底板与原有选中行为。