@galacean/effects-threejs 2.0.0-alpha.16 → 2.0.0-alpha.18

package/dist/index.js

@@ -3,7 +3,7 @@
  * Description: Galacean Effects runtime threejs plugin for the web
  * Author: Ant Group CO., Ltd.
  * Contributors: 燃然,飂兮,十弦,云垣,茂安,意绮
- * Version: v2.0.0-alpha.16
+ * Version: v2.0.0-alpha.18
  */
 
 'use strict';
@@ -474,7 +474,6 @@ function isSimulatorCellPhone() {
 }
 function isAlipayMiniApp() {
     var _my;
-    // @ts-expect-error
     return typeof my !== "undefined" && ((_my = my) == null ? void 0 : _my.renderTarget) === "web";
 }
 
@@ -730,8 +729,8 @@ function noop() {}
  *
  * @static
  * @function isString
- * @param {object} obj - 要判断的对象
- * @return {boolean}
+ * @param obj - 要判断的对象
+ * @return
  */ function isString(obj) {
     return typeof obj === "string";
 }
@@ -740,8 +739,8 @@ function noop() {}
  *
  * @static
  * @function isArray
- * @param {object} obj - 要判断的对象
- * @return {boolean}
+ * @param obj - 要判断的对象
+ * @return
  */ var isArray = Array.isArray || function(obj) {
     return Object.prototype.toString.call(obj) === "[object Array]";
 };
@@ -750,8 +749,8 @@ function noop() {}
  *
  * @static
  * @function isFunction
- * @param {object} obj - 要判断的对象
- * @return {boolean}
+ * @param obj - 要判断的对象
+ * @return
  */ function isFunction(obj) {
     return Object.prototype.toString.call(obj) === "[object Function]";
 }
@@ -760,8 +759,8 @@ function noop() {}
  *
  * @static
  * @function isObject
- * @param {object} obj - 要判断的对象
- * @return {boolean}
+ * @param obj - 要判断的对象
+ * @return
  */ function isObject(obj) {
     return Object.prototype.toString.call(obj) === "[object Object]";
 }
@@ -770,29 +769,16 @@ function isCanvas(canvas) {
     // 小程序 Canvas 无法使用 instanceof HTMLCanvasElement 判断
     return typeof canvas === "object" && canvas !== null && ((_canvas_tagName = canvas.tagName) == null ? void 0 : _canvas_tagName.toUpperCase()) === "CANVAS";
 }
-function deepClone(obj) {
-    if (isArray(obj)) {
-        return obj.map(deepClone);
-    } else if (obj && typeof obj === "object") {
-        if (ArrayBuffer.isView(obj)) {
-            return obj.slice();
-        }
-        var ret = {};
-        var kas = Object.keys(obj);
-        for(var i = 0; i < kas.length; i++){
-            var key = kas[i];
-            ret[key] = deepClone(obj[key]);
-        }
-        return ret;
-    }
-    return obj;
-}
-// TODO: 改名
-function random(min, max) {
+/**
+ * 生成一个位于 min 和 max 之间的随机数
+ * @param min
+ * @param max
+ * @returns
+ */ function randomInRange(min, max) {
     return min + Math.random() * (max - min);
 }
 function throwDestroyedError() {
-    throw Error("destroyed item cannot be used again");
+    throw new Error("Destroyed item cannot be used again.");
 }
 function generateGUID() {
     return v4().replace(/-/g, "");
@@ -4119,7 +4105,7 @@ var CameraClipMode;
      * 蒙版形状切分
      */ ValueType[ValueType["SHAPE_SPLITS"] = 11] = "SHAPE_SPLITS";
     /**
-     *直线路径
+     * 直线路径
      */ ValueType[ValueType["LINEAR_PATH"] = 12] = "LINEAR_PATH";
     /**
      * 多色
@@ -4295,7 +4281,7 @@ var TextAlignment;
 (function(TextAlignment) {
     /**
      * text alignment starts from（x,y) to right direction
-     * 从(x,y)开始第一个字符，向右边延伸
+     * 从 (x,y) 开始第一个字符，向右边延伸
      */ TextAlignment[TextAlignment["left"] = 0] = "left";
     /**
      * (x,y) is middle position of text, where (left + right)/2 =(x,y)
@@ -4303,7 +4289,7 @@ var TextAlignment;
      */ TextAlignment[TextAlignment["middle"] = 1] = "middle";
     /**
      * text alignment ends with（x,y) from left direction
-     * 从(x,y)结束最后一个字符，向左边延伸
+     * 从 (x,y) 结束最后一个字符，向左边延伸
      */ TextAlignment[TextAlignment["right"] = 2] = "right";
 })(TextAlignment || (TextAlignment = {}));
 /**
@@ -4353,6 +4339,7 @@ var DataType;
     DataType["TimelineAsset"] = "TimelineAsset";
     DataType["TransformPlayableAsset"] = "TransformPlayableAsset";
     DataType["SpriteColorPlayableAsset"] = "SpriteColorPlayableAsset";
+    DataType["BinaryAsset"] = "BinaryAsset";
     // FIXME: 先完成ECS的场景转换，后面移到spec中
     DataType["MeshComponent"] = "MeshComponent";
     DataType["SkyboxComponent"] = "SkyboxComponent";
@@ -4361,6 +4348,7 @@ var DataType;
     DataType["ModelPluginComponent"] = "ModelPluginComponent";
     DataType["TreeComponent"] = "TreeComponent";
     DataType["AnimationComponent"] = "AnimationComponent";
+    DataType["SpineComponent"] = "SpineComponent";
     // Non-EffectObject
     DataType["TimelineClip"] = "TimelineClip";
 })(DataType || (DataType = {}));
@@ -4448,11 +4436,11 @@ var VertexBufferSemantic;
     VertexBufferSemantic["TangentBS3"] = "TANGENT_BS3";
 })(VertexBufferSemantic || (VertexBufferSemantic = {}));
 
-var BuiltinObjectGUID = function BuiltinObjectGUID() {
+var BuiltinObjectGUID = {
+    WhiteTexture: "whitetexture00000000000000000000",
+    PBRShader: "pbr00000000000000000000000000000",
+    UnlitShader: "unlit000000000000000000000000000"
 };
-BuiltinObjectGUID.WhiteTexture = "whitetexture00000000000000000000";
-BuiltinObjectGUID.PBRShader = "pbr00000000000000000000000000000";
-BuiltinObjectGUID.UnlitShader = "unlit000000000000000000000000000";
 
 var index$1 = /*#__PURE__*/Object.freeze({
     __proto__: null,
@@ -4508,15 +4496,20 @@ var index$1 = /*#__PURE__*/Object.freeze({
     BuiltinObjectGUID: BuiltinObjectGUID
 });
 
-var effectsClassStore = {};
 var decoratorInitialStore = {};
 var mergedStore = {};
-function getDirectStore(target) {
-    var classKey = target.constructor.name;
-    if (!decoratorInitialStore[classKey]) {
-        decoratorInitialStore[classKey] = {};
-    }
-    return decoratorInitialStore[classKey];
+var effectsClassStore = {};
+function effectsClass(className) {
+    return function(target, context) {
+        if (effectsClassStore[className]) {
+            console.warn("Class " + className + " is already registered.");
+        }
+        // TODO: three修改json dataType, 这边重复注册直接 return
+        effectsClassStore[className] = target;
+    };
+}
+function serialize(type, sourceName) {
+    return generateSerializableMember(type, sourceName); // value member
 }
 function getMergedStore(target) {
     var classKey = target.constructor.name;
@@ -4541,18 +4534,6 @@ function getMergedStore(target) {
     }
     return store;
 }
-function serialize(type, sourceName) {
-    return generateSerializableMember(type, sourceName); // value member
-}
-function effectsClass(className) {
-    return function(target, context) {
-        if (effectsClassStore[className]) {
-            console.warn("Class " + className + " 重复注册");
-        }
-        //TODO: three修改json dataType, 这边重复注册直接 return
-        effectsClassStore[className] = target;
-    };
-}
 function generateSerializableMember(type, sourceName) {
     return function(target, propertyKey) {
         var classStore = getDirectStore(target);
@@ -4564,6 +4545,13 @@ function generateSerializableMember(type, sourceName) {
         }
     };
 }
+function getDirectStore(target) {
+    var classKey = target.constructor.name;
+    if (!decoratorInitialStore[classKey]) {
+        decoratorInitialStore[classKey] = {};
+    }
+    return decoratorInitialStore[classKey];
+}
 
 /**
  * @since 2.0.0
@@ -4595,6 +4583,9 @@ function generateSerializableMember(type, sourceName) {
         }
     };
     _proto.dispose = function dispose() {};
+    EffectsObject.is = function is(obj) {
+        return _instanceof1(obj, EffectsObject) && "guid" in obj;
+    };
     return EffectsObject;
 }();
 __decorate([
@@ -4747,6 +4738,7 @@ __decorate([
         _this = Component.apply(this, arguments) || this;
         _this.started = false;
         _this.materials = [];
+        _this._priority = 0;
         _this._enabled = true;
         return _this;
     }
@@ -7378,8 +7370,8 @@ var SEMANTIC_MAIN_PRE_COLOR_ATTACHMENT_0 = "PRE_MAIN_COLOR_0";
 var SEMANTIC_MAIN_PRE_COLOR_ATTACHMENT_SIZE_0 = "PRE_MAIN_COLOR_SIZE_0";
 var PLAYER_OPTIONS_ENV_EDITOR = "editor";
 var HELP_LINK = {
-    "Filter not imported": "https://galacean.antgroup.com/effects/#/user/gasrv4ka5sacrwpg",
-    "Item duration can't be less than 0": "https://galacean.antgroup.com/effects/#/user/gasrv4ka5sacrwpg"
+    "Item duration can't be less than 0": "https://galacean.antgroup.com/effects/user/gasrv4ka5sacrwpg#AOnQS",
+    "ValueType: 21/22 is not supported": "https://galacean.antgroup.com/effects/user/gasrv4ka5sacrwpg#smO1b"
 };
 
 /**
@@ -7564,17 +7556,17 @@ var downgradeKeywords = (_obj$7 = {}, _obj$7[exports.ShaderType.vertex] = {
 }, _obj$7);
 /**
  * 生成 shader，检测到 WebGL1 上下文会降级
- * @param marcos - 宏定义数组
+ * @param macros - 宏定义数组
  * @param shader - 原始 shader 文本
  * @param shaderType - shader 类型
  * @return 去除版本号的 shader 文本
- */ function createShaderWithMarcos(marcos, shader, shaderType, level) {
+ */ function createShaderWithMacros(macros, shader, shaderType, level) {
     var ret = [];
     var header = "";
     // shader 标志宏，没有其他含义，方便不支持完全的自定义 shader 的三方引擎接入使用
     ret.push("#define GE_RUNTIME");
-    if (marcos) {
-        marcos.forEach(function(param) {
+    if (macros) {
+        macros.forEach(function(param) {
             var key = param[0], value = param[1];
             if (value === true) {
                 ret.push("#define " + key);
@@ -7683,7 +7675,7 @@ function setBlendMode(material, blendMode) {
             ];
             break;
         default:
-            console.warn("blendMode " + blendMode + " not in specification, please set blend params separately");
+            console.warn("BlendMode " + blendMode + " not in specification, please set blend params separately.");
     }
 }
 function setSideMode(material, side) {
@@ -7729,7 +7721,7 @@ function setMaskMode(material, maskMode) {
             material.stencilTest = false;
             break;
         default:
-            console.warn("maskMode " + maskMode + " not in specification, please set stencil params seperately");
+            console.warn("MaskMode " + maskMode + " not in specification, please set stencil params seperately.");
     }
 }
 
@@ -7950,7 +7942,7 @@ function _loadImage() {
             }
             // 2. 非法类型
             if (!url) {
-                throw new Error("Invalid url type: " + JSON.stringify(source));
+                throw new Error("Invalid url type: " + JSON.stringify(source) + ".");
             }
             return [
                 2,
@@ -8118,21 +8110,21 @@ function _loadMedia() {
     return _loadMedia.apply(this, arguments);
 }
 
-function deserializeMipmapTexture(texOpts, bins) {
+function deserializeMipmapTexture(textureOptions, bins, engine) {
     return _deserializeMipmapTexture.apply(this, arguments);
 }
 function _deserializeMipmapTexture() {
-    _deserializeMipmapTexture = _async_to_generator(function(texOpts, bins, files, engine) {
+    _deserializeMipmapTexture = _async_to_generator(function(textureOptions, bins, engine, files) {
         var mipmaps, target, loadedMipmaps, _iterator, _step, level, newLevel, _iterator1, _step1, face, loadedImageAsset, mipmaps1, target1, jobs, loadedMipmaps1, bin;
         return __generator(this, function(_state) {
             switch(_state.label){
                 case 0:
                     if (files === void 0) files = [];
-                    if (!(texOpts.target === 34067)) return [
+                    if (!(textureOptions.target === 34067)) return [
                         3,
                         1
                     ];
-                    mipmaps = texOpts.mipmaps, target = texOpts.target;
+                    mipmaps = textureOptions.mipmaps, target = textureOptions.target;
                     // const jobs = mipmaps.map(mipmap => Promise.all(mipmap.map(pointer => loadMipmapImage(pointer, bins))));
                     loadedMipmaps = [];
                     for(_iterator = _create_for_of_iterator_helper_loose(mipmaps); !(_step = _iterator()).done;){
@@ -8152,7 +8144,7 @@ function _deserializeMipmapTexture() {
                         2,
                         _extends({
                             keepImageSource: false
-                        }, texOpts, {
+                        }, textureOptions, {
                             mipmaps: loadedMipmaps,
                             sourceFrom: {
                                 target: target,
@@ -8163,7 +8155,7 @@ function _deserializeMipmapTexture() {
                     ];
                 case 1:
                     // TODO: 补充测试用例
-                    mipmaps1 = texOpts.mipmaps, target1 = texOpts.target;
+                    mipmaps1 = textureOptions.mipmaps, target1 = textureOptions.target;
                     jobs = mipmaps1.map(function(pointer) {
                         return loadMipmapImage(pointer, bins);
                     });
@@ -8178,7 +8170,7 @@ function _deserializeMipmapTexture() {
                         2,
                         _extends({
                             keepImageSource: false
-                        }, texOpts, {
+                        }, textureOptions, {
                             mipmaps: loadedMipmaps1,
                             sourceType: exports.TextureSourceType.mipmaps,
                             sourceFrom: {
@@ -8213,7 +8205,7 @@ function _loadMipmapImage() {
             _pointer_ = pointer[1], index = _pointer_[0], start = _pointer_[1], length = _pointer_[2];
             bin = bins[index];
             if (!bin) {
-                throw new Error("invalid bin pointer: " + JSON.stringify(pointer));
+                throw new Error("Invalid bin pointer: " + JSON.stringify(pointer) + ".");
             }
             return [
                 2,
@@ -8417,7 +8409,7 @@ var KTXTexture = /*#__PURE__*/ function() {
         // 0xAB, 0x4B, 0x54, 0x58, 0x20, 0x31, 0x31, 0xBB, 0x0D, 0x0A, 0x1A, 0x0A
         var identifier = new Uint8Array(this.arrayBuffer, this.baseOffset, 12);
         if (identifier[0] !== 0xab || identifier[1] !== 0x4b || identifier[2] !== 0x54 || identifier[3] !== 0x58 || identifier[4] !== 0x20 || identifier[5] !== 0x31 || identifier[6] !== 0x31 || identifier[7] !== 0xbb || identifier[8] !== 0x0d || identifier[9] !== 0x0a || identifier[10] !== 0x1a || identifier[11] !== 0x0a) {
-            throw Error("texture missing KTX identifier");
+            throw new Error("Texture missing KTX identifier.");
         }
         // load the reset of the header in native 32 bit uint
         var dataSize = Uint32Array.BYTES_PER_ELEMENT;
@@ -8439,15 +8431,15 @@ var KTXTexture = /*#__PURE__*/ function() {
         // value of zero is an indication to generate mipmaps @ runtime.  Not usually allowed for compressed, so disregard.
         this.numberOfMipmapLevels = Math.max(1, this.numberOfMipmapLevels);
         if (this.pixelHeight === 0 || this.pixelDepth !== 0) {
-            logger.warn("Only 2D textures currently supported");
+            logger.warn("Only 2D textures currently supported.");
             return;
         }
         if (this.numberOfArrayElements !== 0) {
-            logger.warn("Texture arrays not currently supported");
+            logger.warn("Texture arrays not currently supported.");
             return;
         }
         if (this.numberOfFaces !== facesExpected) {
-            logger.warn("Number of faces expected" + facesExpected + ", but found " + this.numberOfFaces);
+            logger.warn("Number of faces expected " + facesExpected + ", but found " + this.numberOfFaces + ".");
             return;
         }
         // we now have a completely validated file, so could use existence of loadType as success
@@ -8535,7 +8527,7 @@ var TextureFactory = /*#__PURE__*/ function() {
                             3
                         ];
                     case 2:
-                        throw new Error("No source from");
+                        throw new Error("No source from.");
                     case 3:
                         return [
                             2
@@ -8779,7 +8771,7 @@ var TextureFactory = /*#__PURE__*/ function() {
                             })
                         ];
                     case 17:
-                        throw new Error("Invalid resource type: " + type);
+                        throw new Error("Invalid resource type: " + type + ".");
                 }
             });
         })();
@@ -9710,19 +9702,19 @@ function buildEasingCurve(leftKeyframe, rightKeyframe) {
         y2 = numberToFix((p2.y - p0.y) / valueInterval, 5);
     }
     if (x1 < 0) {
-        console.error("invalid bezier points, x1 < 0", p0, p1, p2, p3);
+        console.error("Invalid bezier points, x1 < 0", p0, p1, p2, p3);
         x1 = 0;
     }
     if (x2 < 0) {
-        console.error("invalid bezier points, x2 < 0", p0, p1, p2, p3);
+        console.error("Invalid bezier points, x2 < 0", p0, p1, p2, p3);
         x2 = 0;
     }
     if (x1 > 1) {
-        console.error("invalid bezier points, x1 >= 1", p0, p1, p2, p3);
+        console.error("Invalid bezier points, x1 >= 1", p0, p1, p2, p3);
         x1 = 1;
     }
     if (x2 > 1) {
-        console.error("invalid bezier points, x2 >= 1", p0, p1, p2, p3);
+        console.error("Invalid bezier points, x2 >= 1", p0, p1, p2, p3);
         x2 = 1;
     }
     var str = ("bez_" + x1 + "_" + y1 + "_" + x2 + "_" + y2).replace(/\./g, "p");
@@ -9903,31 +9895,31 @@ var ValueGetter = /*#__PURE__*/ function() {
     }
     var _proto = ValueGetter.prototype;
     _proto.onCreate = function onCreate(props) {
-        throw Error(NOT_IMPLEMENT);
+        throw new Error(NOT_IMPLEMENT);
     };
     _proto.getIntegrateValue = function getIntegrateValue(t0, t1, timeScale) {
-        throw Error(NOT_IMPLEMENT);
+        throw new Error(NOT_IMPLEMENT);
     };
     _proto.getIntegrateByTime = function getIntegrateByTime(t0, time) {
-        throw Error(NOT_IMPLEMENT);
+        throw new Error(NOT_IMPLEMENT);
     };
     _proto.getValue = function getValue(time) {
-        throw Error(NOT_IMPLEMENT);
+        throw new Error(NOT_IMPLEMENT);
     };
     _proto.getMaxTime = function getMaxTime() {
-        throw Error(NOT_IMPLEMENT);
+        throw new Error(NOT_IMPLEMENT);
     };
     _proto.toUniform = function toUniform(meta) {
-        throw Error(NOT_IMPLEMENT);
+        throw new Error(NOT_IMPLEMENT);
     };
     _proto.map = function map(func) {
-        throw Error(NOT_IMPLEMENT);
+        throw new Error(NOT_IMPLEMENT);
     };
     _proto.scaleXCoord = function scaleXCoord(scale) {
         return this;
     };
     _proto.toData = function toData() {
-        throw Error(NOT_IMPLEMENT);
+        throw new Error(NOT_IMPLEMENT);
     };
     ValueGetter.getAllData = function getAllData(meta, halfFloat) {
         var ret = new (halfFloat ? Float16ArrayWrapper : Float32Array)(meta.index * 4);
@@ -10003,7 +9995,7 @@ var RandomValue = /*#__PURE__*/ function(ValueGetter) {
         this.max = props[1];
     };
     _proto.getValue = function getValue(time) {
-        return random(this.min, this.max);
+        return randomInRange(this.min, this.max);
     };
     _proto.toUniform = function toUniform() {
         return new Float32Array([
@@ -10624,7 +10616,7 @@ function createValueGetter(args) {
     if (isFunction(map$1[args[0]])) {
         return map$1[args[0]](args[1]);
     } else {
-        throw new Error("ValueType: " + args[0] + " is not support");
+        throw new Error("ValueType: " + args[0] + " is not supported, see " + HELP_LINK["ValueType: 21/22 is not supported"] + ".");
     }
 }
 function lineSegIntegrate(t, t0, t1, y0, y1) {
@@ -10768,7 +10760,7 @@ function createCopyShader(level, writeDepth) {
         vertex: version + "\n" + COPY_VERTEX_SHADER,
         fragment: version + "\n" + COPY_FRAGMENT_SHADER,
         glslVersion: webgl2 ? exports.GLSLVersion.GLSL3 : exports.GLSLVersion.GLSL1,
-        marcos: [
+        macros: [
             [
                 "WEBGL2",
                 !!webgl2
@@ -10841,7 +10833,7 @@ var PassTextureCache = /*#__PURE__*/ function() {
         var refCount = this.textureRef[id];
         if (refCount <= 1) {
             if (refCount < 0) {
-                console.error("ref count < 0");
+                console.error("Ref count < 0.");
             }
             var tex = this.textureCache[id];
             if (tex) {
@@ -11519,21 +11511,21 @@ var seed$7 = 1;
     return RenderPass;
 }();
 
-var blend = "vec4 blendColor(vec4 color,vec4 vc,float mode){vec4 ret=color*vc;\n#ifdef PRE_MULTIPLY_ALPHA\nfloat alpha=vc.a;\n#else\nfloat alpha=ret.a;\n#endif\nif(mode==1.){ret.rgb*=alpha;}else if(mode==2.){ret.rgb*=alpha;ret.a=dot(ret.rgb,vec3(0.33333333));}else if(mode==3.){alpha=color.r*alpha;ret=vec4(vc.rgb*alpha,alpha);}return ret;}";
+var blend = "vec4 blendColor(vec4 color,vec4 vc,float mode){vec4 ret=color*vc;float alpha=ret.a;if(mode==1.){ret.rgb*=alpha;}else if(mode==2.){ret.rgb*=alpha;ret.a=dot(ret.rgb,vec3(0.33333333));}else if(mode==3.){alpha=color.r*alpha;ret=vec4(vc.rgb*alpha,alpha);}return ret;}";
 
 var compatible_frag = "#version 300 es\n#ifdef WEBGL2\n#define texture2D texture\n#define textureCube texture\n#define textureCubeLodEXT textureLod\nlayout(location=0)out vec4 fragColor;\n#else\n#define fragColor gl_FragColor\n#endif\n";
 
 var compatible_vert = "#version 300 es\n#ifdef WEBGL2\n#define texture2D texture\n#else\n#endif\n";
 
-var itemFrameFrag = "#version 300 es\nprecision highp float;\n#version 300 es\n#ifdef WEBGL2\n#define texture2D texture\n#define textureCube texture\n#define textureCubeLodEXT textureLod\nlayout(location=0)out vec4 fragColor;\n#else\n#define fragColor gl_FragColor\n#endif\nvec4 blendColor(vec4 color,vec4 vc,float mode){vec4 ret=color*vc;\n#ifdef PRE_MULTIPLY_ALPHA\nfloat alpha=vc.a;\n#else\nfloat alpha=ret.a;\n#endif\nif(mode==1.){ret.rgb*=alpha;}else if(mode==2.){ret.rgb*=alpha;ret.a=dot(ret.rgb,vec3(0.33333333));}else if(mode==3.){alpha=color.r*alpha;ret=vec4(vc.rgb*alpha,alpha);}return ret;}in vec4 vColor;in vec4 vTexCoord;in highp vec2 vParams;uniform vec3 uFrameColor;void main(){fragColor=vec4(uFrameColor.xyz,1.0);}";
+var itemFrameFrag = "#version 300 es\nprecision highp float;\n#version 300 es\n#ifdef WEBGL2\n#define texture2D texture\n#define textureCube texture\n#define textureCubeLodEXT textureLod\nlayout(location=0)out vec4 fragColor;\n#else\n#define fragColor gl_FragColor\n#endif\nvec4 blendColor(vec4 color,vec4 vc,float mode){vec4 ret=color*vc;float alpha=ret.a;if(mode==1.){ret.rgb*=alpha;}else if(mode==2.){ret.rgb*=alpha;ret.a=dot(ret.rgb,vec3(0.33333333));}else if(mode==3.){alpha=color.r*alpha;ret=vec4(vc.rgb*alpha,alpha);}return ret;}in vec4 vColor;in vec4 vTexCoord;in highp vec2 vParams;uniform vec3 uFrameColor;void main(){fragColor=vec4(uFrameColor.xyz,1.0);}";
 
 var integrate = "float calculateMovement(float t,vec2 p1,vec2 p2,vec2 p3,vec2 p4){float movement=0.0;float h=(t-p1.x)*0.05;for(int i=0;i<=20;i++){float t=float(i)*h;float nt=binarySearchT(t,p1.x,p2.x,p3.x,p4.x);float y=cubicBezier(nt,p1.y,p2.y,p3.y,p4.y);float weight=(i==0||i==20)? 1.0 :(mod(float(i),2.)!=0.)? 4.0 : 2.0;movement+=weight*y;}movement*=h/3.;return movement;}float integrateFromBezierCurveFrames(float time,float frameStart,float frameCount){int start=int(frameStart);int count=int(frameCount-1.);float ret=0.;for(int i=0;i<ITR_END;i+=2){vec4 k0=lookup_curve(i+start);vec4 k1=lookup_curve(i+1+start);if(i==0&&time<k0.x){return ret;}vec2 p1=vec2(k0.x,k0.y);vec2 p2=vec2(k0.z,k0.w);vec2 p3=vec2(k1.z,k1.w);vec2 p4=vec2(k1.x,k1.y);if(time>=k1.x){ret+=calculateMovement(k1.x,p1,p2,p3,p4);}if(time>=k0.x&&time<k1.x){return ret+calculateMovement(time,p1,p2,p3,p4);}}return ret;}float integrateByTimeLineSeg(float t,vec2 p0,vec2 p1){float t0=p0.x;float t1=p1.x;float y0=p0.y;float y1=p1.y;vec4 tSqr=vec4(t,t,t0,t0);tSqr=tSqr*tSqr;vec4 a=vec4(2.*t,3.,-t0,3.)*tSqr;float t1y0=t1*y0;vec4 b=vec4(y0-y1,t0*y1-t1y0,2.*y0+y1,t1y0);float r=dot(a,b);return r/(t0-t1)*0.16666667;}float integrateLineSeg(float time,vec2 p0,vec2 p1){float h=time-p0.x;float y0=p0.y;return(y0+y0+(p1.y-y0)*h/(p1.x-p0.x))*h/2.;}float integrateFromLineSeg(float time,float frameStart,float frameCount){if(time==0.){return 0.;}int start=int(frameStart);int count=int(frameCount-1.);float ret=0.;for(int i=0;i<ITR_END;i++){if(i>count){return ret;}vec4 ks=lookup_curve(i+start);vec2 k0=ks.xy;vec2 k1=ks.zw;if(time>k0.x&&time<=k1.x){return ret+integrateLineSeg(time,k0,k1);}ret+=integrateLineSeg(k1.x,k0,k1);vec2 k2=lookup_curve(i+start+1).xy;if(time>k1.x&&time<=k2.x){return ret+integrateLineSeg(time,k1,k2);}ret+=integrateLineSeg(k2.x,k1,k2);}return ret;}float integrateByTimeFromLineSeg(float time,float frameStart,float frameCount){if(time==0.){return 0.;}int start=int(frameStart);int count=int(frameCount-1.);float ret=0.;for(int i=0;i<ITR_END;i++){if(i>count){return ret;}vec4 ks=lookup_curve(i+start);vec2 k0=ks.xy;vec2 k1=ks.zw;if(time>k0.x&&time<=k1.x){return ret+integrateByTimeLineSeg(time,k0,k1);}ret+=integrateByTimeLineSeg(k1.x,k0,k1);vec2 k2=lookup_curve(i+start+1).xy;if(time>k1.x&&time<=k2.x){return ret+integrateByTimeLineSeg(time,k1,k2);}ret+=integrateByTimeLineSeg(k2.x,k1,k2);}return ret;}float getIntegrateFromTime0(float t1,vec4 value){float type=value.x;if(type==0.){return value.y*t1;}if(type==1.){vec2 p0=vec2(0.,value.y);vec2 p1=vec2(value.w,value.z);return integrateLineSeg(t1,p0,p1);}if(type==3.){return integrateFromLineSeg(t1,value.y,value.z);}if(type==4.){return mix(value.y,value.z,aSeed)*t1;}if(type==5.){return integrateFromBezierCurveFrames(t1,value.z,value.w);}return 0.;}float getIntegrateByTimeFromTime(float t0,float t1,vec4 value){float type=value.x;if(type==0.){return value.y*(t1*t1-t0*t0)/2.;}else if(type==1.){vec2 p0=vec2(0.,value.y);vec2 p1=vec2(value.w,value.z);return integrateByTimeLineSeg(t1,p0,p1)-integrateByTimeLineSeg(t0,p0,p1);}if(type==3.){return integrateByTimeFromLineSeg(t1,value.y,value.z)-integrateByTimeFromLineSeg(t0,value.y,value.z);}if(type==4.){return mix(value.y,value.z,aSeed)*(t1*t1-t0*t0)/2.;}if(type==5.){return integrateFromBezierCurveFrames(t1,value.z,value.w)-integrateFromBezierCurveFrames(t0,value.z,value.w);}return 0.;}";
 
 var itemVert = "precision highp float;attribute vec2 atlasOffset;attribute vec3 aPos;varying vec2 vTexCoord;varying vec3 vParams;varying vec4 vColor;uniform vec2 _Size;uniform vec4 _Color;uniform vec4 _TexParams;uniform vec4 _TexOffset;uniform mat4 effects_MatrixVP;uniform mat4 effects_MatrixInvV;uniform mat4 effects_ObjectToWorld;\n#ifdef ENV_EDITOR\nuniform vec4 uEditorTransform;\n#endif\nvoid main(){vec4 texParams=_TexParams;vTexCoord=vec2(atlasOffset.xy*_TexOffset.zw+_TexOffset.xy);vColor=_Color;vParams=vec3(0.0,texParams.y,texParams.x);vec4 pos=vec4(aPos.xy*_Size,aPos.z,1.0);gl_Position=effects_MatrixVP*effects_ObjectToWorld*pos;\n#ifdef ENV_EDITOR\ngl_Position=vec4(gl_Position.xy*uEditorTransform.xy+uEditorTransform.zw*gl_Position.w,gl_Position.zw);\n#endif\n}";
 
-var itemFrag = "precision highp float;varying vec4 vColor;varying vec2 vTexCoord;varying vec3 vParams;uniform sampler2D uSampler0;vec4 blendColor(vec4 color,vec4 vc,float mode){vec4 ret=color*vc;\n#ifdef PRE_MULTIPLY_ALPHA\nfloat alpha=vc.a;\n#else\nfloat alpha=ret.a;\n#endif\nif(mode==1.){ret.rgb*=alpha;}else if(mode==2.){ret.rgb*=alpha;ret.a=dot(ret.rgb,vec3(0.33333333));}else if(mode==3.){alpha=color.r*alpha;ret=vec4(vc.rgb*alpha,alpha);}return ret;}void main(){vec4 color=vec4(0.);vec4 texColor=texture2D(uSampler0,vTexCoord.xy);color=blendColor(texColor,vColor,floor(0.5+vParams.y));if(vParams.z==0.&&color.a<0.04){discard;}color.a=clamp(color.a,0.0,1.0);gl_FragColor=color;}";
+var itemFrag = "precision highp float;varying vec4 vColor;varying vec2 vTexCoord;varying vec3 vParams;uniform sampler2D uSampler0;vec4 blendColor(vec4 color,vec4 vc,float mode){vec4 ret=color*vc;float alpha=ret.a;if(mode==1.){ret.rgb*=alpha;}else if(mode==2.){ret.rgb*=alpha;ret.a=dot(ret.rgb,vec3(0.33333333));}else if(mode==3.){alpha=color.r*alpha;ret=vec4(vc.rgb*alpha,alpha);}return ret;}void main(){vec4 color=vec4(0.);vec4 texColor=texture2D(uSampler0,vTexCoord.xy);color=blendColor(texColor,vColor,floor(0.5+vParams.y));if(vParams.z==0.&&color.a<0.04){discard;}color.a=clamp(color.a,0.0,1.0);gl_FragColor=color;}";
 
-var particleFrag = "#version 300 es\nprecision mediump float;\n#version 300 es\n#ifdef WEBGL2\n#define texture2D texture\n#define textureCube texture\n#define textureCubeLodEXT textureLod\nlayout(location=0)out vec4 fragColor;\n#else\n#define fragColor gl_FragColor\n#endif\nvec4 blendColor(vec4 color,vec4 vc,float mode){vec4 ret=color*vc;\n#ifdef PRE_MULTIPLY_ALPHA\nfloat alpha=vc.a;\n#else\nfloat alpha=ret.a;\n#endif\nif(mode==1.){ret.rgb*=alpha;}else if(mode==2.){ret.rgb*=alpha;ret.a=dot(ret.rgb,vec3(0.33333333));}else if(mode==3.){alpha=color.r*alpha;ret=vec4(vc.rgb*alpha,alpha);}return ret;}\n#define PATICLE_SHADER 1\nin float vLife;in vec2 vTexCoord;in vec4 vColor;uniform vec3 emissionColor;uniform float emissionIntensity;uniform sampler2D uMaskTex;uniform vec4 uColorParams;uniform vec2 uTexOffset;\n#ifdef COLOR_OVER_LIFETIME\nuniform sampler2D uColorOverLifetime;\n#endif\n#ifdef USE_SPRITE\nin vec4 vTexCoordBlend;\n#endif\nin float vSeed;\n#ifdef PREVIEW_BORDER\nuniform vec4 uPreviewColor;\n#endif\n#ifdef USE_SPRITE\nvec4 getTextureColor(sampler2D tex,vec2 texCoord){if(vTexCoordBlend.w>0.){return mix(texture2D(tex,texCoord),texture2D(tex,vTexCoordBlend.xy+texCoord),vTexCoordBlend.z);}return texture2D(tex,texCoord);}\n#else\n#define getTextureColor texture2D\n#endif\n#ifndef WEBGL2\n#define round(a) floor(0.5+a)\n#endif\n#ifdef PREVIEW_BORDER\nvoid main(){fragColor=uPreviewColor;}\n#else\nvoid main(){vec4 color=vec4(1.0);vec4 tempColor=vColor;vec2 texOffset=uTexOffset;if(vLife<0.){discard;}if(uColorParams.x>0.0){color=getTextureColor(uMaskTex,vTexCoord);}\n#ifdef COLOR_OVER_LIFETIME\n#ifndef ENABLE_VERTEX_TEXTURE\ntempColor*=texture2D(uColorOverLifetime,vec2(vLife,0.));\n#endif\n#endif\ncolor=blendColor(color,tempColor,round(uColorParams.y));if(color.a<=0.01&&uColorParams.w>0.){float _at=texture2D(uMaskTex,vTexCoord+texOffset).a+texture2D(uMaskTex,vTexCoord+texOffset*-1.).a;if(_at<=0.02){discard;}}vec3 emission=emissionColor*pow(2.0,emissionIntensity);color=vec4(pow(pow(color.rgb,vec3(2.2))+emission,vec3(1.0/2.2)),color.a);fragColor=color;}\n#endif\n";
+var particleFrag = "#version 300 es\nprecision mediump float;\n#version 300 es\n#ifdef WEBGL2\n#define texture2D texture\n#define textureCube texture\n#define textureCubeLodEXT textureLod\nlayout(location=0)out vec4 fragColor;\n#else\n#define fragColor gl_FragColor\n#endif\nvec4 blendColor(vec4 color,vec4 vc,float mode){vec4 ret=color*vc;float alpha=ret.a;if(mode==1.){ret.rgb*=alpha;}else if(mode==2.){ret.rgb*=alpha;ret.a=dot(ret.rgb,vec3(0.33333333));}else if(mode==3.){alpha=color.r*alpha;ret=vec4(vc.rgb*alpha,alpha);}return ret;}\n#define PATICLE_SHADER 1\nin float vLife;in vec2 vTexCoord;in vec4 vColor;uniform vec3 emissionColor;uniform float emissionIntensity;uniform sampler2D uMaskTex;uniform vec4 uColorParams;uniform vec2 uTexOffset;\n#ifdef COLOR_OVER_LIFETIME\nuniform sampler2D uColorOverLifetime;\n#endif\n#ifdef USE_SPRITE\nin vec4 vTexCoordBlend;\n#endif\nin float vSeed;\n#ifdef PREVIEW_BORDER\nuniform vec4 uPreviewColor;\n#endif\n#ifdef USE_SPRITE\nvec4 getTextureColor(sampler2D tex,vec2 texCoord){if(vTexCoordBlend.w>0.){return mix(texture2D(tex,texCoord),texture2D(tex,vTexCoordBlend.xy+texCoord),vTexCoordBlend.z);}return texture2D(tex,texCoord);}\n#else\n#define getTextureColor texture2D\n#endif\n#ifndef WEBGL2\n#define round(a) floor(0.5+a)\n#endif\n#ifdef PREVIEW_BORDER\nvoid main(){fragColor=uPreviewColor;}\n#else\nvoid main(){vec4 color=vec4(1.0);vec4 tempColor=vColor;vec2 texOffset=uTexOffset;if(vLife<0.){discard;}if(uColorParams.x>0.0){color=getTextureColor(uMaskTex,vTexCoord);}\n#ifdef COLOR_OVER_LIFETIME\n#ifndef ENABLE_VERTEX_TEXTURE\ntempColor*=texture2D(uColorOverLifetime,vec2(vLife,0.));\n#endif\n#endif\ncolor=blendColor(color,tempColor,round(uColorParams.y));if(color.a<=0.01&&uColorParams.w>0.){float _at=texture2D(uMaskTex,vTexCoord+texOffset).a+texture2D(uMaskTex,vTexCoord+texOffset*-1.).a;if(_at<=0.02){discard;}}vec3 emission=emissionColor*pow(2.0,emissionIntensity);color=vec4(pow(pow(color.rgb,vec3(2.2))+emission,vec3(1.0/2.2)),color.a);fragColor=color;}\n#endif\n";
 
 var particleVert = "#version 300 es\nprecision mediump float;\n#define SHADER_VERTEX 1\n#define PATICLE_SHADER 1\n#version 300 es\n#ifdef WEBGL2\n#define texture2D texture\n#else\n#endif\n#ifdef SHADER_VERTEX\n#define CURVE_VALUE_TEXTURE uVCurveValueTexture\n#define CURVE_VALUE_ARRAY uVCurveValues\n#define CURVE_VALUE_COUNT VERT_CURVE_VALUE_COUNT\n#define FRAG_CURVE_VALUE_COUNT 0\n#else\n#define CURVE_VALUE_TEXTURE uFCurveValueTexture\n#define CURVE_VALUE_ARRAY uFCurveValues\n#define CURVE_VALUE_COUNT FRAG_CURVE_VALUE_COUNT\n#define VERT_CURVE_VALUE_COUNT 0\n#endif\n#if CURVE_VALUE_COUNT > 0\n#if LOOKUP_TEXTURE_CURVE\nuniform sampler2D CURVE_VALUE_TEXTURE;const float uCurveCount=1./float(CURVE_VALUE_COUNT);\n#define lookup_curve(i) texture2D(CURVE_VALUE_TEXTURE,vec2(float(i) * uCurveCount,0.))\n#else\nuniform vec4 CURVE_VALUE_ARRAY[CURVE_VALUE_COUNT];\n#define lookup_curve(i) CURVE_VALUE_ARRAY[i]\n#endif\n#else\n#define lookup_curve(i) vec4(0.)\n#endif\n#ifdef WEBGL2\n#define ITR_END (count + 1)\n#else\n#define ITR_END MAX_C\n#endif\n#define NONE_CONST_INDEX 1\n#ifdef SHADER_VERTEX\nin float aSeed;out float vSeed;\n#endif\n#ifdef SHADER_VERTEX\n#define MAX_C VERT_MAX_KEY_FRAME_COUNT\n#else\n#define MAX_C FRAG_MAX_KEY_FRAME_COUNT\n#endif\nmat4 cubicBezierMatrix=mat4(1.0,-3.0,3.0,-1.0,0.0,3.0,-6.0,3.0,0.0,0.0,3.0,-3.0,0.0,0.0,0.0,1.0);float cubicBezier(float t,float y1,float y2,float y3,float y4){vec4 tVec=vec4(1.0,t,t*t,t*t*t);vec4 yVec=vec4(y1,y2,y3,y4);vec4 result=tVec*cubicBezierMatrix*yVec;return result.x+result.y+result.z+result.w;}float binarySearchT(float x,float x1,float x2,float x3,float x4){float left=0.0;float right=1.0;float mid=0.0;float computedX;for(int i=0;i<8;i++){mid=(left+right)*0.5;computedX=cubicBezier(mid,x1,x2,x3,x4);if(abs(computedX-x)<0.0001){break;}else if(computedX>x){right=mid;}else{left=mid;}}return mid;}float valueFromBezierCurveFrames(float time,float frameStart,float frameCount){int start=int(frameStart);int count=int(frameCount-1.);for(int i=0;i<ITR_END;i+=2){if(i>=count){break;}vec4 k0=lookup_curve(i+start);vec4 k1=lookup_curve(i+1+start);if(i==0&&time<k0.x){return k0.y;}if(i==int(frameCount-2.)&&time>=k1.x){return k1.y;}if(time>=k0.x&&time<=k1.x){float t=(time-k0.x)/(k1.x-k0.x);float nt=binarySearchT(time,k0.x,k0.z,k1.z,k1.x);return cubicBezier(nt,k0.y,k0.w,k1.w,k1.y);}}}float evaluteLineSeg(float t,vec2 p0,vec2 p1){return p0.y+(p1.y-p0.y)*(t-p0.x)/(p1.x-p0.x);}float valueFromLineSegs(float time,float frameStart,float frameCount){int start=int(frameStart);int count=int(frameCount-1.);int end=start+count;for(int i=0;i<ITR_END;i++){if(i>count){return lookup_curve(i).w;}vec4 seg=lookup_curve(i+start);vec2 p0=seg.xy;vec2 p1=seg.zw;if(time>=p0.x&&time<=p1.x){return evaluteLineSeg(time,p0,p1);}vec2 p2=lookup_curve(i+start+1).xy;if(time>p1.x&&time<=p2.x){return evaluteLineSeg(time,p1,p2);}}return lookup_curve(0).y;}float getValueFromTime(float time,vec4 value){float type=value.x;if(type==0.){return value.y;}if(type==1.){return mix(value.y,value.z,time/value.w);}if(type==3.){return valueFromLineSegs(time,value.y,value.z);}if(type==4.){return mix(value.y,value.z,aSeed);}if(type==5.){return valueFromBezierCurveFrames(time,value.z,value.w);}return 0.;}float calculateMovement(float t,vec2 p1,vec2 p2,vec2 p3,vec2 p4){float movement=0.0;float h=(t-p1.x)*0.05;for(int i=0;i<=20;i++){float t=float(i)*h;float nt=binarySearchT(t,p1.x,p2.x,p3.x,p4.x);float y=cubicBezier(nt,p1.y,p2.y,p3.y,p4.y);float weight=(i==0||i==20)? 1.0 :(mod(float(i),2.)!=0.)? 4.0 : 2.0;movement+=weight*y;}movement*=h/3.;return movement;}float integrateFromBezierCurveFrames(float time,float frameStart,float frameCount){int start=int(frameStart);int count=int(frameCount-1.);float ret=0.;for(int i=0;i<ITR_END;i+=2){vec4 k0=lookup_curve(i+start);vec4 k1=lookup_curve(i+1+start);if(i==0&&time<k0.x){return ret;}vec2 p1=vec2(k0.x,k0.y);vec2 p2=vec2(k0.z,k0.w);vec2 p3=vec2(k1.z,k1.w);vec2 p4=vec2(k1.x,k1.y);if(time>=k1.x){ret+=calculateMovement(k1.x,p1,p2,p3,p4);}if(time>=k0.x&&time<k1.x){return ret+calculateMovement(time,p1,p2,p3,p4);}}return ret;}float integrateByTimeLineSeg(float t,vec2 p0,vec2 p1){float t0=p0.x;float t1=p1.x;float y0=p0.y;float y1=p1.y;vec4 tSqr=vec4(t,t,t0,t0);tSqr=tSqr*tSqr;vec4 a=vec4(2.*t,3.,-t0,3.)*tSqr;float t1y0=t1*y0;vec4 b=vec4(y0-y1,t0*y1-t1y0,2.*y0+y1,t1y0);float r=dot(a,b);return r/(t0-t1)*0.16666667;}float integrateLineSeg(float time,vec2 p0,vec2 p1){float h=time-p0.x;float y0=p0.y;return(y0+y0+(p1.y-y0)*h/(p1.x-p0.x))*h/2.;}float integrateFromLineSeg(float time,float frameStart,float frameCount){if(time==0.){return 0.;}int start=int(frameStart);int count=int(frameCount-1.);float ret=0.;for(int i=0;i<ITR_END;i++){if(i>count){return ret;}vec4 ks=lookup_curve(i+start);vec2 k0=ks.xy;vec2 k1=ks.zw;if(time>k0.x&&time<=k1.x){return ret+integrateLineSeg(time,k0,k1);}ret+=integrateLineSeg(k1.x,k0,k1);vec2 k2=lookup_curve(i+start+1).xy;if(time>k1.x&&time<=k2.x){return ret+integrateLineSeg(time,k1,k2);}ret+=integrateLineSeg(k2.x,k1,k2);}return ret;}float integrateByTimeFromLineSeg(float time,float frameStart,float frameCount){if(time==0.){return 0.;}int start=int(frameStart);int count=int(frameCount-1.);float ret=0.;for(int i=0;i<ITR_END;i++){if(i>count){return ret;}vec4 ks=lookup_curve(i+start);vec2 k0=ks.xy;vec2 k1=ks.zw;if(time>k0.x&&time<=k1.x){return ret+integrateByTimeLineSeg(time,k0,k1);}ret+=integrateByTimeLineSeg(k1.x,k0,k1);vec2 k2=lookup_curve(i+start+1).xy;if(time>k1.x&&time<=k2.x){return ret+integrateByTimeLineSeg(time,k1,k2);}ret+=integrateByTimeLineSeg(k2.x,k1,k2);}return ret;}float getIntegrateFromTime0(float t1,vec4 value){float type=value.x;if(type==0.){return value.y*t1;}if(type==1.){vec2 p0=vec2(0.,value.y);vec2 p1=vec2(value.w,value.z);return integrateLineSeg(t1,p0,p1);}if(type==3.){return integrateFromLineSeg(t1,value.y,value.z);}if(type==4.){return mix(value.y,value.z,aSeed)*t1;}if(type==5.){return integrateFromBezierCurveFrames(t1,value.z,value.w);}return 0.;}float getIntegrateByTimeFromTime(float t0,float t1,vec4 value){float type=value.x;if(type==0.){return value.y*(t1*t1-t0*t0)/2.;}else if(type==1.){vec2 p0=vec2(0.,value.y);vec2 p1=vec2(value.w,value.z);return integrateByTimeLineSeg(t1,p0,p1)-integrateByTimeLineSeg(t0,p0,p1);}if(type==3.){return integrateByTimeFromLineSeg(t1,value.y,value.z)-integrateByTimeFromLineSeg(t0,value.y,value.z);}if(type==4.){return mix(value.y,value.z,aSeed)*(t1*t1-t0*t0)/2.;}if(type==5.){return integrateFromBezierCurveFrames(t1,value.z,value.w)-integrateFromBezierCurveFrames(t0,value.z,value.w);}return 0.;}const float d2r=3.141592653589793/180.;in vec3 aPos;in vec4 aOffset;in vec3 aVel;in vec3 aRot;in vec4 aColor;in vec3 aDirX;in vec3 aDirY;\n#ifdef USE_SPRITE\nin vec3 aSprite;uniform vec4 uSprite;struct UVDetail{vec2 uv0;vec3 uv1;};UVDetail getSpriteUV(vec2 uv,float lifeTime);out vec4 vTexCoordBlend;\n#endif\n#ifdef FINAL_TARGET\nuniform vec3 uFinalTarget;uniform vec4 uForceCurve;\n#endif\nuniform mat4 effects_ObjectToWorld;uniform mat4 effects_MatrixV;uniform mat4 effects_MatrixVP;uniform vec4 uParams;uniform vec4 uAcceleration;uniform vec4 uGravityModifierValue;uniform vec4 uOpacityOverLifetimeValue;\n#ifdef ROT_X_LIFETIME\nuniform vec4 uRXByLifeTimeValue;\n#endif\n#ifdef ROT_Y_LIFETIME\nuniform vec4 uRYByLifeTimeValue;\n#endif\n#ifdef ROT_Z_LIFETIME\nuniform vec4 uRZByLifeTimeValue;\n#endif\n#ifdef COLOR_OVER_LIFETIME\nuniform sampler2D uColorOverLifetime;\n#endif\n#if LINEAR_VEL_X + LINEAR_VEL_Y + LINEAR_VEL_Z\n#if LINEAR_VEL_X\nuniform vec4 uLinearXByLifetimeValue;\n#endif\n#if LINEAR_VEL_Y\nuniform vec4 uLinearYByLifetimeValue;\n#endif\n#if LINEAR_VEL_Z\nuniform vec4 uLinearZByLifetimeValue;\n#endif\n#endif\n#ifdef SPEED_OVER_LIFETIME\nuniform vec4 uSpeedLifetimeValue;\n#endif\n#if ORB_VEL_X + ORB_VEL_Y + ORB_VEL_Z\n#if ORB_VEL_X\nuniform vec4 uOrbXByLifetimeValue;\n#endif\n#if ORB_VEL_Y\nuniform vec4 uOrbYByLifetimeValue;\n#endif\n#if ORB_VEL_Z\nuniform vec4 uOrbZByLifetimeValue;\n#endif\nuniform vec3 uOrbCenter;\n#endif\nuniform vec4 uSizeByLifetimeValue;\n#ifdef SIZE_Y_BY_LIFE\nuniform vec4 uSizeYByLifetimeValue;\n#endif\nout float vLife;out vec4 vColor;out vec2 vTexCoord;\n#ifdef ENV_EDITOR\nuniform vec4 uEditorTransform;\n#endif\nvec3 calOrbitalMov(float _life,float _dur){vec3 orb=vec3(0.0);\n#ifdef AS_ORBITAL_MOVEMENT\n#define FUNC(a) getValueFromTime(_life,a)\n#else\n#define FUNC(a) getIntegrateFromTime0(_life,a) * _dur\n#endif\n#if ORB_VEL_X\norb.x=FUNC(uOrbXByLifetimeValue);\n#endif\n#if ORB_VEL_Y\norb.y=FUNC(uOrbYByLifetimeValue);\n#endif\n#if ORB_VEL_Z\norb.z=FUNC(uOrbZByLifetimeValue);\n#endif\n#undef FUNC\nreturn orb;}vec3 calLinearMov(float _life,float _dur){vec3 mov=vec3(0.0);\n#ifdef AS_LINEAR_MOVEMENT\n#define FUNC(a) getValueFromTime(_life,a)\n#else\n#define FUNC(a) getIntegrateFromTime0(_life,a) * _dur\n#endif\n#if LINEAR_VEL_X\nmov.x=FUNC(uLinearXByLifetimeValue);\n#endif\n#if LINEAR_VEL_Y\nmov.y=FUNC(uLinearYByLifetimeValue);\n#endif\n#if LINEAR_VEL_Z\nmov.z=FUNC(uLinearZByLifetimeValue);\n#endif\n#undef FUNC\nreturn mov;}mat3 mat3FromRotation(vec3 rotation){vec3 sinR=sin(rotation*d2r);vec3 cosR=cos(rotation*d2r);return mat3(cosR.z,-sinR.z,0.,sinR.z,cosR.z,0.,0.,0.,1.)*mat3(cosR.y,0.,sinR.y,0.,1.,0.,-sinR.y,0,cosR.y)*mat3(1.,0.,0.,0,cosR.x,-sinR.x,0.,sinR.x,cosR.x);}\n#ifdef USE_SPRITE\nUVDetail getSpriteUV(vec2 uv,float lifeTime){float t=fract(clamp((lifeTime-aSprite.x)/aSprite.y,0.0,1.)*aSprite.z);float frame=uSprite.z*t;float frameIndex=max(ceil(frame)-1.,0.);float row=floor((frameIndex+0.1)/uSprite.x);float col=frameIndex-row*uSprite.x;vec2 retUV=(vec2(col,row)+uv)/uSprite.xy;UVDetail ret;if(uSprite.w>0.){float blend=frame-frameIndex;float frameIndex1=min(ceil(frame),uSprite.z-1.);float row1=floor((frameIndex1+0.1)/uSprite.x);float col1=frameIndex1-row1*uSprite.x;vec2 coord=(vec2(col1,row1)+uv)/uSprite.xy-retUV;ret.uv1=vec3(coord.x,1.-coord.y,blend);}ret.uv0=vec2(retUV.x,1.-retUV.y);return ret;}\n#endif\nvec3 calculateTranslation(vec3 vel,float t0,float t1,float dur){float dt=t1-t0;float d=getIntegrateByTimeFromTime(0.,dt,uGravityModifierValue);vec3 acc=uAcceleration.xyz*d;\n#ifdef SPEED_OVER_LIFETIME\nreturn vel*getIntegrateFromTime0(dt/dur,uSpeedLifetimeValue)*dur+acc;\n#endif\nreturn vel*dt+acc;}mat3 transformFromRotation(vec3 rot,float _life,float _dur){vec3 rotation=rot;\n#ifdef ROT_LIFETIME_AS_MOVEMENT\n#define FUNC1(a) getValueFromTime(_life,a)\n#else\n#define FUNC1(a) getIntegrateFromTime0(_life,a) * _dur\n#endif\n#ifdef ROT_X_LIFETIME\nrotation.x+=FUNC1(uRXByLifeTimeValue);\n#endif\n#ifdef ROT_Y_LIFETIME\nrotation.y+=FUNC1(uRYByLifeTimeValue);\n#endif\n#ifdef ROT_Z_LIFETIME\nrotation.z+=FUNC1(uRZByLifeTimeValue);\n#endif\nif(dot(rotation,rotation)==0.0){return mat3(1.0);}\n#undef FUNC1\nreturn mat3FromRotation(rotation);}void main(){float time=uParams.x-aOffset.z;float dur=aOffset.w;if(time<0.||time>dur){gl_Position=vec4(-3.,-3.,-3.,1.);}else{float life=clamp(time/dur,0.0,1.0);vLife=life;\n#ifdef USE_SPRITE\nUVDetail uvD=getSpriteUV(aOffset.xy,time);vTexCoord=uvD.uv0;vTexCoordBlend=vec4(uvD.uv1,uSprite.w);\n#else\nvTexCoord=aOffset.xy;\n#endif\nvColor=aColor;\n#ifdef COLOR_OVER_LIFETIME\n#ifdef ENABLE_VERTEX_TEXTURE\nvColor*=texture2D(uColorOverLifetime,vec2(life,0.));\n#endif\n#endif\nvColor.a*=clamp(getValueFromTime(life,uOpacityOverLifetimeValue),0.,1.);vec3 size=vec3(vec2(getValueFromTime(life,uSizeByLifetimeValue)),1.0);\n#ifdef SIZE_Y_BY_LIFE\nsize.y=getValueFromTime(life,uSizeYByLifetimeValue);\n#endif\nvec3 point=transformFromRotation(aRot,life,dur)*(aDirX*size.x+aDirY*size.y);vec3 pt=calculateTranslation(aVel,aOffset.z,uParams.x,dur);vec3 _pos=aPos+pt;\n#if ORB_VEL_X + ORB_VEL_Y + ORB_VEL_Z\n_pos=mat3FromRotation(calOrbitalMov(life,dur))*(_pos-uOrbCenter);_pos+=uOrbCenter;\n#endif\n#if LINEAR_VEL_X + LINEAR_VEL_Y + LINEAR_VEL_Z\n_pos.xyz+=calLinearMov(life,dur);\n#endif\n#ifdef FINAL_TARGET\nfloat force=getValueFromTime(life,uForceCurve);vec4 pos=vec4(mix(_pos,uFinalTarget,force),1.);\n#else\nvec4 pos=vec4(_pos,1.0);\n#endif\n#if RENDER_MODE == 1\npos.xyz+=point;pos=effects_ObjectToWorld*pos;\n#elif RENDER_MODE == 3\npos=effects_ObjectToWorld*pos;pos.xyz+=effects_MatrixV[0].xyz*point.x+effects_MatrixV[2].xyz*point.y;\n#elif RENDER_MODE == 2\npos=effects_ObjectToWorld*pos;pos.xy+=point.xy;\n#elif RENDER_MODE == 0\npos=effects_ObjectToWorld*pos;pos.xyz+=effects_MatrixV[0].xyz*point.x+effects_MatrixV[1].xyz*point.y;\n#endif\ngl_Position=effects_MatrixVP*pos;vSeed=aSeed;gl_PointSize=6.0;\n#ifdef ENV_EDITOR\ngl_Position=vec4(gl_Position.xy*uEditorTransform.xy+uEditorTransform.zw*gl_Position.w,gl_Position.zw);\n#endif\n}}";
 
@@ -12727,20 +12719,20 @@ var GPUCapability = /*#__PURE__*/ function() {
     _proto.framebufferTexture2D = function framebufferTexture2D(gl, target, index, textarget, texture) {
         var ext = this.drawBufferExtension;
         if (this.level === 1 && !ext && index > 0) {
-            throw new Error("draw multiple color buffers not available");
+            throw new Error("Draw multiple color buffers not available.");
         }
         var attachment = ext ? ext["COLOR_ATTACHMENT" + index + "_WEBGL"] : gl["COLOR_ATTACHMENT" + index];
         if (attachment) {
             gl.framebufferTexture2D(target, attachment, textarget, texture, 0);
         } else {
-            console.error("invalid color attachment index: " + index);
+            console.error("Invalid color attachment index: " + index + ".");
         }
     };
     _proto.drawBuffers = function drawBuffers(gl, bufferStates) {
         var ext = this.drawBufferExtension;
         if (this.level === 1 && !ext) {
             if (bufferStates.length > 1) {
-                throw Error("draw buffers not available");
+                throw new Error("Draw buffers not available.");
             } else {
                 return;
             }
@@ -12977,7 +12969,7 @@ var InteractMesh = /*#__PURE__*/ function() {
     };
     _proto.createMaterial = function createMaterial(rendererOptions) {
         var _this_engine_renderer;
-        var marcos = [
+        var macros = [
             [
                 "ENV_EDITOR",
                 ((_this_engine_renderer = this.engine.renderer) == null ? void 0 : _this_engine_renderer.env) === PLAYER_OPTIONS_ENV_EDITOR
@@ -12990,7 +12982,7 @@ var InteractMesh = /*#__PURE__*/ function() {
                 fragment: fragment,
                 glslVersion: exports.GLSLVersion.GLSL1,
                 cacheId: "" + rendererOptions.cachePrefix + "_effects_interact",
-                marcos: marcos
+                macros: macros
             },
             uniformSemantics: {
                 effects_MatrixVP: "VIEWPROJECTION",
@@ -13256,16 +13248,12 @@ function shouldIgnoreBouncing(arg, mul) {
 }
 
 exports.maxSpriteMeshItemCount = 8;
-exports.maxSpriteTextureCount = 8;
 function setSpriteMeshMaxItemCountByGPU(gpuCapability) {
-    // 8 or 16
-    exports.maxSpriteTextureCount = Math.min(gpuCapability.maxFragmentTextures, 16);
     if (gpuCapability.maxVertexUniforms >= 256) {
         return exports.maxSpriteMeshItemCount = 32;
     } else if (gpuCapability.maxVertexUniforms >= 128) {
         return exports.maxSpriteMeshItemCount = 16;
     }
-    exports.maxSpriteTextureCount = 8;
 }
 function getImageItemRenderInfo(item) {
     var renderer = item.renderer;
@@ -13283,27 +13271,11 @@ function getImageItemRenderInfo(item) {
     };
 }
 function spriteMeshShaderFromFilter(level, options) {
-    var _ref = options != null ? options : {}, _ref_count = _ref.count, count = _ref_count === void 0 ? 2 : _ref_count, _ref_env = _ref.env, env = _ref_env === void 0 ? "" : _ref_env, ignoreBlend = _ref.ignoreBlend, wireframe = _ref.wireframe;
-    var marcos = [
-        [
-            "MAX_ITEM_COUNT",
-            count
-        ],
-        [
-            "PRE_MULTIPLY_ALPHA",
-            false
-        ],
+    var _ref = options != null ? options : {}, _ref_env = _ref.env, env = _ref_env === void 0 ? "" : _ref_env, wireframe = _ref.wireframe;
+    var macros = [
         [
             "ENV_EDITOR",
             env === PLAYER_OPTIONS_ENV_EDITOR
-        ],
-        [
-            "USE_BLEND",
-            !ignoreBlend
-        ],
-        [
-            "MAX_FRAG_TEX",
-            exports.maxSpriteTextureCount >= 16 ? 16 : 8
         ]
     ];
     var fragment = wireframe ? itemFrameFrag : itemFrag;
@@ -13312,7 +13284,7 @@ function spriteMeshShaderFromFilter(level, options) {
         fragment: fragment,
         vertex: vertex,
         glslVersion: level === 1 ? exports.GLSLVersion.GLSL1 : exports.GLSLVersion.GLSL3,
-        marcos: marcos,
+        macros: macros,
         shared: true
     };
 }
@@ -13322,7 +13294,6 @@ function spriteMeshShaderIdFromRenderInfo(renderInfo, count) {
 function spriteMeshShaderFromRenderInfo(renderInfo, count, level, env) {
     var wireframe = renderInfo.wireframe;
     var shader = spriteMeshShaderFromFilter(level, {
-        count: count,
         wireframe: wireframe,
         env: env
     });
@@ -13336,9 +13307,6 @@ function spriteMeshShaderFromRenderInfo(renderInfo, count, level, env) {
 function setMaxSpriteMeshItemCount(count) {
     exports.maxSpriteMeshItemCount = count;
 }
-function setSpriteMeshMaxFragmentTextures(count) {
-    exports.maxSpriteTextureCount = count;
-}
 
 var defRenderInfo = {
     blending: 0,
@@ -14739,7 +14707,7 @@ var Cone = /*#__PURE__*/ function() {
         // dir + [0,0,1]
         dir.z += 1;
         return {
-            position: position.multiply(random(0, 1)),
+            position: position.multiply(randomInRange(0, 1)),
             direction: dir.normalize()
         };
     };
@@ -14747,7 +14715,7 @@ var Cone = /*#__PURE__*/ function() {
 }();
 function getArcAngle(arc, arcMode, opt) {
     if (arcMode === ShapeArcMode.RANDOM) {
-        arc = random(0, arc);
+        arc = randomInRange(0, arc);
     } else if (arcMode === ShapeArcMode.UNIDIRECTIONAL_CYCLE) {
         var d = opt.index % (opt.total + 1);
         arc = arc / opt.total * d;
@@ -14787,8 +14755,8 @@ var Rectangle = /*#__PURE__*/ function() {
     }
     var _proto = Rectangle.prototype;
     _proto.generate = function generate(opt) {
-        var x = random(-this._d, this._d);
-        var y = random(-this._h, this._h);
+        var x = randomInRange(-this._d, this._d);
+        var y = randomInRange(-this._h, this._h);
         return {
             direction: new Vector3(0, 0, 1),
             position: new Vector3(x, y, 0)
@@ -14838,7 +14806,7 @@ var Edge = /*#__PURE__*/ function() {
     }
     var _proto = Edge.prototype;
     _proto.generate = function generate(options) {
-        var x = this.arcMode === ShapeArcMode.UNIFORM_BURST ? options.burstIndex % options.burstCount / (options.burstCount - 1) : random(0, 1);
+        var x = this.arcMode === ShapeArcMode.UNIFORM_BURST ? options.burstIndex % options.burstCount / (options.burstCount - 1) : randomInRange(0, 1);
         return {
             direction: new Vector3(0, 1, 0),
             position: new Vector3(this._d * (x - 0.5), 0, 0)
@@ -14859,7 +14827,7 @@ var Donut = /*#__PURE__*/ function() {
     _proto.generate = function generate(opt) {
         var dradius = this.donutRadius;
         var center = this.radius - dradius;
-        var angle = random(0, Math.PI * 2);
+        var angle = randomInRange(0, Math.PI * 2);
         var arc = getArcAngle(this.arc, this.arcMode, opt) * DEG2RAD;
         var rot = tempMat4$2.setFromRotationZ(arc);
         var direction = new Vector3(Math.cos(angle), Math.sin(angle), 0);
@@ -14882,7 +14850,7 @@ var Sphere = /*#__PURE__*/ function() {
     }
     var _proto = Sphere.prototype;
     _proto.getHorizontalAngle = function getHorizontalAngle() {
-        return random(-90, 90);
+        return randomInRange(-90, 90);
     };
     _proto.generate = function generate(opt) {
         var rz = getArcAngle(this.arc, this.arcMode, opt) * DEG2RAD;
@@ -14905,7 +14873,7 @@ var Hemisphere = /*#__PURE__*/ function(Sphere) {
     }
     var _proto = Hemisphere.prototype;
     _proto.getHorizontalAngle = function getHorizontalAngle() {
-        return random(0, 90);
+        return randomInRange(0, 90);
     };
     return Hemisphere;
 }(Sphere);
@@ -14971,7 +14939,7 @@ function createShape(shapeOptions) {
     var type = shapeOptions.type;
     var Ctrl = map[type];
     if (!Ctrl) {
-        throw Error("invalid shape:" + type);
+        throw new Error("Invalid shape: " + type + ".");
     }
     var ctrl = new Ctrl(options);
     if (type !== ShapeType.NONE) {
@@ -15801,7 +15769,7 @@ var TrailMesh = /*#__PURE__*/ function() {
         var uniformValues = {};
         // const lookUpTexture = getConfig(RENDER_PREFER_LOOKUP_TEXTURE) ? 1 : 0;
         var lookUpTexture = 0;
-        var marcos = [
+        var macros = [
             [
                 "ENABLE_VERTEX_TEXTURE",
                 enableVertexTexture
@@ -15818,7 +15786,7 @@ var TrailMesh = /*#__PURE__*/ function() {
         var useAttributeTrailStart = maxTrailCount > 64;
         var shaderCacheId = 0;
         if (colorOverLifetime) {
-            marcos.push([
+            macros.push([
                 "COLOR_OVER_LIFETIME",
                 true
             ]);
@@ -15826,7 +15794,7 @@ var TrailMesh = /*#__PURE__*/ function() {
             uniformValues.uColorOverLifetime = Texture.createWithData(engine, imageDataFromGradient(colorOverLifetime));
         }
         if (colorOverTrail) {
-            marcos.push([
+            macros.push([
                 "COLOR_OVER_TRAIL",
                 true
             ]);
@@ -15834,7 +15802,7 @@ var TrailMesh = /*#__PURE__*/ function() {
             uniformValues.uColorOverTrail = Texture.createWithData(engine, imageDataFromGradient(colorOverTrail));
         }
         if (useAttributeTrailStart) {
-            marcos.push([
+            macros.push([
                 "ATTR_TRAIL_START",
                 1
             ]);
@@ -15844,7 +15812,7 @@ var TrailMesh = /*#__PURE__*/ function() {
         }
         uniformValues.uOpacityOverLifetimeValue = opacityOverLifetime.toUniform(keyFrameMeta);
         var uWidthOverTrail = widthOverTrail.toUniform(keyFrameMeta);
-        marcos.push([
+        macros.push([
             "VERT_CURVE_VALUE_COUNT",
             keyFrameMeta.index
         ], [
@@ -15863,7 +15831,7 @@ var TrailMesh = /*#__PURE__*/ function() {
             shader: {
                 vertex: vertex,
                 fragment: fragment,
-                marcos: marcos,
+                macros: macros,
                 glslVersion: level === 1 ? exports.GLSLVersion.GLSL1 : exports.GLSLVersion.GLSL3,
                 shared: true,
                 name: "trail#" + name,
@@ -16166,12 +16134,12 @@ function calculateDirection(prePoint, point, nextPoint) {
     }
     return dir.normalize().toArray();
 }
-function getTrailMeshShader(trails, particleMaxCount, name, env, gpuCapability) {
+function getTrailMeshShader(trails, particleMaxCount, name, gpuCapability, env) {
     if (env === void 0) env = "";
     var shaderCacheId = 0;
     var lookUpTexture = getConfig(RENDER_PREFER_LOOKUP_TEXTURE) ? 1 : 0;
     var enableVertexTexture = gpuCapability.detail.maxVertexTextures > 0;
-    var marcos = [
+    var macros = [
         [
             "ENABLE_VERTEX_TEXTURE",
             enableVertexTexture
@@ -16187,14 +16155,14 @@ function getTrailMeshShader(trails, particleMaxCount, name, env, gpuCapability)
     ];
     var keyFrameMeta = createKeyFrameMeta();
     if (trails.colorOverLifetime) {
-        marcos.push([
+        macros.push([
             "COLOR_OVER_LIFETIME",
             true
         ]);
         shaderCacheId |= 1;
     }
     if (trails.colorOverTrail) {
-        marcos.push([
+        macros.push([
             "COLOR_OVER_TRAIL",
             true
         ]);
@@ -16202,7 +16170,7 @@ function getTrailMeshShader(trails, particleMaxCount, name, env, gpuCapability)
     }
     var useAttributeTrailStart = particleMaxCount > 64;
     if (useAttributeTrailStart) {
-        marcos.push([
+        macros.push([
             "ATTR_TRAIL_START",
             1
         ]);
@@ -16210,7 +16178,7 @@ function getTrailMeshShader(trails, particleMaxCount, name, env, gpuCapability)
     }
     getKeyFrameMetaByRawValue(keyFrameMeta, trails.opacityOverLifetime);
     getKeyFrameMetaByRawValue(keyFrameMeta, trails.widthOverTrail);
-    marcos.push([
+    macros.push([
         "VERT_CURVE_VALUE_COUNT",
         keyFrameMeta.index
     ], [
@@ -16220,7 +16188,7 @@ function getTrailMeshShader(trails, particleMaxCount, name, env, gpuCapability)
     return {
         vertex: trailVert,
         fragment: particleFrag,
-        marcos: marcos,
+        macros: macros,
         shared: true,
         name: "trail#" + name,
         cacheId: "-t:+" + shaderCacheId + "+" + keyFrameMeta.index + "+" + keyFrameMeta.max
@@ -16943,11 +16911,9 @@ exports.ParticleSystem = /*#__PURE__*/ function(Component) {
         this.props = props;
         this.destroyed = false;
         var cachePrefix = "";
-        var options = props.options;
-        var positionOverLifetime = props.positionOverLifetime;
-        var shape = props.shape;
-        var gravityModifier = positionOverLifetime.gravityOverLifetime;
-        var gravity = ensureVec3(positionOverLifetime.gravity);
+        var options = props.options, _props_positionOverLifetime = props.positionOverLifetime, positionOverLifetime = _props_positionOverLifetime === void 0 ? {} : _props_positionOverLifetime, shape = props.shape;
+        var gravityModifier = positionOverLifetime == null ? void 0 : positionOverLifetime.gravityOverLifetime;
+        var gravity = ensureVec3(positionOverLifetime == null ? void 0 : positionOverLifetime.gravity);
         var _textureSheetAnimation = props.textureSheetAnimation;
         var textureSheetAnimation = _textureSheetAnimation ? {
             animationDelay: createValueGetter(_textureSheetAnimation.animationDelay || 0),
@@ -16958,7 +16924,7 @@ exports.ParticleSystem = /*#__PURE__*/ function(Component) {
             row: _textureSheetAnimation.row,
             total: _textureSheetAnimation.total || _textureSheetAnimation.col * _textureSheetAnimation.row
         } : undefined;
-        var startTurbulence = !!(shape && shape.turbulenceX || shape.turbulenceY || shape.turbulenceZ);
+        var startTurbulence = !!(shape && shape.turbulenceX || (shape == null ? void 0 : shape.turbulenceY) || (shape == null ? void 0 : shape.turbulenceZ));
         var turbulence;
         if (startTurbulence) {
             var _shape_turbulenceX, _shape_turbulenceY, _shape_turbulenceZ;
@@ -16991,7 +16957,7 @@ exports.ParticleSystem = /*#__PURE__*/ function(Component) {
             }
         }
         var forceTarget;
-        if (positionOverLifetime.forceTarget) {
+        if (positionOverLifetime == null ? void 0 : positionOverLifetime.forceTarget) {
             forceTarget = {
                 target: positionOverLifetime.target || [
                     0,
@@ -17382,15 +17348,12 @@ var ParticleMesh = /*#__PURE__*/ function() {
         var speedOverLifetime = props.speedOverLifetime, colorOverLifetime = props.colorOverLifetime, linearVelOverLifetime = props.linearVelOverLifetime, orbitalVelOverLifetime = props.orbitalVelOverLifetime, sizeOverLifetime = props.sizeOverLifetime, rotationOverLifetime = props.rotationOverLifetime, sprite = props.sprite, gravityModifier = props.gravityModifier, maxCount = props.maxCount, textureFlip = props.textureFlip, useSprite = props.useSprite, name = props.name, gravity = props.gravity, forceTarget = props.forceTarget, side = props.side, occlusion = props.occlusion, anchor = props.anchor, blending = props.blending, maskMode = props.maskMode, mask = props.mask, transparentOcclusion = props.transparentOcclusion, meshSlots = props.meshSlots, _props_renderMode = props.renderMode, renderMode = _props_renderMode === void 0 ? 0 : _props_renderMode, _props_diffuse = props.diffuse, diffuse = _props_diffuse === void 0 ? Texture.createWithData(engine) : _props_diffuse;
         var detail = engine.gpuCapability.detail;
         var halfFloatTexture = detail.halfFloatTexture, maxVertexUniforms = detail.maxVertexUniforms;
-        var marcos = [
+        var macros = [
+            // spec.RenderMode
             [
                 "RENDER_MODE",
                 +renderMode
             ],
-            [
-                "PRE_MULTIPLY_ALPHA",
-                false
-            ],
             [
                 "ENV_EDITOR",
                 env === PLAYER_OPTIONS_ENV_EDITOR
@@ -17406,13 +17369,13 @@ var ParticleMesh = /*#__PURE__*/ function() {
         var useOrbitalVel;
         this.useSprite = useSprite;
         if (enableVertexTexture) {
-            marcos.push([
+            macros.push([
                 "ENABLE_VERTEX_TEXTURE",
                 true
             ]);
         }
         if (speedOverLifetime) {
-            marcos.push([
+            macros.push([
                 "SPEED_OVER_LIFETIME",
                 true
             ]);
@@ -17420,7 +17383,7 @@ var ParticleMesh = /*#__PURE__*/ function() {
             uniformValues.uSpeedLifetimeValue = speedOverLifetime.toUniform(vertexKeyFrameMeta);
         }
         if (sprite == null ? void 0 : sprite.animate) {
-            marcos.push([
+            macros.push([
                 "USE_SPRITE",
                 true
             ]);
@@ -17434,7 +17397,7 @@ var ParticleMesh = /*#__PURE__*/ function() {
             this.useSprite = true;
         }
         if (colorOverLifetime == null ? void 0 : colorOverLifetime.color) {
-            marcos.push([
+            macros.push([
                 "COLOR_OVER_LIFETIME",
                 true
             ]);
@@ -17459,7 +17422,7 @@ var ParticleMesh = /*#__PURE__*/ function() {
                 shaderCacheId |= 1 << 7 + i;
                 linearVelOverLifetime.enabled = true;
             }
-            marcos.push([
+            macros.push([
                 "LINEAR_VEL_" + pro.toUpperCase(),
                 defL
             ]);
@@ -17470,13 +17433,13 @@ var ParticleMesh = /*#__PURE__*/ function() {
                 useOrbitalVel = true;
                 orbitalVelOverLifetime.enabled = true;
             }
-            marcos.push([
+            macros.push([
                 "ORB_VEL_" + pro.toUpperCase(),
                 defO
             ]);
         });
         if (linearVelOverLifetime == null ? void 0 : linearVelOverLifetime.asMovement) {
-            marcos.push([
+            macros.push([
                 "AS_LINEAR_MOVEMENT",
                 true
             ]);
@@ -17484,7 +17447,7 @@ var ParticleMesh = /*#__PURE__*/ function() {
         }
         if (useOrbitalVel) {
             if (orbitalVelOverLifetime == null ? void 0 : orbitalVelOverLifetime.asRotation) {
-                marcos.push([
+                macros.push([
                     "AS_ORBITAL_MOVEMENT",
                     true
                 ]);
@@ -17499,7 +17462,7 @@ var ParticleMesh = /*#__PURE__*/ function() {
         uniformValues.uSizeByLifetimeValue = sizeOverLifetime == null ? void 0 : sizeOverLifetime.x.toUniform(vertexKeyFrameMeta);
         if (sizeOverLifetime == null ? void 0 : sizeOverLifetime.separateAxes) {
             var _sizeOverLifetime_y;
-            marcos.push([
+            macros.push([
                 "SIZE_Y_BY_LIFE",
                 1
             ]);
@@ -17509,7 +17472,7 @@ var ParticleMesh = /*#__PURE__*/ function() {
         if (rotationOverLifetime == null ? void 0 : rotationOverLifetime.z) {
             uniformValues.uRZByLifeTimeValue = rotationOverLifetime.z.toUniform(vertexKeyFrameMeta);
             shaderCacheId |= 1 << 15;
-            marcos.push([
+            macros.push([
                 "ROT_Z_LIFETIME",
                 1
             ]);
@@ -17517,7 +17480,7 @@ var ParticleMesh = /*#__PURE__*/ function() {
         if (rotationOverLifetime == null ? void 0 : rotationOverLifetime.x) {
             uniformValues.uRXByLifeTimeValue = rotationOverLifetime.x.toUniform(vertexKeyFrameMeta);
             shaderCacheId |= 1 << 16;
-            marcos.push([
+            macros.push([
                 "ROT_X_LIFETIME",
                 1
             ]);
@@ -17525,13 +17488,13 @@ var ParticleMesh = /*#__PURE__*/ function() {
         if (rotationOverLifetime == null ? void 0 : rotationOverLifetime.y) {
             uniformValues.uRYByLifeTimeValue = rotationOverLifetime.y.toUniform(vertexKeyFrameMeta);
             shaderCacheId |= 1 << 17;
-            marcos.push([
+            macros.push([
                 "ROT_Y_LIFETIME",
                 1
             ]);
         }
         if (rotationOverLifetime == null ? void 0 : rotationOverLifetime.asRotation) {
-            marcos.push([
+            macros.push([
                 "ROT_LIFETIME_AS_MOVEMENT",
                 1
             ]);
@@ -17539,7 +17502,7 @@ var ParticleMesh = /*#__PURE__*/ function() {
         }
         uniformValues.uGravityModifierValue = gravityModifier.toUniform(vertexKeyFrameMeta);
         if (forceTarget) {
-            marcos.push([
+            macros.push([
                 "FINAL_TARGET",
                 true
             ]);
@@ -17585,7 +17548,7 @@ var ParticleMesh = /*#__PURE__*/ function() {
             fragmentKeyFrameMeta.index,
             fragmentKeyFrameMeta.max
         ].join("+");
-        marcos.push([
+        macros.push([
             "VERT_CURVE_VALUE_COUNT",
             vertexKeyFrameMeta.index
         ], [
@@ -17607,7 +17570,7 @@ var ParticleMesh = /*#__PURE__*/ function() {
             glslVersion: level === 1 ? exports.GLSLVersion.GLSL1 : exports.GLSLVersion.GLSL3,
             shared: true,
             cacheId: shaderCache,
-            marcos: marcos,
+            macros: macros,
             name: "particle#" + name
         };
         var mtlOptions = {
@@ -17684,7 +17647,7 @@ var ParticleMesh = /*#__PURE__*/ function() {
                     res.length = 0;
                     break;
                 default:
-                    console.warn("uniform " + name + "'s type not in typeMap");
+                    console.warn("Uniform " + name + "'s type not in typeMap.");
             }
         });
         material.setVector3("emissionColor", new Vector3(0, 0, 0));
@@ -18020,20 +17983,16 @@ function generateGeometryProps(maxVertex, useSprite, name) {
         maxVertex: maxVertex
     };
 }
-function getParticleMeshShader(item, env, gpuCapability) {
+function getParticleMeshShader(item, gpuCapability, env) {
     if (env === void 0) env = "";
     var _props_renderer;
     var props = item.content;
     var renderMode = +(((_props_renderer = props.renderer) == null ? void 0 : _props_renderer.renderMode) || 0);
-    var marcos = [
+    var macros = [
         [
             "RENDER_MODE",
             renderMode
         ],
-        [
-            "PRE_MULTIPLY_ALPHA",
-            false
-        ],
         [
             "ENV_EDITOR",
             env === PLAYER_OPTIONS_ENV_EDITOR
@@ -18048,13 +18007,13 @@ function getParticleMeshShader(item, env, gpuCapability) {
     var vertex_lookup_texture = 0;
     var shaderCacheId = 0;
     if (enableVertexTexture) {
-        marcos.push([
+        macros.push([
             "ENABLE_VERTEX_TEXTURE",
             true
         ]);
     }
     if (speedOverLifetime) {
-        marcos.push([
+        macros.push([
             "SPEED_OVER_LIFETIME",
             true
         ]);
@@ -18063,7 +18022,7 @@ function getParticleMeshShader(item, env, gpuCapability) {
     }
     var sprite = props.textureSheetAnimation;
     if (sprite && sprite.animate) {
-        marcos.push([
+        macros.push([
             "USE_SPRITE",
             true
         ]);
@@ -18071,7 +18030,7 @@ function getParticleMeshShader(item, env, gpuCapability) {
     }
     var colorOverLifetime = props.colorOverLifetime;
     if (colorOverLifetime && colorOverLifetime.color) {
-        marcos.push([
+        macros.push([
             "COLOR_OVER_LIFETIME",
             true
         ]);
@@ -18096,7 +18055,7 @@ function getParticleMeshShader(item, env, gpuCapability) {
             defL = 1;
             shaderCacheId |= 1 << 7 + i;
         }
-        marcos.push([
+        macros.push([
             "LINEAR_VEL_" + pro.toUpperCase(),
             defL
         ]);
@@ -18107,13 +18066,13 @@ function getParticleMeshShader(item, env, gpuCapability) {
             shaderCacheId |= 1 << 10 + i;
             useOrbitalVel = true;
         }
-        marcos.push([
+        macros.push([
             "ORB_VEL_" + pro.toUpperCase(),
             defO
         ]);
     });
     if (positionOverLifetime == null ? void 0 : positionOverLifetime.asMovement) {
-        marcos.push([
+        macros.push([
             "AS_LINEAR_MOVEMENT",
             true
         ]);
@@ -18121,7 +18080,7 @@ function getParticleMeshShader(item, env, gpuCapability) {
     }
     if (useOrbitalVel) {
         if (positionOverLifetime == null ? void 0 : positionOverLifetime.asRotation) {
-            marcos.push([
+            macros.push([
                 "AS_ORBITAL_MOVEMENT",
                 true
             ]);
@@ -18133,7 +18092,7 @@ function getParticleMeshShader(item, env, gpuCapability) {
         var separateAxes = sizeOverLifetime.separateAxes;
         if (separateAxes) {
             getKeyFrameMetaByRawValue(vertexKeyFrameMeta, sizeOverLifetime.x);
-            marcos.push([
+            macros.push([
                 "SIZE_Y_BY_LIFE",
                 1
             ]);
@@ -18148,7 +18107,7 @@ function getParticleMeshShader(item, env, gpuCapability) {
         if (rot.z) {
             getKeyFrameMetaByRawValue(vertexKeyFrameMeta, rot == null ? void 0 : rot.z);
             shaderCacheId |= 1 << 15;
-            marcos.push([
+            macros.push([
                 "ROT_Z_LIFETIME",
                 1
             ]);
@@ -18157,7 +18116,7 @@ function getParticleMeshShader(item, env, gpuCapability) {
             if (rot.x) {
                 getKeyFrameMetaByRawValue(vertexKeyFrameMeta, rot.x);
                 shaderCacheId |= 1 << 16;
-                marcos.push([
+                macros.push([
                     "ROT_X_LIFETIME",
                     1
                 ]);
@@ -18165,14 +18124,14 @@ function getParticleMeshShader(item, env, gpuCapability) {
             if (rot.y) {
                 getKeyFrameMetaByRawValue(vertexKeyFrameMeta, rot.y);
                 shaderCacheId |= 1 << 17;
-                marcos.push([
+                macros.push([
                     "ROT_Y_LIFETIME",
                     1
                 ]);
             }
         }
         if (rot == null ? void 0 : rot.asRotation) {
-            marcos.push([
+            macros.push([
                 "ROT_LIFETIME_AS_MOVEMENT",
                 1
             ]);
@@ -18182,7 +18141,7 @@ function getParticleMeshShader(item, env, gpuCapability) {
     getKeyFrameMetaByRawValue(vertexKeyFrameMeta, positionOverLifetime == null ? void 0 : positionOverLifetime.gravityOverLifetime);
     var forceOpt = positionOverLifetime == null ? void 0 : positionOverLifetime.forceTarget;
     if (forceOpt) {
-        marcos.push([
+        macros.push([
             "FINAL_TARGET",
             true
         ]);
@@ -18223,10 +18182,10 @@ function getParticleMeshShader(item, env, gpuCapability) {
         vertex: "#define LOOKUP_TEXTURE_CURVE " + vertex_lookup_texture + "\n" + particleVert,
         shared: true,
         cacheId: shaderCache,
-        marcos: marcos,
+        macros: macros,
         name: "particle#" + item.name
     };
-    marcos.push([
+    macros.push([
         "VERT_CURVE_VALUE_COUNT",
         vertexKeyFrameMeta.index
     ], [
@@ -18251,11 +18210,11 @@ function modifyMaxKeyframeShader(shader, maxVertex, maxFrag) {
     shaderIds[3] = maxVertex;
     shaderIds[5] = maxFrag;
     shader.cacheId = shaderIds.join("+");
-    if (!shader.marcos) {
+    if (!shader.macros) {
         return;
     }
-    for(var i = 0; i < shader.marcos.length; i++){
-        var marco = shader.marcos[i];
+    for(var i = 0; i < shader.macros.length; i++){
+        var marco = shader.macros[i];
         if (marco[0] === "VERT_CURVE_VALUE_COUNT") {
             marco[1] = maxVertex;
         } else if (marco[0] === "FRAG_CURVE_VALUE_COUNT") {
@@ -18288,17 +18247,17 @@ var ParticleLoader = /*#__PURE__*/ function(AbstractPlugin) {
             });
         });
         items.forEach(function(item) {
-            var _getParticleMeshShader = getParticleMeshShader(item, env, gpuCapability), shader = _getParticleMeshShader.shader, fragment = _getParticleMeshShader.fragment, vertex = _getParticleMeshShader.vertex;
+            var _getParticleMeshShader = getParticleMeshShader(item, gpuCapability, env), shader = _getParticleMeshShader.shader, fragment = _getParticleMeshShader.fragment, vertex = _getParticleMeshShader.vertex;
             shaders.push(shader);
             maxFragmentCount = Math.max(maxFragmentCount, fragment);
             maxVertexCount = Math.max(maxVertexCount, vertex);
             // TODO 此处add是否有意义？shader变量似乎没有加到this.shaders数组。
             if (item.content.trails) {
-                var shader1 = getTrailMeshShader(item.content.trails, item.content.options.maxCount, item.name, env, gpuCapability);
-                var _shader_marcos;
-                shader1.vertex = createShaderWithMarcos((_shader_marcos = shader1.marcos) != null ? _shader_marcos : [], shader1.vertex, exports.ShaderType.vertex, level);
-                var _shader_marcos1;
-                shader1.fragment = createShaderWithMarcos((_shader_marcos1 = shader1.marcos) != null ? _shader_marcos1 : [], shader1.fragment, exports.ShaderType.fragment, level);
+                var shader1 = getTrailMeshShader(item.content.trails, item.content.options.maxCount, item.name, gpuCapability, env);
+                var _shader_macros;
+                shader1.vertex = createShaderWithMacros((_shader_macros = shader1.macros) != null ? _shader_macros : [], shader1.vertex, exports.ShaderType.vertex, level);
+                var _shader_macros1;
+                shader1.fragment = createShaderWithMacros((_shader_macros1 = shader1.macros) != null ? _shader_macros1 : [], shader1.fragment, exports.ShaderType.fragment, level);
                 shader1.glslVersion = level === 2 ? exports.GLSLVersion.GLSL3 : exports.GLSLVersion.GLSL1;
                 shaderLibrary.addShader(shader1);
             }
@@ -18310,10 +18269,10 @@ var ParticleLoader = /*#__PURE__*/ function(AbstractPlugin) {
             } else {
                 shader.glslVersion = exports.GLSLVersion.GLSL1;
             }
-            var _shader_marcos;
-            shader.vertex = createShaderWithMarcos((_shader_marcos = shader.marcos) != null ? _shader_marcos : [], shader.vertex, exports.ShaderType.vertex, level);
-            var _shader_marcos1;
-            shader.fragment = createShaderWithMarcos((_shader_marcos1 = shader.marcos) != null ? _shader_marcos1 : [], shader.fragment, exports.ShaderType.fragment, level);
+            var _shader_macros;
+            shader.vertex = createShaderWithMacros((_shader_macros = shader.macros) != null ? _shader_macros : [], shader.vertex, exports.ShaderType.vertex, level);
+            var _shader_macros1;
+            shader.fragment = createShaderWithMacros((_shader_macros1 = shader.macros) != null ? _shader_macros1 : [], shader.fragment, exports.ShaderType.fragment, level);
             shaderLibrary.addShader(shader);
         });
         if (level === 2) {
@@ -18695,6 +18654,29 @@ var AnimationClipPlayable = /*#__PURE__*/ function(Playable) {
     return AnimationClipPlayable;
 }(Playable);
 
+/**
+ * @since 2.0.0
+ * @internal
+ */ var TimelineClip = /*#__PURE__*/ function() {
+    function TimelineClip() {
+        this.start = 0;
+        this.duration = 0;
+    }
+    var _proto = TimelineClip.prototype;
+    _proto.toLocalTime = function toLocalTime(time) {
+        var localTime = time - this.start;
+        var duration = this.duration;
+        if (localTime - duration > 0.001) {
+            if (this.endBehaviour === ItemEndBehavior.loop) {
+                localTime = localTime % duration;
+            } else if (this.endBehaviour === ItemEndBehavior.freeze) {
+                localTime = Math.min(duration, localTime);
+            }
+        }
+        return localTime;
+    };
+    return TimelineClip;
+}();
 exports.TrackAsset = /*#__PURE__*/ function(PlayableAsset) {
     _inherits(TrackAsset, PlayableAsset);
     function TrackAsset() {
@@ -18756,7 +18738,7 @@ exports.TrackAsset = /*#__PURE__*/ function(PlayableAsset) {
         this.children.push(child);
     };
     _proto.createClip = function createClip(classConstructor, name) {
-        var newClip = new exports.TimelineClip();
+        var newClip = new TimelineClip();
         newClip.asset = new classConstructor(this.engine);
         newClip.name = name ? name : "TimelineClip" + newClip.id;
         this.addClip(newClip);
@@ -18783,7 +18765,7 @@ exports.TrackAsset = /*#__PURE__*/ function(PlayableAsset) {
     return TrackAsset;
 }(PlayableAsset);
 __decorate([
-    serialize("TimelineClip")
+    serialize(TimelineClip)
 ], exports.TrackAsset.prototype, "clips", void 0);
 __decorate([
     serialize()
@@ -18796,29 +18778,6 @@ exports.TrackType = void 0;
     TrackType[TrackType["MasterTrack"] = 0] = "MasterTrack";
     TrackType[TrackType["ObjectTrack"] = 1] = "ObjectTrack";
 })(exports.TrackType || (exports.TrackType = {}));
-exports.TimelineClip = /*#__PURE__*/ function() {
-    function TimelineClip() {
-        this.start = 0;
-        this.duration = 0;
-    }
-    var _proto = TimelineClip.prototype;
-    _proto.toLocalTime = function toLocalTime(time) {
-        var localTime = time - this.start;
-        var duration = this.duration;
-        if (localTime - duration > 0.001) {
-            if (this.endBehaviour === ItemEndBehavior.loop) {
-                localTime = localTime % duration;
-            } else if (this.endBehaviour === ItemEndBehavior.freeze) {
-                localTime = Math.min(duration, localTime);
-            }
-        }
-        return localTime;
-    };
-    return TimelineClip;
-}();
-exports.TimelineClip = __decorate([
-    effectsClass("TimelineClip")
-], exports.TimelineClip);
 var RuntimeClip = /*#__PURE__*/ function() {
     function RuntimeClip(clip, clipPlayable, parentMixer, track) {
         this.clip = clip;
@@ -18905,10 +18864,6 @@ exports.ObjectBindingTrack = /*#__PURE__*/ function(TrackAsset1) {
             particleClip.endBehaviour = boundItem.endBehavior;
         }
     };
-    _proto.fromData = function fromData(data) {
-        TrackAsset1.prototype.fromData.call(this, data);
-        this.data = data;
-    };
     return ObjectBindingTrack;
 }(exports.TrackAsset);
 exports.ObjectBindingTrack = __decorate([
@@ -19148,7 +19103,6 @@ function compareTracks(a, b) {
         this.startTime = startTime;
         this.resolveBindings();
         this.timelinePlayable = this.timelineAsset.createPlayable(this.graph);
-        this.timelinePlayable.play();
         // 重播不销毁元素
         if (this.item.endBehavior !== ItemEndBehavior.destroy) {
             this.setReusable(true);
@@ -19206,7 +19160,7 @@ function compareTracks(a, b) {
                     var refId = itemData.content.options.refId;
                     var props = this.item.composition.refCompositionProps.get(refId);
                     if (!props) {
-                        throw new Error("引用的Id: " + refId + " 的预合成不存在");
+                        throw new Error("Referenced precomposition with Id: " + refId + " does not exist.");
                     }
                     // endBehaviour 类型需优化
                     props.content = itemData.content;
@@ -19359,7 +19313,7 @@ exports.SubCompositionTrack = /*#__PURE__*/ function(TrackAsset) {
     var _proto = SubCompositionTrack.prototype;
     _proto.resolveBinding = function resolveBinding(parentBinding) {
         if (!_instanceof1(parentBinding, exports.VFXItem)) {
-            throw new Error("SubCompositionTrack needs to be set under the VFXItem track");
+            throw new Error("SubCompositionTrack needs to be set under the VFXItem track.");
         }
         return parentBinding.getComponent(CompositionComponent);
     };
@@ -19567,7 +19521,6 @@ var CanvasPool = /*#__PURE__*/ function() {
             return this.elements.shift();
         }
         if (getConfig(TEMPLATE_USE_OFFSCREEN_CANVAS)) {
-            // @ts-expect-error
             return window._createOffscreenCanvas(10, 10);
         } else {
             // in hongmeng system, create too many canvas will case render error
@@ -20136,6 +20089,7 @@ exports.VFXItem = /*#__PURE__*/ function(EffectsObject) {
         /**
    * 元素动画的速度
    */ _this.speed = 1;
+        _this.listIndex = 0;
         _this.name = "VFXItem";
         _this.transform.name = _this.name;
         _this.transform.engine = engine;
@@ -20406,7 +20360,6 @@ exports.VFXItem = /*#__PURE__*/ function(EffectsObject) {
         this.parentId = parentId;
         this.duration = duration;
         this.endBehavior = endBehavior;
-        this.renderOrder = listIndex;
         //@ts-expect-error
         this.oldId = data.oldId;
         if (!data.content) {
@@ -20415,20 +20368,14 @@ exports.VFXItem = /*#__PURE__*/ function(EffectsObject) {
             };
         }
         if (duration <= 0) {
-            throw Error("Item duration can't be less than 0, see " + HELP_LINK["Item duration can't be less than 0"]);
+            throw new Error("Item duration can't be less than 0, see " + HELP_LINK["Item duration can't be less than 0"] + ".");
         }
-        if (data.components) {
-            for(var _iterator = _create_for_of_iterator_helper_loose(data.components), _step; !(_step = _iterator()).done;){
-                var component = _step.value;
-                var newComponent = component;
-                this.components.push(newComponent);
-                if (_instanceof1(newComponent, RendererComponent)) {
-                    this.rendererComponents.push(newComponent);
-                } else if (_instanceof1(newComponent, ItemBehaviour)) {
-                    this.itemBehaviours.push(newComponent);
-                }
-            }
+        for(var _iterator = _create_for_of_iterator_helper_loose(this.components), _step; !(_step = _iterator()).done;){
+            var component = _step.value;
+            component.onAttached();
         }
+        // renderOrder 在 component 初始化后设置。确保能拿到 rendererComponent。
+        this.renderOrder = listIndex;
     };
     _proto.toData = function toData() {
         var _this_parent;
@@ -20559,6 +20506,9 @@ exports.VFXItem = /*#__PURE__*/ function(EffectsObject) {
     ]);
     return VFXItem;
 }(EffectsObject);
+__decorate([
+    serialize()
+], exports.VFXItem.prototype, "components", void 0);
 exports.VFXItem = __decorate([
     effectsClass(DataType.VFXItemData)
 ], exports.VFXItem);
@@ -20612,7 +20562,7 @@ exports.Item = void 0;
                 pluginName = "tree";
                 break;
             default:
-                throw new Error("invalid vfx item type");
+                throw new Error("Invalid vfx item type.");
         }
     }
     return composition.pluginSystem.createPluginItem(pluginName, props, composition);
@@ -20656,7 +20606,7 @@ var PluginSystem = /*#__PURE__*/ function() {
         this.plugins = Object.keys(loaders).map(function(name) {
             var CTRL = pluginLoaderMap[name];
             if (!CTRL) {
-                throw new Error("plugin '" + name + "' not found." + getPluginUsageInfo(name));
+                throw new Error("The plugin '" + name + "' not found." + getPluginUsageInfo(name));
             }
             var loader = new CTRL();
             loader.name = name;
@@ -20684,13 +20634,13 @@ var PluginSystem = /*#__PURE__*/ function() {
     _proto.createPluginItem = function createPluginItem(name, props, composition) {
         var CTRL = pluginCtrlMap[name];
         if (!CTRL) {
-            throw new Error("plugin " + name + " no registered constructor");
+            throw new Error("The plugin '" + name + "' does not have a registered constructor.");
         }
         var engine = composition.getEngine();
         var item = new CTRL(engine, props, composition);
         item.composition = composition;
         if (!_instanceof1(item, exports.VFXItem)) {
-            throw new Error("plugin " + name + " invalid constructor type");
+            throw new Error("The plugin '" + name + "' invalid constructor type.");
         }
         return item;
     };
@@ -20788,22 +20738,22 @@ var SerializationHelper = /*#__PURE__*/ function() {
             if (value === undefined) {
                 value = effectsObject[key];
             }
-            if (_instanceof1(value, EffectsObject)) {
-                this.collectSerializableObject(value, res);
-            } else if (_instanceof1(value, Array)) {
+            if (EffectsObject.is(value)) {
+                SerializationHelper.collectSerializableObject(value, res);
+            } else if (isArray(value)) {
                 for(var _iterator1 = _create_for_of_iterator_helper_loose(value), _step1; !(_step1 = _iterator1()).done;){
                     var arrayValue = _step1.value;
-                    if (_instanceof1(arrayValue, EffectsObject)) {
-                        this.collectSerializableObject(arrayValue, res);
+                    if (EffectsObject.is(arrayValue)) {
+                        SerializationHelper.collectSerializableObject(arrayValue, res);
                     }
                 }
-            } else if (_instanceof1(value, Object)) {
+            } else if (isObject(value)) {
                 // 非 EffectsObject 对象只递归一层
                 for(var _iterator2 = _create_for_of_iterator_helper_loose(Object.keys(value)), _step2; !(_step2 = _iterator2()).done;){
                     var objectKey = _step2.value;
                     var objectValue = value[objectKey];
-                    if (_instanceof1(objectValue, EffectsObject)) {
-                        this.collectSerializableObject(objectValue, res);
+                    if (EffectsObject.is(objectValue)) {
+                        SerializationHelper.collectSerializableObject(objectValue, res);
                     }
                 }
             }
@@ -20840,17 +20790,17 @@ var SerializationHelper = /*#__PURE__*/ function() {
             if (typeof value === "number" || typeof value === "string" || typeof value === "boolean" || SerializationHelper.checkTypedArray(value)) {
                 // TODO json 数据避免传 typedArray
                 serializedData[key] = value;
-            } else if (_instanceof1(value, Array)) {
+            } else if (isArray(value)) {
                 if (!serializedData[key]) {
                     serializedData[key] = [];
                 }
                 SerializationHelper.serializeArrayProperty(value, serializedData[key], 0);
-            } else if (_instanceof1(value, EffectsObject)) {
+            } else if (EffectsObject.is(value)) {
                 // TODO 处理 EffectsObject 递归序列化
                 serializedData[key] = {
                     id: value.getInstanceId()
                 };
-            } else if (_instanceof1(value, Object)) {
+            } else if (isObject(value)) {
                 if (!serializedData[key]) {
                     serializedData[key] = {};
                 }
@@ -20864,17 +20814,17 @@ var SerializationHelper = /*#__PURE__*/ function() {
             if (typeof value1 === "number" || typeof value1 === "string" || typeof value1 === "boolean" || SerializationHelper.checkTypedArray(value1)) {
                 // TODO json 数据避免传 typedArray
                 serializedData[key1] = value1;
-            } else if (_instanceof1(value1, Array)) {
+            } else if (isArray(value1)) {
                 if (!serializedData[key1]) {
                     serializedData[key1] = [];
                 }
                 SerializationHelper.serializeArrayProperty(value1, serializedData[key1], 0);
-            } else if (_instanceof1(value1, EffectsObject)) {
+            } else if (EffectsObject.is(value1)) {
                 // TODO 处理 EffectsObject 递归序列化
                 serializedData[key1] = {
                     id: value1.getInstanceId()
                 };
-            } else if (_instanceof1(value1, Object)) {
+            } else if (isObject(value1)) {
                 if (!serializedData[key1]) {
                     serializedData[key1] = {};
                 }
@@ -20987,24 +20937,24 @@ var SerializationHelper = /*#__PURE__*/ function() {
     SerializationHelper.checkTypedArray = function checkTypedArray(obj) {
         return _instanceof1(obj, Int8Array) || _instanceof1(obj, Uint8Array) || _instanceof1(obj, Uint8ClampedArray) || _instanceof1(obj, Int16Array) || _instanceof1(obj, Uint16Array) || _instanceof1(obj, Int32Array) || _instanceof1(obj, Uint32Array) || _instanceof1(obj, Float32Array) || _instanceof1(obj, Float64Array) || _instanceof1(obj, ArrayBuffer);
     };
+    // check value is { id: 7e69662e964e4892ae8933f24562395b }
     SerializationHelper.checkDataPath = function checkDataPath(value) {
-        // check value is { id: 7e69662e964e4892ae8933f24562395b }
-        return _instanceof1(value, Object) && Object.keys(value).length === 1 && value.id && value.id.length === 32;
+        return !!(isObject(value) && Object.keys(value).length === 1 && "id" in value && isString(value.id) && value.id.length === 32);
     };
     // TODO 测试函数，2.0 上线后移除
     SerializationHelper.checkGLTFNode = function checkGLTFNode(value) {
-        return _instanceof1(value, Object) && value.nodeIndex !== undefined && value.isJoint !== undefined;
+        return isObject(value) && value.nodeIndex !== undefined && value.isJoint !== undefined;
     };
     SerializationHelper.checkImageSource = function checkImageSource(value) {
         return isCanvas(value) || _instanceof1(value, HTMLImageElement);
     };
     SerializationHelper.deserializeProperty = function deserializeProperty(property, engine, level, type) {
         if (level > 14) {
-            console.error("序列化数据的内嵌对象层数大于上限");
+            console.error("The nested object layers of the serialized data exceed the maximum limit.");
             return;
         }
         // 加载并链接 DataPath 字段表示的 EffectsObject 引用。Class 对象 copy [key, value] 会丢失对象信息，因此只递归数组对象和普通 js Object 结构对象。
-        if (_instanceof1(property, Array)) {
+        if (isArray(property)) {
             var res = [];
             for(var _iterator = _create_for_of_iterator_helper_loose(property), _step; !(_step = _iterator()).done;){
                 var value = _step.value;
@@ -21014,17 +20964,15 @@ var SerializationHelper = /*#__PURE__*/ function() {
         // TODO json 数据避免传 typedArray
         } else if (SerializationHelper.checkDataPath(property)) {
             return engine.assetLoader.loadGUID(property.id);
-        } else if (_instanceof1(property, Object) && property.constructor === Object) {
+        } else if (isObject(property) && property.constructor === Object) {
             var res1;
             if (type) {
-                var classConstructor = effectsClassStore[type];
-                res1 = new classConstructor();
+                res1 = new type();
             } else {
                 res1 = {};
             }
             for(var _iterator1 = _create_for_of_iterator_helper_loose(Object.keys(property)), _step1; !(_step1 = _iterator1()).done;){
                 var key = _step1.value;
-                // @ts-expect-error
                 res1[key] = SerializationHelper.deserializeProperty(property[key], engine, level + 1);
             }
             return res1;
@@ -21034,17 +20982,17 @@ var SerializationHelper = /*#__PURE__*/ function() {
     };
     SerializationHelper.deserializePropertyAsync = function deserializePropertyAsync(property, engine, level, type) {
         return _async_to_generator(function() {
-            var res, _iterator, _step, value, _, res1, res2, classConstructor, _iterator1, _step1, key;
+            var res, _iterator, _step, value, _, res1, res2, _iterator1, _step1, key;
             return __generator(this, function(_state) {
                 switch(_state.label){
                     case 0:
                         if (level > 14) {
-                            console.error("序列化数据的内嵌对象层数大于上限");
+                            console.error("The nested object layers of the serialized data exceed the maximum limit.");
                             return [
                                 2
                             ];
                         }
-                        if (!_instanceof1(property, Array)) return [
+                        if (!isArray(property)) return [
                             3,
                             5
                         ];
@@ -21093,16 +21041,14 @@ var SerializationHelper = /*#__PURE__*/ function() {
                             res1
                         ];
                     case 7:
-                        if (_instanceof1(property, Object) && property.constructor === Object) {
+                        if (isObject(property) && property.constructor === Object) {
                             if (type) {
-                                classConstructor = effectsClassStore[type];
-                                res2 = new classConstructor();
+                                res2 = new type();
                             } else {
                                 res2 = {};
                             }
                             for(_iterator1 = _create_for_of_iterator_helper_loose(Object.keys(property)); !(_step1 = _iterator1()).done;){
                                 key = _step1.value;
-                                // @ts-expect-error
                                 res2[key] = SerializationHelper.deserializeProperty(property[key], engine, level + 1);
                             }
                             return [
@@ -21125,7 +21071,7 @@ var SerializationHelper = /*#__PURE__*/ function() {
     };
     SerializationHelper.serializeObjectProperty = function serializeObjectProperty(objectProperty, serializedData, level) {
         if (level > 14) {
-            console.error("序列化数据的内嵌对象层数大于上限");
+            console.error("The nested object layers of the serialized data exceed the maximum limit.");
             return;
         }
         if (!serializedData) {
@@ -21137,17 +21083,17 @@ var SerializationHelper = /*#__PURE__*/ function() {
             if (typeof value === "number" || typeof value === "string" || typeof value === "boolean" || SerializationHelper.checkTypedArray(objectProperty)) {
                 // TODO json 数据避免传 typedArray
                 serializedData[key] = value;
-            } else if (_instanceof1(value, Array)) {
+            } else if (isArray(value)) {
                 if (!serializedData[key]) {
                     serializedData[key] = [];
                 }
                 SerializationHelper.serializeArrayProperty(value, serializedData[key], level + 1);
-            } else if (_instanceof1(value, EffectsObject)) {
+            } else if (EffectsObject.is(value)) {
                 // TODO 处理 EffectsObject 递归序列化
                 serializedData[key] = {
                     id: value.getInstanceId()
                 };
-            } else if (_instanceof1(value, Object)) {
+            } else if (isObject(value)) {
                 if (!serializedData[key]) {
                     serializedData[key] = {};
                 }
@@ -21157,7 +21103,7 @@ var SerializationHelper = /*#__PURE__*/ function() {
     };
     SerializationHelper.serializeArrayProperty = function serializeArrayProperty(arrayProperty, serializedData, level) {
         if (level > 14) {
-            console.error("序列化数据的内嵌对象层数大于上限");
+            console.error("The nested object layers of the serialized data exceed the maximum limit.");
             return;
         }
         if (!serializedData) {
@@ -21168,17 +21114,17 @@ var SerializationHelper = /*#__PURE__*/ function() {
             if (typeof value === "number" || typeof value === "string" || typeof value === "boolean" || SerializationHelper.checkTypedArray(arrayProperty)) {
                 // TODO json 数据避免传 typedArray
                 serializedData[i] = value;
-            } else if (_instanceof1(value, Array)) {
+            } else if (isArray(value)) {
                 if (!serializedData[i]) {
                     serializedData[i] = [];
                 }
-                this.serializeArrayProperty(value, serializedData[i], level + 1);
-            } else if (_instanceof1(value, EffectsObject)) {
+                SerializationHelper.serializeArrayProperty(value, serializedData[i], level + 1);
+            } else if (EffectsObject.is(value)) {
                 // TODO 处理 EffectsObject 递归序列化
                 serializedData[i] = {
                     id: value.getInstanceId()
                 };
-            } else if (_instanceof1(value, Object)) {
+            } else if (isObject(value)) {
                 if (!serializedData[i]) {
                     serializedData[i] = {};
                 }
@@ -21204,7 +21150,7 @@ var SerializationHelper = /*#__PURE__*/ function() {
         var effectsObject;
         var effectsObjectData = this.findData(guid);
         if (!effectsObjectData) {
-            console.error("未找到 uuid: " + guid + "的对象数据");
+            console.error("Object data with uuid: " + guid + " not found.");
             return undefined;
         }
         switch(effectsObjectData.dataType){
@@ -21226,7 +21172,7 @@ var SerializationHelper = /*#__PURE__*/ function() {
                 }
         }
         if (!effectsObject) {
-            console.error("未找到 DataType: " + effectsObjectData.dataType + "的构造函数");
+            console.error("Constructor for DataType: " + effectsObjectData.dataType + " not found.");
             return undefined;
         }
         effectsObject.setInstanceId(effectsObjectData.id);
@@ -21254,7 +21200,7 @@ var SerializationHelper = /*#__PURE__*/ function() {
                             2
                         ];
                         if (!_this.engine.database) {
-                            console.error("未找到 uuid: " + guid + "的对象数据");
+                            console.error("Object data with uuid: " + guid + " not found.");
                             return [
                                 2,
                                 undefined
@@ -21267,7 +21213,7 @@ var SerializationHelper = /*#__PURE__*/ function() {
                     case 1:
                         effectsObject = _state.sent();
                         if (!effectsObject) {
-                            console.error("未找到 uuid: " + guid + "的磁盘数据");
+                            console.error("Disk data with uuid: " + guid + " not found.");
                             return [
                                 2,
                                 undefined
@@ -21298,7 +21244,7 @@ var SerializationHelper = /*#__PURE__*/ function() {
                                 }
                         }
                         if (!effectsObject) {
-                            console.error("未找到 DataType: " + effectsObjectData.dataType + "的构造函数");
+                            console.error("Constructor for DataType: " + effectsObjectData.dataType + " not found.");
                             return [
                                 2,
                                 undefined
@@ -22218,8 +22164,6 @@ function getStandardCameraContent(model) {
         // 生成时间轴数据
         convertTimelineAsset(compositionData, guidToItemMap, result);
     };
-    var // 更正 spine 数据中的 images 属性
-    _json_spines;
     var // 兼容老版本数据中不存在textures的情况
     _result;
     var result = _extends({}, json, {
@@ -22229,7 +22173,8 @@ function getStandardCameraContent(model) {
         materials: [],
         shaders: [],
         geometries: [],
-        animations: []
+        animations: [],
+        miscs: []
     });
     // image数据添加 guid
     for(var _iterator = _create_for_of_iterator_helper_loose(result.images), _step; !(_step = _iterator()).done;){
@@ -22259,17 +22204,10 @@ function getStandardCameraContent(model) {
             });
         }
     }
-    (_json_spines = json.spines) == null ? void 0 : _json_spines.forEach(function(spine) {
-        for(var i = 0; i < spine.images.length; i++){
-            var _json_textures_spine_images_i;
-            //@ts-expect-error
-            var textureId = (_json_textures_spine_images_i = json.textures[spine.images[i]]) == null ? void 0 : _json_textures_spine_images_i.id;
-            //@ts-expect-error
-            spine.images[i] = {
-                id: textureId
-            };
-        }
-    });
+    // 处理老版本数据中 bins 没有 id 的情况
+    if (json.bins) {
+        convertBinaryAsset(json.bins, result);
+    }
     var itemOldIdToGuidMap = {};
     var guidToItemMap = {};
     // 更正Composition.endBehavior
@@ -22433,6 +22371,10 @@ function getStandardCameraContent(model) {
             //@ts-expect-error
             item.type = "orientation-transformer";
         }
+        // Spine 元素转为 guid 索引
+        if (item.type === ItemType.spine && json.spines && json.spines.length !== 0) {
+            convertSpineData(json.spines[item.content.options.spine], item.content, result);
+        }
         // item 的 content 转为 component data 加入 JSONScene.components
         if (item.type === ItemType.sprite || item.type === ItemType.particle || item.type === ItemType.mesh || item.type === ItemType.skybox || item.type === ItemType.light || item.type === "camera" || item.type === ItemType.tree || item.type === ItemType.interact || item.type === ItemType.camera || item.type === ItemType.text || item.type === ItemType.spine || item.type === "editor-gizmo" || item.type === "orientation-transformer") {
             item.components = [];
@@ -22680,29 +22622,61 @@ function convertTimelineAsset(composition, guidToItemMap, jsonScene) {
         id: timelineAssetData.id
     };
     composition.sceneBindings = sceneBindings;
-    if (!jsonScene.animations) {
-        jsonScene.animations = [];
-    }
-    // @ts-expect-error
-    jsonScene.animations.push(timelineAssetData);
+    jsonScene.miscs.push(timelineAssetData);
     for(var _iterator2 = _create_for_of_iterator_helper_loose(trackDatas), _step2; !(_step2 = _iterator2()).done;){
         var trackData1 = _step2.value;
         //@ts-expect-error
-        jsonScene.animations.push(trackData1);
+        jsonScene.miscs.push(trackData1);
     }
     for(var _iterator3 = _create_for_of_iterator_helper_loose(playableAssetDatas), _step3; !(_step3 = _iterator3()).done;){
         var playableAsset = _step3.value;
         //@ts-expect-error
-        jsonScene.animations.push(playableAsset);
+        jsonScene.miscs.push(playableAsset);
     }
 }
+function convertBinaryAsset(bins, jsonScene) {
+    //@ts-expect-error
+    jsonScene.bins = bins.map(function(bin) {
+        return {
+            url: bin.url,
+            "dataType": "BinaryAsset",
+            id: generateGUID()
+        };
+    });
+}
+function convertSpineData(resource, content, jsonScene) {
+    //@ts-expect-error
+    content.resource = {
+        "atlas": {
+            "bins": {
+                //@ts-expect-error
+                "id": jsonScene.bins[resource.atlas[1][0]].id
+            },
+            "source": resource.atlas[1].slice(1)
+        },
+        "skeleton": {
+            "bins": {
+                //@ts-expect-error
+                "id": jsonScene.bins[resource.skeleton[1][0]].id
+            },
+            "source": resource.skeleton[1].slice(1)
+        },
+        "skeletonType": resource.skeletonType,
+        "images": resource.images.map(function(i) {
+            return {
+                //@ts-expect-error
+                id: jsonScene.textures[i].id
+            };
+        })
+    };
+}
 
 var v0 = /^(\d+)\.(\d+)\.(\d+)(-(\w+)\.\d+)?$/;
 var standardVersion = /^(\d+)\.(\d+)$/;
 var reverseParticle = false;
 function getStandardJSON(json) {
     if (!json || typeof json !== "object") {
-        throw Error("expect a json object");
+        throw new Error("Invalid input: Expected a JSON object.");
     }
     // 修正老版本数据中，meshItem 以及 lightItem 结束行为错误问题
     version22Migration(json);
@@ -22723,7 +22697,7 @@ function getStandardJSON(json) {
         }
         return json;
     }
-    throw Error("invalid json version " + json.version);
+    throw new Error("Invalid JSON version: " + json.version + ".");
 }
 var currentVersion = "1.0";
 function getStandardJSONFromV0(json) {
@@ -22815,7 +22789,7 @@ function getStandardImage(image, index, imageTags) {
     } else if (image && image.sourceType) {
         return image;
     }
-    throw Error("invalid image type");
+    throw new Error("Invalid image type.");
 }
 function getStandardComposition(composition, opt) {
     if (opt === void 0) opt = {};
@@ -23099,7 +23073,7 @@ function _combineImageTemplate() {
                     _state.label = 3;
                 case 3:
                     if (!image) {
-                        throw new Error("image not provided.");
+                        throw new Error("Image not provided.");
                     }
                     if (!template) {
                         return [
@@ -23217,7 +23191,7 @@ var seed$1 = 1;
                         cancelLoading = true;
                         _this.removeTimer(loadTimer);
                         var totalTime = performance.now() - startTime;
-                        reject(new Error("Load time out: totalTime: " + totalTime.toFixed(4) + "ms " + timeInfos.join(" ") + ", url: " + assetUrl));
+                        reject(new Error("Load time out: totalTime: " + totalTime.toFixed(4) + "ms " + timeInfos.join(" ") + ", url: " + assetUrl + "."));
                     }, _this.timeout * 1000);
                     _this.timers.push(loadTimer);
                 });
@@ -23252,7 +23226,7 @@ var seed$1 = 1;
                                 ];
                             case 3:
                                 e = _state.sent();
-                                throw new Error("Load error in " + label + ", " + e);
+                                throw new Error("Load error in " + label + ", " + e + ".");
                             case 4:
                                 throw new Error("Load canceled.");
                         }
@@ -23398,7 +23372,7 @@ var seed$1 = 1;
                                 _state.label = 12;
                             case 12:
                                 totalTime = performance.now() - startTime;
-                                logger.info("Load asset: totalTime: " + totalTime.toFixed(4) + "ms " + timeInfos.join(" ") + ", url: " + assetUrl);
+                                logger.info("Load asset: totalTime: " + totalTime.toFixed(4) + "ms " + timeInfos.join(" ") + ", url: " + assetUrl + ".");
                                 window.clearTimeout(loadTimer);
                                 _this.removeTimer(loadTimer);
                                 scene.totalTime = totalTime;
@@ -23441,7 +23415,7 @@ var seed$1 = 1;
                         return [
                             4,
                             new Promise(function(resolve) {
-                                shaderLibrary.compileAllShaders(function() {
+                                shaderLibrary == null ? void 0 : shaderLibrary.compileAllShaders(function() {
                                     resolve(null);
                                 });
                             })
@@ -23516,7 +23490,7 @@ var seed$1 = 1;
                     if (passRenderLevel(bin.renderLevel, renderLevel)) {
                         return _this.loadBins(new URL(bin.url, baseUrl).href);
                     }
-                    throw new Error("Invalid bins source: " + JSON.stringify(bins));
+                    throw new Error("Invalid bins source: " + JSON.stringify(bins) + ".");
                 });
                 return [
                     2,
@@ -23547,7 +23521,7 @@ var seed$1 = 1;
                                 ];
                                 if (!isValidFontFamily(font.fontFamily)) {
                                     // 在所有设备上提醒开发者
-                                    console.warn("Risky font family: " + font.fontFamily);
+                                    console.warn("Risky font family: " + font.fontFamily + ".");
                                 }
                                 _state.label = 1;
                             case 1:
@@ -23574,7 +23548,7 @@ var seed$1 = 1;
                                 ];
                             case 3:
                                 _state.sent();
-                                logger.warn("Invalid font family or font source: " + JSON.stringify(font.fontURL));
+                                logger.warn("Invalid font family or font source: " + JSON.stringify(font.fontURL) + ".");
                                 return [
                                     3,
                                     4
@@ -23670,7 +23644,7 @@ var seed$1 = 1;
                                 ];
                             case 6:
                                 e = _state.sent();
-                                throw new Error("Failed to load. Check the template or if the URL is " + (isVideo ? "video" : "image") + " type, URL: " + url + ", Error: " + e.message);
+                                throw new Error("Failed to load. Check the template or if the URL is " + (isVideo ? "video" : "image") + " type, URL: " + url + ", Error: " + e.message + ".");
                             case 7:
                                 return [
                                     3,
@@ -23769,7 +23743,7 @@ var seed$1 = 1;
                                 ]);
                                 return [
                                     4,
-                                    deserializeMipmapTexture(texOpts, bins, jsonScene.bins, engine)
+                                    deserializeMipmapTexture(texOpts, bins, engine, jsonScene.bins)
                                 ];
                             case 2:
                                 return [
@@ -23778,7 +23752,7 @@ var seed$1 = 1;
                                 ];
                             case 3:
                                 e = _state.sent();
-                                throw new Error("load texture " + idx + " fails, error message: " + e);
+                                throw new Error("Load texture " + idx + " fails, error message: " + e + ".");
                             case 4:
                                 source = texOpts.source;
                                 if (!isObject(source)) return [
@@ -23813,7 +23787,7 @@ var seed$1 = 1;
                                         tex.sourceType === exports.TextureSourceType.compressed ? tex : _extends({}, tex, texOpts)
                                     ];
                                 }
-                                throw new Error("Invalid texture source: " + source);
+                                throw new Error("Invalid texture source: " + source + ".");
                         }
                     });
                 }));
@@ -23931,7 +23905,7 @@ function createTextureOptionsBySource(image, sourceFrom) {
             magFilter: glContext.NEAREST
         };
     }
-    throw new Error("Invalid texture options");
+    throw new Error("Invalid texture options.");
 }
 
 var tmpScale = new Vector3(1, 1, 1);
@@ -24223,7 +24197,7 @@ var listOrder = 0;
         var jsonScene = scene.jsonScene, renderLevel = scene.renderLevel, textureOptions = scene.textureOptions, pluginSystem = scene.pluginSystem, totalTime = scene.totalTime;
         var compositions = jsonScene.compositions, imgUsage = jsonScene.imgUsage, compositionId = jsonScene.compositionId;
         if (!textureOptions) {
-            throw new Error("scene.textures expected");
+            throw new Error("scene.textures expected.");
         }
         var cachedTextures = textureOptions;
         for(var _iterator = _create_for_of_iterator_helper_loose(compositions), _step; !(_step = _iterator()).done;){
@@ -24235,7 +24209,7 @@ var listOrder = 0;
             }
         }
         if (!this.composition) {
-            throw new Error("Invalid composition id: " + compositionId);
+            throw new Error("Invalid composition id: " + compositionId + ".");
         }
         this.jsonScene = jsonScene;
         this.renderLevel = renderLevel;
@@ -24297,7 +24271,7 @@ var listOrder = 0;
                 if (itemProps.type === ItemType.composition) {
                     var refId = sourceItemData.content.options.refId;
                     if (!this.refCompositions.get(refId)) {
-                        throw new Error("Invalid Ref Composition id: " + refId);
+                        throw new Error("Invalid ref composition id: " + refId + ".");
                     }
                     var ref = this.getContent(this.refCompositions.get(refId));
                     if (!this.refCompositionProps.has(refId)) {
@@ -24410,11 +24384,11 @@ var listOrder = 0;
         /**
    * 销毁状态位
    */ this.destroyed = false;
+        this.postLoaders = [];
         /**
    * 合成暂停/播放 标识
    */ this.paused = false;
         this.lastVideoUpdateTime = 0;
-        this.postLoaders = [];
         var _props_reusable = props.reusable, reusable = _props_reusable === void 0 ? false : _props_reusable, _props_speed = props.speed, speed = _props_speed === void 0 ? 1 : _props_speed, _props_baseRenderOrder = props.baseRenderOrder, baseRenderOrder = _props_baseRenderOrder === void 0 ? 0 : _props_baseRenderOrder, renderer = props.renderer, onPlayerPause = props.onPlayerPause, onMessageItem = props.onMessageItem, onEnd = props.onEnd, event = props.event, width = props.width, height = props.height;
         this.compositionSourceManager = new CompositionSourceManager(scene, renderer.engine);
         scene.jsonScene.imgUsage = undefined;
@@ -24813,7 +24787,7 @@ var listOrder = 0;
                     }
                     parent.children.push(item1);
                 } else {
-                    throw Error("元素引用了不存在的元素，请检查数据");
+                    throw new Error("The element references a non-existent element, please check the data.");
                 }
             }
         }
@@ -25062,7 +25036,7 @@ var listOrder = 0;
    * 合成整体在水平方向移动 x 像素，垂直方向移动 y 像素
    */ _proto.translateByPixel = function translateByPixel(x, y) {
         if (!this.renderer) {
-            console.warn("Can not translate position when container not assigned");
+            console.warn("Renderer not assigned. Operation aborted.");
             return;
         }
         this.rootItem.translateByPixel(x, y);
@@ -25076,7 +25050,7 @@ var listOrder = 0;
    * @param y - y 坐标
    */ _proto.setPositionByPixel = function setPositionByPixel(x, y) {
         if (!this.renderer) {
-            console.warn("Can not setPosition when container not assigned");
+            console.warn("Renderer not assigned. Operation aborted.");
             return;
         }
         this.rootItem.setPositionByPixel(x, y);
@@ -25255,7 +25229,7 @@ var listOrder = 0;
     };
     _proto.addPackageDatas = function addPackageDatas(scene) {
         var jsonScene = scene.jsonScene, _scene_textureOptions = scene.textureOptions, textureOptions = _scene_textureOptions === void 0 ? [] : _scene_textureOptions;
-        var _jsonScene_items = jsonScene.items, items = _jsonScene_items === void 0 ? [] : _jsonScene_items, _jsonScene_materials = jsonScene.materials, materials = _jsonScene_materials === void 0 ? [] : _jsonScene_materials, _jsonScene_shaders = jsonScene.shaders, shaders = _jsonScene_shaders === void 0 ? [] : _jsonScene_shaders, _jsonScene_geometries = jsonScene.geometries, geometries = _jsonScene_geometries === void 0 ? [] : _jsonScene_geometries, _jsonScene_components = jsonScene.components, components = _jsonScene_components === void 0 ? [] : _jsonScene_components, _jsonScene_animations = jsonScene.animations, animations = _jsonScene_animations === void 0 ? [] : _jsonScene_animations, _jsonScene_bins = jsonScene.bins, bins = _jsonScene_bins === void 0 ? [] : _jsonScene_bins;
+        var _jsonScene_items = jsonScene.items, items = _jsonScene_items === void 0 ? [] : _jsonScene_items, _jsonScene_materials = jsonScene.materials, materials = _jsonScene_materials === void 0 ? [] : _jsonScene_materials, _jsonScene_shaders = jsonScene.shaders, shaders = _jsonScene_shaders === void 0 ? [] : _jsonScene_shaders, _jsonScene_geometries = jsonScene.geometries, geometries = _jsonScene_geometries === void 0 ? [] : _jsonScene_geometries, _jsonScene_components = jsonScene.components, components = _jsonScene_components === void 0 ? [] : _jsonScene_components, _jsonScene_animations = jsonScene.animations, animations = _jsonScene_animations === void 0 ? [] : _jsonScene_animations, _jsonScene_bins = jsonScene.bins, bins = _jsonScene_bins === void 0 ? [] : _jsonScene_bins, _jsonScene_miscs = jsonScene.miscs, miscs = _jsonScene_miscs === void 0 ? [] : _jsonScene_miscs;
         for(var _iterator = _create_for_of_iterator_helper_loose(items), _step; !(_step = _iterator()).done;){
             var vfxItemData = _step.value;
             this.addEffectsObjectData(vfxItemData);
@@ -25280,6 +25254,10 @@ var listOrder = 0;
             var animationData = _step5.value;
             this.addEffectsObjectData(animationData);
         }
+        for(var _iterator6 = _create_for_of_iterator_helper_loose(miscs), _step6; !(_step6 = _iterator6()).done;){
+            var miscData = _step6.value;
+            this.addEffectsObjectData(miscData);
+        }
         for(var i = 0; i < bins.length; i++){
             var binaryData = bins[i];
             var binaryBuffer = scene.bins[i];
@@ -25291,8 +25269,8 @@ var listOrder = 0;
                 this.addEffectsObjectData(binaryData);
             }
         }
-        for(var _iterator6 = _create_for_of_iterator_helper_loose(textureOptions), _step6; !(_step6 = _iterator6()).done;){
-            var textureData = _step6.value;
+        for(var _iterator7 = _create_for_of_iterator_helper_loose(textureOptions), _step7; !(_step7 = _iterator7()).done;){
+            var textureData = _step7.value;
             this.addEffectsObjectData(textureData);
         }
     };
@@ -25427,7 +25405,7 @@ var listOrder = 0;
             info.push("Tex " + this.textures.length);
         }
         if (info.length > 0) {
-            logger.warn("Release GPU memory: " + info.join(", "));
+            logger.warn("Release GPU memory: " + info.join(", ") + ".");
         }
         this.renderPasses.forEach(function(pass) {
             return pass.dispose();
@@ -25563,7 +25541,7 @@ var listOrder = 0;
    * @param ticker - 定时器类
    */ _proto.add = function add(ticker) {
         if (typeof ticker !== "function") {
-            throw new Error("Ticker: The tick object must implement the tick method.");
+            throw new Error("The tick object must implement the tick method.");
         }
         this.tickers.push(ticker);
     };
@@ -25739,8 +25717,8 @@ var _obj3;
             1
         ]);
         _this.material = new THREE__namespace.RawShaderMaterial({
-            vertexShader: createShaderWithMarcos(shader.marcos, shader.vertex, exports.ShaderType.vertex, _this.engine.gpuCapability.level),
-            fragmentShader: createShaderWithMarcos(shader.marcos, shader.fragment, exports.ShaderType.fragment, _this.engine.gpuCapability.level),
+            vertexShader: createShaderWithMacros(shader.macros, shader.vertex, exports.ShaderType.vertex, _this.engine.gpuCapability.level),
+            fragmentShader: createShaderWithMacros(shader.macros, shader.fragment, exports.ShaderType.fragment, _this.engine.gpuCapability.level),
             alphaToCoverage: false,
             depthFunc: THREE__namespace.LessDepth,
             polygonOffsetFactor: THREE__namespace.ZeroFactor,
@@ -26660,6 +26638,14 @@ var seed = 1;
    */ _proto.dispose = function dispose() {
         this.texture.dispose();
     };
+    /**
+   * 通过图层设置创建贴图
+   * @param data - 图层设置
+   */ _proto.fromData = function fromData(data) {
+        Texture.prototype.fromData.call(this, data);
+        this.texture = this.createTextureByType(data);
+        this.texture.needsUpdate = true;
+    };
     _proto.createTextureByType = function createTextureByType(options) {
         var assembleOptions = this.assembleOptions(options);
         // TODO renderer.getMaxAnisotropy() 查询最大各向异性
@@ -26720,7 +26706,7 @@ var seed = 1;
             texture.flipY = !!flipY;
             return texture;
         }
-        throw new Error("使用未知的数据类型创建纹理");
+        throw new Error("Create a texture using an unknown data type.");
     };
     /**
    * 将 WebGL 纹理过滤器枚举类型映射到 THREE 纹理过滤器枚举类型
@@ -27014,7 +27000,7 @@ var ThreeRenderer = /*#__PURE__*/ function(Renderer) {
                         }
                         firstFrameTime = performance.now() - last + composition.statistic.loadTime;
                         composition.statistic.firstFrameTime = firstFrameTime;
-                        logger.info("first frame: [" + composition.name + "]" + firstFrameTime.toFixed(4) + "ms");
+                        logger.info("First frame: [" + composition.name + "]" + firstFrameTime.toFixed(4) + "ms.");
                         _this.compositions.push(composition);
                         return [
                             2,
@@ -27180,8 +27166,8 @@ setMaxSpriteMeshItemCount(8);
  */ Mesh.create = function(engine, props) {
     return new ThreeMesh(engine, props);
 };
-var version = "2.0.0-alpha.16";
-logger.info("THREEJS plugin version: " + version);
+var version = "2.0.0-alpha.18";
+logger.info("THREEJS plugin version: " + version + ".");
 
 exports.AbstractPlugin = AbstractPlugin;
 exports.ActivationPlayable = ActivationPlayable;
@@ -27273,7 +27259,9 @@ exports.SpriteLoader = SpriteLoader;
 exports.StaticValue = StaticValue;
 exports.TEMPLATE_USE_OFFSCREEN_CANVAS = TEMPLATE_USE_OFFSCREEN_CANVAS;
 exports.TEXTURE_UNIFORM_MAP = TEXTURE_UNIFORM_MAP;
+exports.TextLayout = TextLayout;
 exports.TextLoader = TextLoader;
+exports.TextStyle = TextStyle;
 exports.Texture = Texture;
 exports.TextureFactory = TextureFactory;
 exports.ThreeComposition = ThreeComposition;
@@ -27282,6 +27270,7 @@ exports.ThreeEngine = ThreeEngine;
 exports.ThreeMaterial = ThreeMaterial;
 exports.ThreeTexture = ThreeTexture;
 exports.Ticker = Ticker;
+exports.TimelineClip = TimelineClip;
 exports.TimelinePlayable = TimelinePlayable;
 exports.TrackSortWrapper = TrackSortWrapper;
 exports.Transform = Transform;
@@ -27305,12 +27294,11 @@ exports.compatibleVert = compatible_vert;
 exports.createCopyShader = createCopyShader;
 exports.createGLContext = createGLContext;
 exports.createKeyFrameMeta = createKeyFrameMeta;
-exports.createShaderWithMarcos = createShaderWithMarcos;
+exports.createShaderWithMacros = createShaderWithMacros;
 exports.createShape = createShape;
 exports.createVFXItem = createVFXItem;
 exports.createValueGetter = createValueGetter;
 exports.decimalEqual = decimalEqual;
-exports.deepClone = deepClone;
 exports.defaultGlobalVolume = defaultGlobalVolume;
 exports.defaultPlugins = defaultPlugins;
 exports.deserializeMipmapTexture = deserializeMipmapTexture;
@@ -27397,7 +27385,7 @@ exports.particleUniformTypeMap = particleUniformTypeMap;
 exports.particleVert = particleVert;
 exports.pluginLoaderMap = pluginLoaderMap;
 exports.pointOnLine = pointOnLine;
-exports.random = random;
+exports.randomInRange = randomInRange;
 exports.registerPlugin = registerPlugin;
 exports.removeItem = removeItem;
 exports.rotateVec2 = rotateVec2;
@@ -27410,7 +27398,6 @@ exports.setMaskMode = setMaskMode;
 exports.setMaxSpriteMeshItemCount = setMaxSpriteMeshItemCount;
 exports.setRayFromCamera = setRayFromCamera;
 exports.setSideMode = setSideMode;
-exports.setSpriteMeshMaxFragmentTextures = setSpriteMeshMaxFragmentTextures;
 exports.setSpriteMeshMaxItemCountByGPU = setSpriteMeshMaxItemCountByGPU;
 exports.setUniformValue = setUniformValue;
 exports.sortByOrder = sortByOrder;