@galacean/engine-core 1.2.0-alpha.0 → 1.2.0-alpha.1

package/dist/main.js

@@ -59,347 +59,6 @@ function _inherits(subClass, superClass) {
     if (superClass) _set_prototype_of(subClass, superClass);
 }
 
-/**
- * Common utility methods for math operations.
- */ var MathUtil = /*#__PURE__*/ function() {
-    function MathUtil() {}
-    /**
-   * Clamps the specified value.
-   * @param v - The specified value
-   * @param min - The min value
-   * @param max - The max value
-   * @returns The result of clamping a value between min and max
-   */ MathUtil.clamp = function clamp(v, min, max) {
-        return Math.max(min, Math.min(max, v));
-    };
-    /**
-   * Checks if a and b are almost equals.
-   * The absolute value of the difference between a and b is close to zero.
-   * @param a - The left value to compare
-   * @param b - The right value to compare
-   * @returns True if a almost equal to b, false otherwise
-   */ MathUtil.equals = function equals(a, b) {
-        return Math.abs(a - b) <= MathUtil.zeroTolerance;
-    };
-    /**
-   * Determines whether the specified v is pow2.
-   * @param v - The specified v
-   * @returns True if the specified v is pow2, false otherwise
-   */ MathUtil.isPowerOf2 = function isPowerOf2(v) {
-        return (v & v - 1) === 0;
-    };
-    /**
-   * Modify the specified r from radian to degree.
-   * @param r - The specified r
-   * @returns The degree value
-   */ MathUtil.radianToDegree = function radianToDegree(r) {
-        return r * MathUtil.radToDegreeFactor;
-    };
-    /**
-   * Modify the specified d from degree to radian.
-   * @param d - The specified d
-   * @returns The radian value
-   */ MathUtil.degreeToRadian = function degreeToRadian(d) {
-        return d * MathUtil.degreeToRadFactor;
-    };
-    return MathUtil;
-}();
-(function() {
-    /** The value for which all absolute numbers smaller than are considered equal to zero. */ MathUtil.zeroTolerance = 1e-6;
-})();
-(function() {
-    /** The conversion factor that radian to degree. */ MathUtil.radToDegreeFactor = 180 / Math.PI;
-})();
-(function() {
-    /** The conversion factor that degree to radian. */ MathUtil.degreeToRadFactor = Math.PI / 180;
-})();
-
-/**
- * Describes a color in the from of RGBA (in order: R, G, B, A).
- */ var Color = /*#__PURE__*/ function() {
-    function Color(r, g, b, a) {
-        if (r === void 0) r = 1;
-        if (g === void 0) g = 1;
-        if (b === void 0) b = 1;
-        if (a === void 0) a = 1;
-        /** @internal */ this._onValueChanged = null;
-        this._r = r;
-        this._g = g;
-        this._b = b;
-        this._a = a;
-    }
-    var _proto = Color.prototype;
-    /**
-   * Set the value of this color.
-   * @param r - The red component of the color
-   * @param g - The green component of the color
-   * @param b - The blue component of the color
-   * @param a - The alpha component of the color
-   * @returns This color.
-   */ _proto.set = function set(r, g, b, a) {
-        this._r = r;
-        this._g = g;
-        this._b = b;
-        this._a = a;
-        this._onValueChanged && this._onValueChanged();
-        return this;
-    };
-    /**
-   * Determines the sum of this color and the specified color.
-   * @param color - The specified color
-   * @returns The added color
-   */ _proto.add = function add(color) {
-        this._r += color._r;
-        this._g += color._g;
-        this._b += color._b;
-        this._a += color._a;
-        this._onValueChanged && this._onValueChanged();
-        return this;
-    };
-    /**
-   * Scale this color by the given value.
-   * @param s - The amount by which to scale the color
-   * @returns The scaled color
-   */ _proto.scale = function scale(s) {
-        this._r *= s;
-        this._g *= s;
-        this._b *= s;
-        this._a *= s;
-        this._onValueChanged && this._onValueChanged();
-        return this;
-    };
-    /**
-   * Creates a clone of this color.
-   * @returns A clone of this color
-   */ _proto.clone = function clone() {
-        var ret = new Color(this._r, this._g, this._b, this._a);
-        return ret;
-    };
-    /**
-   * Copy from color like object.
-   * @param source - Color like object.
-   * @returns This vector
-   */ _proto.copyFrom = function copyFrom(source) {
-        this._r = source.r;
-        this._g = source.g;
-        this._b = source.b;
-        this._a = source.a;
-        this._onValueChanged && this._onValueChanged();
-        return this;
-    };
-    /**
-   * Copy from array like object.
-   * @param source - Array like object
-   * @param offset - The start offset
-   * @returns This color
-   */ _proto.copyFromArray = function copyFromArray(source, offset) {
-        if (offset === void 0) offset = 0;
-        this._r = source[offset];
-        this._g = source[offset + 1];
-        this._b = source[offset + 2];
-        this._a = source[offset + 3];
-        this._onValueChanged && this._onValueChanged();
-        return this;
-    };
-    /**
-   * Copy the value of this color to an array.
-   * @param out - The color
-   * @param outOffset - The start offset
-   */ _proto.copyToArray = function copyToArray(out, outOffset) {
-        if (outOffset === void 0) outOffset = 0;
-        out[outOffset] = this._r;
-        out[outOffset + 1] = this._g;
-        out[outOffset + 2] = this._b;
-        out[outOffset + 3] = this._a;
-    };
-    /**
-   * Modify components (r, g, b) of this color from gamma space to linear space.
-   * @param out - The color in linear space
-   * @returns The color in linear space
-   */ _proto.toLinear = function toLinear(out) {
-        out._r = Color.gammaToLinearSpace(this._r);
-        out._g = Color.gammaToLinearSpace(this._g);
-        out._b = Color.gammaToLinearSpace(this._b);
-        this._onValueChanged && this._onValueChanged();
-        return out;
-    };
-    /**
-   * Modify components (r, g, b) of this color from linear space to gamma space.
-   * @param out - The color in gamma space
-   * @returns The color in gamma space
-   */ _proto.toGamma = function toGamma(out) {
-        out._r = Color.linearToGammaSpace(this._r);
-        out._g = Color.linearToGammaSpace(this._g);
-        out._b = Color.linearToGammaSpace(this._b);
-        this._onValueChanged && this._onValueChanged();
-        return out;
-    };
-    /**
-   * Gets the brightness.
-   * @returns The Hue-Saturation-Brightness (HSB) saturation for this
-   */ _proto.getBrightness = function getBrightness() {
-        var r = this.r;
-        var g = this.g;
-        var b = this.b;
-        var max = r;
-        var min = r;
-        if (g > max) max = g;
-        if (b > max) max = b;
-        if (g < min) min = g;
-        if (b < min) min = b;
-        return (max + min) / 2;
-    };
-    /**
-   * Serialize this color to a JSON representation.
-   * @return A JSON representation of this color
-   */ _proto.toJSON = function toJSON() {
-        return {
-            r: this._r,
-            g: this._g,
-            b: this._b,
-            a: this._a
-        };
-    };
-    /**
-   * Modify a value from the gamma space to the linear space.
-   * @param value - The value in gamma space
-   * @returns The value in linear space
-   */ Color.gammaToLinearSpace = function gammaToLinearSpace(value) {
-        // https://www.khronos.org/registry/OpenGL/extensions/EXT/EXT_framebuffer_sRGB.txt
-        // https://www.khronos.org/registry/OpenGL/extensions/EXT/EXT_texture_sRGB_decode.txt
-        if (value <= 0.0) return 0.0;
-        else if (value <= 0.04045) return value / 12.92;
-        else if (value < 1.0) return Math.pow((value + 0.055) / 1.055, 2.4);
-        else return Math.pow(value, 2.4);
-    };
-    /**
-   * Modify a value from the linear space to the gamma space.
-   * @param value - The value in linear space
-   * @returns The value in gamma space
-   */ Color.linearToGammaSpace = function linearToGammaSpace(value) {
-        // https://www.khronos.org/registry/OpenGL/extensions/EXT/EXT_framebuffer_sRGB.txt
-        // https://www.khronos.org/registry/OpenGL/extensions/EXT/EXT_texture_sRGB_decode.txt
-        if (value <= 0.0) return 0.0;
-        else if (value < 0.0031308) return 12.92 * value;
-        else if (value < 1.0) return 1.055 * Math.pow(value, 0.41666) - 0.055;
-        else return Math.pow(value, 0.41666);
-    };
-    /**
-   * Determines whether the specified colors are equals.
-   * @param left - The first color to compare
-   * @param right - The second color to compare
-   * @returns True if the specified colors are equals, false otherwise
-   */ Color.equals = function equals(left, right) {
-        return MathUtil.equals(left._r, right._r) && MathUtil.equals(left._g, right._g) && MathUtil.equals(left._b, right._b) && MathUtil.equals(left._a, right._a);
-    };
-    /**
-   * Determines the sum of two colors.
-   * @param left - The first color to add
-   * @param right - The second color to add
-   * @param out - The sum of two colors
-   * @returns The added color
-   */ Color.add = function add(left, right, out) {
-        out._r = left._r + right._r;
-        out._g = left._g + right._g;
-        out._b = left._b + right._b;
-        out._a = left._a + right._a;
-        out._onValueChanged && out._onValueChanged();
-        return out;
-    };
-    /**
-   * Determines the difference between two colors.
-   * @param left - The first color to subtract
-   * @param right - The second color to subtract
-   * @param out - The difference between two colors
-   */ Color.subtract = function subtract(left, right, out) {
-        out._r = left._r - right._r;
-        out._g = left._g - right._g;
-        out._b = left._b - right._b;
-        out._a = left._a - right._a;
-        out._onValueChanged && out._onValueChanged();
-    };
-    /**
-   * Scale a color by the given value.
-   * @param left - The color to scale
-   * @param s - The amount by which to scale the color
-   * @param out - The scaled color
-   * @returns The scaled color
-   */ Color.scale = function scale(left, s, out) {
-        out._r = left._r * s;
-        out._g = left._g * s;
-        out._b = left._b * s;
-        out._a = left._a * s;
-        out._onValueChanged && out._onValueChanged();
-        return out;
-    };
-    /**
-   * Performs a linear interpolation between two color.
-   * @param start - The first color
-   * @param end - The second color
-   * @param t - The blend amount where 0 returns start and 1 end
-   * @param out - The result of linear blending between two color
-   */ Color.lerp = function lerp(start, end, t, out) {
-        var _r = start._r, _g = start._g, _b = start._b, _a = start._a;
-        out._r = _r + (end._r - _r) * t;
-        out._g = _g + (end._g - _g) * t;
-        out._b = _b + (end._b - _b) * t;
-        out._a = _a + (end._a - _a) * t;
-        out._onValueChanged && out._onValueChanged();
-        return out;
-    };
-    _create_class(Color, [
-        {
-            key: "r",
-            get: /**
-   * The red component of the color, 0~1.
-   */ function get() {
-                return this._r;
-            },
-            set: function set(value) {
-                this._r = value;
-                this._onValueChanged && this._onValueChanged();
-            }
-        },
-        {
-            key: "g",
-            get: /**
-   * The green component of the color, 0~1.
-   */ function get() {
-                return this._g;
-            },
-            set: function set(value) {
-                this._g = value;
-                this._onValueChanged && this._onValueChanged();
-            }
-        },
-        {
-            key: "b",
-            get: /**
-   * The blue component of the color, 0~1.
-   */ function get() {
-                return this._b;
-            },
-            set: function set(value) {
-                this._b = value;
-                this._onValueChanged && this._onValueChanged();
-            }
-        },
-        {
-            key: "a",
-            get: /**
-   * The alpha component of the color, 0~1.
-   */ function get() {
-                return this._a;
-            },
-            set: function set(value) {
-                this._a = value;
-                this._onValueChanged && this._onValueChanged();
-            }
-        }
-    ]);
-    return Color;
-}();
-
 /**
  * Sprite mask interaction.
  */ exports.SpriteMaskInteraction = void 0;
@@ -2120,20 +1779,28 @@ var ActiveChangeFlag;
                     this._enabled = value;
                     if (this._entity._isActiveInScene) {
                         if (value) {
-                            this._phasedActiveInScene = true;
-                            this._onEnableInScene();
+                            if (!this._phasedActiveInScene) {
+                                this._phasedActiveInScene = true;
+                                this._onEnableInScene();
+                            }
                         } else {
-                            this._phasedActiveInScene = false;
-                            this._onDisableInScene();
+                            if (this._phasedActiveInScene) {
+                                this._phasedActiveInScene = false;
+                                this._onDisableInScene();
+                            }
                         }
                     }
                     if (this._entity.isActiveInHierarchy) {
                         if (value) {
-                            this._phasedActive = true;
-                            this._onEnable();
+                            if (!this._phasedActive) {
+                                this._phasedActive = true;
+                                this._onEnable();
+                            }
                         } else {
-                            this._phasedActive = false;
-                            this._onDisable();
+                            if (this._phasedActive) {
+                                this._phasedActive = false;
+                                this._onDisable();
+                            }
                         }
                     }
                 }
@@ -9930,6 +9597,10 @@ var VertexElementIndex;
                 var sphereInfo = primitiveInfo;
                 PrimitiveMesh._setSphereData(this.resource, sphereInfo.radius, sphereInfo.segments, sphereInfo.noLongerAccessible, true, sphereInfo.vertexBuffer);
                 break;
+            case 7:
+                var CCSphereInfo = primitiveInfo;
+                PrimitiveMesh._setSubdivisionSurfaceSphereData(this.resource, CCSphereInfo.radius, CCSphereInfo.step, CCSphereInfo.noLongerAccessible, true, CCSphereInfo.vertexBuffer);
+                break;
             case 1:
                 var cuboidInfo = primitiveInfo;
                 PrimitiveMesh._setCuboidData(this.resource, cuboidInfo.width, cuboidInfo.height, cuboidInfo.depth, cuboidInfo.noLongerAccessible, true, cuboidInfo.vertexBuffer);
@@ -9967,6 +9638,7 @@ var PrimitiveType;
     PrimitiveType[PrimitiveType["Torus"] = 4] = "Torus";
     PrimitiveType[PrimitiveType["Cone"] = 5] = "Cone";
     PrimitiveType[PrimitiveType["Capsule"] = 6] = "Capsule";
+    PrimitiveType[PrimitiveType["CCSphere"] = 7] = "CCSphere";
 })(PrimitiveType || (PrimitiveType = {}));
 /**
  * @internal
@@ -9988,6 +9660,19 @@ var PrimitiveType;
     }
     return SphereRestoreInfo;
 }(PrimitiveRestoreInfo);
+/**
+ * @internal
+ */ var SubdivisionSurfaceSphereRestoreInfo = /*#__PURE__*/ function(PrimitiveRestoreInfo) {
+    _inherits(SubdivisionSurfaceSphereRestoreInfo, PrimitiveRestoreInfo);
+    function SubdivisionSurfaceSphereRestoreInfo(radius, step, vertexBuffer, noLongerAccessible) {
+        var _this;
+        _this = PrimitiveRestoreInfo.call(this, 7, vertexBuffer, noLongerAccessible) || this;
+        _this.radius = radius;
+        _this.step = step;
+        return _this;
+    }
+    return SubdivisionSurfaceSphereRestoreInfo;
+}(PrimitiveRestoreInfo);
 /**
  * @internal
  */ var CuboidRestoreInfo = /*#__PURE__*/ function(PrimitiveRestoreInfo) {
@@ -10102,6 +9787,24 @@ var PrimitiveType;
         return sphereMesh;
     };
     /**
+   * Create a sphere mesh by implementing Catmull-Clark Surface Subdivision Algorithm.
+   * Max step is limited to 6.
+   * @param engine - Engine
+   * @param radius - Sphere radius
+   * @param step - Number of subdiv steps
+   * @param noLongerAccessible - No longer access the vertices of the mesh after creation
+   * @returns Sphere model mesh
+   */ PrimitiveMesh.createSubdivisionSurfaceSphere = function createSubdivisionSurfaceSphere(engine, radius, step, noLongerAccessible) {
+        if (radius === void 0) radius = 0.5;
+        if (step === void 0) step = 3;
+        if (noLongerAccessible === void 0) noLongerAccessible = true;
+        var sphereMesh = new ModelMesh(engine);
+        PrimitiveMesh._setSubdivisionSurfaceSphereData(sphereMesh, radius, step, noLongerAccessible, false);
+        var vertexBuffer = sphereMesh.vertexBufferBindings[0].buffer;
+        engine.resourceManager.addContentRestorer(new PrimitiveMeshRestorer(sphereMesh, new SubdivisionSurfaceSphereRestoreInfo(radius, step, vertexBuffer, noLongerAccessible)));
+        return sphereMesh;
+    };
+    /**
    * Create a cuboid mesh.
    * @param engine - Engine
    * @param width - Cuboid width
@@ -10231,6 +9934,90 @@ var PrimitiveType;
     };
     /**
    * @internal
+   */ PrimitiveMesh._setSubdivisionSurfaceSphereData = function _setSubdivisionSurfaceSphereData(sphereMesh, radius, step, noLongerAccessible, isRestoreMode, restoreVertexBuffer) {
+        // Max step is limited to 6. Because 7 step will generate a single mesh with over 98306 vertices
+        step = engineMath.MathUtil.clamp(Math.floor(step), 1, 6);
+        var positions = new Float32Array(3 * (6 * Math.pow(4, step) + 2));
+        var cells = new Float32Array(24 * Math.pow(4, step));
+        PrimitiveMesh._subdiveCatmullClark(step, positions, cells);
+        var positionCount = positions.length / 3;
+        var cellsCount = cells.length / 4;
+        var poleOffset = positionCount + Math.pow(2, step + 1) - 1;
+        // 16 extra vertices for pole uv
+        // 2 vertices at each pole are idle
+        var vertexCount = poleOffset + 16;
+        var vertices = new Float32Array(vertexCount * 8);
+        var indices = PrimitiveMesh._generateIndices(sphereMesh.engine, positionCount, cellsCount * 6);
+        var seamCount = 0;
+        var seamVertices = {};
+        // Get normals, uvs, and scale to radius
+        for(var i = 0; i < positionCount; i++){
+            var offset = 3 * i;
+            var x = positions[offset];
+            var y = positions[offset + 1];
+            var z = positions[offset + 2];
+            var reciprocalLength = 1 / Math.sqrt(x * x + y * y + z * z);
+            x *= reciprocalLength;
+            y *= reciprocalLength;
+            z *= reciprocalLength;
+            offset = 8 * i;
+            vertices[offset] = x * radius;
+            vertices[offset + 1] = y * radius;
+            vertices[offset + 2] = z * radius;
+            vertices[offset + 3] = x;
+            vertices[offset + 4] = y;
+            vertices[offset + 5] = z;
+            vertices[offset + 6] = (Math.PI - Math.atan2(z, x)) / (2 * Math.PI);
+            vertices[offset + 7] = Math.acos(y) / Math.PI;
+            if (vertices[offset + 6] === 0) {
+                // Generate seam vertex
+                var seamOffset = 8 * (positionCount + seamCount++);
+                vertices.set(vertices.subarray(offset, offset + 8), seamOffset);
+                vertices[seamOffset + 6] = 1.0;
+                // Cache seam vertex
+                seamVertices[offset / 8] = seamOffset / 8;
+            }
+        }
+        // Get indices
+        var offset1 = 0;
+        this._spherePoleIdx = 0;
+        for(var i1 = 0; i1 < cellsCount; i1++){
+            var idx = 4 * i1;
+            var indexA = cells[idx];
+            var indexB = cells[idx + 1];
+            var indexC = cells[idx + 2];
+            var indexD = cells[idx + 3];
+            // Handle seam by replacing vertex index to seam vertex index if necessary
+            var floatIndexA = 8 * indexA;
+            var floatIndexB = 8 * indexB;
+            var floatIndexC = 8 * indexC;
+            var floatIndexD = 8 * indexD;
+            // If center Z is negative
+            if (vertices[floatIndexA + 2] + vertices[floatIndexB + 2] + vertices[floatIndexC + 2] < 0) {
+                vertices[floatIndexA + 6] === 0 && (indexA = seamVertices[indexA]);
+                vertices[floatIndexB + 6] === 0 && (indexB = seamVertices[indexB]);
+                vertices[floatIndexC + 6] === 0 && (indexC = seamVertices[indexC]);
+                vertices[floatIndexD + 6] === 0 && (indexD = seamVertices[indexD]);
+            }
+            indices[offset1] = indexA;
+            indices[offset1 + 1] = indexB;
+            indices[offset1 + 2] = indexC;
+            this._generateAndReplacePoleUV(indices, vertices, offset1, poleOffset);
+            indices[offset1 + 3] = indexA;
+            indices[offset1 + 4] = indexC;
+            indices[offset1 + 5] = indexD;
+            this._generateAndReplacePoleUV(indices, vertices, offset1 + 3, poleOffset);
+            offset1 += 6;
+        }
+        if (!isRestoreMode) {
+            var bounds = sphereMesh.bounds;
+            bounds.min.set(-radius, -radius, -radius);
+            bounds.max.set(radius, radius, radius);
+        }
+        PrimitiveMesh._initialize(sphereMesh, vertices, indices, noLongerAccessible, isRestoreMode, restoreVertexBuffer);
+    };
+    /**
+   * @internal
    */ PrimitiveMesh._setSphereData = function _setSphereData(sphereMesh, radius, segments, noLongerAccessible, isRestoreMode, restoreVertexBuffer) {
         segments = Math.max(2, Math.floor(segments));
         var count = segments + 1;
@@ -10291,6 +10078,135 @@ var PrimitiveType;
     };
     /**
    * @internal
+   */ PrimitiveMesh._subdiveCatmullClark = function _subdiveCatmullClark(step, positions, cells) {
+        var edges = new Map();
+        var faces = new Array();
+        positions.set(PrimitiveMesh._sphereSeedPositions);
+        cells.set(PrimitiveMesh._sphereSeedCells);
+        for(var i = 0; i < step; i++){
+            var cellCount = 6 * Math.pow(4, i);
+            var positionCount = 4 * cellCount + 2;
+            edges.clear();
+            faces.length = 0;
+            // Get cell face's facePoint
+            for(var j = 0; j < cellCount; j++){
+                var face = faces[j] = {
+                    facePoint: new engineMath.Vector3(),
+                    adjacentEdges: new Array(4)
+                };
+                // Get cell's edgePoint
+                for(var k = 0; k < 4; k++){
+                    var offset = 3 * cells[4 * j + k];
+                    face.facePoint.x += 0.25 * positions[offset];
+                    face.facePoint.y += 0.25 * positions[offset + 1];
+                    face.facePoint.z += 0.25 * positions[offset + 2];
+                }
+                // Get cell edges
+                for(var k1 = 0; k1 < 4; k1++){
+                    var vertexIdxA = cells[4 * j + k1];
+                    var vertexIdxB = cells[4 * j + (k1 + 1) % 4];
+                    var edgeIdxKey = Math.min(vertexIdxA, vertexIdxB) * positionCount + Math.max(vertexIdxA, vertexIdxB);
+                    if (!edges.has(edgeIdxKey)) {
+                        var edge = {
+                            edgePoint: new engineMath.Vector3(),
+                            edgePointIndex: undefined
+                        };
+                        var offsetA = 3 * vertexIdxA;
+                        var offsetB = 3 * vertexIdxB;
+                        edge.edgePoint.set(0.25 * (positions[offsetA] + positions[offsetB]), 0.25 * (positions[offsetA + 1] + positions[offsetB + 1]), 0.25 * (positions[offsetA + 2] + positions[offsetB + 2]));
+                        edges.set(edgeIdxKey, edge);
+                    }
+                    var edge1 = edges.get(edgeIdxKey);
+                    face.adjacentEdges[k1] = edge1;
+                    var edgePoint = edge1.edgePoint;
+                    var facePoint = face.facePoint;
+                    edgePoint.x += 0.25 * facePoint.x;
+                    edgePoint.y += 0.25 * facePoint.y;
+                    edgePoint.z += 0.25 * facePoint.z;
+                }
+            }
+            var prePointCount = cellCount + 2;
+            var edgePointOffset = prePointCount + cellCount;
+            var pointIdx = 0;
+            this._sphereEdgeIdx = 0;
+            var preCells = cells.slice(0, 4 * cellCount);
+            // Get New positions, which consists of updated positions of existing points, face points and edge points
+            for(var j1 = 0; j1 < cellCount; j1++){
+                // Add face point to new positions
+                var face1 = faces[j1];
+                face1.facePoint.copyToArray(positions, 3 * (prePointCount + j1));
+                // Get the face point index
+                var ic = prePointCount + j1;
+                var id = void 0, ib = void 0, temp = void 0;
+                //  ia -- id -- ia
+                //  |     |     |
+                //  ib -- ic -- ib
+                //  |     |     |
+                //  ia -- id -- ia
+                for(var k2 = 0; k2 < 4; k2++){
+                    // Get the updated existing point index
+                    var ia = preCells[pointIdx++];
+                    // ib and id share four edge points in one cell
+                    switch(k2){
+                        case 0:
+                            {
+                                var edgeB = face1.adjacentEdges[k2 % 4];
+                                var edgeD = face1.adjacentEdges[(k2 + 3) % 4];
+                                ib = this._calculateEdgeIndex(positions, edgeB, edgePointOffset);
+                                id = this._calculateEdgeIndex(positions, edgeD, edgePointOffset);
+                                temp = id;
+                                break;
+                            }
+                        case 1:
+                        case 2:
+                            {
+                                var edgeB1 = face1.adjacentEdges[k2 % 4];
+                                id = ib;
+                                ib = this._calculateEdgeIndex(positions, edgeB1, edgePointOffset);
+                                break;
+                            }
+                        case 3:
+                            {
+                                id = ib;
+                                ib = temp;
+                                break;
+                            }
+                    }
+                    var idx = 4 * (4 * j1 + k2);
+                    cells[idx] = ia;
+                    cells[idx + 1] = ib;
+                    cells[idx + 2] = ic;
+                    cells[idx + 3] = id;
+                }
+            }
+        }
+    };
+    /**
+   * Duplicate vertices at the poles and adjust their UV coordinates.
+   */ PrimitiveMesh._generateAndReplacePoleUV = function _generateAndReplacePoleUV(indices, vertices, idx, poleOffset) {
+        var v = vertices[8 * indices[idx] + 7];
+        if (v === 0 || v === 1) {
+            var offset = 8 * indices[idx];
+            var addedOffset = 8 * (poleOffset + this._spherePoleIdx);
+            vertices.set(vertices.subarray(offset, offset + 8), addedOffset);
+            vertices[addedOffset + 6] = 0.5 * (vertices[offset + 6] + vertices[8 * indices[idx + 1] + 6] + vertices[8 * indices[idx + 2] + 6] - 0.5);
+            indices[idx] = poleOffset + this._spherePoleIdx++;
+        }
+    };
+    /**
+   * Get edge point index for subdivision surface sphere.
+   */ PrimitiveMesh._calculateEdgeIndex = function _calculateEdgeIndex(positions, edge, offset) {
+        if (edge.edgePointIndex !== undefined) {
+            return edge.edgePointIndex;
+        } else {
+            edge.edgePoint.copyToArray(positions, 3 * (offset + PrimitiveMesh._sphereEdgeIdx));
+            var index = offset + PrimitiveMesh._sphereEdgeIdx++;
+            edge.edgePointIndex = index;
+            return index;
+        }
+    };
+    /**
+   * @internal
    */ PrimitiveMesh._setCuboidData = function _setCuboidData(cuboidMesh, width, height, depth, noLongerAccessible, isRestoreMode, restoreVertexBuffer) {
         var halfWidth = width / 2;
         var halfHeight = height / 2;
@@ -10920,6 +10836,68 @@ var PrimitiveType;
 (function() {
     PrimitiveMesh._tempVec30 = new engineMath.Vector3();
 })();
+(function() {
+    PrimitiveMesh._sphereSeedPositions = new Float32Array([
+        -1,
+        1,
+        1,
+        -1,
+        -1,
+        1,
+        1,
+        -1,
+        1,
+        1,
+        1,
+        1,
+        1,
+        -1,
+        -1,
+        1,
+        1,
+        -1,
+        -1,
+        -1,
+        -1,
+        -1,
+        1,
+        -1
+    ]);
+})();
+(function() {
+    PrimitiveMesh._sphereSeedCells = new Float32Array([
+        0,
+        1,
+        2,
+        3,
+        3,
+        2,
+        4,
+        5,
+        5,
+        4,
+        6,
+        7,
+        7,
+        0,
+        3,
+        5,
+        7,
+        6,
+        1,
+        0,
+        6,
+        4,
+        2,
+        1
+    ]);
+})();
+(function() {
+    PrimitiveMesh._sphereEdgeIdx = 0;
+})();
+(function() {
+    PrimitiveMesh._spherePoleIdx = 0;
+})();
 
 /**
  * Mesh skin data, equal glTF skins define
@@ -11464,8 +11442,10 @@ var Basic2DBatcher = /*#__PURE__*/ function() {
         }
         mesh.addSubMesh(this._getSubMeshFromPool(vertexStartIndex, vertexCount));
         batchedQueue[curMeshIndex] = preElement;
-        this._vertexBuffers[_flushId].setData(vertices, 0, 0, vertexIndex);
-        this._indiceBuffers[_flushId].setData(indices, 0, 0, indiceIndex);
+        // Set data option use Discard, or will resulted in performance slowdown when open antialias and cross-rendering of 3D and 2D elements.
+        // Device: iphone X(16.7.2)、iphone 15 pro max(17.1.1)、iphone XR(17.1.2) etc.
+        this._vertexBuffers[_flushId].setData(vertices, 0, 0, vertexIndex, exports.SetDataOptions.Discard);
+        this._indiceBuffers[_flushId].setData(indices, 0, 0, indiceIndex, exports.SetDataOptions.Discard);
     };
     _proto._getSubMeshFromPool = function _getSubMeshFromPool(start, count) {
         var subMesh = this._subMeshPool.getFromPool();
@@ -12495,6 +12475,9 @@ var /**
 __decorate([
     assignmentClone
 ], SpriteMask.prototype, "influenceLayers", void 0);
+__decorate([
+    ignoreClone
+], SpriteMask.prototype, "_verticesData", void 0);
 __decorate([
     ignoreClone
 ], SpriteMask.prototype, "_sprite", void 0);
@@ -12778,8 +12761,8 @@ var /**
                     } else {
                         word += char;
                         wordWidth += charInfo.xAdvance;
-                        wordMaxAscent = lineMaxAscent = Math.max(wordMaxAscent, ascent);
-                        wordMaxDescent = lineMaxDescent = Math.max(wordMaxDescent, descent);
+                        wordMaxAscent = Math.max(wordMaxAscent, ascent);
+                        wordMaxDescent = Math.max(wordMaxDescent, descent);
                     }
                 }
             }
@@ -13010,13 +12993,15 @@ var /**
     ];
 })();
 (function() {
-    /** These characters are all tall to help calculate the height required for text. */ TextUtils._measureString = "|\xc9q\xc5";
+    // _heightMultiplier used to measure the height of text, but in miniprogram performance is different from h5.
+    // so can set _heightMultiplier to adapt miniprogram, the larger the value, the worse the performance.
+    /** @internal */ TextUtils._heightMultiplier = 2;
 })();
 (function() {
-    TextUtils._measureBaseline = "M";
+    /** These characters are all tall to help calculate the height required for text. */ TextUtils._measureString = "|\xc9q\xc5";
 })();
 (function() {
-    TextUtils._heightMultiplier = 2;
+    TextUtils._measureBaseline = "M";
 })();
 (function() {
     TextUtils._baselineMultiplier = 1.4;
@@ -13099,7 +13084,8 @@ var /**
     _proto._createFontAtlas = function _createFontAtlas() {
         var _this = this, engine = _this._engine;
         var fontAtlas = new FontAtlas(engine);
-        var texture = new Texture2D(engine, 256, 256);
+        var texture = new Texture2D(engine, 256, 256, exports.TextureFormat.R8G8B8A8, false);
+        texture.filterMode = exports.TextureFilterMode.Bilinear;
         fontAtlas.texture = texture;
         fontAtlas.isGCIgnored = texture.isGCIgnored = true;
         this._fontAtlases.push(fontAtlas);
@@ -13337,7 +13323,7 @@ var /**
     /**
    * @internal
    */ _proto._render = function _render(context) {
-        if (this._text === "" || this.enableWrapping && this.width <= 0 || this.overflowMode === exports.OverflowMode.Truncate && this.height <= 0) {
+        if (this._isTextNoVisible()) {
             return;
         }
         if (this._isContainDirtyFlag(0x10)) {
@@ -13429,8 +13415,8 @@ var /**
         }
     };
     _proto._updateLocalData = function _updateLocalData() {
-        var _this = this, color = _this.color, charRenderDatas = _this._charRenderDatas, charFont = _this._subFont;
         var _this__localBounds = this._localBounds, min = _this__localBounds.min, max = _this__localBounds.max;
+        var _this = this, color = _this.color, charRenderDatas = _this._charRenderDatas, charFont = _this._subFont;
         var textMetrics = this.enableWrapping ? TextUtils.measureTextWithWrap(this) : TextUtils.measureTextWithoutWrap(this);
         var height = textMetrics.height, lines = textMetrics.lines, lineWidths = textMetrics.lineWidths, lineHeight = textMetrics.lineHeight, lineMaxSizes = textMetrics.lineMaxSizes;
         var charRenderDataPool = TextRenderer._charRenderDataPool;
@@ -13498,7 +13484,7 @@ var /**
                             var left = startX * pixelsPerUnitReciprocal;
                             var right = (startX + w) * pixelsPerUnitReciprocal;
                             var top = (startY + ascent) * pixelsPerUnitReciprocal;
-                            var bottom = (startY - descent + 1) * pixelsPerUnitReciprocal;
+                            var bottom = (startY - descent) * pixelsPerUnitReciprocal;
                             localPositions.set(left, top, right, bottom);
                             i === firstLine && (maxY = Math.max(maxY, top));
                             minY = Math.min(minY, bottom);
@@ -13539,6 +13525,9 @@ var /**
         Renderer1.prototype._onTransformChanged.call(this, bit);
         this._setDirtyFlagTrue(0x4 | 0x8);
     };
+    _proto._isTextNoVisible = function _isTextNoVisible() {
+        return this._text === "" || this._fontSize === 0 || this.enableWrapping && this.width <= 0 || this.overflowMode === exports.OverflowMode.Truncate && this.height <= 0;
+    };
     _create_class(TextRenderer, [
         {
             key: "color",
@@ -13741,6 +13730,16 @@ var /**
             get: /**
    * The bounding volume of the TextRenderer.
    */ function get() {
+                if (this._isTextNoVisible()) {
+                    if (this._isContainDirtyFlag(0x8)) {
+                        var localBounds = this._localBounds;
+                        localBounds.min.set(0, 0, 0);
+                        localBounds.max.set(0, 0, 0);
+                        this._updateBounds(this._bounds);
+                        this._setDirtyFlagFalse(0x8);
+                    }
+                    return this._bounds;
+                }
                 this._isContainDirtyFlag(0x1) && this._resetSubFont();
                 this._isContainDirtyFlag(0x2) && this._updateLocalData();
                 this._isContainDirtyFlag(0x4) && this._updatePosition();
@@ -15729,6 +15728,66 @@ var rePropName = RegExp(// Match anything that isn't a dot or bracket.
             }
         }
     };
+    /**
+   * @internal
+   */ SystemInfo._detectSIMDSupported = function _detectSIMDSupported() {
+        if (this._simdSupported === null) {
+            this._simdSupported = WebAssembly.validate(new Uint8Array([
+                0,
+                97,
+                115,
+                109,
+                1,
+                0,
+                0,
+                0,
+                1,
+                4,
+                1,
+                96,
+                0,
+                0,
+                3,
+                3,
+                2,
+                0,
+                0,
+                5,
+                3,
+                1,
+                0,
+                1,
+                12,
+                1,
+                0,
+                10,
+                22,
+                2,
+                12,
+                0,
+                65,
+                0,
+                65,
+                0,
+                65,
+                0,
+                252,
+                10,
+                0,
+                0,
+                11,
+                7,
+                0,
+                65,
+                0,
+                253,
+                15,
+                26,
+                11
+            ]));
+        }
+        return this._simdSupported;
+    };
     _create_class(SystemInfo, null, [
         {
             key: "devicePixelRatio",
@@ -15747,6 +15806,9 @@ var rePropName = RegExp(// Match anything that isn't a dot or bracket.
 (function() {
     /** The operating system is running on. */ SystemInfo.operatingSystem = "";
 })();
+(function() {
+    /** Whether the system support SIMD. */ SystemInfo._simdSupported = null;
+})();
 SystemInfo._initialize();
 
 /**
@@ -18580,6 +18642,8 @@ __decorate([
         _this = ReferResource1.call(this, engine) || this;
         /** @internal */ _this._renderStates = [] // todo: later will as a part of shaderData when shader effect frame is OK, that is more powerful and flexible.
         ;
+        /** @internal */ _this._priority = 0 // todo: temporary resolution of submesh rendering order issue.
+        ;
         _this._shaderData = new ShaderData(ShaderDataGroup.Material);
         _this.shader = shader;
         return _this;
@@ -19049,11 +19113,11 @@ ShaderPool.init();
         }
         var meshMagentaMaterial = new Material(_assert_this_initialized(_this), Shader.find("unlit"));
         meshMagentaMaterial.isGCIgnored = true;
-        meshMagentaMaterial.shaderData.setColor("material_BaseColor", new Color(1.0, 0.0, 1.01, 1.0));
+        meshMagentaMaterial.shaderData.setColor("material_BaseColor", new engineMath.Color(1.0, 0.0, 1.01, 1.0));
         _this._meshMagentaMaterial = meshMagentaMaterial;
         var particleMagentaMaterial = new Material(_assert_this_initialized(_this), Shader.find("particle-shader"));
         particleMagentaMaterial.isGCIgnored = true;
-        particleMagentaMaterial.shaderData.setColor("material_BaseColor", new Color(1.0, 0.0, 1.01, 1.0));
+        particleMagentaMaterial.shaderData.setColor("material_BaseColor", new engineMath.Color(1.0, 0.0, 1.01, 1.0));
         _this._particleMagentaMaterial = particleMagentaMaterial;
         var innerSettings = _this._settings;
         var colorSpace = configuration.colorSpace || exports.ColorSpace.Linear;
@@ -21869,12 +21933,38 @@ var passNum = 0;
     /**
    * @internal
    */ RenderQueue._compareFromNearToFar = function _compareFromNearToFar(a, b) {
-        return a.data.component.priority - b.data.component.priority || a.data.component._distanceForSort - b.data.component._distanceForSort;
+        var dataA = a.data;
+        var dataB = b.data;
+        var componentA = dataA.component;
+        var componentB = dataB.component;
+        var priorityOrder = componentA.priority - componentB.priority;
+        if (priorityOrder !== 0) {
+            return priorityOrder;
+        }
+        // make suer from the same renderer.
+        if (componentA.instanceId === componentB.instanceId) {
+            return dataA.material._priority - dataB.material._priority || componentA._distanceForSort - componentB._distanceForSort;
+        } else {
+            return componentA._distanceForSort - componentB._distanceForSort;
+        }
     };
     /**
    * @internal
    */ RenderQueue._compareFromFarToNear = function _compareFromFarToNear(a, b) {
-        return a.data.component.priority - b.data.component.priority || b.data.component._distanceForSort - a.data.component._distanceForSort;
+        var dataA = a.data;
+        var dataB = b.data;
+        var componentA = dataA.component;
+        var componentB = dataB.component;
+        var priorityOrder = componentA.priority - componentB.priority;
+        if (priorityOrder !== 0) {
+            return priorityOrder;
+        }
+        // make suer from the same renderer.
+        if (componentA.instanceId === componentB.instanceId) {
+            return dataA.material._priority - dataB.material._priority || componentB._distanceForSort - componentA._distanceForSort;
+        } else {
+            return componentB._distanceForSort - componentA._distanceForSort;
+        }
     };
     return RenderQueue;
 }();
@@ -25245,6 +25335,7 @@ AnimationCurveOwner.registerAssembler(SkinnedMeshRenderer, "blendShapeWeights",
         _this = EngineObject1.call(this, null) || this;
         _this.name = name;
         _this./** @internal */ _curveBindings = [];
+        _this./** @internal */ _updateFlagManager = new UpdateFlagManager();
         _this._length = 0;
         _this._events = [];
         return _this;
@@ -25272,11 +25363,13 @@ AnimationCurveOwner.registerAssembler(SkinnedMeshRenderer, "blendShapeWeights",
             while(--index >= 0 && eventTime < events[index].time);
             events.splice(index + 1, 0, newEvent);
         }
+        this._updateFlagManager.dispatch();
     };
     /**
    * Clears all events from the clip.
    */ _proto.clearEvents = function clearEvents() {
         this._events.length = 0;
+        this._updateFlagManager.dispatch();
     };
     _proto.addCurveBinding = function addCurveBinding(entityPath, componentType, propertyOrSetPropertyPathOrComponentIndex, curveOrSetPropertyPathOrGetPropertyPath, curveOrGetPropertyPath, curve) {
         var curveBinding = new AnimationClipCurveBinding();
@@ -26833,26 +26926,31 @@ exports.AnimatorLayerBlendingMode = void 0;
         }
     };
     _proto._saveAnimatorEventHandlers = function _saveAnimatorEventHandlers(state, animatorStateData) {
+        var _this = this;
         var eventHandlerPool = this._animationEventHandlerPool;
         var scripts = [];
-        this._entity.getComponents(Script, scripts);
-        var scriptCount = scripts.length;
         var eventHandlers = animatorStateData.eventHandlers;
-        var events = state.clip.events;
-        eventHandlers.length = 0;
-        for(var i = 0, n = events.length; i < n; i++){
-            var event = events[i];
-            var eventHandler = eventHandlerPool.getFromPool();
-            var funcName = event.functionName;
-            var handlers = eventHandler.handlers;
-            eventHandler.event = event;
-            handlers.length = 0;
-            for(var j = scriptCount - 1; j >= 0; j--){
-                var handler = scripts[j][funcName];
-                handler && handlers.push(handler);
+        var clipChangedListener = function() {
+            _this._entity.getComponents(Script, scripts);
+            var scriptCount = scripts.length;
+            var events = state.clip.events;
+            eventHandlers.length = 0;
+            for(var i = 0, n = events.length; i < n; i++){
+                var event = events[i];
+                var eventHandler = eventHandlerPool.getFromPool();
+                var funcName = event.functionName;
+                var handlers = eventHandler.handlers;
+                eventHandler.event = event;
+                handlers.length = 0;
+                for(var j = scriptCount - 1; j >= 0; j--){
+                    var handler = scripts[j][funcName];
+                    handler && handlers.push(handler);
+                }
+                eventHandlers.push(eventHandler);
             }
-            eventHandlers.push(eventHandler);
-        }
+        };
+        clipChangedListener();
+        state._updateFlagManager.addListener(clipChangedListener);
     };
     _proto._clearCrossData = function _clearCrossData(animatorLayerData) {
         animatorLayerData.crossCurveMark++;
@@ -27463,9 +27561,11 @@ __decorate([
         this./** @internal */ _onStateEnterScripts = [];
         this./** @internal */ _onStateUpdateScripts = [];
         this./** @internal */ _onStateExitScripts = [];
+        this./** @internal */ _updateFlagManager = new UpdateFlagManager();
         this._clipStartTime = 0;
         this._clipEndTime = 1;
         this._transitions = [];
+        this._onClipChanged = this._onClipChanged.bind(this);
     }
     var _proto = AnimatorState.prototype;
     /**
@@ -27539,6 +27639,11 @@ __decorate([
             index2 !== -1 && this._onStateExitScripts.splice(index2, 1);
         }
     };
+    /**
+   * @internal
+   */ _proto._onClipChanged = function _onClipChanged() {
+        this._updateFlagManager.dispatch();
+    };
     _create_class(AnimatorState, [
         {
             key: "transitions",
@@ -27556,8 +27661,17 @@ __decorate([
                 return this._clip;
             },
             set: function set(clip) {
+                var lastClip = this._clip;
+                if (lastClip === clip) {
+                    return;
+                }
+                if (lastClip) {
+                    lastClip._updateFlagManager.removeListener(this._onClipChanged);
+                }
                 this._clip = clip;
                 this._clipEndTime = Math.min(this._clipEndTime, 1);
+                this._onClipChanged();
+                clip._updateFlagManager.addListener(this._onClipChanged);
             }
         },
         {