@rings-webgpu/core 1.0.2 → 1.0.3

package/dist/rings.umd.max.js

@@ -2095,11 +2095,7 @@
     if (!dic) {
       dic = window["__Component__"] = {};
     }
-    if (key) {
-      dic[key] = cls;
-    } else {
-      dic[cls.name] = cls;
-    }
+    dic[key] = cls;
   }
   function GetComponentClass(name) {
     let coms = window["__Component__"];
@@ -2113,11 +2109,7 @@
     if (!dic) {
       dic = window["__shader__"] = {};
     }
-    if (key) {
-      dic[key] = cls;
-    } else {
-      dic[cls.name] = cls;
-    }
+    dic[key] = cls;
   }
   function GetShader(name) {
     let coms = window["__shader__"];
@@ -2139,6 +2131,10 @@
   const _Struct = class _Struct {
     __refection;
     __size = 0;
+    /**
+     * get reflection name
+     * @returns
+     */
     getValueType() {
       if (!this.__refection) {
         let self = this;
@@ -2156,6 +2152,11 @@
       }
       return this.__refection;
     }
+    /**
+     * get any type value memory size
+     * @param value any type value
+     * @returns
+     */
     static getValueSize(value) {
       let type = value.constructor.name;
       switch (type) {
@@ -2202,6 +2203,10 @@
       }
       return struct;
     }
+    /**
+     * get any struct memory size
+     * @returns
+     */
     static GetSize(c) {
       let struct = this.Get(c);
       if (struct.__size == 0) {
@@ -22396,7 +22401,7 @@ fn SH9(dir: vec3<f32>, coefficients: array<vec4f, 9>) -> vec4<f32> {
     }
     /**
      * current instance attached from parent instance
-     * @param ref reference current
+     * @param ref reference current 
      * @param target reference parent
      */
     attached(ref, target) {
@@ -22408,7 +22413,7 @@ fn SH9(dir: vec3<f32>, coefficients: array<vec4f, 9>) -> vec4<f32> {
     }
     /**
      * current instance detached from parent instance
-     * @param ref reference current
+     * @param ref reference current 
      * @param target reference parent
      */
     detached(ref, target) {
@@ -22418,7 +22423,7 @@ fn SH9(dir: vec3<f32>, coefficients: array<vec4f, 9>) -> vec4<f32> {
       }
     }
     /**
-     * current instance has reference
+     * current instance has reference 
      */
     hasReference(ref) {
       let refMap = this.reference.get(ref);
@@ -22429,8 +22434,8 @@ fn SH9(dir: vec3<f32>, coefficients: array<vec4f, 9>) -> vec4<f32> {
     }
     /**
      * get current instance reference count
-     * @param ref
-     * @returns
+     * @param ref 
+     * @returns 
      */
     getReferenceCount(ref) {
       let refMap = this.reference.get(ref);
@@ -22440,10 +22445,10 @@ fn SH9(dir: vec3<f32>, coefficients: array<vec4f, 9>) -> vec4<f32> {
       return 0;
     }
     /**
-     * get current instance reference from where
-     * @param ref
-     * @returns
-     */
+    * get current instance reference from where
+    * @param ref 
+    * @returns 
+    */
     getReference(ref) {
       let refMap = this.reference.get(ref);
       if (refMap) {
@@ -25075,8 +25080,7 @@ fn SH9(dir: vec3<f32>, coefficients: array<vec4f, 9>) -> vec4<f32> {
       this.indicesGPUBuffer = new IndicesGPUBuffer(indicesData.data);
     }
     upload(data) {
-      const buffer = data.buffer instanceof ArrayBuffer ? data.buffer : new Uint8Array(data.buffer).buffer;
-      this.indicesGPUBuffer.indicesNode.setArrayBuffer(0, buffer);
+      this.indicesGPUBuffer.indicesNode.setArrayBuffer(0, data);
       this.indicesGPUBuffer.apply();
     }
     compute() {
@@ -25089,6 +25093,22 @@ fn SH9(dir: vec3<f32>, coefficients: array<vec4f, 9>) -> vec4<f32> {
       this.indicesGPUBuffer.destroy();
       this.indicesGPUBuffer = null;
     }
+    /**
+     * Get indices from geometry data 
+     * Get position attribute from geometry data 
+     * Get normal attribute from geometry data 
+     * Get tangent attribute from geometry data 
+     * Get uv0 attribute from geometry data 
+     * Get uv1 attribute from geometry data 
+     * Get uv2 attribute from geometry data 
+     * 
+     * Change position data to GPUBuffer and apply
+     * Change normal data to GPUBuffer and apply
+     * Change tangent data to GPUBuffer and apply
+     * Change uv0 data to GPUBuffer and apply
+     * Change uv1 data to GPUBuffer and apply
+     * Change uv2 data to GPUBuffer and apply
+     */
   }
 
   class SubGeometry {
@@ -25898,7 +25918,7 @@ fn SH9(dir: vec3<f32>, coefficients: array<vec4f, 9>) -> vec4<f32> {
     }
   };
   exports.QuadShader = __decorateClass$e([
-    RegisterShader
+    RegisterShader(exports.QuadShader, "QuadShader")
   ], exports.QuadShader);
 
   class ViewQuad extends exports.Object3D {
@@ -38416,7 +38436,7 @@ fn CsMain( @builtin(workgroup_id) workgroup_id : vec3<u32> , @builtin(global_inv
     }
   }
 
-  const version = "1.0.1";
+  const version = "1.0.3";
 
   class Engine3D {
     /**
@@ -42865,14 +42885,16 @@ fn frag(){
     _internalTexture;
     _cubeSize;
     setting;
+    /**
+     * @constructor
+     * @param setting AtmosphericScatteringSkySetting
+     * @returns
+     */
     constructor(setting) {
       super();
       this.setting = setting;
       this._cubeSize = setting.defaultTextureCubeSize;
-      this._internalTexture = new AtmosphericTexture2D(
-        setting.defaultTexture2DSize,
-        setting.defaultTexture2DSize * 0.5
-      );
+      this._internalTexture = new AtmosphericTexture2D(setting.defaultTexture2DSize, setting.defaultTexture2DSize * 0.5);
       this._internalTexture.update(this.setting);
       this.createFromTexture(this._cubeSize, this._internalTexture);
       return this;
@@ -42880,6 +42902,10 @@ fn frag(){
     get texture2D() {
       return this._internalTexture;
     }
+    /**
+     * @internal
+     * @returns
+     */
     apply() {
       this._internalTexture.update(this.setting);
       this._faceData.uploadErpTexture(this._internalTexture);
@@ -42890,13 +42916,7 @@ fn frag(){
     _computeShader;
     _uniformBuffer;
     constructor(width, height) {
-      super(
-        width,
-        height,
-        GPUTextureFormat.rgba16float,
-        false,
-        GPUTextureUsage.STORAGE_BINDING | GPUTextureUsage.TEXTURE_BINDING
-      );
+      super(width, height, GPUTextureFormat.rgba16float, false, GPUTextureUsage.STORAGE_BINDING | GPUTextureUsage.TEXTURE_BINDING);
       this.initCompute(width, height);
     }
     initCompute(w, h) {
@@ -42956,7 +42976,7 @@ fn frag(){
     }
   };
   exports.SkyShader = __decorateClass$a([
-    RegisterShader
+    RegisterShader(exports.SkyShader, "SkyShader")
   ], exports.SkyShader);
 
   class SkyMaterial extends Material {
@@ -57022,7 +57042,7 @@ fn frag(){
     }
   };
   exports.LitSSSShader = __decorateClass$3([
-    RegisterShader
+    RegisterShader(exports.LitSSSShader, "LitSSSShader")
   ], exports.LitSSSShader);
 
   var __getOwnPropDesc$2 = Object.getOwnPropertyDescriptor;
@@ -57124,7 +57144,7 @@ fn frag(){
     }
   };
   exports.LitShader = __decorateClass$2([
-    RegisterShader
+    RegisterShader(exports.LitShader, "LitShader")
   ], exports.LitShader);
 
   class ComData {
@@ -57360,7 +57380,7 @@ fn frag(){
     }
   };
   exports.UnLitShader = __decorateClass$1([
-    RegisterShader
+    RegisterShader(exports.UnLitShader, "UnLitShader")
   ], exports.UnLitShader);
 
   var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -57449,7 +57469,7 @@ fn frag(){
     }
   };
   exports.UnLitTexArrayShader = __decorateClass([
-    RegisterShader
+    RegisterShader(exports.UnLitTexArrayShader, "UnLitTexArrayShader")
   ], exports.UnLitTexArrayShader);
 
   class TileSet {
@@ -58327,253 +58347,23 @@ fn frag(){
     }
   }
 
-  class PlaneClassification {
-    /**
-     * @language zh_CN
-     * 背面
-     * @platform Web,Native
-     */
-    static BACK = 0;
-    /**
-     * @language zh_CN
-     * 正面
-     * @platform Web,Native
-     */
-    static FRONT = 1;
-    /**
-     * @language zh_CN
-     * 在法线朝上的一面
-     * @platform Web,Native
-     */
-    static IN = 0;
-    /**
-     * @language zh_CN
-     * 在法线朝下的一面
-     * @platform Web,Native
-     */
-    static OUT = 1;
-    /**
-     * @language zh_CN
-     * 相交
-     * @platform Web,Native
-     */
-    static INTERSECT = 2;
-  }
-
-  class Plane3D {
-    /**
-     * @language en_US
-     * The A coefficient of this plane. (Also the x dimension of the plane normal)
-     */
-    /**
-     * @language zh_CN
-     * 平面中的a分量
-     * @platform Web,Native
-     */
-    a;
-    /**
-     * @language en_US
-     * The B coefficient of this plane. (Also the y dimension of the plane normal)
-     */
-    /**
-     * @language zh_CN
-     * 平面中的b分量
-     * @platform Web,Native
-     */
-    b;
-    /**
-     * @language en_US
-     * The C coefficient of this plane. (Also the z dimension of the plane normal)
-     */
-    /**
-     * @language zh_CN
-     * 平面中的c分量
-     * @platform Web,Native
-     */
-    c;
-    /**
-     * @language en_US
-     * The D coefficient of this plane. (Also the inverse dot product between normal and point)
-     */
-    /**
-     * @language zh_CN
-     * 平面中的d分量
-     * @platform Web,Native
-     */
-    d;
-    // indicates the alignment of the plane
-    /**
-     * @private
-     */
-    static ALIGN_ANY = 0;
-    /**
-     * @private
-     */
-    static ALIGN_XY_AXIS = 1;
-    /**
-     * @private
-     */
-    static ALIGN_YZ_AXIS = 2;
-    /**
-     * @private
-     */
-    static ALIGN_XZ_AXIS = 3;
-    /**
-     * @language en_US
-     * Create a Plane3D with ABCD coefficients
-     */
-    /**
-     * @language zh_CN
-     * 创建一个平面实例
-     * @param a
-     * @param b
-     * @param c
-     * @param d
-     * @platform Web,Native
-     */
-    constructor(a = 0, b = 0, c = 0, d = 0) {
-      this.a = a;
-      this.b = b;
-      this.c = c;
-      this.d = d;
-    }
-    /**
-     * @language zh_CN
-     * 填充平面的各分量的值
-     * @param a
-     * @param b
-     * @param c
-     * @param d
-     * @platform Web,Native
-     */
-    setTo(a = 0, b = 0, c = 0, d = 0) {
-      this.a = a;
-      this.b = b;
-      this.c = c;
-      this.d = d;
-    }
-    /**
-     * @language en_US
-     * Fills this Plane3D with the coefficients from 3 points in 3d space.
-     * @param p0 Vector3
-     * @param p1 Vector3
-     * @param p2 Vector3
-     */
-    /**
-     * @language zh_CN
-     * 由3个坐标来创建一个3d平面
-     * @param p0 Vector3
-     * @param p1 Vector3
-     * @param p2 Vector3
-     * @platform Web,Native
-     */
-    fromPoints(p0, p1, p2) {
-      var d1x = p1.x - p0.x;
-      var d1y = p1.y - p0.y;
-      var d1z = p1.z - p0.z;
-      var d2x = p2.x - p0.x;
-      var d2y = p2.y - p0.y;
-      var d2z = p2.z - p0.z;
-      this.a = d1y * d2z - d1z * d2y;
-      this.b = d1z * d2x - d1x * d2z;
-      this.c = d1x * d2y - d1y * d2x;
-      this.d = -(this.a * p0.x + this.b * p0.y + this.c * p0.z);
-    }
-    /**
-     * @language en_US
-     * Fills this Plane3D with the coefficients from the plane's normal and a point in 3d space.
-     * @param normal Vector3
-     * @param point  Vector3
-     */
-    /**
-     * @language zh_CN
-     * 由一条normal向量和一个坐标创建一个3d平面
-     * @param normal Vector3
-     * @param point  Vector3
-     * @platform Web,Native
-     */
-    fromNormalAndPoint(normal, point) {
-      this.a = normal.x;
-      this.b = normal.y;
-      this.c = normal.z;
-      this.d = -(this.a * point.x + this.b * point.y + this.c * point.z);
-    }
-    /**
-     * @language en_US
-     * Normalize this Plane3D
-     * @returns Plane3D This Plane3D.
-     */
-    /**
-     * @language zh_CN
-     * 单位化3d平面
-     * @returns number 返回平面长度
-     * @platform Web,Native
-     */
-    normalize() {
-      var len = Math.sqrt(
-        this.a * this.a + this.b * this.b + this.c * this.c
-      );
-      if (len > 0) {
-        var invLength = 1 / len;
-        this.a *= invLength;
-        this.b *= invLength;
-        this.c *= invLength;
-        this.d *= invLength;
-      }
-      return len;
-    }
-    /**
-     * @language en_US
-     * Returns the signed distance between this Plane3D and the point p.
-     * @param p Vector3
-     * @returns Number
-     */
-    /**
-     * @language zh_CN
-     * 计算3d平面到点p的距离
-     * @param p Vector3
-     * @returns number 返回计算后的距离
-     * @platform Web,Native
-     */
-    distance(p) {
-      return this.a * p.x + this.b * p.y + this.c * p.z + this.d;
-    }
-    /**
-     * @language en_US
-     * Classify a point against this Plane3D. (in front, back or intersecting)
-     * @param p Vector3
-     * @param epsilon
-     * @returns PlaneClassification.FRONT在平面正面
-     * PlaneClassification.BACK在平面背面面
-     * PlaneClassification.INTERSECT在平面上
-     */
-    /**
-     * @language zh_CN
-     * 计算3d平面和点p的空间关系
-     * @param p Vector3
-     * @param epsilon 相对偏移值
-     * @returns number int Plane3.FRONT or Plane3D.BACK or Plane3D.INTERSECT
-     * @platform Web,Native
-     */
-    classifyPoint(p, epsilon = 0.01) {
-      var dis = this.distance(p);
-      if (dis < -epsilon) {
-        return PlaneClassification.BACK;
-      } else if (dis > epsilon) {
-        return PlaneClassification.FRONT;
-      }
-      return PlaneClassification.INTERSECT;
-    }
-    /**
-     * @language zh_CN
-     * 当前Plane3D以字符串形式返回
-     * @returns string
-     * @platform Web,Native
-     */
-    toString() {
-      return "Plane3D [a:" + this.a + ", b:" + this.b + ", c:" + this.c + ", d:" + this.d + "]";
-    }
-  }
+  var ParticleSystemRandomnessIds = /* @__PURE__ */ ((ParticleSystemRandomnessIds2) => {
+    ParticleSystemRandomnessIds2[ParticleSystemRandomnessIds2["kParticleSystemClampVelocityCurveId"] = 322376503] = "kParticleSystemClampVelocityCurveId";
+    ParticleSystemRandomnessIds2[ParticleSystemRandomnessIds2["kParticleSystemForceCurveId"] = 306581307] = "kParticleSystemForceCurveId";
+    ParticleSystemRandomnessIds2[ParticleSystemRandomnessIds2["kParticleSystemRotationCurveId"] = 1793934638] = "kParticleSystemRotationCurveId";
+    ParticleSystemRandomnessIds2[ParticleSystemRandomnessIds2["kParticleSystemRotationBySpeedCurveId"] = 3737431713] = "kParticleSystemRotationBySpeedCurveId";
+    ParticleSystemRandomnessIds2[ParticleSystemRandomnessIds2["kParticleSystemStartSpeedCurveId"] = 2527743459] = "kParticleSystemStartSpeedCurveId";
+    ParticleSystemRandomnessIds2[ParticleSystemRandomnessIds2["kParticleSystemSizeCurveId"] = 2368504881] = "kParticleSystemSizeCurveId";
+    ParticleSystemRandomnessIds2[ParticleSystemRandomnessIds2["kParticleSystemSizeBySpeedCurveId"] = 4085612399] = "kParticleSystemSizeBySpeedCurveId";
+    ParticleSystemRandomnessIds2[ParticleSystemRandomnessIds2["kParticleSystemVelocityCurveId"] = 3774601268] = "kParticleSystemVelocityCurveId";
+    ParticleSystemRandomnessIds2[ParticleSystemRandomnessIds2["kParticleSystemUVCurveId"] = 326370691] = "kParticleSystemUVCurveId";
+    ParticleSystemRandomnessIds2[ParticleSystemRandomnessIds2["kParticleSystemColorGradientId"] = 1494990940] = "kParticleSystemColorGradientId";
+    ParticleSystemRandomnessIds2[ParticleSystemRandomnessIds2["kParticleSystemColorByVelocityGradientId"] = 1089181156] = "kParticleSystemColorByVelocityGradientId";
+    ParticleSystemRandomnessIds2[ParticleSystemRandomnessIds2["kParticleSystemMeshSelectionId"] = 3159510623] = "kParticleSystemMeshSelectionId";
+    ParticleSystemRandomnessIds2[ParticleSystemRandomnessIds2["kParticleSystemUVRowSelectionId"] = 2941263940] = "kParticleSystemUVRowSelectionId";
+    return ParticleSystemRandomnessIds2;
+  })(ParticleSystemRandomnessIds || {});
+  const kPI = 3.141592653589793;
 
   class Polynomials {
   }
@@ -58851,6 +58641,403 @@ fn frag(){
     coeff[3] /= 1;
   }
 
+  var ParticleSystemCurveEvalMode = /* @__PURE__ */ ((ParticleSystemCurveEvalMode2) => {
+    ParticleSystemCurveEvalMode2[ParticleSystemCurveEvalMode2["kEMScalar"] = 0] = "kEMScalar";
+    ParticleSystemCurveEvalMode2[ParticleSystemCurveEvalMode2["kEMOptimized"] = 1] = "kEMOptimized";
+    ParticleSystemCurveEvalMode2[ParticleSystemCurveEvalMode2["kEMOptimizedMinMax"] = 2] = "kEMOptimizedMinMax";
+    ParticleSystemCurveEvalMode2[ParticleSystemCurveEvalMode2["kEMSlow"] = 3] = "kEMSlow";
+    return ParticleSystemCurveEvalMode2;
+  })(ParticleSystemCurveEvalMode || {});
+  var MinMaxCurveState = /* @__PURE__ */ ((MinMaxCurveState2) => {
+    MinMaxCurveState2[MinMaxCurveState2["kMMCScalar"] = 0] = "kMMCScalar";
+    MinMaxCurveState2[MinMaxCurveState2["kMMCCurve"] = 1] = "kMMCCurve";
+    MinMaxCurveState2[MinMaxCurveState2["kMMCTwoCurves"] = 2] = "kMMCTwoCurves";
+    MinMaxCurveState2[MinMaxCurveState2["kMMCTwoConstants"] = 3] = "kMMCTwoConstants";
+    return MinMaxCurveState2;
+  })(MinMaxCurveState || {});
+  class MinMaxAnimationCurves {
+    // public SupportsProcedural ();
+    max;
+    min;
+  }
+  class MinMaxPolyCurves {
+    max;
+    min;
+    integrate() {
+      this.max.integrate();
+      this.min.integrate();
+    }
+    doubleIntegrate() {
+      this.max.doubleIntegrate();
+      this.min.doubleIntegrate();
+    }
+    findMinMaxIntegrated() {
+      return null;
+    }
+    findMinMaxDoubleIntegrated() {
+      return null;
+    }
+  }
+  class MinMaxCurve {
+    minMaxState;
+    // see enum MinMaxCurveState
+    minCurve;
+    maxCurve;
+    _scalar = 1;
+    // Since scalar is baked into the optimized curve we use the setter function to modify it.
+    _minScalar;
+    constructor(scalarValue = 1) {
+      this._scalar = scalarValue;
+      this.minMaxState = 0 /* kMMCScalar */;
+      this.minCurve = new AnimationCurve();
+      this.maxCurve = new AnimationCurve();
+    }
+    setScalar(value) {
+      this._scalar = value;
+    }
+    getScalar() {
+      return this._scalar;
+    }
+    static evaluateSlow(curve, t, factor) {
+      let v = curve.maxCurve.getValue(t) * curve.getScalar();
+      if (curve.minMaxState == 2 /* kMMCTwoCurves */) {
+        return lerp(curve.minCurve.getValue(t) * curve.getScalar(), v, factor);
+      } else return v;
+    }
+    static evaluate(curve, t, randomValue = 1) {
+      if (curve.minMaxState == 0 /* kMMCScalar */) {
+        return curve.getScalar();
+      }
+      let v = curve.maxCurve.getValue(t) * curve.getScalar();
+      if (curve.minMaxState == 1 /* kMMCCurve */) {
+        return lerp(curve.minCurve.getValue(t) * curve.getScalar(), v, randomValue);
+      }
+      if (curve.minMaxState == 3 /* kMMCTwoConstants */) {
+        return lerp(curve._minScalar, curve._scalar, randomValue);
+      }
+      if (curve.minMaxState == 2 /* kMMCTwoCurves */) {
+        return lerp(curve.minCurve.getValue(t) * curve.getScalar(), v, 1 * Math.random());
+      }
+      return this.evaluateSlow(curve, t, 1);
+    }
+    unSerialized(data) {
+      this.minMaxState = data["minMaxState"];
+      this._scalar = data["scalar"];
+      this._minScalar = data["minScalar"];
+      this.maxCurve.unSerialized(data["maxCurve"]);
+      this.minCurve.unSerialized(data["minCurve"]);
+    }
+  }
+  class ValueSpread {
+    value = 0;
+    mode = 0;
+    spread = 0;
+    speed = new MinMaxCurve();
+    unSerialized(data) {
+      this.value = data["value"];
+      this.mode = data["mode"];
+      this.spread = data["spread"];
+      this.speed.unSerialized(data["speed"]);
+    }
+  }
+  function curvesSupportProcedural(editorCurves, minMaxState) {
+    let isValid = PolynomialCurve.isValidCurve(editorCurves.max);
+    if (minMaxState != 2 /* kMMCTwoCurves */ && minMaxState != 3 /* kMMCTwoConstants */) {
+      return isValid;
+    } else {
+      return isValid && PolynomialCurve.isValidCurve(editorCurves.min);
+    }
+  }
+  function buildCurves(polyCurves, editorCurves, scalar, minMaxState) {
+    polyCurves.max.buildCurve(editorCurves.max, scalar);
+    if (minMaxState != 2 /* kMMCTwoCurves */ && minMaxState != 3 /* kMMCTwoConstants */) {
+      polyCurves.min.buildCurve(editorCurves.max, scalar);
+    } else {
+      polyCurves.min.buildCurve(editorCurves.min, scalar);
+    }
+  }
+  function calculateCurveRangesValue(minMaxValue, curve) {
+    let keyCount = curve.getKeyCount();
+    if (keyCount == 0) {
+      return;
+    }
+    if (keyCount == 1) {
+      calculateMinMax(minMaxValue, curve.getKey(0).value);
+    } else {
+      let segmentCount = keyCount - 1;
+      calculateMinMax(minMaxValue, curve.getKey(0).value);
+      for (let i = 0; i < segmentCount; i++) {
+        let cache = new FrameCache();
+        curve.calculateCacheData(cache, i, i + 1, 0);
+        let a = 3 * cache.coeff[0];
+        let b = 2 * cache.coeff[1];
+        let c = 1 * cache.coeff[2];
+        let start = curve.getKey(i).time;
+        let end = curve.getKey(i + 1).time;
+        let roots = [];
+        let numRoots = quadraticPolynomialRootsGeneric(a, b, c, { r0: roots[0], r1: roots[1] });
+        for (let r = 0; r < numRoots; r++) {
+          if (roots[r] >= 0 && roots[r] + start < end) {
+            calculateMinMax(minMaxValue, Polynomial.EvalSegment(roots[r], cache.coeff));
+          }
+        }
+        calculateMinMax(minMaxValue, Polynomial.EvalSegment(end - start, cache.coeff));
+      }
+    }
+  }
+  function calculateMinMax(minmax, value) {
+    minmax.x = Math.min(minmax.x, value);
+    minmax.y = Math.max(minmax.y, value);
+  }
+
+  class PlaneClassification {
+    /**
+     * @language zh_CN
+     * 背面
+     * @platform Web,Native
+     */
+    static BACK = 0;
+    /**
+     * @language zh_CN
+     * 正面
+     * @platform Web,Native
+     */
+    static FRONT = 1;
+    /**
+     * @language zh_CN
+     * 在法线朝上的一面
+     * @platform Web,Native
+     */
+    static IN = 0;
+    /**
+     * @language zh_CN
+     * 在法线朝下的一面
+     * @platform Web,Native
+     */
+    static OUT = 1;
+    /**
+     * @language zh_CN
+     * 相交
+     * @platform Web,Native
+     */
+    static INTERSECT = 2;
+  }
+
+  class Plane3D {
+    /**
+     * @language en_US
+     * The A coefficient of this plane. (Also the x dimension of the plane normal)
+     */
+    /**
+     * @language zh_CN
+     * 平面中的a分量
+     * @platform Web,Native
+     */
+    a;
+    /**
+     * @language en_US
+     * The B coefficient of this plane. (Also the y dimension of the plane normal)
+     */
+    /**
+     * @language zh_CN
+     * 平面中的b分量
+     * @platform Web,Native
+     */
+    b;
+    /**
+     * @language en_US
+     * The C coefficient of this plane. (Also the z dimension of the plane normal)
+     */
+    /**
+     * @language zh_CN
+     * 平面中的c分量
+     * @platform Web,Native
+     */
+    c;
+    /**
+     * @language en_US
+     * The D coefficient of this plane. (Also the inverse dot product between normal and point)
+     */
+    /**
+     * @language zh_CN
+     * 平面中的d分量
+     * @platform Web,Native
+     */
+    d;
+    // indicates the alignment of the plane
+    /**
+     * @private
+     */
+    static ALIGN_ANY = 0;
+    /**
+     * @private
+     */
+    static ALIGN_XY_AXIS = 1;
+    /**
+     * @private
+     */
+    static ALIGN_YZ_AXIS = 2;
+    /**
+     * @private
+     */
+    static ALIGN_XZ_AXIS = 3;
+    /**
+     * @language en_US
+     * Create a Plane3D with ABCD coefficients
+     */
+    /**
+     * @language zh_CN
+     * 创建一个平面实例
+     * @param a
+     * @param b
+     * @param c
+     * @param d
+     * @platform Web,Native
+     */
+    constructor(a = 0, b = 0, c = 0, d = 0) {
+      this.a = a;
+      this.b = b;
+      this.c = c;
+      this.d = d;
+    }
+    /**
+     * @language zh_CN
+     * 填充平面的各分量的值
+     * @param a
+     * @param b
+     * @param c
+     * @param d
+     * @platform Web,Native
+     */
+    setTo(a = 0, b = 0, c = 0, d = 0) {
+      this.a = a;
+      this.b = b;
+      this.c = c;
+      this.d = d;
+    }
+    /**
+     * @language en_US
+     * Fills this Plane3D with the coefficients from 3 points in 3d space.
+     * @param p0 Vector3
+     * @param p1 Vector3
+     * @param p2 Vector3
+     */
+    /**
+     * @language zh_CN
+     * 由3个坐标来创建一个3d平面
+     * @param p0 Vector3
+     * @param p1 Vector3
+     * @param p2 Vector3
+     * @platform Web,Native
+     */
+    fromPoints(p0, p1, p2) {
+      var d1x = p1.x - p0.x;
+      var d1y = p1.y - p0.y;
+      var d1z = p1.z - p0.z;
+      var d2x = p2.x - p0.x;
+      var d2y = p2.y - p0.y;
+      var d2z = p2.z - p0.z;
+      this.a = d1y * d2z - d1z * d2y;
+      this.b = d1z * d2x - d1x * d2z;
+      this.c = d1x * d2y - d1y * d2x;
+      this.d = -(this.a * p0.x + this.b * p0.y + this.c * p0.z);
+    }
+    /**
+     * @language en_US
+     * Fills this Plane3D with the coefficients from the plane's normal and a point in 3d space.
+     * @param normal Vector3
+     * @param point  Vector3
+     */
+    /**
+     * @language zh_CN
+     * 由一条normal向量和一个坐标创建一个3d平面
+     * @param normal Vector3
+     * @param point  Vector3
+     * @platform Web,Native
+     */
+    fromNormalAndPoint(normal, point) {
+      this.a = normal.x;
+      this.b = normal.y;
+      this.c = normal.z;
+      this.d = -(this.a * point.x + this.b * point.y + this.c * point.z);
+    }
+    /**
+     * @language en_US
+     * Normalize this Plane3D
+     * @returns Plane3D This Plane3D.
+     */
+    /**
+     * @language zh_CN
+     * 单位化3d平面
+     * @returns number 返回平面长度
+     * @platform Web,Native
+     */
+    normalize() {
+      var len = Math.sqrt(
+        this.a * this.a + this.b * this.b + this.c * this.c
+      );
+      if (len > 0) {
+        var invLength = 1 / len;
+        this.a *= invLength;
+        this.b *= invLength;
+        this.c *= invLength;
+        this.d *= invLength;
+      }
+      return len;
+    }
+    /**
+     * @language en_US
+     * Returns the signed distance between this Plane3D and the point p.
+     * @param p Vector3
+     * @returns Number
+     */
+    /**
+     * @language zh_CN
+     * 计算3d平面到点p的距离
+     * @param p Vector3
+     * @returns number 返回计算后的距离
+     * @platform Web,Native
+     */
+    distance(p) {
+      return this.a * p.x + this.b * p.y + this.c * p.z + this.d;
+    }
+    /**
+     * @language en_US
+     * Classify a point against this Plane3D. (in front, back or intersecting)
+     * @param p Vector3
+     * @param epsilon
+     * @returns PlaneClassification.FRONT在平面正面
+     * PlaneClassification.BACK在平面背面面
+     * PlaneClassification.INTERSECT在平面上
+     */
+    /**
+     * @language zh_CN
+     * 计算3d平面和点p的空间关系
+     * @param p Vector3
+     * @param epsilon 相对偏移值
+     * @returns number int Plane3.FRONT or Plane3D.BACK or Plane3D.INTERSECT
+     * @platform Web,Native
+     */
+    classifyPoint(p, epsilon = 0.01) {
+      var dis = this.distance(p);
+      if (dis < -epsilon) {
+        return PlaneClassification.BACK;
+      } else if (dis > epsilon) {
+        return PlaneClassification.FRONT;
+      }
+      return PlaneClassification.INTERSECT;
+    }
+    /**
+     * @language zh_CN
+     * 当前Plane3D以字符串形式返回
+     * @returns string
+     * @platform Web,Native
+     */
+    toString() {
+      return "Plane3D [a:" + this.a + ", b:" + this.b + ", c:" + this.c + ", d:" + this.d + "]";
+    }
+  }
+
   function uniform_real_distribution(min, max) {
     return Math.random() * max + Math.random() * min + (max - min) * Math.random();
   }
@@ -63672,6 +63859,10 @@ fn frag(){
   exports.MergeRGBACreator = MergeRGBACreator;
   exports.MergeRGBA_cs = MergeRGBA_cs;
   exports.MeshColliderShape = MeshColliderShape;
+  exports.MinMaxAnimationCurves = MinMaxAnimationCurves;
+  exports.MinMaxCurve = MinMaxCurve;
+  exports.MinMaxCurveState = MinMaxCurveState;
+  exports.MinMaxPolyCurves = MinMaxPolyCurves;
   exports.MorePassParser = MorePassParser;
   exports.MorePassShader = MorePassShader;
   exports.MorphTargetBlender = MorphTargetBlender;
@@ -63719,6 +63910,8 @@ fn frag(){
   exports.PBRLitSSSShader = PBRLitSSSShader;
   exports.ParserBase = ParserBase;
   exports.ParserFormat = ParserFormat;
+  exports.ParticleSystemCurveEvalMode = ParticleSystemCurveEvalMode;
+  exports.ParticleSystemRandomnessIds = ParticleSystemRandomnessIds;
   exports.PassGenerate = PassGenerate;
   exports.PassShader = PassShader;
   exports.PassType = PassType;
@@ -63965,6 +64158,7 @@ fn frag(){
   exports.ValueEnumType = ValueEnumType;
   exports.ValueOp = ValueOp;
   exports.ValueParser = ValueParser;
+  exports.ValueSpread = ValueSpread;
   exports.Vector2 = Vector2;
   exports.Vector3 = Vector3;
   exports.Vector3Ex = Vector3Ex;
@@ -63998,6 +64192,9 @@ fn frag(){
   exports.append = append;
   exports.arrayToString = arrayToString;
   exports.blendComponent = blendComponent;
+  exports.buildCurves = buildCurves;
+  exports.calculateCurveRangesValue = calculateCurveRangesValue;
+  exports.calculateMinMax = calculateMinMax;
   exports.castPointShadowMap_vert = castPointShadowMap_vert;
   exports.clamp = clamp;
   exports.clampRepeat = clampRepeat;
@@ -64005,6 +64202,7 @@ fn frag(){
   exports.crossProduct = crossProduct;
   exports.cubicPolynomialRoot = cubicPolynomialRoot;
   exports.cubicPolynomialRootsGeneric = cubicPolynomialRootsGeneric;
+  exports.curvesSupportProcedural = curvesSupportProcedural;
   exports.deg2Rad = deg2Rad;
   exports.directionShadowCastMap_frag = directionShadowCastMap_frag;
   exports.dot = dot;
@@ -64027,6 +64225,7 @@ fn frag(){
   exports.grad4 = grad4;
   exports.integrateSegment = integrateSegment;
   exports.irradianceDataReader = irradianceDataReader;
+  exports.kPI = kPI;
   exports.lerp = lerp;
   exports.lerpByte = lerpByte;
   exports.lerpColor = lerpColor;