@metagl/sdk-render 1.0.4 → 1.0.6

package/cjs/lacdt.render.d.ts

@@ -1,3 +1,4 @@
+import * as Cesium from 'cesium';
 import { Cartesian3, Color, Viewer, PostProcessStage, Cartesian4, Rectangle, Cesium3DTileset, ClippingPolygonCollection } from 'cesium';
 import { Render as Render$1 } from '@/system/RenderCore';
 
@@ -26,9 +27,11 @@ interface RenderSystem {
 /**
  * DirectionalLightConfig
  * @param enabled - 是否启用
- * @param direction - 方向
+ * @param followSun - 是否跟随太阳（自动模式）
+ * @param direction - 方向（手动模式）
  * @param intensity - 强度
  * @param color - 颜色
+ * @param ambientIntensity - 环境光强度
  */
 interface DirectionalLightConfig {
     enabled?: boolean;
@@ -40,53 +43,55 @@ interface DirectionalLightConfig {
 }
 /**
  * LightingSystem
- * @param viewer - Viewer
- * @param config - DirectionalLightConfig
+ *
+ * 两种完全独立互斥的光照模式：
+ * - auto (followSun=true)：仅启用 globe.enableLighting，使用 Cesium 内置太阳光
+ *   方向由 viewer.clock.currentTime 自动驱动，不创建自定义 DirectionalLight
+ * - manual (followSun=false)：创建自定义 DirectionalLight，通过 XYZ 方向控制
+ *
+ * 切换模式时必须先 disable() 清理旧状态再 enable()
  */
 declare class LightingSystem implements RenderSystem {
     private viewer;
     private config;
     private isEnabled;
-    private originalSettings?;
+    private originalGlobeLighting;
+    private originalLight;
+    private originalLightSaved;
     /**
-     * 默认配置 - 从 EnvironmentDefaults 统一管理
+     * 默认配置
      */
     private static DEFAULT_CONFIG;
-    /**
-     * 构造函数
-     * @param viewer - Viewer
-     * @param config - DirectionalLightConfig
-     */
     constructor(viewer: Viewer, config?: DirectionalLightConfig);
     /**
-     * 初始化
+     * 初始化 — 保存原始场景光照状态
      */
     initialize(): void;
     /**
-     * 保存原始设置
+     * 启用光照系统
+     * - auto 模式：仅启用 globe.enableLighting（Cesium 内置太阳光）
+     * - manual 模式：创建自定义 DirectionalLight
      */
-    private saveOriginalSettings;
+    enable(): void;
     /**
-     * 启用方向光
+     * 根据当前 config.followSun 应用对应光照模式
      */
-    enable(): void;
+    private _applyCurrentMode;
     /**
-     * 禁用方向光
+     * 禁用光照系统，恢复原始场景状态
      */
     disable(): void;
     /**
      * 更新配置
-     * @param config - DirectionalLightConfig
+     * 若系统已启用，立即重新应用光照模式
      */
     update(config: Partial<DirectionalLightConfig>): void;
     /**
      * 获取状态
-     * @returns boolean
      */
     getStatus(): boolean;
     /**
      * 获取配置
-     * @returns DirectionalLightConfig
      */
     getConfig(): DirectionalLightConfig;
     /**
@@ -596,6 +601,15 @@ interface PostProcessingConfig {
     contrast?: number;
     /** 饱和度（1.0 = 原始，0 = 灰度，>1 增强，范围 0~3.0）*/
     saturation?: number;
+    /**
+     * 暗部提亮（Shadows Lift）
+     * 将最暗区域的黑点向上提，使阴影不死黑，产生"透亮/通透"感
+     * 0.0 = 不提亮（默认黑色保持纯黑）
+     * 0.04 = 轻微提亮（推荐，建筑阴影面变深灰而非黑）
+     * 0.10 = 明显提亮（场景整体亮度感知提升）
+     * 范围：0 ~ 0.15
+     */
+    shadowsLift?: number;
     /** 色温 Kelvin（6500K = 日光中性，<6500K 暖色，>6500K 冷色，范围 3000~12000）*/
     temperature?: number;
     /** 色调（0 = 中性，-1 偏洋红，+1 偏绿，范围 -1~1）*/
@@ -730,8 +744,14 @@ declare class PostProcessingSystem implements RenderSystem {
      * 色彩调整 Shader
      * 输入：白平衡后的 sRGB [0,1]
      *
-     * 在 sRGB 空间做 contrast + saturation，与 Lightroom/达芬奇行为一致。
+     * 在 sRGB 空间做 contrast + saturation + shadowsLift，与 Lightroom/达芬奇行为一致。
      * 不做 gamma pow()，避免双重 gamma 过曝。
+     *
+     * shadowsLift（暗部提亮 / Shadows Lift）：
+     *   对暗部区域（亮度 < 0.35）做黑点提升，使深黑变为深灰。
+     *   公式：color += lift * (1.0 - color) * shadowFactor
+     *   其中 shadowFactor = smoothstep(0.35, 0.0, lum)，保证只影响暗部。
+     *   这是让建筑阴影面"透气"的关键 —— UE 的暗部从不死黑。
      */
     private getColorAdjustmentShader;
     /**
@@ -1284,6 +1304,286 @@ declare class LayerSystem implements RenderSystem {
     destroy(): void;
 }
 
+interface ViewshedConfig {
+    position: Cesium.Cartesian3;
+    heading: number;
+    pitch: number;
+    distance: number;
+    hfov: number;
+    vfov: number;
+    showFrustum?: boolean;
+    texelSnap?: boolean;
+    minHeight?: number;
+    near?: number;
+    visibleColor?: Cesium.Color;
+    hiddenColor?: Cesium.Color;
+}
+/**
+ * 视域分析系统 - 支持多视域实例和多视锥体模式
+ */
+declare class ViewshedAnalysisSystem implements RenderSystem {
+    private render;
+    private viewer;
+    private scene;
+    private viewshedInstances;
+    private activeViewshedId;
+    private enabled;
+    private eventListeners;
+    private _position;
+    private _heading;
+    private _pitch;
+    private _distance;
+    private _near;
+    private _far;
+    private _fovH;
+    private _fovV;
+    private _visibleColor;
+    private _hiddenColor;
+    private _twoPostionsEditing;
+    private _positionEditing;
+    private _rotationEditing;
+    constructor(render: any);
+    initialize(): void;
+    enable(): void;
+    disable(): void;
+    update(config: any): void;
+    getStatus(): boolean;
+    destroy(): void;
+    /**
+     * 创建新的视域分析实例
+     */
+    createViewshed(config?: Partial<ViewshedConfig>): string;
+    /**
+     * 删除视域分析实例
+     */
+    removeViewshed(id: string): void;
+    /**
+     * 显示指定视域
+     */
+    showViewshed(id: string): void;
+    /**
+     * 隐藏指定视域
+     */
+    hideViewshed(id: string): void;
+    /**
+     * 获取所有视域实例
+     */
+    getAllViewsheds(): string[];
+    /**
+     * 获取当前激活的视域ID
+     */
+    getActiveViewshedId(): string | null;
+    /**
+     * 更新视域位置
+     */
+    updatePosition(id: string, position: Cartesian3): void;
+    /**
+     * 更新视域方向
+     */
+    updateOrientation(id: string, heading: number, pitch: number): void;
+    /**
+     * 使用 direction 和 up 向量更新视域方向（参考 DirectionCameraBinding）
+     */
+    updateViewshedOrientation(id: string, position: Cesium.Cartesian3, direction: Cesium.Cartesian3, up: Cesium.Cartesian3): void;
+    /**
+     * 更新可视距离
+     */
+    updateDistance(id: string, distance: number): void;
+    /**
+     * 获取两点编辑状态（兼容旧 API）
+     */
+    getTwoPostionsEditing(): boolean;
+    /**
+     * 设置两点编辑状态（兼容旧 API）
+     * 拾取绘制功能：用户点击两个点来定义视域方向
+     */
+    setTwoPostionsEditing(value: boolean): void;
+    private _pickingEntities;
+    private _pickingPosition0;
+    private _pickingPosition1;
+    /**
+     * 创建拾取可视化（点和箭头线）
+     */
+    private createPickingVisualization;
+    /**
+     * 移除拾取可视化
+     */
+    private removePickingVisualization;
+    /**
+     * 更新拾取可视化
+     */
+    private updatePickingVisualization;
+    /**
+     * 开始拾取模式
+     */
+    private _pickingHandler;
+    private _pickingMouseMoveHandler;
+    private _pickingRightClickHandler;
+    private _pickingPositions;
+    private startPicking;
+    private stopPicking;
+    /**
+     * 获取位置编辑状态（兼容旧 API）
+     */
+    getPositionEditing(): boolean;
+    /**
+     * 设置位置编辑状态（兼容旧 API）
+     */
+    setPositionEditing(value: boolean): void;
+    /**
+     * 获取旋转编辑状态（兼容旧 API）
+     */
+    getRotationEditing(): boolean;
+    /**
+     * 设置旋转编辑状态（兼容旧 API）
+     */
+    setRotationEditing(value: boolean): void;
+    /**
+     * 获取当前视域实例（兼容旧 API）
+     */
+    getViewshed(): any;
+    /**
+     * 设置近裁（兼容旧 API）
+     */
+    setNear(value: number): void;
+    /**
+     * 设置远裁（兼容旧 API）
+     */
+    setFar(value: number): void;
+    /**
+     * 设置水平广角（兼容旧 API）
+     */
+    setFovH(value: number): void;
+    /**
+     * 设置垂直广角（兼容旧 API）
+     */
+    setFovV(value: number): void;
+    /**
+     * 开始视域分析（兼容旧 API）
+     */
+    start(): void;
+    /**
+     * 取消视域分析（兼容旧 API）
+     */
+    cancel(): void;
+    /**
+     * 从相机位置创建视域
+     */
+    createFromCurrentCamera(): string | null;
+    /**
+     * 设置当前位置为相机位置
+     */
+    setPositionWithCurrentCamera(): void;
+    on(event: string, callback: Function): void;
+    off(event: string, callback: Function): void;
+    private emitEvent;
+    /**
+     * 简化版视域分析实现（用于不支持完整 ShadowMap 的环境）
+     */
+    private static createSimplifiedViewshed;
+}
+
+interface SingleViewshedConfig {
+    position: Cesium.Cartesian3;
+    heading: number;
+    pitch: number;
+    distance: number;
+    hfov: number;
+    vfov: number;
+    showFrustum?: boolean;
+    minHeight?: number;
+    near?: number;
+}
+/**
+ * 单视域分析系统 - 使用 LACDT.Obj.Viewshed
+ */
+declare class SingleViewshedSystem implements RenderSystem {
+    private render;
+    private viewer;
+    private scene;
+    private viewshed;
+    private enabled;
+    constructor(render: any);
+    initialize(): void;
+    enable(): void;
+    disable(): void;
+    update(config: any): void;
+    getStatus(): boolean;
+    destroy(): void;
+    /**
+     * 创建单视域实例
+     */
+    createViewshed(config?: Partial<SingleViewshedConfig>): string;
+    /**
+     * 获取视域实例
+     */
+    getViewshed(): any;
+    /**
+     * 显示视域
+     */
+    showViewshed(): void;
+    /**
+     * 隐藏视域
+     */
+    hideViewshed(): void;
+    /**
+     * 获取两点编辑状态
+     */
+    getTwoPostionsEditing(): boolean;
+    /**
+     * 设置两点编辑状态（拾取模式）
+     */
+    setTwoPostionsEditing(value: boolean): void;
+    /**
+     * 获取位置编辑状态
+     */
+    getPositionEditing(): boolean;
+    /**
+     * 设置位置编辑状态
+     */
+    setPositionEditing(value: boolean): void;
+    /**
+     * 获取旋转编辑状态
+     */
+    getRotationEditing(): boolean;
+    /**
+     * 设置旋转编辑状态
+     */
+    setRotationEditing(value: boolean): void;
+    /**
+     * 设置近裁
+     */
+    setNear(value: number): void;
+    /**
+     * 设置远裁
+     */
+    setFar(value: number): void;
+    /**
+     * 设置水平广角
+     */
+    setFovH(value: number): void;
+    /**
+     * 设置垂直广角
+     */
+    setFovV(value: number): void;
+    /**
+     * 从当前相机创建视域
+     */
+    createFromCurrentCamera(): string | null;
+    /**
+     * 设置当前位置为相机位置
+     */
+    setPositionWithCurrentCamera(): void;
+    /**
+     * 开始视域分析
+     */
+    start(): void;
+    /**
+     * 取消视域分析
+     */
+    cancel(): void;
+}
+
 /**
  * 工具箱系统
  */
@@ -1291,6 +1591,8 @@ declare class ToolboxSystem implements RenderSystem {
     private tools;
     private eventListeners;
     private measurementSystem;
+    private viewshedAnalysisSystem;
+    private singleViewshedSystem;
     private render;
     private currentTileset;
     constructor(render: Render);
@@ -1330,6 +1632,18 @@ declare class ToolboxSystem implements RenderSystem {
      * 获取测量工具
      */
     getMeasurementTools(): ToolItem[];
+    /**
+     * 获取视域分析系统
+     */
+    getViewshedAnalysisSystem(): ViewshedAnalysisSystem | undefined;
+    /**
+     * 获取单视域分析系统
+     */
+    getSingleViewshedSystem(): SingleViewshedSystem | undefined;
+    /**
+     * 获取分析工具
+     */
+    getAnalysisTools(): ToolItem[];
     /**
      * 执行工具
      */
@@ -1974,94 +2288,6 @@ declare class TilesetSearchSystem implements RenderSystem {
     destroy(): void;
 }
 
-/**
- * 光照配置
- */
-interface LightingPresetConfig {
-    enabled: boolean;
-    followSun: boolean;
-    intensity: number;
-    ambientIntensity: number;
-    color: string;
-}
-/**
- * 阴影配置
- */
-interface ShadowPresetConfig {
-    enabled: boolean;
-    softShadows: boolean;
-    size: number;
-    darkness: number;
-    softness: number;
-}
-/**
- * 大气配置
- */
-interface AtmospherePresetConfig {
-    enabled: boolean;
-    intensity: number;
-    rayleighIntensity: number;
-    mieIntensity: number;
-    absorptionIntensity: number;
-}
-/**
- * 云层配置
- */
-interface CloudsPresetConfig {
-    enabled: boolean;
-    cover: number;
-    base: number;
-    top: number;
-    windSpeed: number;
-    lightIntensity: number;
-}
-/**
- * 雾效配置
- */
-interface FogPresetConfig {
-    enabled: boolean;
-    type: 'none' | 'distance' | 'height' | 'both';
-    distanceIntensity: number;
-    heightIntensity: number;
-    color: string;
-}
-/**
- * 后处理配置
- */
-interface PostProcessingPresetConfig {
-    enabled: boolean;
-    brightness: number;
-    contrast: number;
-    saturation: number;
-    gamma: number;
-}
-/**
- * 水体配置
- */
-interface WaterPresetConfig {
-    enabled: boolean;
-    color: string;
-    opacity: number;
-    waveStrength: number;
-    waveSpeed: number;
-}
-/**
- * 预设配置结构（扁平化，便于序列化）
- */
-interface EnvironmentPresetConfig {
-    time: {
-        hour: number;
-        minute: number;
-    };
-    lighting: LightingPresetConfig;
-    shadow: ShadowPresetConfig;
-    atmosphere: AtmospherePresetConfig;
-    clouds: CloudsPresetConfig;
-    fog: FogPresetConfig;
-    postProcessing: PostProcessingPresetConfig;
-    water: WaterPresetConfig;
-}
-
 /**
  * 渲染引擎配置接口
  */
@@ -2080,6 +2306,7 @@ interface RenderConfig {
     water?: WaterConfig;
     enableAll?: boolean;
     visible?: boolean;
+    preset?: string;
 }
 /**
  * 渲染引擎类
@@ -2097,6 +2324,7 @@ declare class Render {
     private heightFogSystem;
     private postProcessingSystem;
     private cameraListenerSystem;
+    private presetSystem;
     private waterSystem;
     private layerSystem;
     private toolboxSystem;
@@ -2120,6 +2348,30 @@ declare class Render {
     private ensurePostProcessStageOrder;
     private registerSystems;
     private initialize;
+    /**
+     * 全局场景质量提升
+     * 一次性配置，不受任何系统开关影响，始终生效
+     *
+     * 主要解决"不够透亮"问题：
+     *   1. perFragmentAtmosphere — 逐像素大气计算，地平线过渡更精细
+     *   2. scene.atmosphere — 统一调整天空与地球大气的亮度/饱和度
+     *   3. scene.globe 大气参数 — 让地球表面雾蒙蒙感减少，更透亮
+     *   4. lightingFactor — 提升散射光对地面的贡献
+     */
+    private applyGlobalSceneQuality;
+    /**
+     * 应用场景预设
+     * @param presetId 预设 ID，见 SCENE_PRESETS
+     */
+    applyPreset(presetId: string): void;
+    /**
+     * 清除当前预设，关闭所有环境系统
+     */
+    clearPreset(): void;
+    /**
+     * 获取当前激活的预设 ID，未激活时返回 null
+     */
+    getActivePreset(): string | null;
     /**
      * 启用所有系统
      */
@@ -2206,22 +2458,6 @@ declare class Render {
         building: BuildingSystem;
         tilesetSearch: TilesetSearchSystem;
     };
-    /**
-     * 应用环境预设（通过预设ID）
-     * RenderCore 统一的预设驱动入口
-     *
-     * 策略：预设中的 enabled 字段表示该预设是否应该启用该系统
-     * 当用户点击预设时，自动启用预设定义的系统
-     */
-    applyEnvironmentPreset(presetId: string, enableSystems?: boolean): boolean;
-    /**
-     * 将 EnvironmentPresetConfig 映射并应用到各 System
-     * 字段映射的唯一权威实现（lighting/atmosphere/clouds/fog → 对应系统名称）
-     *
-     * @param config 预设配置
-     * @param autoEnableSystems 是否自动启用预设中定义的系统
-     */
-    applyEnvironmentConfig(config: EnvironmentPresetConfig, autoEnableSystems?: boolean): void;
     /**
      * 销毁渲染引擎
      */
@@ -2373,13 +2609,12 @@ declare class EnvironmentControl {
     private createPanelHeader;
     private createPanelContent;
     private createConfigManagementSection;
-    private getPresetIcon;
     private initEventListeners;
     private switchTab;
     private initConfigEventListeners;
-    private initPresetCardListeners;
-    private handlePresetSelect;
-    private applyPresetConfig;
+    private initPresetListeners;
+    /** 根据 render.getActivePreset() 同步预设卡片高亮状态 */
+    private refreshActivePreset;
     private handleConfigImport;
     private handleConfigExport;
     private updateAllControlPanels;
@@ -2387,7 +2622,6 @@ declare class EnvironmentControl {
     private handleDisableAllEffects;
     private handleConfigReset;
     private showNotification;
-    private applyDefaultPresets;
     private resetAll;
     togglePanel(visible?: boolean): void;
     private clearPanel;
@@ -2490,10 +2724,20 @@ declare class LightingControl extends BaseControlPanel {
     private updateModeState;
     /**
      * 应用模式设置
+     *
+     * 两种光照模式完全独立互斥：
+     * - auto：仅使用 Cesium 内置太阳光（globe.enableLighting），由时钟驱动，无自定义 DirectionalLight
+     * - manual：使用自定义 DirectionalLight，由 XYZ 滑块控制方向
+     *
+     * 切换模式时必须先 disable 清理旧状态再重新 enable
      */
     private applyModeSettings;
     /**
-     * 应用光照设置
+     * 将手动模式下的滑块方向值同步到系统
+     */
+    private applyManualDirectionToSystem;
+    /**
+     * 应用光照设置（强度/颜色/环境光，不涉及模式切换）
      */
     private applyLightingSettings;
     /**
@@ -2508,14 +2752,6 @@ declare class LightingControl extends BaseControlPanel {
      * 更新太阳位置
      */
     private updateSunPosition;
-    /**
-     * 从方向向量计算高度角和方位角
-     */
-    private vectorToElevationAzimuth;
-    /**
-     * 更新手动方向
-     */
-    private updateManualDirection;
     /**
      * 应用时间预设
      * 输入时间为北京时间（UTC+8），需要转换为UTC时间
@@ -2527,8 +2763,11 @@ declare class LightingControl extends BaseControlPanel {
      */
     private applyCustomTime;
     /**
-     * 从时钟同步时间选择器
-     * UTC时间转北京时间（UTC+8）
+     * 分钟数转时间字符串 HH:MM
+     */
+    private minutesToTimeString;
+    /**
+     * 从时钟同步时间滑块（UTC → 北京时间）
      */
     private syncTimePickerFromClock;
     /**
@@ -3368,7 +3607,12 @@ declare class LayerControl extends PanelBase {
  */
 declare class ToolboxControl extends PanelBase {
     private toolboxSystem;
+    private viewshedAnalysisSystem;
+    private singleViewshedSystem;
     private isExpanded;
+    private viewshedPanel;
+    private viewshedUpdateInterval;
+    private currentViewshedToolAlias;
     constructor(render: Render$1, config?: PanelConfig);
     /**
      * 初始化面板
@@ -3398,6 +3642,10 @@ declare class ToolboxControl extends PanelBase {
      * 创建裁切工具分类
      */
     private createClippingCategory;
+    /**
+     * 创建分析工具分类
+     */
+    private createAnalysisCategory;
     /**
      * 创建裁切工具控件
      */
@@ -3447,6 +3695,35 @@ declare class ToolboxControl extends PanelBase {
      * 显示通知
      */
     private showNotification;
+    /**
+     * 显示可视域分析面板
+     * @param tool 工具项
+     */
+    private showViewshedPanel;
+    /**
+     * 绑定可视域分析面板事件
+     */
+    private bindViewshedPanelEvents;
+    /**
+     * 重置所有视域分析按钮状态
+     */
+    private resetViewshedButtonStates;
+    /**
+     * 更新视域分析按钮状态
+     */
+    private updateViewshedButtonState;
+    /**
+     * 启动视域分析UI更新
+     */
+    private startViewshedUIUpdate;
+    /**
+     * 停止视域分析UI更新
+     */
+    private stopViewshedUIUpdate;
+    /**
+     * 隐藏可视域分析面板
+     */
+    private hideViewshedPanel;
     /**
      * 刷新面板
      */
@@ -3811,6 +4088,229 @@ declare class CameraUrlManager {
     destroy(): void;
 }
 
+/**
+ * 矩形区域定义
+ */
+interface RainBounds {
+    /** 左上角经度 */
+    west: number;
+    /** 左上角纬度 */
+    north: number;
+    /** 右下角经度 */
+    east: number;
+    /** 右下角纬度 */
+    south: number;
+}
+/**
+ * 下雨系统配置接口
+ */
+interface RainConfig {
+    /** 是否启用下雨系统 */
+    enabled: boolean;
+    /** 雨滴发射率 (个/秒) */
+    emissionRate: number;
+    /** 雨滴大小 */
+    particleSize: number;
+    /** 最小生命周期(秒) */
+    minimumParticleLife: number;
+    /** 最大生命周期(秒) */
+    maximumParticleLife: number;
+    /** 最小速度 */
+    minimumSpeed: number;
+    /** 最大速度 */
+    maximumSpeed: number;
+    /** 雨滴颜色 */
+    color: Color;
+    /** 重力因子（负值向下，正值向上） */
+    gravity: number;
+    /** 下雨区域范围（矩形） */
+    bounds?: RainBounds;
+    /** 相机高度超过此值时隐藏雨滴（单位：米），默认5000 */
+    hideAltitude?: number;
+    /** 雨滴纹理图片路径，默认 './image/rain.png' */
+    imagePath?: string;
+    /** 雨滴纹理类型: 'rain' | 'hail' | 'snow' */
+    imageType?: 'rain' | 'hail' | 'snow';
+}
+/**
+ * 默认下雨配置
+ */
+declare const defaultRainConfig: RainConfig;
+/**
+ * 下雨系统类
+ * 负责管理场景中的局部下雨效果
+ */
+declare class RainSystem implements RenderSystem {
+    private viewer;
+    private config;
+    private rainParticleSystems;
+    private isInitialized;
+    private isEnabled;
+    private rainImage;
+    private hideAltitude;
+    private lastAltitudeCheck;
+    private readonly altitudeCheckInterval;
+    private shaderRainStage;
+    private useShaderRain;
+    private shaderRainHeight;
+    private currentImageType;
+    private weatherIconElement;
+    private weatherIconVisible;
+    constructor(viewer: Viewer, config?: Partial<RainConfig>);
+    /**
+     * 初始化下雨系统
+     */
+    initialize(): void;
+    /**
+     * 在指定矩形范围内创建下雨效果
+     */
+    private createRainSystemsInBounds;
+    /**
+     * 创建网格点的下雨粒子系统
+     */
+    private createGridRainSystem;
+    /**
+     * 计算发射器模型矩阵
+     * 让发射方向向下（旋转使发射器朝向地面）
+     */
+    private computeEmitterModelMatrix;
+    /**
+     * 创建雨滴纹理图像 - 使用 Canvas 程序生成细长的雨丝
+       */
+    private createRainImage;
+    /**
+     * 创建 Canvas 雨滴纹理
+     */
+    private createCanvashailImage;
+    private createCanvasSnowImage;
+    /**
+     * 设置雨滴纹理类型
+     * @param type 纹理类型: 'rain' | 'hail' | 'snow'
+     */
+    setRainImageType(type: 'rain' | 'hail' | 'snow'): void;
+    /**
+     * 设置自定义雨滴纹理路径
+     * @param imagePath 纹理图片路径，如 './image/rain.png'
+     */
+    setRainImage(imagePath: string): void;
+    /**
+     * 创建着色器雨效（后期处理方式）
+     * 参考 natureSimulate.js 的 FS_Rain 实现，兼容 WebGL 2.0
+     */
+    private createShaderRainStage;
+    /**
+     * 根据相机高度切换雨效模式
+     * 500米以内使用着色器雨效，500米以上使用粒子系统
+     */
+    private switchRainEffectMode;
+    /**
+     * 获取相机正下方地形的海拔高度
+     */
+    private getTerrainHeightBelowCamera;
+    /**
+     * 应用重力效果 - 雨滴下落
+     */
+    private applyGravity;
+    /**
+     * 根据相机高度更新雨滴可见性
+     * 当相机高度超过 hideAltitude 时隐藏雨滴，拉近时重新显示
+     * 同时更新天气图标的显示状态
+     */
+    updateCameraVisibility(): void;
+    /**
+     * 创建天气图标 DOM 元素
+     */
+    private createWeatherIcon;
+    /**
+     * 获取当前天气类型的图标信息
+     */
+    private getWeatherIconInfo;
+    /**
+     * 显示天气图标
+     */
+    private showWeatherIcon;
+    /**
+     * 隐藏天气图标
+     */
+    private hideWeatherIcon;
+    /**
+     * 更新天气图标显示内容
+     */
+    private updateWeatherIconContent;
+    /**
+     * 启用下雨系统
+     */
+    enable(): void;
+    /**
+     * 设置相机高度追踪
+     * 在每一帧渲染后检测相机高度，超过阈值时隐藏雨滴
+     * 同时根据高度切换着色器雨效和粒子系统
+     */
+    private cameraTrackingCallback;
+    /**
+     * 设置相机追踪
+     */
+    private setupCameraTracking;
+    /**
+     * 禁用下雨系统
+     */
+    disable(): void;
+    /**
+     * 更新系统配置 - 实时天气数据更新的统一公共接口
+     * 支持不同天气状态间的动态平滑过渡（例如强度由小雨转大雨，或类型由雨转雪）
+     * @param config 部分配置参数，将与现有配置合并
+     */
+    update(config: Partial<RainConfig>): void;
+    /**
+     * 更新下雨区域范围
+     * @param bounds 新的区域范围
+     */
+    private updateBounds;
+    /**
+     * 平滑过渡到新的天气强度
+     * @param targetEmissionRate 目标发射率
+     * @param duration 过渡持续时间（毫秒）
+     */
+    transitionToIntensity(targetEmissionRate: number, duration?: number): void;
+    /**
+     * 平滑过渡到新的天气类型
+     * @param targetType 目标天气类型
+     * @param duration 过渡持续时间（毫秒）
+     */
+    transitionToType(targetType: 'rain' | 'hail' | 'snow', duration?: number): void;
+    /**
+     * 获取系统状态
+     */
+    getStatus(): boolean;
+    /**
+     * 设置相机隐藏高度
+     * @param altitude 相机高度超过此值时隐藏雨滴（单位：米）
+     */
+    setHideAltitude(altitude: number): void;
+    /**
+     * 获取当前相机高度
+     */
+    getCurrentCameraHeight(): number;
+    /**
+     * 设置是否启用着色器雨效模式
+     * @param enabled 是否启用着色器雨效（相机低于500米时自动切换）
+     */
+    setShaderRainEnabled(enabled: boolean): void;
+    /**
+     * 设置着色器雨效切换高度
+     * @param height 相机高度低于此值时切换到着色器雨效（单位：米）
+     */
+    setShaderRainHeight(height: number): void;
+    /**
+     * 销毁系统
+     */
+    destroy(): void;
+    /**
+     * 获取当前配置
+     */
+    getConfig(): RainConfig;
+}
+
 declare global {
     interface Window {
         LACDT?: Record<string, any>;
@@ -3851,6 +4351,8 @@ declare const render: {
     TilesetManager: typeof TilesetManager;
     /** URL相机寻址管理 */
     CameraUrlManager: typeof CameraUrlManager;
+    /** 下雨天气系统 */
+    RainSystem: typeof RainSystem;
 };
 
-export { AtmosphereControl, type AtmosphereScatteringConfig, AtmosphereScatteringSystem, BuildingControl, BuildingSystem, CameraListener, type CameraListenerConfig, CameraListenerSystem, type CameraListenerSystemConfig, type CameraParams, CameraUrlManager, type CameraUrlManagerConfig, type DirectionalLightConfig, type DistanceFogConfig, DistanceFogSystem, EnvironmentControl, FogControl, type HeightFogConfig, HeightFogSystem, LayerControl, LayerSystem, LightingControl, LightingSystem, PlottingControl, type PostProcessingConfig, PostProcessingControl, PostProcessingSystem, Render, type RenderConfig, RenderControl, type ShadowConfig, ShadowControl, ShadowSystem, SidebarControl, TilesetManager, TilesetSearchControl, ToolboxControl, ToolboxSystem, VolumetricCloudControl, type VolumetricCloudsConfig, VolumetricCloudsSystem, type WaterConfig, WaterControl, WaterSystem, render };
+export { AtmosphereControl, type AtmosphereScatteringConfig, AtmosphereScatteringSystem, BuildingControl, BuildingSystem, CameraListener, type CameraListenerConfig, CameraListenerSystem, type CameraListenerSystemConfig, type CameraParams, CameraUrlManager, type CameraUrlManagerConfig, type DirectionalLightConfig, type DistanceFogConfig, DistanceFogSystem, EnvironmentControl, FogControl, type HeightFogConfig, HeightFogSystem, LayerControl, LayerSystem, LightingControl, LightingSystem, PlottingControl, type PostProcessingConfig, PostProcessingControl, PostProcessingSystem, type RainBounds, type RainConfig, RainSystem, Render, type RenderConfig, RenderControl, type ShadowConfig, ShadowControl, ShadowSystem, SidebarControl, TilesetManager, TilesetSearchControl, ToolboxControl, ToolboxSystem, VolumetricCloudControl, type VolumetricCloudsConfig, VolumetricCloudsSystem, type WaterConfig, WaterControl, WaterSystem, defaultRainConfig, render };