@metagl/sdk-render 1.0.9 → 1.0.11

package/lacdt.render.d.ts

@@ -1,6 +1,7 @@
-import * as Cesium from 'cesium';
+import * as Cesium$1 from 'cesium';
 import { Cartesian3, Color, Viewer, PostProcessStage, Cartesian4, Rectangle, Primitive, Cesium3DTileset, ClippingPolygonCollection } from 'cesium';
 import { Render as Render$1 } from '@/system/RenderCore';
+import { VectorTileset } from '@metagl/sdk-mbtiles';
 
 /**
  * RenderSystem
@@ -233,6 +234,8 @@ interface VolumetricCloudsConfig {
     cloudThickness?: number;
     cloudLightIntensity?: number;
     cloudIntensity?: number;
+    cloudOpacityMin?: number;
+    cloudOpacityMax?: number;
     visibility?: CloudVisibilityConfig;
 }
 /**
@@ -527,6 +530,12 @@ interface HeightFogConfig {
     enabled?: boolean;
     fogByHeight?: Cartesian4;
     fogColor?: Color;
+    /** Henyey-Greenstein 前向散射系数 [0,1]，默认 0.70 */
+    fogG?: number;
+    /** 太阳方向散射强度乘数，默认 1.2 */
+    fogScattering?: number;
+    /** 环境光散射占比 [0,1]，默认 0.25 */
+    fogAmbient?: number;
     visibility?: FogVisibilityConfig;
 }
 /**
@@ -732,6 +741,8 @@ declare class PostProcessingSystem implements RenderSystem {
     disable(): void;
     update(config: Partial<PostProcessingConfig>): void;
     getStatus(): boolean;
+    /** 返回当前已加入队列的自定义 Stage 列表（供 RenderCore 做顺序修正）*/
+    getCustomStages(): PostProcessStage[];
     getConfig(): PostProcessingConfig;
     saveConfig(): any;
     destroy(): void;
@@ -1131,6 +1142,10 @@ declare class WaterSystem implements RenderSystem {
      * 直接修改已存在水图元的材质参数
      */
     updateWaterLayerEffect(config: Partial<WaterConfig>): void;
+    /**
+     * 更新单个图元的材质参数
+     */
+    private updateSinglePrimitiveMaterial;
     /**
      * 获取系统状态
      */
@@ -1471,7 +1486,7 @@ declare class LayerSystem implements RenderSystem {
 }
 
 interface ViewshedConfig {
-    position: Cesium.Cartesian3;
+    position: Cesium$1.Cartesian3;
     heading: number;
     pitch: number;
     distance: number;
@@ -1481,8 +1496,8 @@ interface ViewshedConfig {
     texelSnap?: boolean;
     minHeight?: number;
     near?: number;
-    visibleColor?: Cesium.Color;
-    hiddenColor?: Cesium.Color;
+    visibleColor?: Cesium$1.Color;
+    hiddenColor?: Cesium$1.Color;
 }
 /**
  * 视域分析系统 - 支持多视域实例和多视锥体模式
@@ -1550,7 +1565,7 @@ declare class ViewshedAnalysisSystem implements RenderSystem {
     /**
      * 使用 direction 和 up 向量更新视域方向（参考 DirectionCameraBinding）
      */
-    updateViewshedOrientation(id: string, position: Cesium.Cartesian3, direction: Cesium.Cartesian3, up: Cesium.Cartesian3): void;
+    updateViewshedOrientation(id: string, position: Cesium$1.Cartesian3, direction: Cesium$1.Cartesian3, up: Cesium$1.Cartesian3): void;
     /**
      * 更新可视距离
      */
@@ -1650,7 +1665,7 @@ declare class ViewshedAnalysisSystem implements RenderSystem {
 }
 
 interface SingleViewshedConfig {
-    position: Cesium.Cartesian3;
+    position: Cesium$1.Cartesian3;
     heading: number;
     pitch: number;
     distance: number;
@@ -2511,6 +2526,9 @@ declare class Render {
      *
      * 修正方式：直接操作 PostProcessStageCollection 的内部 _stages 数组调整顺序，
      * 不调用 remove()（remove 会 destroy GPU 资源），不触发 Shader 重编译，无视觉闪烁。
+     *
+     * 目标顺序：云 → 大气 → 后处理(whiteBalance/colorAdjustment/...)
+     * 原因：后处理的 exposure 等效果作用在大气之后才正确；大气需读取未经后处理的原始场景。
      */
     private ensurePostProcessStageOrder;
     private registerSystems;
@@ -2535,6 +2553,11 @@ declare class Render {
      * 清除当前预设，关闭所有环境系统
      */
     clearPreset(): void;
+    /**
+     * 重置所有环境系统到默认配置（单一出口）
+     * 等效于 applyConfig(DEFAULT_CONFIG)，所有系统参数回到 DefaultConfig.ts 定义的值并禁用。
+     */
+    resetConfig(): void;
     /**
      * 获取当前激活的预设 ID，未激活时返回 null
      */
@@ -2543,6 +2566,19 @@ declare class Render {
      * 启用所有系统
      */
     enableAllSystems(): void;
+    /**
+     * 以 DefaultConfig 参数启用所有环境系统
+     *
+     * 与直接调用 enableSystem() 的区别：
+     *   - 先将所有系统参数重置为 DefaultConfig（清除预设残留）
+     *   - 再启用所有环境系统
+     *
+     * 解决问题：
+     *   "全部开启"按钮点击时，若之前曾应用过预设，系统内部仍持有预设参数
+     *   （如 ACES 色调映射 / exposure 1.20 / 暖色温），导致视觉结果与 DefaultConfig 不一致。
+     *   此方法保证"全部开启"始终以 DefaultConfig 参数运行。
+     */
+    enableAllWithDefaults(): void;
     /**
      * 禁用所有系统
      */
@@ -4495,227 +4531,173 @@ declare class CameraUrlManager {
     destroy(): void;
 }
 
-/**
- * 矩形区域定义
- */
-interface RainBounds {
-    /** 左上角经度 */
-    west: number;
-    /** 左上角纬度 */
-    north: number;
-    /** 右下角经度 */
-    east: number;
-    /** 右下角纬度 */
-    south: number;
+interface WeatherAreaData {
+    gger: string;
+    minLon: number;
+    maxLon: number;
+    minLat: number;
+    maxLat: number;
+    weatherType: 'rainy' | 'snowy' | 'foggy' | 'sunny';
 }
-/**
- * 下雨系统配置接口
- */
-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 class RainSystem {
+    private _viewer;
+    private _effects;
+    private _anchorEntities;
+    private _allAreas;
+    private _lastCameraPosition;
+    private _effectPaused;
+    private _isPageVisible;
+    private _isWindowFocused;
+    private _rainCanvas;
+    private _snowCanvas;
+    private _fogCanvas;
+    private readonly MAX_EFFECTS;
+    private readonly UPDATE_THRESHOLD;
+    private _pendingAdd;
+    private _pendingRemove;
+    private _isUpdating;
+    private _lastUpdateTime;
+    private readonly THROTTLE_MS;
+    private _tickHandler;
+    constructor(viewer: any, Cesium?: any);
+    /**
+     * 从JSON数组加载天气效果
+     */
+    loadFromJson(areas: WeatherAreaData[]): void;
+    private _setupVisibilityHandler;
+    private _updatePauseState;
+    private _setEffectsPaused;
+    private _pauseAllEffects;
+    private _resumeAllEffects;
+    private _startCameraWatch;
+    private _scheduleUpdate;
+    private _computePendingChanges;
+    private _processNextPending;
+    private _updateVisibleEffects;
+    private _getVisibleAreas;
+    /**
+     * 添加单个天气区域
+     */
+    addWeatherArea(area: WeatherAreaData): void;
+    /**
+     * 移除指定区域天气效果
+     */
+    removeWeatherArea(id: string): void;
+    /**
+     * 清空所有天气效果
+     */
+    clearAll(): void;
+    private _createSunnyEffect;
+    private _createRainEffect;
+    private _createSnowEffect;
+    private _createFogEffect;
+    private _createSunCoreCanvas;
+    private _createRainCanvas;
+    private _createSnowCanvas;
+    private _createFogCanvas;
+    private _getParticleSystemMatrix;
+}
+
+interface VectorTileSystemConfig {
+    enabled?: boolean;
+    style?: string | object;
+    showTileColor?: boolean;
+    workerUrl?: string;
+    maximumActiveTasks?: number;
 }
 /**
- * 默认下雨配置
- */
-declare const defaultRainConfig: RainConfig;
-/**
- * 下雨系统类
- * 负责管理场景中的局部下雨效果
+ * 矢量瓦片系统类
+ * 用于加载和显示Mapbox矢量瓦片
+ * 参考: sdk-mbtiles/examples/index.js
  */
-declare class RainSystem implements RenderSystem {
+declare class VectorTileSystem {
     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 config;
+    private tileset;
+    private style;
+    constructor(viewer: Cesium.Viewer, config?: VectorTileSystemConfig);
     /**
-     * 获取当前天气类型的图标信息
+     * 初始化系统
      */
-    private getWeatherIconInfo;
+    private init;
     /**
-     * 显示天气图标
+     * 设置样式并重新加载
+     * @param style Mapbox样式URL或样式对象
      */
-    private showWeatherIcon;
+    setStyle(style: string | object): Promise<void>;
     /**
-     * 隐藏天气图标
+     * 获取当前样式
      */
-    private hideWeatherIcon;
+    getStyle(): string | object | null;
     /**
-     * 更新天气图标显示内容
+     * 设置图层布局属性
+     * @param layerId 图层ID
+     * @param name 属性名
+     * @param value 属性值
      */
-    private updateWeatherIconContent;
+    setLayoutProperty(layerId: string, name: string, value: any): boolean;
     /**
-     * 启用下雨系统
+     * 设置图层绘制属性
+     * @param layerId 图层ID
+     * @param name 属性名
+     * @param value 属性值
      */
-    enable(): void;
+    setPaintProperty(layerId: string, name: string, value: any): boolean;
     /**
-     * 设置相机高度追踪
-     * 在每一帧渲染后检测相机高度，超过阈值时隐藏雨滴
-     * 同时根据高度切换着色器雨效和粒子系统
+     * 设置图层过滤器
+     * @param layerId 图层ID
+     * @param filter 过滤器
      */
-    private cameraTrackingCallback;
+    setFilter(layerId: string, filter: any): boolean;
     /**
-     * 设置相机追踪
+     * 获取矢量瓦片集实例
      */
-    private setupCameraTracking;
+    getTileset(): VectorTileset | null;
     /**
-     * 禁用下雨系统
+     * 获取就绪状态
      */
-    disable(): void;
+    isReady(): boolean;
     /**
-     * 更新系统配置 - 实时天气数据更新的统一公共接口
-     * 支持不同天气状态间的动态平滑过渡（例如强度由小雨转大雨，或类型由雨转雪）
-     * @param config 部分配置参数，将与现有配置合并
+     * 设置显示状态
      */
-    update(config: Partial<RainConfig>): void;
+    setVisible(visible: boolean): void;
     /**
-     * 更新下雨区域范围
-     * @param bounds 新的区域范围
+     * 获取显示状态
      */
-    private updateBounds;
+    getVisible(): boolean;
     /**
-     * 平滑过渡到新的天气强度
-     * @param targetEmissionRate 目标发射率
-     * @param duration 过渡持续时间（毫秒）
+     * 启用系统
      */
-    transitionToIntensity(targetEmissionRate: number, duration?: number): void;
+    enable(): Promise<void>;
     /**
-     * 平滑过渡到新的天气类型
-     * @param targetType 目标天气类型
-     * @param duration 过渡持续时间（毫秒）
+     * 禁用系统
      */
-    transitionToType(targetType: 'rain' | 'hail' | 'snow', duration?: number): void;
+    disable(): Promise<void>;
     /**
-     * 获取系统状态
+     * 获取启用状态
      */
     getStatus(): boolean;
     /**
-     * 设置相机隐藏高度
-     * @param altitude 相机高度超过此值时隐藏雨滴（单位：米）
+     * 切换启用状态
      */
-    setHideAltitude(altitude: number): void;
+    toggle(): Promise<boolean>;
     /**
-     * 获取当前相机高度
+     * 更新配置
      */
-    getCurrentCameraHeight(): number;
+    update(newConfig: Partial<VectorTileSystemConfig>): Promise<void>;
     /**
-     * 设置是否启用着色器雨效模式
-     * @param enabled 是否启用着色器雨效（相机低于500米时自动切换）
+     * 获取当前配置
      */
-    setShaderRainEnabled(enabled: boolean): void;
+    getConfig(): VectorTileSystemConfig;
     /**
-     * 设置着色器雨效切换高度
-     * @param height 相机高度低于此值时切换到着色器雨效（单位：米）
+     * 移除矢量瓦片集
      */
-    setShaderRainHeight(height: number): void;
+    private removeTileset;
     /**
      * 销毁系统
      */
-    destroy(): void;
-    /**
-     * 获取当前配置
-     */
-    getConfig(): RainConfig;
+    destroy(): Promise<void>;
 }
 
 declare global {
@@ -4762,6 +4744,8 @@ declare const render: {
     RainSystem: typeof RainSystem;
     /** 海洋系统 */
     SeaSystem: typeof SeaSystem;
+    /** 矢量瓦片系统 */
+    VectorTileSystem: typeof VectorTileSystem;
 };
 
-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 SeaConfig, SeaSystem, type ShadowConfig, ShadowControl, ShadowSystem, SidebarControl, TilesetManager, TilesetSearchControl, ToolboxControl, ToolboxSystem, VolumetricCloudControl, type VolumetricCloudsConfig, VolumetricCloudsSystem, type WaterConfig, WaterControl, WaterSystem, defaultRainConfig, 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, RainSystem, Render, type RenderConfig, RenderControl, type SeaConfig, SeaSystem, type ShadowConfig, ShadowControl, ShadowSystem, SidebarControl, TilesetManager, TilesetSearchControl, ToolboxControl, ToolboxSystem, VectorTileSystem, VolumetricCloudControl, type VolumetricCloudsConfig, VolumetricCloudsSystem, type WaterConfig, WaterControl, WaterSystem, type WeatherAreaData, render };