@terra.gl/core 0.0.1-alpha.61 → 0.0.1-alpha.63

package/dist/index.d.ts

@@ -29,6 +29,7 @@ import { MultiPolygon } from 'geojson';
 import { NormalBufferAttributes } from 'three';
 import { Object3D } from 'three';
 import { Object3DEventMap } from 'three';
+import { OrthographicCamera } from 'three';
 import { PerspectiveCamera } from 'three';
 import { PlaneGeometry } from 'three';
 import { Point as Point_2 } from 'geojson';
@@ -37,6 +38,7 @@ import { PointsMaterial } from 'three';
 import { Polygon as Polygon_2 } from 'geojson';
 import { Raycaster } from 'three';
 import { Scene } from 'three';
+import { ShaderMaterial } from 'three';
 import { Sprite } from 'three';
 import { Texture } from 'three';
 import { TileLoadingManager as TileLoadingManager_2 } from './LoaderFactory';
@@ -3275,6 +3277,37 @@ declare type LayerOptions = {
     depthOffset?: number;
 };
 
+/** 闪电系统 */
+declare class LightningSystem {
+    private readonly _scene;
+    private _hw;
+    private _hh;
+    private _bolts;
+    private _flashMesh;
+    private _flashOpacity;
+    private _flickerLeft;
+    private _flickerTick;
+    private _intervalMin;
+    private _intervalMax;
+    private _lastTriggerTime;
+    private _nextInterval;
+    constructor(scene: Scene);
+    /** 设置闪电间隔范围（毫秒） */
+    setTriggerInterval(min: number, max: number): void;
+    /** 获取当前间隔设置 */
+    getTriggerInterval(): [number, number];
+    trigger(): void;
+    /** 内部用：重置下次触发间隔 */
+    private _resetNextInterval;
+    /**
+     * 每帧调用，自动触发闪电
+     * @param delta 帧间隔（秒）
+     */
+    update(delta: number, now?: number): void;
+    resize(hw: number, hh: number): void;
+    dispose(): void;
+}
+
 export declare interface LightStyle extends BaseStyle {
     type: 'light';
     /** 点颜色 */
@@ -7699,6 +7732,8 @@ export declare class Viewer extends ViewerBase {
     /** 雾效因子 */
     private _fogFactor;
     private _sceneSize;
+    /** 天气效果实例 */
+    private _weatherEffect;
     /** 地面网格 */
     private gorund;
     /** 地图实例 */
@@ -7921,6 +7956,54 @@ export declare class Viewer extends ViewerBase {
      */
     getWidthHeight(): number[];
     _createGorund(): Mesh<PlaneGeometry, MeshStandardMaterial, Object3DEventMap>;
+    /**
+     * 初始化天气效果
+     * 内部方法，由构造函数调用
+     * @private
+     */
+    private _initWeather;
+    /**
+     * 设置天气效果
+     * @param type 天气类型：'rain' | 'snow' | 'fog' | null（关闭）
+     * @param options 额外配置项
+     * @returns this
+     * @example
+     * viewer.setWeather('rain');
+     * viewer.setWeather('snow', { speed: 0.5 });
+     * viewer.setWeather('fog', { opacity: 0.8, speed: 1.5 });
+     * viewer.setWeather(null); // 关闭天气效果
+     */
+    setWeather(type: WeatherType | null, options?: WeatherEffectOptions): this;
+    /**
+     * 获取当前天气效果实例
+     * 用于直接操作 shader uniforms 等高级用法
+     * @returns WeatherEffect 实例或 null
+     */
+    getWeatherEffect(): WeatherEffect | null;
+    /**
+     * 设置天气速度（雨/雾）
+     * @param speed 速度值
+     * @returns this
+     */
+    setWeatherSpeed(speed: number): this;
+    /**
+     * 设置天气透明度/浓度
+     * @param opacity 透明度值
+     * @returns this
+     */
+    setWeatherOpacity(opacity: number): this;
+    /**
+     * 设置雨倾斜角度
+     * @param angle 角度（弧度）
+     * @returns this
+     */
+    setWeatherRainAngle(angle: number): this;
+    /**
+     * 设置雨量/雨强（0.0 ~ 1.0）
+     * @param intensity 雨强值，值越大雨滴越多/越密
+     * @returns this
+     */
+    setWeatherRainIntensity(intensity: number): this;
     /**
      * 销毁viewer实例，释放所有资源
      * @description
@@ -8070,6 +8153,19 @@ export declare type ViewerOptions = {
     minDistance?: number;
     /** Maximum controller zoom distance (how far the camera can move), default is 60000 控制器最大缩放距离（相机能拉多远），默认为 60000 */
     maxDistance?: number;
+    /** 天气效果配置（可选） Weather effect configuration */
+    weather?: {
+        /** 天气类型：'rain' | 'snow' | 'fog' | null */
+        type?: WeatherType | null;
+        /** 速度（雨/雾），默认 1.0 */
+        speed?: number;
+        /** 透明度/浓度（雾），默认 1.0 */
+        opacity?: number;
+        /** 雨倾斜角度（弧度），默认 -0.1 */
+        rainAngle?: number;
+        /** 雨量/雨强（0.0 ~ 1.0），默认 1.0 */
+        rainIntensity?: number;
+    };
 };
 
 /**
@@ -8082,6 +8178,95 @@ export declare function waitFor(condition: boolean, delay?: number): Promise<voi
  */
 export declare type WaterStyle = BaseWaterStyle | LightWaterStyle;
 
+export declare class WeatherEffect {
+    /** 天气专用正交场景 */
+    readonly scene: Scene;
+    /** 天气专用正交相机 */
+    readonly camera: OrthographicCamera;
+    /** 全屏 mesh */
+    readonly mesh: Mesh;
+    /** 雨材质 */
+    readonly rainMaterial: ShaderMaterial;
+    /** 雪材质 */
+    readonly snowMaterial: ShaderMaterial;
+    /** 雾材质 */
+    readonly fogMaterial: ShaderMaterial;
+    /** 闪电系统 */
+    readonly lightningSystem: LightningSystem;
+    /** 当前天气类型 */
+    private _type;
+    /** 当前激活的材质 */
+    private _activeMaterial;
+    /**
+     * 构造函数
+     * @param width 容器宽度
+     * @param height 容器高度
+     * @param options 初始化配置
+     */
+    constructor(width: number, height: number, options?: WeatherEffectOptions);
+    /** 获取当前天气类型 */
+    get type(): WeatherType | null;
+    /**
+     * 切换天气类型
+     * @param type 天气类型，为 null 时关闭天气效果
+     */
+    setWeather(type: WeatherType | null): this;
+    /**
+     * 设置速度（雨 speed / 雾 speed）
+     * @param speed 速度值
+     */
+    setSpeed(speed: number): this;
+    /**
+     * 设置透明度/浓度
+     * @param opacity 透明度值
+     */
+    setOpacity(opacity: number): this;
+    /**
+     * 设置雨倾斜角度（弧度）
+     * @param angle 角度（弧度）
+     */
+    setRainAngle(angle: number): this;
+    /**
+     * 设置雨量/雨强（0.0 ~ 1.0）
+     * @param intensity 雨强值，值越大雨滴越多/越密
+     */
+    setRainIntensity(intensity: number): this;
+    /**
+     * 触发一次闪电（可随时调用，常配合雷暴天气使用）
+     */
+    triggerLightning(): void;
+    /**
+     * 每帧调用，更新 iTime uniform
+     * @param delta 帧间隔时间（秒）
+     */
+    update(delta: number): void;
+    /**
+     * 响应容器尺寸变化
+     * @param width 新宽度
+     * @param height 新高度
+     */
+    resize(width: number, height: number): void;
+    /** 销毁资源 */
+    dispose(): void;
+}
+
+/** 天气效果配置选项 */
+export declare interface WeatherEffectOptions {
+    /** 默认天气类型，默认为 null（无天气） */
+    type?: WeatherType | null;
+    /** 速度（雨/雾），默认 1.0 */
+    speed?: number;
+    /** 透明度/浓度，默认 1.0 */
+    opacity?: number;
+    /** 雨倾斜角度（弧度），默认 -0.1 */
+    rainAngle?: number;
+    /** 雨量/雨强（0.0 ~ 1.0），默认 1.0 */
+    rainIntensity?: number;
+}
+
+/** 天气类型 */
+export declare type WeatherType = 'rain' | 'snow' | 'fog';
+
 /**
  * WMTS标准瓦片数据源
  * @description 实现OGC WMTS 1.0.0标准的瓦片数据源