deeptwins-engine-3d 0.1.65 → 0.1.66

package/dist/esm/material/AtmosphericDispersion.js

@@ -1,39 +1,166 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
-function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
 function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
 function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
 function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
-var AtmosphericDispersion = /*#__PURE__*/function () {
-  function AtmosphericDispersion(viewer) {
+import * as Cesium from 'deeptwins-cesium';
+/* babel-plugin-inline-import './shader/AtmosphericShader.glsl' */
+var AtmosphericShader = "precision highp float;\nuniform sampler2D colorTexture;\nuniform sampler2D depthTexture;\nuniform float u_threshold;\nuniform float u_blendFactor;\nuniform float u_lightIntensity;\nuniform float u_scatterStrength;\nuniform float u_tonemapExposure;\nuniform float u_mieExtinctionStrength;\nuniform float u_fogOpacity;\nuniform float u_fogPower;\nuniform float u_clearMixBias;\nin vec2 v_textureCoordinates;\nconst float PI = 3.14159265359;\nconst float TWO_PI = PI * 2.0;\nconst float FOUR_PI = PI * 4.0;\nconst float SCATTER_VISIBILITY_SCALE = 30000.0;\nconst float MAX_EXPOSURE_RESPONSE = 1.8;\nconst float MAX_LIGHT_RESPONSE = 3.0;\n\nconst vec3 betaR = vec3(5.5e-6, 13.0e-6, 22.4e-6);\n\nconst vec3 betaM = vec3(21e-6);\n\nconst float hR = 10e3;\nconst float hM = 3.8e3;\nconst int num_samples = 16;\nconst int num_samples_light = 4;\n#ifdef GL_ES\n          #define _in(T) const in T\n          #define _inout(T) inout T\n          #define _out(T) out T\n          #define _begin(type) type (\n          #define _end )\n          #define mul(a, b) (a) * (b)\n      #endif\n\nstruct ray_t {\n    vec3 origin;\n    vec3 direction;\n};\nstruct sphere_t {\n    vec3 origin;\n    float radius;\n    int material;\n};\nstruct plane_t {\n    vec3 direction;\n    float distance;\n    int material;\n};\nplane_t plane;\nmat3 rotate_around_x(_in(float)  angle_degrees) {\n    float angle = radians(angle_degrees);\n    float _sin = sin(angle);\n    float _cos = cos(angle);\n    return mat3(1, 0, 0, 0, _cos, -_sin, 0, _sin, _cos);\n}\n\nbool isect_sphere(_in(ray_t)  ray, _in(sphere_t)  sphere, _inout(float)  t0, _inout(float)  t1) {\n    vec3 rc = sphere.origin - ray.origin;\n    float radius2 = sphere.radius * sphere.radius;\n    float tca = dot(rc, ray.direction);\n    float d2 = dot(rc, rc) - tca * tca;\n    if (d2 > radius2) return false;\n    float thc = sqrt(radius2 - d2);\n    t0 = tca - thc;\n    t1 = tca + thc;\n    return true;\n}\nfloat rayleigh_phase_func(float mu) {\n    return\n    3. * (1. + mu * mu)\n    /\n    (16. * PI);\n}\nconst float g = 0.76;\nfloat henyey_greenstein_phase_func(float mu) {\n    return\n    (1. - g * g)\n    /\n    ((4. * PI) * pow(1. + g * g - 2. * g * mu, 1.5));\n}\nconst float k = 1.55 * g - 0.55 * (g * g * g);\nfloat schlick_phase_func(float mu) {\n    return\n    (1. - k * k)\n    /\n    (4. * PI * (1. + k * mu) * (1. + k * mu));\n}\nconst sphere_t atmosphere = _begin(sphere_t)\nvec3(0, 0, 0), 6420e3, 0\n_end;\n\nbool get_sun_light(\n_in(ray_t)  ray, _inout(float)  optical_depthR, _inout(float)  optical_depthM\n) {\n    float t0, t1;\n    isect_sphere(ray, atmosphere, t0, t1);\n    float march_pos = 0.;\n    float march_step = t1 / float(num_samples_light);\n    for (int i = 0; i < num_samples_light; i++) {\n        vec3 s = ray.origin +\n        ray.direction * (march_pos + 0.5 * march_step);\n        float height = length(s) - 6360e3;\n        if (height < 0.)\n        return false;\n        optical_depthR += exp(-height / hR) * march_step;\n        optical_depthM += exp(-height / hM) * march_step;\n        march_pos += march_step;\n    }\n    return true;\n}\nvec4 get_incident_light(_in(ray_t)  ray) {\n    vec3 dir = ray.direction;\n    vec3 start = ray.origin;\n    float a = dot(dir, dir);\n    float b = 2.0 * dot(dir, start);\n    float radius2 = atmosphere.radius * atmosphere.radius;\n    float c = dot(start, start) - radius2;\n    float d = (b * b) - 4.0 * a * c;\n    if (d < 0.0) return vec4(0.0);\n    float squaredD = sqrt(d);\n    vec2 ray_length = vec2(\n    max((-b - squaredD) / (2.0 * a), 0.0), min((-b + squaredD) / (2.0 * a), plane.distance)\n    );\n    if (ray_length.x > ray_length.y) return vec4(0.0);\n    float march_step = (ray_length.y - ray_length.x) / float(num_samples);\n    float mu = dot(ray.direction, normalize(czm_sunPositionWC));\n    float phaseR = rayleigh_phase_func(mu);\n    float phaseM =\n    #if 1\n              henyey_greenstein_phase_func(mu);\n    #else\n              schlick_phase_func(mu);\n    #endif\n\n    float optical_depthR = 0.;\n    float optical_depthM = 0.;\n    vec3 sumR = vec3(0);\n    vec3 sumM = vec3(0);\n    float march_pos = 0.;\n    for (int i = 0; i < num_samples; i++) {\n        vec3 s = ray.origin +\n        ray.direction * (march_pos + 0.5 * march_step);\n        float height = length(s) - 6360e3;\n\n        float hr = exp(-height / hR) * march_step;\n        float hm = exp(-height / hM) * march_step;\n        optical_depthR += hr;\n        optical_depthM += hm;\n\n        ray_t light_ray = _begin(ray_t)\n        s, normalize(czm_sunPositionWC)\n        _end;\n        float optical_depth_lightR = 0.;\n        float optical_depth_lightM = 0.;\n        bool overground = get_sun_light(\n            light_ray,\n            optical_depth_lightR,\n            optical_depth_lightM);\n\n        if (overground) {\n\n            vec3 tau =\n            betaR * (optical_depthR + optical_depth_lightR) +\n            betaM * u_mieExtinctionStrength * (optical_depthM + optical_depth_lightM);\n            vec3 attenuation = exp(-tau);\n            sumR += hr * attenuation;\n            sumM += hm * attenuation;\n        }\n\n        march_pos += march_step;\n    }\n    vec3 transmittance = exp(-((betaM * optical_depthM * u_mieExtinctionStrength)\n    + (betaR * optical_depthR)) * 4.);\n    float attenuation = clamp(dot(transmittance, vec3(0.3333333)), 0.0, 1.0);\n\n    return vec4(\n    u_scatterStrength *\n    (sumR * phaseR * betaR +\n    sumM * phaseM * betaM), 1.0 - attenuation);\n}\n\nvoid main() {\n    vec4 rawColor = texture(colorTexture, v_textureCoordinates);\n    float depth = czm_unpackDepth(texture(depthTexture, v_textureCoordinates));\n\n    vec4 positionEC = czm_windowToEyeCoordinates(gl_FragCoord.xy, depth);\n    vec4 positionWC = czm_inverseView * positionEC;\n    positionWC.xyz = positionWC.xyz / positionWC.w;\n\n    vec3 lVector = positionWC.xyz - czm_viewerPositionWC;\n    ray_t ray;\n    ray.origin = czm_viewerPositionWC;\n    ray.direction = normalize(lVector);\n    plane.distance = length(lVector);\n\n    vec4 atmosphereColor = get_incident_light(ray);\n    float lightControl = clamp(u_lightIntensity / 4.0, 0.0, 1.0);\n    float lightStrength = MAX_LIGHT_RESPONSE * (\n    1.0 - exp(-2.6 * pow(lightControl, 1.6))\n    );\n    vec3 scatterColor = atmosphereColor.rgb * lightStrength;\n    float exposureControl = clamp(u_tonemapExposure / 3.0, 0.0, 1.0);\n    float exposureStrength = pow(exposureControl, 1.25) * MAX_EXPOSURE_RESPONSE;\n    float mieVisualFactor = mix(\n        0.6,\n        1.8,\n        clamp(u_mieExtinctionStrength / 2.0, 0.0, 1.0)\n    );\n    vec3 visibleScatter = 1.0 - exp(\n        -max(scatterColor * SCATTER_VISIBILITY_SCALE, 0.0) * exposureStrength\n    );\n    visibleScatter *= mieVisualFactor;\n    float brightness = dot(visibleScatter, vec3(0.299, 0.587, 0.114));\n    float thresholdMask = u_threshold > 0.0\n    ? smoothstep(0.0, u_threshold, brightness)\n    : 1.0;\n    visibleScatter *= thresholdMask;\n    float fogSignal = clamp(atmosphereColor.a * 2.5, 0.0, 1.0);\n    float fogAlpha = clamp(\n        pow(fogSignal, u_fogPower) * u_fogOpacity * mieVisualFactor,\n        0.0,\n        1.0\n    );\n    float clearPreserve = clamp(1.0 - u_clearMixBias, 0.0, 1.0);\n    float fogMix = fogAlpha * clearPreserve * 0.85;\n    vec3 foggedBase = mix(\n        rawColor.rgb,\n        rawColor.rgb * (1.0 - fogAlpha * 0.35),\n        fogMix\n    );\n    vec3 overlayColor = visibleScatter *\n    (0.55 + fogAlpha * 1.25) *\n    mix(1.0, 0.6, u_clearMixBias);\n    vec3 finalColor = mix(\n        rawColor.rgb,\n        foggedBase + overlayColor,\n        u_blendFactor\n    );\n\n    out_FragColor = vec4(clamp(finalColor, 0.0, 1.0), rawColor.a);\n}\n";
+var DEFAULT_PARAMS = {
+  u_threshold: 0.5,
+  u_blendFactor: 0.22,
+  u_lightIntensity: 0.9,
+  u_scatterStrength: 8,
+  u_tonemapExposure: 1,
+  u_mieExtinctionStrength: 0.65,
+  u_fogOpacity: 0.22,
+  u_fogPower: 1.9,
+  u_clearMixBias: 0.78
+};
+var DEFAULT_ZOOM_DAMPING_OPTIONS = {
+  enableZoomDamping: true,
+  dampingStartPitchDeg: -60,
+  dampingFullPitchDeg: -89.9,
+  minZoomScale: 0.12
+};
+var DEFAULT_CLOCK_TEXT = '12:00:00';
+var MIN_ZOOM_FACTOR = 0.01;
+var ZOOM_DAMPING_STATE_KEY = '__atmosphericDispersionZoomDampingState';
+var CLOCK_CONTROL_STATE_KEY = '__atmosphericDispersionClockControlState';
+var atmosphericDispersionInstanceSeed = 0;
+
+// 大气散射
+export var AtmosphericDispersion = /*#__PURE__*/function () {
+  function AtmosphericDispersion(map) {
     var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
     _classCallCheck(this, AtmosphericDispersion);
-    this.viewer = viewer.viewer;
-    if (!this.viewer || _typeof(this.viewer) !== 'object') {
+    // 地图上下文
+    _defineProperty(this, "_mapContext", void 0);
+    // 当前生效的参数
+    _defineProperty(this, "params", void 0);
+    // 构造时的原始参数
+    _defineProperty(this, "originalOptions", void 0);
+    // 后处理阶段实例
+    _defineProperty(this, "atmosphericDispersion", void 0);
+    // 极俯角缩放降速配置
+    _defineProperty(this, "zoomDampingOptions", void 0);
+    // 场景时间配置
+    _defineProperty(this, "clockOption", void 0);
+    // 相机变化监听
+    _defineProperty(this, "_cameraChangedHandler", void 0);
+    // 当前实例的缩放保护标识
+    _defineProperty(this, "_zoomDampingOwnerId", void 0);
+    // 当前实例的时间控制标识
+    _defineProperty(this, "_clockControlOwnerId", void 0);
+    this._mapContext = map._mapContext;
+    var viewer = this.getMap();
+    if (!viewer || _typeof(viewer) !== 'object') {
       throw new Error('Invalid Cesium Viewer instance provided');
     }
-    if (!this.viewer.scene || !this.viewer.scene.postProcessStages) {
+    if (!viewer.scene || !viewer.scene.postProcessStages) {
       throw new Error('Viewer instance must have valid scene and postProcessStages');
     }
-    this.params = {
-      u_threshold: options.u_threshold !== undefined ? options.u_threshold : 1.1,
-      u_blendFactor: options.u_blendFactor !== undefined ? options.u_blendFactor : 0.5,
-      u_lightIntensity: options.u_lightIntensity !== undefined ? options.u_lightIntensity : 1.6
-    };
+    this.params = this._buildParams(options);
+    this.zoomDampingOptions = this._buildZoomDampingOptions(options);
+    this.clockOption = this._buildClockOption(options);
     this.originalOptions = _objectSpread({}, options);
     this.atmosphericDispersion = null;
-    this.initialize();
+    this._cameraChangedHandler = null;
+    atmosphericDispersionInstanceSeed += 1;
+    var ownerId = "atmospheric-dispersion-".concat(atmosphericDispersionInstanceSeed);
+    this._zoomDampingOwnerId = ownerId;
+    this._clockControlOwnerId = ownerId;
+    this._initialize();
   }
+
+  // 获取地图实例
   _createClass(AtmosphericDispersion, [{
-    key: "initialize",
-    value: function initialize() {
+    key: "getMap",
+    value: function getMap() {
+      return this._mapContext && this._mapContext.getMap();
+    }
+
+    // 统一构建参数，避免重复逻辑
+  }, {
+    key: "_buildParams",
+    value: function _buildParams(options) {
+      return {
+        u_threshold: typeof options.u_threshold === 'number' ? Math.max(options.u_threshold, 0) : DEFAULT_PARAMS.u_threshold,
+        u_blendFactor: typeof options.u_blendFactor === 'number' ? Cesium.Math.clamp(options.u_blendFactor, 0, 1) : DEFAULT_PARAMS.u_blendFactor,
+        u_lightIntensity: typeof options.u_lightIntensity === 'number' ? Math.max(options.u_lightIntensity, 0) : DEFAULT_PARAMS.u_lightIntensity,
+        u_scatterStrength: typeof options.u_scatterStrength === 'number' ? Math.max(options.u_scatterStrength, 0) : DEFAULT_PARAMS.u_scatterStrength,
+        u_tonemapExposure: typeof options.u_tonemapExposure === 'number' ? Math.max(options.u_tonemapExposure, 0) : DEFAULT_PARAMS.u_tonemapExposure,
+        u_mieExtinctionStrength: typeof options.u_mieExtinctionStrength === 'number' ? Math.max(options.u_mieExtinctionStrength, 0) : DEFAULT_PARAMS.u_mieExtinctionStrength,
+        u_fogOpacity: typeof options.u_fogOpacity === 'number' ? Math.max(options.u_fogOpacity, 0) : DEFAULT_PARAMS.u_fogOpacity,
+        u_fogPower: typeof options.u_fogPower === 'number' ? Math.max(options.u_fogPower, 0.0001) : DEFAULT_PARAMS.u_fogPower,
+        u_clearMixBias: typeof options.u_clearMixBias === 'number' ? Cesium.Math.clamp(options.u_clearMixBias, 0, 1) : DEFAULT_PARAMS.u_clearMixBias
+      };
+    }
+
+    // 统一构建缩放降速参数，避免危险配置导致交互异常
+  }, {
+    key: "_buildZoomDampingOptions",
+    value: function _buildZoomDampingOptions(options) {
+      var dampingStartPitchDeg = typeof options.dampingStartPitchDeg === 'number' ? options.dampingStartPitchDeg : DEFAULT_ZOOM_DAMPING_OPTIONS.dampingStartPitchDeg;
+      var dampingFullPitchDegCandidate = typeof options.dampingFullPitchDeg === 'number' ? options.dampingFullPitchDeg : DEFAULT_ZOOM_DAMPING_OPTIONS.dampingFullPitchDeg;
+      return {
+        enableZoomDamping: typeof options.enableZoomDamping === 'boolean' ? options.enableZoomDamping : DEFAULT_ZOOM_DAMPING_OPTIONS.enableZoomDamping,
+        dampingStartPitchDeg: dampingStartPitchDeg,
+        dampingFullPitchDeg: Math.min(dampingFullPitchDegCandidate, dampingStartPitchDeg - 0.1),
+        minZoomScale: Cesium.Math.clamp(typeof options.minZoomScale === 'number' ? options.minZoomScale : DEFAULT_ZOOM_DAMPING_OPTIONS.minZoomScale, 0.01, 1)
+      };
+    }
+
+    // 规范化字符串时间，支持 HH:mm:ss
+  }, {
+    key: "_normalizeClockText",
+    value: function _normalizeClockText(clockText) {
+      var matchResult = /^(\d{1,2}):(\d{1,2}):(\d{1,2})$/.exec(clockText.trim());
+      if (!matchResult) return null;
+      var hours = Number(matchResult[1]);
+      var minutes = Number(matchResult[2]);
+      var seconds = Number(matchResult[3]);
+      if (!Number.isInteger(hours) || !Number.isInteger(minutes) || !Number.isInteger(seconds) || hours < 0 || hours > 23 || minutes < 0 || minutes > 59 || seconds < 0 || seconds > 59) {
+        return null;
+      }
+      return "".concat(String(hours).padStart(2, '0'), ":").concat(String(minutes).padStart(2, '0'), ":").concat(String(seconds).padStart(2, '0'));
+    }
+
+    // 统一构建时间参数，只接收字符串时间，非法值回退到默认12点
+  }, {
+    key: "_buildClockOption",
+    value: function _buildClockOption(options) {
+      if (options.clock === 'auto') {
+        return 'auto';
+      }
+      if (typeof options.clock === 'string') {
+        var normalizedClockText = this._normalizeClockText(options.clock);
+        if (normalizedClockText) {
+          return normalizedClockText;
+        }
+      }
+      return DEFAULT_CLOCK_TEXT;
+    }
+
+    // 初始化后处理效果并挂载到场景
+  }, {
+    key: "_initialize",
+    value: function _initialize() {
       var _this = this;
-      var atmosphereFs = this._createFragmentShader();
+      var map = this.getMap();
+      if (!map) return;
       this.atmosphericDispersion = new Cesium.PostProcessStage({
-        fragmentShader: atmosphereFs,
+        fragmentShader: AtmosphericShader,
         uniforms: {
           u_threshold: function u_threshold() {
             return _this.params.u_threshold;
@@ -43,72 +170,397 @@ var AtmosphericDispersion = /*#__PURE__*/function () {
           },
           u_lightIntensity: function u_lightIntensity() {
             return _this.params.u_lightIntensity;
+          },
+          u_scatterStrength: function u_scatterStrength() {
+            return _this.params.u_scatterStrength;
+          },
+          u_tonemapExposure: function u_tonemapExposure() {
+            return _this.params.u_tonemapExposure;
+          },
+          u_mieExtinctionStrength: function u_mieExtinctionStrength() {
+            return _this.params.u_mieExtinctionStrength;
+          },
+          u_fogOpacity: function u_fogOpacity() {
+            return _this.params.u_fogOpacity;
+          },
+          u_fogPower: function u_fogPower() {
+            return _this.params.u_fogPower;
+          },
+          u_clearMixBias: function u_clearMixBias() {
+            return _this.params.u_clearMixBias;
           }
         }
       });
-      this.viewer.scene.postProcessStages.add(this.atmosphericDispersion);
+      map.scene.postProcessStages.add(this.atmosphericDispersion);
+      this._syncClockControlState();
+      this._syncZoomDampingState();
+    }
+
+    // 获取缩放控制器
+  }, {
+    key: "_getCameraController",
+    value: function _getCameraController() {
+      var _this$getMap;
+      return (_this$getMap = this.getMap()) === null || _this$getMap === void 0 || (_this$getMap = _this$getMap.scene) === null || _this$getMap === void 0 ? void 0 : _this$getMap.screenSpaceCameraController;
+    }
+
+    // 读取当前缩放降速共享状态
+  }, {
+    key: "_getZoomDampingControllerState",
+    value: function _getZoomDampingControllerState() {
+      var controller = this._getCameraController();
+      if (!controller) return null;
+      if (!controller[ZOOM_DAMPING_STATE_KEY]) {
+        controller[ZOOM_DAMPING_STATE_KEY] = {
+          baseZoomFactor: this._normalizeZoomFactor(controller.zoomFactor),
+          owners: new Map()
+        };
+      }
+      return controller[ZOOM_DAMPING_STATE_KEY];
+    }
+
+    // 兜底缩放倍率，避免出现非法值
+  }, {
+    key: "_normalizeZoomFactor",
+    value: function _normalizeZoomFactor(zoomFactor) {
+      return typeof zoomFactor === 'number' && Number.isFinite(zoomFactor) ? Math.max(zoomFactor, MIN_ZOOM_FACTOR) : MIN_ZOOM_FACTOR;
+    }
+
+    // 获取时钟控制共享状态
+  }, {
+    key: "_getClockControlState",
+    value: function _getClockControlState() {
+      var _this$getMap2;
+      var viewerClock = (_this$getMap2 = this.getMap()) === null || _this$getMap2 === void 0 ? void 0 : _this$getMap2.clock;
+      if (!viewerClock) return null;
+      if (!viewerClock[CLOCK_CONTROL_STATE_KEY]) {
+        viewerClock[CLOCK_CONTROL_STATE_KEY] = {
+          baseCurrentTime: Cesium.JulianDate.clone(viewerClock.currentTime),
+          owners: new Map(),
+          preRenderHandler: null
+        };
+      }
+      return viewerClock[CLOCK_CONTROL_STATE_KEY];
+    }
+
+    // 获取当前生效的时间配置，后激活的实例优先
+  }, {
+    key: "_getEffectiveClockOption",
+    value: function _getEffectiveClockOption(state) {
+      var effectiveClockOption = null;
+      state.owners.forEach(function (clockOption) {
+        effectiveClockOption = clockOption;
+      });
+      return effectiveClockOption;
+    }
+
+    // 将固定时间转换为当天本地时间的 JulianDate
+  }, {
+    key: "_buildClockCurrentTime",
+    value: function _buildClockCurrentTime(clockOption) {
+      var date = new Date();
+      var _clockOption$split$ma = clockOption.split(':').map(Number),
+        _clockOption$split$ma2 = _slicedToArray(_clockOption$split$ma, 3),
+        hours = _clockOption$split$ma2[0],
+        minutes = _clockOption$split$ma2[1],
+        seconds = _clockOption$split$ma2[2];
+      date.setHours(hours, minutes, seconds, 0);
+      return Cesium.JulianDate.fromDate(date);
+    }
+
+    // 开始自动跟随系统时间
+  }, {
+    key: "_startClockAutoSync",
+    value: function _startClockAutoSync(state) {
+      if (state.preRenderHandler) return;
+      var map = this.getMap();
+      if (!map) return;
+      state.preRenderHandler = function () {
+        var effectiveClockOption = null;
+        state.owners.forEach(function (clockOption) {
+          effectiveClockOption = clockOption;
+        });
+        if (effectiveClockOption !== 'auto') return;
+        map.clock.currentTime = Cesium.JulianDate.fromDate(new Date());
+      };
+      map.scene.preRender.addEventListener(state.preRenderHandler);
+    }
+
+    // 停止自动跟随系统时间
+  }, {
+    key: "_stopClockAutoSync",
+    value: function _stopClockAutoSync(state) {
+      var map = this.getMap();
+      if (!state.preRenderHandler || !map) return;
+      map.scene.preRender.removeEventListener(state.preRenderHandler);
+      state.preRenderHandler = null;
+    }
+
+    // 将共享时间状态同步到场景时钟
+  }, {
+    key: "_syncSceneClockControl",
+    value: function _syncSceneClockControl(state) {
+      var _this$getMap3;
+      var viewerClock = (_this$getMap3 = this.getMap()) === null || _this$getMap3 === void 0 ? void 0 : _this$getMap3.clock;
+      if (!viewerClock) return;
+      var effectiveClockOption = this._getEffectiveClockOption(state);
+      if (effectiveClockOption === null) {
+        this._stopClockAutoSync(state);
+        viewerClock.currentTime = Cesium.JulianDate.clone(state.baseCurrentTime);
+        delete viewerClock[CLOCK_CONTROL_STATE_KEY];
+        return;
+      }
+      if (effectiveClockOption === 'auto') {
+        this._startClockAutoSync(state);
+        viewerClock.currentTime = Cesium.JulianDate.fromDate(new Date());
+        return;
+      }
+      this._stopClockAutoSync(state);
+      viewerClock.currentTime = this._buildClockCurrentTime(effectiveClockOption);
+    }
+
+    // 应用当前实例的时间控制
+  }, {
+    key: "_applyClockControl",
+    value: function _applyClockControl() {
+      var _this$getMap4;
+      var viewerClock = (_this$getMap4 = this.getMap()) === null || _this$getMap4 === void 0 ? void 0 : _this$getMap4.clock;
+      var state = this._getClockControlState();
+      if (!viewerClock || !state) return;
+      if (state.owners.size === 0) {
+        state.baseCurrentTime = Cesium.JulianDate.clone(viewerClock.currentTime);
+      }
+      state.owners.delete(this._clockControlOwnerId);
+      state.owners.set(this._clockControlOwnerId, this.clockOption);
+      this._syncSceneClockControl(state);
+    }
+
+    // 移除当前实例对场景时间的影响
+  }, {
+    key: "_releaseClockControl",
+    value: function _releaseClockControl() {
+      var _this$getMap5;
+      var viewerClock = (_this$getMap5 = this.getMap()) === null || _this$getMap5 === void 0 ? void 0 : _this$getMap5.clock;
+      if (!viewerClock || !viewerClock[CLOCK_CONTROL_STATE_KEY]) return;
+      var state = viewerClock[CLOCK_CONTROL_STATE_KEY];
+      state.owners.delete(this._clockControlOwnerId);
+      this._syncSceneClockControl(state);
+    }
+
+    // 根据效果状态同步时间控制
+  }, {
+    key: "_syncClockControlState",
+    value: function _syncClockControlState() {
+      if (this.isEnabled()) {
+        this._applyClockControl();
+        return;
+      }
+      this._releaseClockControl();
+    }
+
+    // 绑定相机变化监听，在俯角变化时动态调整缩放速率
+  }, {
+    key: "_bindCameraChangedHandler",
+    value: function _bindCameraChangedHandler() {
+      if (this._cameraChangedHandler) return;
+      var map = this.getMap();
+      if (!map) return;
+      this._cameraChangedHandler = this._handleCameraChanged.bind(this);
+      map.camera.changed.addEventListener(this._cameraChangedHandler);
+    }
+
+    // 移除相机变化监听
+  }, {
+    key: "_unbindCameraChangedHandler",
+    value: function _unbindCameraChangedHandler() {
+      var map = this.getMap();
+      if (!this._cameraChangedHandler) return;
+      map === null || map === void 0 || map.camera.changed.removeEventListener(this._cameraChangedHandler);
+      this._cameraChangedHandler = null;
+    }
+
+    // 相机变化时更新缩放阻尼
+  }, {
+    key: "_handleCameraChanged",
+    value: function _handleCameraChanged() {
+      this._applyZoomDamping();
+    }
+
+    // 根据当前俯仰角计算应使用的缩放倍率
+  }, {
+    key: "_computeDampedZoomFactor",
+    value: function _computeDampedZoomFactor(baseZoomFactor) {
+      var map = this.getMap();
+      if (!map) return baseZoomFactor;
+      var cameraPitchDeg = Cesium.Math.toDegrees(map.camera.pitch);
+      var _this$zoomDampingOpti = this.zoomDampingOptions,
+        dampingStartPitchDeg = _this$zoomDampingOpti.dampingStartPitchDeg,
+        dampingFullPitchDeg = _this$zoomDampingOpti.dampingFullPitchDeg,
+        minZoomScale = _this$zoomDampingOpti.minZoomScale;
+      if (!Number.isFinite(cameraPitchDeg) || cameraPitchDeg > dampingStartPitchDeg) {
+        return baseZoomFactor;
+      }
+      var progress = Cesium.Math.clamp((dampingStartPitchDeg - cameraPitchDeg) / (dampingStartPitchDeg - dampingFullPitchDeg), 0, 1);
+      var smoothProgress = progress * progress * (3 - 2 * progress);
+      var zoomScale = 1 - (1 - minZoomScale) * smoothProgress;
+      return this._normalizeZoomFactor(baseZoomFactor * zoomScale);
+    }
+
+    // 将所有实例的缩放保护合并到控制器上
+  }, {
+    key: "_syncControllerZoomFactor",
+    value: function _syncControllerZoomFactor(state, controller) {
+      if (state.owners.size === 0) {
+        controller.zoomFactor = state.baseZoomFactor;
+        delete controller[ZOOM_DAMPING_STATE_KEY];
+        return;
+      }
+      var nextZoomFactor = state.baseZoomFactor;
+      state.owners.forEach(function (zoomFactor) {
+        nextZoomFactor = Math.min(nextZoomFactor, zoomFactor);
+      });
+      controller.zoomFactor = this._normalizeZoomFactor(nextZoomFactor);
     }
+
+    // 应用极俯角缩放降速
   }, {
-    key: "_createFragmentShader",
-    value: function _createFragmentShader() {
-      return "\n      precision highp float;\n      uniform sampler2D colorTexture;\n      uniform sampler2D depthTexture;\n      uniform float u_threshold;\n      uniform float u_blendFactor;\n      uniform float u_lightIntensity;\n      in vec2 v_textureCoordinates;\n      const float PI = 3.14159265359;\n      const float TWO_PI = PI * 2.0;\n      const float FOUR_PI = PI * 4.0;\n\n      const vec3 betaR = vec3(5.5e-6, 13.0e-6, 22.4e-6);\n\n      const vec3 betaM = vec3(21e-6);\n\n      const float hR = 10e3;\n      const float hM = 3.8e3;\n      const int num_samples = 16;\n      const int num_samples_light = 4;\n      #ifdef GL_ES\n          #define _in(T) const in T\n          #define _inout(T) inout T\n          #define _out(T) out T\n          #define _begin(type) type (\n          #define _end )\n          #define mul(a, b) (a) * (b)\n      #endif\n\n      struct ray_t {\n          vec3 origin;\n          vec3 direction;\n      };\n      struct sphere_t {\n          vec3 origin;\n          float radius;\n          int material;\n      };\n      struct plane_t {\n          vec3 direction;\n          float distance;\n          int material;\n      };\n      plane_t plane;\n      mat3 rotate_around_x(_in(float) angle_degrees) {\n          float angle = radians(angle_degrees);\n          float _sin = sin(angle);\n          float _cos = cos(angle);\n          return mat3(1, 0, 0, 0, _cos, -_sin, 0, _sin, _cos);\n      }\n\n      bool isect_sphere(_in(ray_t) ray, _in(sphere_t) sphere, _inout(float) t0, _inout(float) t1) {\n          vec3 rc = sphere.origin - ray.origin;\n          float radius2 = sphere.radius * sphere.radius;\n          float tca = dot(rc, ray.direction);\n          float d2 = dot(rc, rc) - tca * tca;\n          if (d2 > radius2) return false;\n          float thc = sqrt(radius2 - d2);\n          t0 = tca - thc;\n          t1 = tca + thc;\n          return true;\n      }\n      float rayleigh_phase_func(float mu) {\n          return\n          3. * (1. + mu*mu)\n          /\n          (16. * PI);\n      }\n      const float g = 0.76;\n      float henyey_greenstein_phase_func(float mu) {\n          return\n          (1. - g*g)\n          /\n          ((4. * PI) * pow(1. + g*g - 2.*g*mu, 1.5));\n      }\n      const float k = 1.55*g - 0.55 * (g*g*g);\n      float schlick_phase_func(float mu) {\n          return\n          (1. - k*k)\n          /\n          (4. * PI * (1. + k*mu) * (1. + k*mu));\n      }\n      const sphere_t atmosphere = _begin(sphere_t)\n      vec3(0, 0, 0), 6420e3, 0\n      _end;\n\n      bool get_sun_light(\n      _in(ray_t) ray, _inout(float) optical_depthR, _inout(float) optical_depthM\n      ) {\n          float t0, t1;\n          isect_sphere(ray, atmosphere, t0, t1);\n          float march_pos = 0.;\n          float march_step = t1 / float(num_samples_light);\n          for (int i = 0; i < num_samples_light; i++) {\n              vec3 s = ray.origin +\n              ray.direction * (march_pos + 0.5 * march_step);\n              float height = length(s) - 6360e3;\n              if (height < 0.)\n              return false;\n              optical_depthR += exp(-height / hR) * march_step;\n              optical_depthM += exp(-height / hM) * march_step;\n              march_pos += march_step;\n          }\n          return true;\n      }\n      vec4 get_incident_light(_in(ray_t) ray) {\n          vec3 dir = ray.direction;\n          vec3 start = ray.origin;\n          float a = dot( dir, dir);\n          float b = 2.0 * dot(dir, start);\n          float radius2 = atmosphere.radius * atmosphere.radius;\n          float c = dot(start, start) - radius2;\n          float d = (b * b) - 4.0 * a * c;\n          if (d < 0.0) return vec4(0.0);\n          float squaredD = sqrt(d);\n          vec2 ray_length = vec2(\n          max((-b - squaredD) / (2.0 * a), 0.0), min((-b + squaredD) / (2.0 * a), plane.distance)\n          );\n          if (ray_length.x > ray_length.y) return vec4(0.0);\n          float march_step = (ray_length.y - ray_length.x) / float(num_samples);\n          float mu = dot(ray.direction, normalize(czm_sunPositionWC));\n          float phaseR = rayleigh_phase_func(mu);\n          float phaseM =\n          #if 1\n              henyey_greenstein_phase_func(mu);\n          #else\n              schlick_phase_func(mu);\n          #endif\n\n          float optical_depthR = 0.;\n          float optical_depthM = 0.;\n          vec3 sumR = vec3(0);\n          vec3 sumM = vec3(0);\n          float march_pos = 0.;\n          for (int i = 0; i < num_samples; i++) {\n              vec3 s = ray.origin +\n              ray.direction * (march_pos + 0.5 * march_step);\n              float height = length(s) - 6360e3;\n\n              float hr = exp(-height / hR) * march_step;\n              float hm = exp(-height / hM) * march_step;\n              optical_depthR += hr;\n              optical_depthM += hm;\n\n              ray_t light_ray = _begin(ray_t)\n              s, normalize(czm_sunPositionWC)\n              _end;\n              float optical_depth_lightR = 0.;\n              float optical_depth_lightM = 0.;\n              bool overground = get_sun_light(\n                  light_ray,\n                  optical_depth_lightR,\n                  optical_depth_lightM);\n\n              if (overground) {\n\n                  vec3 tau =\n                      betaR * (optical_depthR + optical_depth_lightR) +\n                      betaM * 1.1 * (optical_depthM + optical_depth_lightM);\n                  vec3 attenuation = exp(-tau);\n                  sumR += hr * attenuation;\n                  sumM += hm * attenuation;\n              }\n\n              march_pos += march_step;\n          }\n          float attenuation = length(exp(-((betaM * optical_depthM)\n          + (betaR * optical_depthR)) * 4.));\n\n          return vec4(\n          23. *\n          (sumR * phaseR * betaR +\n          sumM * phaseM * betaM), 1.0-attenuation);\n      }\n\n      void main() {\n          vec4 rawColor = texture(colorTexture, v_textureCoordinates);\n          float depth = czm_unpackDepth(texture(depthTexture, v_textureCoordinates));\n\n          vec4 positionEC = czm_windowToEyeCoordinates(gl_FragCoord.xy, depth);\n          vec4 positionWC = czm_inverseView * positionEC;\n          positionWC.xyz = positionWC.xyz / positionWC.w;\n\n          vec3 lVector = positionWC.xyz - czm_viewerPositionWC;\n          ray_t ray;\n          ray.origin = czm_viewerPositionWC;\n          ray.direction =  normalize(lVector);\n          plane.distance = length(lVector);\n\n          vec4 atmosphereColor = get_incident_light(ray);\n          atmosphereColor.rgb *= u_lightIntensity;\n          float brightness = dot(atmosphereColor.rgb, vec3(0.299, 0.587, 0.114));\n          if (brightness < u_threshold) {\n              atmosphereColor.rgb *= brightness / u_threshold;\n          }\n          rawColor = mix(rawColor, atmosphereColor + rawColor * (1.0 - atmosphereColor.a), u_blendFactor);\n          rawColor = vec4(1.0 - exp(-2.2 * rawColor));\n\n          out_FragColor = rawColor;\n      }\n    ";
+    key: "_applyZoomDamping",
+    value: function _applyZoomDamping() {
+      var controller = this._getCameraController();
+      var state = this._getZoomDampingControllerState();
+      if (!controller || !state) return;
+      if (state.owners.size === 0) {
+        state.baseZoomFactor = this._normalizeZoomFactor(controller.zoomFactor);
+      }
+      var nextZoomFactor = this._computeDampedZoomFactor(state.baseZoomFactor);
+      if (nextZoomFactor >= state.baseZoomFactor) {
+        state.owners.delete(this._zoomDampingOwnerId);
+      } else {
+        state.owners.set(this._zoomDampingOwnerId, nextZoomFactor);
+      }
+      this._syncControllerZoomFactor(state, controller);
     }
+
+    // 移除当前实例对缩放降速的影响
+  }, {
+    key: "_releaseZoomDamping",
+    value: function _releaseZoomDamping() {
+      var controller = this._getCameraController();
+      if (!controller || !controller[ZOOM_DAMPING_STATE_KEY]) return;
+      var state = controller[ZOOM_DAMPING_STATE_KEY];
+      state.owners.delete(this._zoomDampingOwnerId);
+      this._syncControllerZoomFactor(state, controller);
+    }
+
+    // 根据效果状态同步缩放降速监听与倍率
+  }, {
+    key: "_syncZoomDampingState",
+    value: function _syncZoomDampingState() {
+      if (this.isEnabled() && this.zoomDampingOptions.enableZoomDamping) {
+        this._bindCameraChangedHandler();
+        this._applyZoomDamping();
+        return;
+      }
+      this._releaseZoomDamping();
+      this._unbindCameraChangedHandler();
+    }
+
+    // 更新效果参数
   }, {
     key: "updateParameters",
     value: function updateParameters(params) {
       if (params && _typeof(params) === 'object') {
         if (typeof params.u_threshold === 'number') {
-          this.params.u_threshold = params.u_threshold;
+          this.params.u_threshold = Math.max(params.u_threshold, 0);
         }
         if (typeof params.u_blendFactor === 'number') {
-          this.params.u_blendFactor = params.u_blendFactor;
+          this.params.u_blendFactor = Cesium.Math.clamp(params.u_blendFactor, 0, 1);
         }
         if (typeof params.u_lightIntensity === 'number') {
-          this.params.u_lightIntensity = params.u_lightIntensity;
+          this.params.u_lightIntensity = Math.max(params.u_lightIntensity, 0);
+        }
+        if (typeof params.u_scatterStrength === 'number') {
+          this.params.u_scatterStrength = Math.max(params.u_scatterStrength, 0);
+        }
+        if (typeof params.u_tonemapExposure === 'number') {
+          this.params.u_tonemapExposure = Math.max(params.u_tonemapExposure, 0);
+        }
+        if (typeof params.u_mieExtinctionStrength === 'number') {
+          this.params.u_mieExtinctionStrength = Math.max(params.u_mieExtinctionStrength, 0);
         }
+        if (typeof params.u_fogOpacity === 'number') {
+          this.params.u_fogOpacity = Math.max(params.u_fogOpacity, 0);
+        }
+        if (typeof params.u_fogPower === 'number') {
+          this.params.u_fogPower = Math.max(params.u_fogPower, 0.0001);
+        }
+        if (typeof params.u_clearMixBias === 'number') {
+          this.params.u_clearMixBias = Cesium.Math.clamp(params.u_clearMixBias, 0, 1);
+        }
+        this.clockOption = this._buildClockOption(_objectSpread({
+          clock: this.clockOption
+        }, params));
+        this.zoomDampingOptions = this._buildZoomDampingOptions(_objectSpread(_objectSpread({}, this.zoomDampingOptions), params));
+        this._syncClockControlState();
+        this._syncZoomDampingState();
       }
       return this;
     }
+
+    // 重置参数到初始化值
   }, {
     key: "resetParameters",
     value: function resetParameters() {
-      this.params = {
-        u_threshold: this.originalOptions.u_threshold !== undefined ? this.originalOptions.u_threshold : 1.1,
-        u_blendFactor: this.originalOptions.u_blendFactor !== undefined ? this.originalOptions.u_blendFactor : 0.5,
-        u_lightIntensity: this.originalOptions.u_lightIntensity !== undefined ? this.originalOptions.u_lightIntensity : 1.6
-      };
+      this.params = this._buildParams(this.originalOptions);
+      this.clockOption = this._buildClockOption(this.originalOptions);
+      this.zoomDampingOptions = this._buildZoomDampingOptions(this.originalOptions);
+      this._syncClockControlState();
+      this._syncZoomDampingState();
       return this;
     }
+
+    // 显示效果
   }, {
     key: "show",
     value: function show() {
       if (this.atmosphericDispersion) {
         this.atmosphericDispersion.enabled = true;
       }
+      this._syncClockControlState();
+      this._syncZoomDampingState();
       return this;
     }
+
+    // 隐藏效果
   }, {
     key: "hide",
     value: function hide() {
       if (this.atmosphericDispersion) {
         this.atmosphericDispersion.enabled = false;
       }
+      this._syncClockControlState();
+      this._syncZoomDampingState();
       return this;
     }
+
+    // 判断效果是否启用
   }, {
     key: "isEnabled",
     value: function isEnabled() {
       return this.atmosphericDispersion ? this.atmosphericDispersion.enabled : false;
     }
+
+    // 销毁效果并移除后处理阶段
   }, {
     key: "destroy",
     value: function destroy() {
-      if (this.atmosphericDispersion) {
-        this.viewer.scene.postProcessStages.remove(this.atmosphericDispersion);
+      var map = this.getMap();
+      this._releaseClockControl();
+      this._releaseZoomDamping();
+      this._unbindCameraChangedHandler();
+      if (this.atmosphericDispersion && map) {
+        map.scene.postProcessStages.remove(this.atmosphericDispersion);
         this.atmosphericDispersion = null;
-        this.viewer = null;
-        this.params = null;
-        this.originalOptions = null;
       }
     }
   }]);