@metagl/sdk-render 0.0.1 → 0.0.2

package/cjs/lacdt.render.d.ts

@@ -1837,6 +1837,94 @@ 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;
+}
+
 /**
  * 渲染引擎配置接口
  */
@@ -1975,6 +2063,16 @@ declare class Render {
         building: BuildingSystem;
         tilesetSearch: TilesetSearchSystem;
     };
+    /**
+     * 应用环境预设（通过预设ID）
+     * RenderCore 统一的预设驱动入口
+     */
+    applyEnvironmentPreset(presetId: string): boolean;
+    /**
+     * 将 EnvironmentPresetConfig 映射并应用到各 System
+     * 字段映射的唯一权威实现（lighting/atmosphere/clouds/fog → 对应系统名称）
+     */
+    applyEnvironmentConfig(config: EnvironmentPresetConfig): void;
     /**
      * 销毁渲染引擎
      */
@@ -2146,94 +2244,6 @@ declare class EnvironmentControl {
     private clearPanel;
 }
 
-/**
- * 光照配置
- */
-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;
-}
-
 /**
  * 控制面板基类
  * 所有控制面板继承此类，统一配置管理
@@ -2242,12 +2252,7 @@ declare abstract class BaseControlPanel {
     protected viewer: Viewer;
     protected render: Render;
     protected renderConfig: RenderConfig;
-    protected configUnsubscribe: (() => void) | null;
     constructor(viewer: Viewer, render: Render, renderConfig: RenderConfig);
-    /**
-     * 设置配置监听器
-     */
-    private setupConfigListener;
     /**
      * 创建控制面板
      */
@@ -2280,22 +2285,6 @@ declare abstract class BaseControlPanel {
      * 更新滑块视觉
      */
     updateSliderVisual(slider: HTMLInputElement): void;
-    /**
-     * 配置更新时的回调
-     */
-    protected onConfigUpdated(config: EnvironmentPresetConfig): void;
-    /**
-     * 刷新控制面板显示（子类必须实现）
-     */
-    protected abstract refreshControls(config: EnvironmentPresetConfig): void;
-    /**
-     * 获取当前配置
-     */
-    protected getCurrentConfig(): EnvironmentPresetConfig;
-    /**
-     * 更新系统配置
-     */
-    protected updateSystemConfig<K extends keyof EnvironmentPresetConfig>(system: K, config: Partial<EnvironmentPresetConfig[K]>): void;
     /**
      * 颜色对象转十六进制字符串
      */
@@ -2316,6 +2305,10 @@ declare abstract class BaseControlPanel {
      * 重置面板设置
      */
     abstract reset(): void;
+    /**
+     * 刷新控制面板显示（由 render-config-updated 事件触发）
+     */
+    protected abstract refreshControls(config: any): void;
     /**
      * 获取面板容器
      */

package/esm/lacdt.render.d.ts

@@ -1837,6 +1837,94 @@ 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;
+}
+
 /**
  * 渲染引擎配置接口
  */
@@ -1975,6 +2063,16 @@ declare class Render {
         building: BuildingSystem;
         tilesetSearch: TilesetSearchSystem;
     };
+    /**
+     * 应用环境预设（通过预设ID）
+     * RenderCore 统一的预设驱动入口
+     */
+    applyEnvironmentPreset(presetId: string): boolean;
+    /**
+     * 将 EnvironmentPresetConfig 映射并应用到各 System
+     * 字段映射的唯一权威实现（lighting/atmosphere/clouds/fog → 对应系统名称）
+     */
+    applyEnvironmentConfig(config: EnvironmentPresetConfig): void;
     /**
      * 销毁渲染引擎
      */
@@ -2146,94 +2244,6 @@ declare class EnvironmentControl {
     private clearPanel;
 }
 
-/**
- * 光照配置
- */
-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;
-}
-
 /**
  * 控制面板基类
  * 所有控制面板继承此类，统一配置管理
@@ -2242,12 +2252,7 @@ declare abstract class BaseControlPanel {
     protected viewer: Viewer;
     protected render: Render;
     protected renderConfig: RenderConfig;
-    protected configUnsubscribe: (() => void) | null;
     constructor(viewer: Viewer, render: Render, renderConfig: RenderConfig);
-    /**
-     * 设置配置监听器
-     */
-    private setupConfigListener;
     /**
      * 创建控制面板
      */
@@ -2280,22 +2285,6 @@ declare abstract class BaseControlPanel {
      * 更新滑块视觉
      */
     updateSliderVisual(slider: HTMLInputElement): void;
-    /**
-     * 配置更新时的回调
-     */
-    protected onConfigUpdated(config: EnvironmentPresetConfig): void;
-    /**
-     * 刷新控制面板显示（子类必须实现）
-     */
-    protected abstract refreshControls(config: EnvironmentPresetConfig): void;
-    /**
-     * 获取当前配置
-     */
-    protected getCurrentConfig(): EnvironmentPresetConfig;
-    /**
-     * 更新系统配置
-     */
-    protected updateSystemConfig<K extends keyof EnvironmentPresetConfig>(system: K, config: Partial<EnvironmentPresetConfig[K]>): void;
     /**
      * 颜色对象转十六进制字符串
      */
@@ -2316,6 +2305,10 @@ declare abstract class BaseControlPanel {
      * 重置面板设置
      */
     abstract reset(): void;
+    /**
+     * 刷新控制面板显示（由 render-config-updated 事件触发）
+     */
+    protected abstract refreshControls(config: any): void;
     /**
      * 获取面板容器
      */