@baidumap/mapv-three 1.3.3 → 1.4.0

package/dist/types/threemap/natural/PhysicalSky.d.ts

@@ -0,0 +1,220 @@
+/**
+ * 动态天空继承自 {@link EmptySky}，提供高级的大气层渲染、光照变化和云层效果，可以根据时间自动变化光照和天空外观。
+ * 支持体积云、大气散射以及环境反射烘培，为3D场景提供真实感的天空和照明效果。
+ *
+ * @category Natural
+ * @example
+ * ```javascript
+ * // 创建动态天空
+ * const sky = engine.add(new mapvthree.PhysicalSky());
+ *
+ * // 设置时间为下午5:30
+ * sky.time = 3600 * 17.5;
+ * ```
+ */
+export class PhysicalSky extends EmptySky {
+    /**
+     * 标识为PhysicalSky对象
+     * @type {boolean}
+     * @readonly
+     */
+    readonly isPhysicalSky: boolean;
+    /** @private */ private _rtFlipCount;
+    /** @private */ private _skyNeedsCapture;
+    /** @private */ private _skyNeedsUpdate;
+    /** @private */ private _staticEnvMapNeedsUpdate;
+    /** @private */ private _realtimeCapture;
+    /** @private */ private _envMapType;
+    /** @private */ private _PMREMGenerator;
+    /** @private */ private _cloud;
+    /** @private */ private _envRenderTarget1;
+    /** @private */ private _envRenderTarget2;
+    /** @private */ private _skyAtmosphere;
+    /** @private */ private _lastCameraZ;
+    /**
+     * 天空名称
+     * @type {string}
+     * @readonly
+     */
+    readonly name: string;
+    _currentTime: Date;
+    _presetWeatherProperties: {
+        clear: {
+            sunLightIntensity: number;
+            skyLightIntensity: number;
+            cloudsCoverage: number;
+        };
+        partlyCloudy: {
+            sunLightIntensity: number;
+            skyLightIntensity: number;
+            cloudsCoverage: number;
+        };
+        cloudy: {
+            sunLightIntensity: number;
+            skyLightIntensity: number;
+            cloudsCoverage: number;
+        };
+        overcast: {
+            sunLightIntensity: number;
+            skyLightIntensity: number;
+            cloudsCoverage: number;
+        };
+        foggy: {
+            sunLightIntensity: number;
+            skyLightIntensity: number;
+            cloudsCoverage: number;
+        };
+        rainy: {
+            sunLightIntensity: number;
+            skyLightIntensity: number;
+            cloudsCoverage: number;
+        };
+        snowy: {
+            sunLightIntensity: number;
+            skyLightIntensity: number;
+            cloudsCoverage: number;
+        };
+        stormy: {
+            sunLightIntensity: number;
+            skyLightIntensity: number;
+            cloudsCoverage: number;
+        };
+    };
+    _upDirection: any;
+    _currentParameters: {
+        sunDirection: any;
+        moonDirection: any;
+        transmittanceTexture: null;
+        scatteringTexture: null;
+        irradianceTexture: null;
+        singleMieScatteringTexture: null;
+        higherOrderScatteringTexture: null;
+        stbnTexture: null;
+        overlay: null;
+        atmosphereShadow: null;
+        atmosphereShadowLength: null;
+        sunLight: any;
+        skyLight: any;
+        worldToECEFMatrix: any;
+        correctAltitude: boolean;
+        windDirection: any;
+        cloudsSpeed: number;
+    };
+    _engine: any;
+    _skyCamera: any;
+    _precomputedTexturesGenerator: PrecomputedTexturesGenerator | undefined;
+    _skyMaterial: SkyMaterial | undefined;
+    _oldToneMappingExposure: any;
+    _oldToneMapping: any;
+    /**
+     * 初始化环境和大气效果
+     * @internal
+     */
+    initEnv(): void;
+    _atmospherePass: AtmospherePostPass | undefined;
+    _cloudsPass: CloudsPostPass | undefined;
+    _lensFlarePass: any;
+    _hasGeneratedTextures: boolean | undefined;
+    _syncSkyAndClouds(): void;
+    /**
+     * 获取纹理资源
+     * @internal
+     * @returns {Object} 纹理对象列表
+     */
+    getTextures(): Object;
+    /**
+     * 释放环境贴图资源
+     * @param {number} type 环境贴图类型
+     * @private
+     */
+    private disposeEnvRenderTarget;
+    /**
+     * 设置是否启用后处理通道
+     * @type {boolean}
+     * @internal
+     */
+    set enableAtmospherePass(value: boolean);
+    /**
+     * 获取是否启用后处理通道
+     * @type {boolean}
+     * @internal
+     */
+    get enableAtmospherePass(): boolean;
+    /**
+     * 设置是否启用体积云效果
+     * @type {boolean}
+     * @internal
+     */
+    set enableCloudsPass(value: boolean);
+    /**
+     * 获取是否启用体积云效果
+     * @type {boolean}
+     * @internal
+     */
+    get enableCloudsPass(): boolean;
+    set enableCloudsShadow(value: boolean);
+    get enableCloudsShadow(): boolean;
+    /**
+     * 天空颜色是否影响场景颜色
+     * @type {boolean}
+     * @internal
+     */
+    set affectWorld(value: boolean);
+    /**
+     * 天空颜色是否影响场景颜色
+     * @type {boolean}
+     * @internal
+     */
+    get affectWorld(): boolean;
+    /**
+     * 设置是否实时捕获环境
+     * @type {boolean}
+     * @internal
+     */
+    set realtimeCapture(value: boolean);
+    /**
+     * 获取是否实时捕获环境
+     * @type {boolean}
+     * @internal
+     */
+    get realtimeCapture(): boolean;
+    /**
+     * 设置云层覆盖率
+     * @type {number}
+     * @internal
+     */
+    set cloudsCoverage(value: number);
+    /**
+     * 云层覆盖率，范围0-1
+     * @type {number}
+     * @internal
+     */
+    get cloudsCoverage(): number;
+    /**
+     * 设置云层移动速度
+     * @type {number}
+     * @internal
+     */
+    set cloudsSpeed(value: number);
+    /**
+     * 云层移动速度
+     * @type {number}
+     * @internal
+     */
+    get cloudsSpeed(): number;
+    set windDirection(value: any);
+    get windDirection(): any;
+    set cloudsBaseHeight(value: number);
+    get cloudsBaseHeight(): number;
+    /**
+     * 获取向上方向
+     * @type {Vector3}
+     * @internal
+     */
+    get upDirection(): Vector3;
+}
+import { EmptySky } from './EmptySky';
+import { PrecomputedTexturesGenerator } from './sky/PrecomputedTexturesGenerator';
+import { SkyMaterial } from './sky/SkyMaterial';
+import { AtmospherePostPass } from './sky/AtmospherePostPass';
+import { CloudsPostPass } from './clouds/CloudsPostPass';

package/dist/types/threemap/natural/Rain.d.ts

@@ -1,10 +1,13 @@
 export class Rain {
-    constructor(renderer: any, camera: any);
+    constructor(renderer: any, camera: any, options?: {});
+    _density: number;
     _clock: any;
     _system: any;
     _emitter: any;
-    update: () => void;
+    update: (engine: any) => void;
     createRain: () => any;
     createEmitter: () => any;
+    set density(value: number);
+    get density(): number;
     dispose(): void;
 }

package/dist/types/threemap/natural/Snow.d.ts

@@ -1,12 +1,15 @@
 export class Snow {
-    constructor(renderer: any, camera: any);
+    constructor(renderer: any, camera: any, options?: {});
     _renderer: any;
     _camera: any;
+    _density: number;
     _clock: any;
     _system: any;
     _emitter: any;
-    update: () => void;
+    update: (engine: any) => void;
     createSnow: () => any;
     createEmitter: () => any;
+    set density(value: number);
+    get density(): number;
     dispose(): void;
 }

package/dist/types/threemap/natural/StaticSky.d.ts

@@ -26,6 +26,7 @@ export class StaticSky extends CustomStaticSky {
      * @readonly
      */
     readonly name: string;
+    /** @internal */ weather: string;
     /** @internal */ _phase: string;
     /** @internal */ _lastPhase: null;
     /** @internal */ _lastWeather: null;

package/dist/types/threemap/natural/Thunderstorm.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 闪电形状
+ *           *
+ *          *
+ *         ***
+ *          *
+ *         *
+ */
+export class Thunderstorm {
+    constructor(renderer: any, camera: any, options?: {});
+    _clock: any;
+    _renderer: any;
+    _camera: any;
+    _lightningInterval: number;
+    _lastLightningTime: number;
+    _mainLightning: any;
+    sceneSize: number;
+    _createRainSystem(): any;
+    _createLightningEffect(): void;
+    _lightningMaterial: LightningMaterial | undefined;
+    _lightningContainer: any;
+    _generateLightningPath(): any;
+    update(): void;
+    _updateLightning(delta: any): void;
+    _triggerLightning(): void;
+    set density(value: any);
+    get density(): any;
+    _density: any;
+    dispose(): void;
+}
+import { LightningMaterial } from '../../threejs/materials/effects/LightningMaterial';

package/dist/types/threemap/natural/clouds/CascadedShadowMaps.d.ts

@@ -0,0 +1,31 @@
+export namespace cascadedShadowMapsDefaults {
+    let maxFar: null;
+    let farScale: number;
+    let splitMode: string;
+    let splitLambda: number;
+    let margin: number;
+    let fade: boolean;
+}
+export class CascadedShadowMaps {
+    constructor(options: any);
+    cascades: any[];
+    mapSize: any;
+    maxFar: any;
+    farScale: any;
+    splitMode: any;
+    splitLambda: any;
+    margin: any;
+    fade: any;
+    cameraFrustum: FrustumCorners;
+    frusta: any[];
+    splits: any[];
+    _far: number;
+    set cascadeCount(value: number);
+    get cascadeCount(): number;
+    get far(): number;
+    updateIntervals(camera: any): void;
+    getFrustumRadius(camera: any, frustum: any): number;
+    updateMatrices(camera: any, sunDirection: any, distance?: number): void;
+    update(camera: any, sunDirection: any, distance: any): void;
+}
+import { FrustumCorners } from './helpers/FrustumCorners';

package/dist/types/threemap/natural/clouds/CloudLayer.d.ts

@@ -0,0 +1,19 @@
+export class CloudLayer {
+    static DEFAULT: CloudLayer;
+    constructor(options: any);
+    channel: string;
+    altitude: number;
+    height: number;
+    densityScale: number;
+    shapeAmount: number;
+    shapeDetailAmount: number;
+    weatherExponent: number;
+    shapeAlteringBias: number;
+    coverageFilterWidth: number;
+    densityProfile: DensityProfile;
+    shadow: boolean;
+    set(options: any): this;
+    clone(): CloudLayer;
+    copy(other: any): this;
+}
+import { DensityProfile } from './DensityProfile';

package/dist/types/threemap/natural/clouds/CloudLayers.d.ts

@@ -0,0 +1,13 @@
+export class CloudLayers extends Array<any> {
+    static DEFAULT: CloudLayers;
+    constructor(options: any);
+    set(options: any): this;
+    reset(): this;
+    clone(): CloudLayers;
+    copy(other: any): this;
+    get localWeatherChannels(): any;
+    packValues(key: any, result: any): any;
+    packSums(a: any, b: any, result: any): any;
+    packDensityProfiles(key: any, result: any): any;
+    packIntervalHeights(minIntervals: any, maxIntervals: any, baseHeight?: number): void;
+}

package/dist/types/threemap/natural/clouds/CloudShape.d.ts

@@ -0,0 +1,4 @@
+export class CloudShape extends Procedural3DTextureBase {
+    constructor();
+}
+import { Procedural3DTextureBase } from './Procedural3DTexture';

package/dist/types/threemap/natural/clouds/CloudShapeDetail.d.ts

@@ -0,0 +1,4 @@
+export class CloudShapeDetail extends Procedural3DTextureBase {
+    constructor();
+}
+import { Procedural3DTextureBase } from './Procedural3DTexture';

package/dist/types/threemap/natural/clouds/CloudsEffect.d.ts

@@ -0,0 +1,173 @@
+export namespace cloudsPassOptionsDefaults {
+    let resolutionScale: number;
+    let width: any;
+    let height: any;
+}
+export class CloudsEffect {
+    constructor(camera: any, options: any, atmosphere?: AtmosphereParameters);
+    camera: any;
+    atmosphere: AtmosphereParameters;
+    cloudLayers: CloudLayers;
+    correctAltitude: boolean;
+    localWeatherRepeat: any;
+    localWeatherOffset: any;
+    shapeRepeat: any;
+    shapeOffset: any;
+    shapeDetailRepeat: any;
+    shapeDetailOffset: any;
+    turbulenceRepeat: any;
+    worldToECEFMatrix: any;
+    ecefToWorldMatrix: any;
+    altitudeCorrection: any;
+    sunDirection: any;
+    parameterUniforms: {
+        scatteringCoefficient: any;
+        absorptionCoefficient: any;
+        coverage: any;
+        localWeatherTexture: any;
+        localWeatherRepeat: any;
+        localWeatherOffset: any;
+        shapeTexture: any;
+        shapeRepeat: any;
+        shapeOffset: any;
+        shapeDetailTexture: any;
+        shapeDetailRepeat: any;
+        shapeDetailOffset: any;
+        turbulenceTexture: any;
+        turbulenceRepeat: any;
+        turbulenceDisplacement: any;
+    };
+    layerUniforms: {
+        minLayerHeights: any;
+        maxLayerHeights: any;
+        minIntervalHeights: any;
+        maxIntervalHeights: any;
+        densityScales: any;
+        shapeAmounts: any;
+        shapeDetailAmounts: any;
+        weatherExponents: any;
+        shapeAlteringBiases: any;
+        coverageFilterWidths: any;
+        minHeight: any;
+        maxHeight: any;
+        shadowTopHeight: any;
+        shadowBottomHeight: any;
+        shadowLayerMask: any;
+        densityProfile: any;
+    };
+    atmosphereUniforms: {
+        bottomRadius: any;
+        topRadius: any;
+        worldToECEFMatrix: any;
+        ecefToWorldMatrix: any;
+        altitudeCorrection: any;
+        sunDirection: any;
+    };
+    localWeatherVelocity: any;
+    shapeVelocity: any;
+    shapeDetailVelocity: any;
+    proceduralLocalWeather: any;
+    proceduralShape: any;
+    proceduralShapeDetail: any;
+    proceduralTurbulence: any;
+    shadowMaps: CascadedShadowMaps;
+    shadowPass: ShadowPass;
+    cloudsPass: CloudsPass;
+    clouds: any;
+    shadow: any;
+    _atmosphereOverlay: null;
+    _atmosphereShadow: null;
+    _atmosphereShadowLength: null;
+    resolution: any;
+    events: any;
+    frame: number;
+    shadowCascadeCount: number;
+    shadowMapSize: any;
+    baseHeight: number;
+    skipRendering: boolean;
+    onResolutionChange: () => void;
+    set mainCamera(value: any);
+    get mainCamera(): any;
+    initialize(renderer: any, alpha: any, frameBufferType: any): void;
+    updateSharedUniforms(deltaTime: any): void;
+    updateWeatherTextureChannels(): void;
+    updateAtmosphereComposition(): void;
+    update(renderer: any, inputBuffer: any, deltaTime?: number): void;
+    setSize(baseWidth: any, baseHeight: any): void;
+    setDepthTexture(depthTexture: any, depthPacking: any): void;
+    set qualityPreset(value: any);
+    set localWeatherTexture(value: any);
+    get localWeatherTexture(): any;
+    set shapeTexture(value: any);
+    get shapeTexture(): any;
+    set shapeDetailTexture(value: any);
+    get shapeDetailTexture(): any;
+    set turbulenceTexture(value: any);
+    get turbulenceTexture(): any;
+    set stbnTexture(value: any);
+    get stbnTexture(): any;
+    set resolutionScale(value: any);
+    get resolutionScale(): any;
+    set temporalUpscale(value: boolean);
+    get temporalUpscale(): boolean;
+    set lightShafts(value: boolean);
+    get lightShafts(): boolean;
+    set shapeDetail(value: boolean);
+    get shapeDetail(): boolean;
+    set turbulence(value: boolean);
+    get turbulence(): boolean;
+    set haze(value: boolean);
+    get haze(): boolean;
+    set scatteringCoefficient(value: any);
+    get scatteringCoefficient(): any;
+    set absorptionCoefficient(value: any);
+    get absorptionCoefficient(): any;
+    set coverage(value: any);
+    get coverage(): any;
+    set turbulenceDisplacement(value: any);
+    get turbulenceDisplacement(): any;
+    set scatterAnisotropy1(value: number);
+    get scatterAnisotropy1(): number;
+    set scatterAnisotropy2(value: number);
+    get scatterAnisotropy2(): number;
+    set scatterAnisotropyMix(value: number);
+    get scatterAnisotropyMix(): number;
+    /** @deprecated Use skyLightScale instead. */
+    set skyIrradianceScale(value: any);
+    /** @deprecated Use skyLightScale instead. */
+    get skyIrradianceScale(): any;
+    set skyLightScale(value: any);
+    get skyLightScale(): any;
+    /** @deprecated Use groundBounceScale instead. */
+    set groundIrradianceScale(value: any);
+    /** @deprecated Use groundBounceScale instead. */
+    get groundIrradianceScale(): any;
+    set groundBounceScale(value: any);
+    get groundBounceScale(): any;
+    set powderScale(value: any);
+    get powderScale(): any;
+    set powderExponent(value: any);
+    get powderExponent(): any;
+    get atmosphereOverlay(): null;
+    get atmosphereShadow(): null;
+    get atmosphereShadowLength(): null;
+    set irradianceTexture(value: any);
+    get irradianceTexture(): any;
+    set scatteringTexture(value: any);
+    get scatteringTexture(): any;
+    set transmittanceTexture(value: any);
+    get transmittanceTexture(): any;
+    set singleMieScatteringTexture(value: any);
+    get singleMieScatteringTexture(): any;
+    set higherOrderScatteringTexture(value: any);
+    get higherOrderScatteringTexture(): any;
+    set ellipsoid(value: any);
+    get ellipsoid(): any;
+    set sunAngularRadius(value: any);
+    get sunAngularRadius(): any;
+}
+import { AtmosphereParameters } from '../sky/AtmosphereParameters';
+import { CloudLayers } from './CloudLayers';
+import { CascadedShadowMaps } from './CascadedShadowMaps';
+import { ShadowPass } from './ShadowPass';
+import { CloudsPass } from './CloudsPass';

package/dist/types/threemap/natural/clouds/CloudsMaterial.d.ts

@@ -0,0 +1,35 @@
+export class CloudsMaterial extends AtmosphereMaterialBase {
+    constructor({ parameterUniforms, layerUniforms, atmosphereUniforms }: {
+        parameterUniforms: any;
+        layerUniforms: any;
+        atmosphereUniforms: any;
+    }, atmosphere?: AtmosphereParameters);
+    temporalUpscale: boolean;
+    previousProjectionMatrix: any;
+    previousViewMatrix: any;
+    depthPacking: number;
+    localWeatherChannels: string;
+    shapeDetail: boolean;
+    turbulence: boolean;
+    shadowLength: boolean;
+    haze: boolean;
+    multiScatteringOctaves: number;
+    accurateSunSkyLight: boolean;
+    accuratePhaseFunction: boolean;
+    shadowCascadeCount: number;
+    shadowSampleCount: number;
+    scatterAnisotropy1: number;
+    scatterAnisotropy2: number;
+    scatterAnisotropyMix: number;
+    copyReprojectionMatrix(camera: any): void;
+    setSize(width: any, height: any, targetWidth: any, targetHeight: any): void;
+    setShadowSize(width: any, height: any): void;
+    set depthBuffer(value: any);
+    get depthBuffer(): any;
+    /** @deprecated Use accurateSunSkyLight instead. */
+    set accurateSunSkyIrradiance(value: boolean);
+    /** @deprecated Use accurateSunSkyLight instead. */
+    get accurateSunSkyIrradiance(): boolean;
+}
+import { AtmosphereMaterialBase } from '../sky/AtmosphereMaterialBase';
+import { AtmosphereParameters } from '../sky/AtmosphereParameters';

package/dist/types/threemap/natural/clouds/CloudsPass.d.ts

@@ -0,0 +1,39 @@
+export class CloudsPass extends PassBase {
+    constructor({ parameterUniforms, layerUniforms, atmosphereUniforms, ...options }: {
+        [x: string]: any;
+        parameterUniforms: any;
+        layerUniforms: any;
+        atmosphereUniforms: any;
+    }, atmosphere: any);
+    atmosphere: any;
+    currentRenderTarget: any;
+    currentMaterial: CloudsMaterial;
+    currentPass: any;
+    resolveRenderTarget: any;
+    resolveMaterial: CloudsResolveMaterial;
+    resolvePass: any;
+    historyRenderTarget: any;
+    width: number;
+    height: number;
+    copyCameraSettings(camera: any): void;
+    initialize(renderer: any, alpha: any, frameBufferType: any): void;
+    initRenderTargets(options: any): void;
+    copyShadow(): void;
+    copyReprojection(): void;
+    swapBuffers(): void;
+    update(renderer: any, frame: any, deltaTime: any): void;
+    setSize(width: any, height: any): void;
+    setShadowSize(width: any, height: any, depth: any): void;
+    setDepthTexture(depthTexture: any, depthPacking: any): void;
+    get outputBuffer(): any;
+    set shadowBuffer(value: any);
+    get shadowBuffer(): any;
+    get shadowLengthBuffer(): any;
+    set temporalUpscale(value: boolean);
+    get temporalUpscale(): boolean;
+    set lightShafts(value: boolean);
+    get lightShafts(): boolean;
+}
+import { PassBase } from './PassBase';
+import { CloudsMaterial } from './CloudsMaterial';
+import { CloudsResolveMaterial } from './CloudsResolveMaterial';

package/dist/types/threemap/natural/clouds/CloudsPostPass.d.ts

@@ -0,0 +1,10 @@
+export class CloudsPostPass {
+    constructor(camera: any);
+    _effect: CloudsEffect;
+    initialize(renderer: any, alpha: any, frameBufferType: any): void;
+    onFrameUpdate(engine: any, parameters: any): void;
+    get effect(): CloudsEffect;
+    set baseHeight(value: number);
+    get baseHeight(): number;
+}
+import { CloudsEffect } from './CloudsEffect';

package/dist/types/threemap/natural/clouds/CloudsResolveMaterial.d.ts

@@ -0,0 +1,13 @@
+export class CloudsResolveMaterial {
+    constructor({ colorBuffer, depthVelocityBuffer, shadowLengthBuffer, colorHistoryBuffer, shadowLengthHistoryBuffer }?: {
+        colorBuffer?: null | undefined;
+        depthVelocityBuffer?: null | undefined;
+        shadowLengthBuffer?: null | undefined;
+        colorHistoryBuffer?: null | undefined;
+        shadowLengthHistoryBuffer?: null | undefined;
+    });
+    temporalUpscale: boolean;
+    shadowLength: boolean;
+    setSize(width: any, height: any): void;
+    onBeforeRender(renderer: any, scene: any, camera: any, geometry: any, object: any, group: any): void;
+}

package/dist/types/threemap/natural/clouds/DensityProfile.d.ts

@@ -0,0 +1,10 @@
+export class DensityProfile {
+    constructor(expTerm?: number, exponent?: number, linearTerm?: number, constantTerm?: number);
+    expTerm: number;
+    exponent: number;
+    linearTerm: number;
+    constantTerm: number;
+    set(expTerm?: number, exponent?: number, linearTerm?: number, constantTerm?: number): this;
+    clone(): DensityProfile;
+    copy(other: any): this;
+}

package/dist/types/threemap/natural/clouds/LocalWeather.d.ts

@@ -0,0 +1,4 @@
+export class LocalWeather extends ProceduralTextureBase {
+    constructor();
+}
+import { ProceduralTextureBase } from './ProceduralTexture';

package/dist/types/threemap/natural/clouds/PassBase.d.ts

@@ -0,0 +1,7 @@
+export class PassBase {
+    constructor(name: any, options: any);
+    shadow: any;
+    _mainCamera: any;
+    set mainCamera(value: any);
+    get mainCamera(): any;
+}

package/dist/types/threemap/natural/clouds/Procedural3DTexture.d.ts

@@ -0,0 +1,15 @@
+export class Procedural3DTextureBase {
+    constructor({ size, fragmentShader }: {
+        size: any;
+        fragmentShader: any;
+    });
+    size: any;
+    needsRender: boolean;
+    material: any;
+    mesh: any;
+    renderTarget: any;
+    camera: any;
+    dispose(): void;
+    render(renderer: any, deltaTime: any): void;
+    get texture(): any;
+}