@galacean/effects-core 2.0.0-alpha.17 → 2.0.0-alpha.18

package/dist/index.js

@@ -3,7 +3,7 @@
  * Description: Galacean Effects runtime core for the web
  * Author: Ant Group CO., Ltd.
  * Contributors: 燃然,飂兮,十弦,云垣,茂安,意绮
- * Version: v2.0.0-alpha.17
+ * Version: v2.0.0-alpha.18
  */
 
 'use strict';
@@ -610,7 +610,7 @@ function isCanvas(canvas) {
     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, '');
@@ -4243,7 +4243,7 @@ const effectsClassStore = {};
 function effectsClass(className) {
     return (target, context)=>{
         if (effectsClassStore[className]) {
-            console.warn(`Class ${className} 重复注册`);
+            console.warn(`Class ${className} is already registered.`);
         }
         // TODO: three修改json dataType, 这边重复注册直接 return
         effectsClassStore[className] = target;
@@ -7024,8 +7024,8 @@ const SEMANTIC_MAIN_PRE_COLOR_ATTACHMENT_0 = 'PRE_MAIN_COLOR_0';
 const SEMANTIC_MAIN_PRE_COLOR_ATTACHMENT_SIZE_0 = 'PRE_MAIN_COLOR_SIZE_0';
 const PLAYER_OPTIONS_ENV_EDITOR = 'editor';
 const 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'
 };
 
 /**
@@ -7206,17 +7206,17 @@ const downgradeKeywords = {
 };
 /**
  * 生成 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) {
     const ret = [];
     let header = '';
     // shader 标志宏，没有其他含义，方便不支持完全的自定义 shader 的三方引擎接入使用
     ret.push('#define GE_RUNTIME');
-    if (marcos) {
-        marcos.forEach(([key, value])=>{
+    if (macros) {
+        macros.forEach(([key, value])=>{
             if (value === true) {
                 ret.push(`#define ${key}`);
             } else if (Number.isFinite(value)) {
@@ -7327,7 +7327,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) {
@@ -7373,7 +7373,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.`);
     }
 }
 
@@ -7545,7 +7545,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 new Promise((resolve, reject)=>{
             const img = new Image();
@@ -7658,13 +7658,13 @@ 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) {
-        if (texOpts.target === 34067) {
-            const { mipmaps, target } = texOpts;
+    _deserializeMipmapTexture = _async_to_generator(function*(textureOptions, bins, engine, files = []) {
+        if (textureOptions.target === 34067) {
+            const { mipmaps, target } = textureOptions;
             // const jobs = mipmaps.map(mipmap => Promise.all(mipmap.map(pointer => loadMipmapImage(pointer, bins))));
             const loadedMipmaps = [];
             for (const level of mipmaps){
@@ -7680,7 +7680,7 @@ function _deserializeMipmapTexture() {
             // const bin = files[mipmaps[0][0][1][0]].url;
             return _extends({
                 keepImageSource: false
-            }, texOpts, {
+            }, textureOptions, {
                 mipmaps: loadedMipmaps,
                 sourceFrom: {
                     target,
@@ -7690,13 +7690,13 @@ function _deserializeMipmapTexture() {
             });
         } else {
             // TODO: 补充测试用例
-            const { mipmaps, target } = texOpts;
+            const { mipmaps, target } = textureOptions;
             const jobs = mipmaps.map((pointer)=>loadMipmapImage(pointer, bins));
             const loadedMipmaps = yield Promise.all(jobs);
             const bin = files[mipmaps[0][1][0]].url;
             return _extends({
                 keepImageSource: false
-            }, texOpts, {
+            }, textureOptions, {
                 mipmaps: loadedMipmaps,
                 sourceType: exports.TextureSourceType.mipmaps,
                 sourceFrom: {
@@ -7721,7 +7721,7 @@ function _loadMipmapImage() {
         const [index, start, length] = pointer[1];
         const bin = bins[index];
         if (!bin) {
-            throw new Error(`invalid bin pointer: ${JSON.stringify(pointer)}`);
+            throw new Error(`Invalid bin pointer: ${JSON.stringify(pointer)}.`);
         }
         return loadImage(new Blob([
             new Uint8Array(bin, start, length)
@@ -7920,7 +7920,7 @@ class KTXTexture {
         // 0xAB, 0x4B, 0x54, 0x58, 0x20, 0x31, 0x31, 0xBB, 0x0D, 0x0A, 0x1A, 0x0A
         const 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
         const dataSize = Uint32Array.BYTES_PER_ELEMENT;
@@ -7942,15 +7942,15 @@ class KTXTexture {
         // 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
@@ -7990,7 +7990,7 @@ class TextureFactory {
                 texture.updateSource(sourceOpts);
                 _this.reloadPending[id] = false;
             } else {
-                throw new Error('No source from');
+                throw new Error('No source from.');
             }
         })();
     }
@@ -8117,7 +8117,7 @@ class TextureFactory {
                     });
                 }
             }
-            throw new Error(`Invalid resource type: ${type}`);
+            throw new Error(`Invalid resource type: ${type}.`);
         })();
     }
     loadMipmapImages(pointers, bin) {
@@ -8933,19 +8933,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;
     }
     const str = ('bez_' + x1 + '_' + y1 + '_' + x2 + '_' + y2).replace(/\./g, 'p');
@@ -9129,31 +9129,31 @@ class ValueGetter {
         return halfFloat ? ret.data : ret;
     }
     onCreate(props) {
-        throw Error(NOT_IMPLEMENT);
+        throw new Error(NOT_IMPLEMENT);
     }
     getIntegrateValue(t0, t1, timeScale = 1) {
-        throw Error(NOT_IMPLEMENT);
+        throw new Error(NOT_IMPLEMENT);
     }
     getIntegrateByTime(t0, time) {
-        throw Error(NOT_IMPLEMENT);
+        throw new Error(NOT_IMPLEMENT);
     }
     getValue(time) {
-        throw Error(NOT_IMPLEMENT);
+        throw new Error(NOT_IMPLEMENT);
     }
     getMaxTime() {
-        throw Error(NOT_IMPLEMENT);
+        throw new Error(NOT_IMPLEMENT);
     }
     toUniform(meta) {
-        throw Error(NOT_IMPLEMENT);
+        throw new Error(NOT_IMPLEMENT);
     }
     map(func) {
-        throw Error(NOT_IMPLEMENT);
+        throw new Error(NOT_IMPLEMENT);
     }
     scaleXCoord(scale) {
         return this;
     }
     toData() {
-        throw Error(NOT_IMPLEMENT);
+        throw new Error(NOT_IMPLEMENT);
     }
     constructor(arg){
         this.onCreate(arg);
@@ -9785,7 +9785,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) {
@@ -9959,7 +9959,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
@@ -10023,7 +10023,7 @@ class PassTextureCache {
         const refCount = this.textureRef[id];
         if (refCount <= 1) {
             if (refCount < 0) {
-                console.error('ref count < 0');
+                console.error('Ref count < 0.');
             }
             const tex = this.textureCache[id];
             if (tex) {
@@ -10637,21 +10637,21 @@ let seed$6 = 1;
     }
 }
 
-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}}";
 
@@ -11798,20 +11798,20 @@ class GPUCapability {
     framebufferTexture2D(gl, target, index, textarget, texture) {
         const 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.');
         }
         const 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}.`);
         }
     }
     drawBuffers(gl, bufferStates) {
         const 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;
             }
@@ -12071,7 +12071,7 @@ class InteractMesh {
     }
     createMaterial(rendererOptions) {
         var _this_engine_renderer;
-        const marcos = [
+        const macros = [
             [
                 'ENV_EDITOR',
                 ((_this_engine_renderer = this.engine.renderer) == null ? void 0 : _this_engine_renderer.env) === PLAYER_OPTIONS_ENV_EDITOR
@@ -12084,7 +12084,7 @@ class InteractMesh {
                 fragment,
                 glslVersion: exports.GLSLVersion.GLSL1,
                 cacheId: `${rendererOptions.cachePrefix}_effects_interact`,
-                marcos
+                macros
             },
             uniformSemantics: {
                 effects_MatrixVP: 'VIEWPROJECTION',
@@ -12349,16 +12349,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) {
     const { renderer } = item;
@@ -12376,27 +12372,11 @@ function getImageItemRenderInfo(item) {
     };
 }
 function spriteMeshShaderFromFilter(level, options) {
-    const { count = 2, env = '', ignoreBlend, wireframe } = options != null ? options : {};
-    const marcos = [
-        [
-            'MAX_ITEM_COUNT',
-            count
-        ],
-        [
-            'PRE_MULTIPLY_ALPHA',
-            false
-        ],
+    const { env = '', wireframe } = options != null ? options : {};
+    const macros = [
         [
             'ENV_EDITOR',
             env === PLAYER_OPTIONS_ENV_EDITOR
-        ],
-        [
-            'USE_BLEND',
-            !ignoreBlend
-        ],
-        [
-            'MAX_FRAG_TEX',
-            exports.maxSpriteTextureCount >= 16 ? 16 : 8
         ]
     ];
     const fragment = wireframe ? itemFrameFrag : itemFrag;
@@ -12405,7 +12385,7 @@ function spriteMeshShaderFromFilter(level, options) {
         fragment,
         vertex,
         glslVersion: level === 1 ? exports.GLSLVersion.GLSL1 : exports.GLSLVersion.GLSL3,
-        marcos,
+        macros,
         shared: true
     };
 }
@@ -12415,7 +12395,6 @@ function spriteMeshShaderIdFromRenderInfo(renderInfo, count) {
 function spriteMeshShaderFromRenderInfo(renderInfo, count, level, env) {
     const { wireframe } = renderInfo;
     const shader = spriteMeshShaderFromFilter(level, {
-        count,
         wireframe,
         env
     });
@@ -12429,9 +12408,6 @@ function spriteMeshShaderFromRenderInfo(renderInfo, count, level, env) {
 function setMaxSpriteMeshItemCount(count) {
     exports.maxSpriteMeshItemCount = count;
 }
-function setSpriteMeshMaxFragmentTextures(count) {
-    exports.maxSpriteTextureCount = count;
-}
 
 const defRenderInfo = {
     blending: 0,
@@ -13995,7 +13971,7 @@ function createShape(shapeOptions) {
     const { type } = shapeOptions;
     const Ctrl = map[type];
     if (!Ctrl) {
-        throw Error('invalid shape:' + type);
+        throw new Error(`Invalid shape: ${type}.`);
     }
     const ctrl = new Ctrl(options);
     if (type !== ShapeType.NONE) {
@@ -14964,7 +14940,7 @@ class TrailMesh {
         const uniformValues = {};
         // const lookUpTexture = getConfig(RENDER_PREFER_LOOKUP_TEXTURE) ? 1 : 0;
         const lookUpTexture = 0;
-        const marcos = [
+        const macros = [
             [
                 'ENABLE_VERTEX_TEXTURE',
                 enableVertexTexture
@@ -14981,7 +14957,7 @@ class TrailMesh {
         const useAttributeTrailStart = maxTrailCount > 64;
         let shaderCacheId = 0;
         if (colorOverLifetime) {
-            marcos.push([
+            macros.push([
                 'COLOR_OVER_LIFETIME',
                 true
             ]);
@@ -14989,7 +14965,7 @@ class TrailMesh {
             uniformValues.uColorOverLifetime = Texture.createWithData(engine, imageDataFromGradient(colorOverLifetime));
         }
         if (colorOverTrail) {
-            marcos.push([
+            macros.push([
                 'COLOR_OVER_TRAIL',
                 true
             ]);
@@ -14997,7 +14973,7 @@ class TrailMesh {
             uniformValues.uColorOverTrail = Texture.createWithData(engine, imageDataFromGradient(colorOverTrail));
         }
         if (useAttributeTrailStart) {
-            marcos.push([
+            macros.push([
                 'ATTR_TRAIL_START',
                 1
             ]);
@@ -15007,7 +14983,7 @@ class TrailMesh {
         }
         uniformValues.uOpacityOverLifetimeValue = opacityOverLifetime.toUniform(keyFrameMeta);
         const uWidthOverTrail = widthOverTrail.toUniform(keyFrameMeta);
-        marcos.push([
+        macros.push([
             'VERT_CURVE_VALUE_COUNT',
             keyFrameMeta.index
         ], [
@@ -15026,7 +15002,7 @@ class TrailMesh {
             shader: {
                 vertex,
                 fragment,
-                marcos,
+                macros,
                 glslVersion: level === 1 ? exports.GLSLVersion.GLSL1 : exports.GLSLVersion.GLSL3,
                 shared: true,
                 name: `trail#${name}`,
@@ -15181,11 +15157,11 @@ function calculateDirection(prePoint, point, nextPoint) {
     }
     return dir.normalize().toArray();
 }
-function getTrailMeshShader(trails, particleMaxCount, name, env = '', gpuCapability) {
+function getTrailMeshShader(trails, particleMaxCount, name, gpuCapability, env = '') {
     let shaderCacheId = 0;
     const lookUpTexture = getConfig(RENDER_PREFER_LOOKUP_TEXTURE) ? 1 : 0;
     const enableVertexTexture = gpuCapability.detail.maxVertexTextures > 0;
-    const marcos = [
+    const macros = [
         [
             'ENABLE_VERTEX_TEXTURE',
             enableVertexTexture
@@ -15201,14 +15177,14 @@ function getTrailMeshShader(trails, particleMaxCount, name, env = '', gpuCapabil
     ];
     const 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
         ]);
@@ -15216,7 +15192,7 @@ function getTrailMeshShader(trails, particleMaxCount, name, env = '', gpuCapabil
     }
     const useAttributeTrailStart = particleMaxCount > 64;
     if (useAttributeTrailStart) {
-        marcos.push([
+        macros.push([
             'ATTR_TRAIL_START',
             1
         ]);
@@ -15224,7 +15200,7 @@ function getTrailMeshShader(trails, particleMaxCount, name, env = '', gpuCapabil
     }
     getKeyFrameMetaByRawValue(keyFrameMeta, trails.opacityOverLifetime);
     getKeyFrameMetaByRawValue(keyFrameMeta, trails.widthOverTrail);
-    marcos.push([
+    macros.push([
         'VERT_CURVE_VALUE_COUNT',
         keyFrameMeta.index
     ], [
@@ -15234,7 +15210,7 @@ function getTrailMeshShader(trails, particleMaxCount, name, env = '', gpuCapabil
     return {
         vertex: trailVert,
         fragment: particleFrag,
-        marcos,
+        macros,
         shared: true,
         name: 'trail#' + name,
         cacheId: `-t:+${shaderCacheId}+${keyFrameMeta.index}+${keyFrameMeta.max}`
@@ -16545,15 +16521,12 @@ class ParticleMesh {
         const { speedOverLifetime, colorOverLifetime, linearVelOverLifetime, orbitalVelOverLifetime, sizeOverLifetime, rotationOverLifetime, sprite, gravityModifier, maxCount, textureFlip, useSprite, name, gravity, forceTarget, side, occlusion, anchor, blending, maskMode, mask, transparentOcclusion, meshSlots, renderMode = 0, diffuse = Texture.createWithData(engine) } = props;
         const { detail } = engine.gpuCapability;
         const { halfFloatTexture, maxVertexUniforms } = detail;
-        const marcos = [
+        const macros = [
+            // spec.RenderMode
             [
                 'RENDER_MODE',
                 +renderMode
             ],
-            [
-                'PRE_MULTIPLY_ALPHA',
-                false
-            ],
             [
                 'ENV_EDITOR',
                 env === PLAYER_OPTIONS_ENV_EDITOR
@@ -16569,13 +16542,13 @@ class ParticleMesh {
         let useOrbitalVel;
         this.useSprite = useSprite;
         if (enableVertexTexture) {
-            marcos.push([
+            macros.push([
                 'ENABLE_VERTEX_TEXTURE',
                 true
             ]);
         }
         if (speedOverLifetime) {
-            marcos.push([
+            macros.push([
                 'SPEED_OVER_LIFETIME',
                 true
             ]);
@@ -16583,7 +16556,7 @@ class ParticleMesh {
             uniformValues.uSpeedLifetimeValue = speedOverLifetime.toUniform(vertexKeyFrameMeta);
         }
         if (sprite == null ? void 0 : sprite.animate) {
-            marcos.push([
+            macros.push([
                 'USE_SPRITE',
                 true
             ]);
@@ -16597,7 +16570,7 @@ class ParticleMesh {
             this.useSprite = true;
         }
         if (colorOverLifetime == null ? void 0 : colorOverLifetime.color) {
-            marcos.push([
+            macros.push([
                 'COLOR_OVER_LIFETIME',
                 true
             ]);
@@ -16622,7 +16595,7 @@ class ParticleMesh {
                 shaderCacheId |= 1 << 7 + i;
                 linearVelOverLifetime.enabled = true;
             }
-            marcos.push([
+            macros.push([
                 `LINEAR_VEL_${pro.toUpperCase()}`,
                 defL
             ]);
@@ -16633,13 +16606,13 @@ class ParticleMesh {
                 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
             ]);
@@ -16647,7 +16620,7 @@ class ParticleMesh {
         }
         if (useOrbitalVel) {
             if (orbitalVelOverLifetime == null ? void 0 : orbitalVelOverLifetime.asRotation) {
-                marcos.push([
+                macros.push([
                     'AS_ORBITAL_MOVEMENT',
                     true
                 ]);
@@ -16662,7 +16635,7 @@ class ParticleMesh {
         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
             ]);
@@ -16672,7 +16645,7 @@ class ParticleMesh {
         if (rotationOverLifetime == null ? void 0 : rotationOverLifetime.z) {
             uniformValues.uRZByLifeTimeValue = rotationOverLifetime.z.toUniform(vertexKeyFrameMeta);
             shaderCacheId |= 1 << 15;
-            marcos.push([
+            macros.push([
                 'ROT_Z_LIFETIME',
                 1
             ]);
@@ -16680,7 +16653,7 @@ class ParticleMesh {
         if (rotationOverLifetime == null ? void 0 : rotationOverLifetime.x) {
             uniformValues.uRXByLifeTimeValue = rotationOverLifetime.x.toUniform(vertexKeyFrameMeta);
             shaderCacheId |= 1 << 16;
-            marcos.push([
+            macros.push([
                 'ROT_X_LIFETIME',
                 1
             ]);
@@ -16688,13 +16661,13 @@ class ParticleMesh {
         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
             ]);
@@ -16702,7 +16675,7 @@ class ParticleMesh {
         }
         uniformValues.uGravityModifierValue = gravityModifier.toUniform(vertexKeyFrameMeta);
         if (forceTarget) {
-            marcos.push([
+            macros.push([
                 'FINAL_TARGET',
                 true
             ]);
@@ -16748,7 +16721,7 @@ class ParticleMesh {
             fragmentKeyFrameMeta.index,
             fragmentKeyFrameMeta.max
         ].join('+');
-        marcos.push([
+        macros.push([
             'VERT_CURVE_VALUE_COUNT',
             vertexKeyFrameMeta.index
         ], [
@@ -16770,7 +16743,7 @@ class ParticleMesh {
             glslVersion: level === 1 ? exports.GLSLVersion.GLSL1 : exports.GLSLVersion.GLSL3,
             shared: true,
             cacheId: shaderCache,
-            marcos,
+            macros,
             name: `particle#${name}`
         };
         const mtlOptions = {
@@ -16847,7 +16820,7 @@ class ParticleMesh {
                     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));
@@ -16978,19 +16951,15 @@ function generateGeometryProps(maxVertex, useSprite, name) {
         maxVertex
     };
 }
-function getParticleMeshShader(item, env = '', gpuCapability) {
+function getParticleMeshShader(item, gpuCapability, env = '') {
     var _props_renderer;
     const props = item.content;
     const renderMode = +(((_props_renderer = props.renderer) == null ? void 0 : _props_renderer.renderMode) || 0);
-    const marcos = [
+    const macros = [
         [
             'RENDER_MODE',
             renderMode
         ],
-        [
-            'PRE_MULTIPLY_ALPHA',
-            false
-        ],
         [
             'ENV_EDITOR',
             env === PLAYER_OPTIONS_ENV_EDITOR
@@ -17005,13 +16974,13 @@ function getParticleMeshShader(item, env = '', gpuCapability) {
     let vertex_lookup_texture = 0;
     let shaderCacheId = 0;
     if (enableVertexTexture) {
-        marcos.push([
+        macros.push([
             'ENABLE_VERTEX_TEXTURE',
             true
         ]);
     }
     if (speedOverLifetime) {
-        marcos.push([
+        macros.push([
             'SPEED_OVER_LIFETIME',
             true
         ]);
@@ -17020,7 +16989,7 @@ function getParticleMeshShader(item, env = '', gpuCapability) {
     }
     const sprite = props.textureSheetAnimation;
     if (sprite && sprite.animate) {
-        marcos.push([
+        macros.push([
             'USE_SPRITE',
             true
         ]);
@@ -17028,7 +16997,7 @@ function getParticleMeshShader(item, env = '', gpuCapability) {
     }
     const colorOverLifetime = props.colorOverLifetime;
     if (colorOverLifetime && colorOverLifetime.color) {
-        marcos.push([
+        macros.push([
             'COLOR_OVER_LIFETIME',
             true
         ]);
@@ -17053,7 +17022,7 @@ function getParticleMeshShader(item, env = '', gpuCapability) {
             defL = 1;
             shaderCacheId |= 1 << 7 + i;
         }
-        marcos.push([
+        macros.push([
             `LINEAR_VEL_${pro.toUpperCase()}`,
             defL
         ]);
@@ -17064,13 +17033,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
         ]);
@@ -17078,7 +17047,7 @@ function getParticleMeshShader(item, env = '', gpuCapability) {
     }
     if (useOrbitalVel) {
         if (positionOverLifetime == null ? void 0 : positionOverLifetime.asRotation) {
-            marcos.push([
+            macros.push([
                 'AS_ORBITAL_MOVEMENT',
                 true
             ]);
@@ -17090,7 +17059,7 @@ function getParticleMeshShader(item, env = '', gpuCapability) {
         const separateAxes = sizeOverLifetime.separateAxes;
         if (separateAxes) {
             getKeyFrameMetaByRawValue(vertexKeyFrameMeta, sizeOverLifetime.x);
-            marcos.push([
+            macros.push([
                 'SIZE_Y_BY_LIFE',
                 1
             ]);
@@ -17105,7 +17074,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
             ]);
@@ -17114,7 +17083,7 @@ function getParticleMeshShader(item, env = '', gpuCapability) {
             if (rot.x) {
                 getKeyFrameMetaByRawValue(vertexKeyFrameMeta, rot.x);
                 shaderCacheId |= 1 << 16;
-                marcos.push([
+                macros.push([
                     'ROT_X_LIFETIME',
                     1
                 ]);
@@ -17122,14 +17091,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
             ]);
@@ -17139,7 +17108,7 @@ function getParticleMeshShader(item, env = '', gpuCapability) {
     getKeyFrameMetaByRawValue(vertexKeyFrameMeta, positionOverLifetime == null ? void 0 : positionOverLifetime.gravityOverLifetime);
     const forceOpt = positionOverLifetime == null ? void 0 : positionOverLifetime.forceTarget;
     if (forceOpt) {
-        marcos.push([
+        macros.push([
             'FINAL_TARGET',
             true
         ]);
@@ -17180,10 +17149,10 @@ function getParticleMeshShader(item, env = '', gpuCapability) {
         vertex: `#define LOOKUP_TEXTURE_CURVE ${vertex_lookup_texture}\n${particleVert}`,
         shared: true,
         cacheId: shaderCache,
-        marcos,
+        macros,
         name: `particle#${item.name}`
     };
-    marcos.push([
+    macros.push([
         'VERT_CURVE_VALUE_COUNT',
         vertexKeyFrameMeta.index
     ], [
@@ -17208,11 +17177,11 @@ function modifyMaxKeyframeShader(shader, maxVertex, maxFrag) {
     shaderIds[3] = maxVertex;
     shaderIds[5] = maxFrag;
     shader.cacheId = shaderIds.join('+');
-    if (!shader.marcos) {
+    if (!shader.macros) {
         return;
     }
-    for(let i = 0; i < shader.marcos.length; i++){
-        const marco = shader.marcos[i];
+    for(let i = 0; i < shader.macros.length; i++){
+        const marco = shader.macros[i];
         if (marco[0] === 'VERT_CURVE_VALUE_COUNT') {
             marco[1] = maxVertex;
         } else if (marco[0] === 'FRAG_CURVE_VALUE_COUNT') {
@@ -17241,17 +17210,17 @@ class ParticleLoader extends AbstractPlugin {
             });
         });
         items.forEach((item)=>{
-            const { shader, fragment, vertex } = getParticleMeshShader(item, env, gpuCapability);
+            const { shader, fragment, vertex } = getParticleMeshShader(item, gpuCapability, env);
             shaders.push(shader);
             maxFragmentCount = Math.max(maxFragmentCount, fragment);
             maxVertexCount = Math.max(maxVertexCount, vertex);
             // TODO 此处add是否有意义？shader变量似乎没有加到this.shaders数组。
             if (item.content.trails) {
-                const shader = getTrailMeshShader(item.content.trails, item.content.options.maxCount, item.name, env, gpuCapability);
-                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);
+                const shader = getTrailMeshShader(item.content.trails, item.content.options.maxCount, item.name, gpuCapability, env);
+                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);
                 shader.glslVersion = level === 2 ? exports.GLSLVersion.GLSL3 : exports.GLSLVersion.GLSL1;
                 shaderLibrary.addShader(shader);
             }
@@ -17263,10 +17232,10 @@ class ParticleLoader extends 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) {
@@ -18012,7 +17981,7 @@ function compareTracks(a, b) {
                     const refId = itemData.content.options.refId;
                     const 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;
@@ -18156,7 +18125,7 @@ function compareTracks(a, b) {
 class SubCompositionTrack extends TrackAsset {
     resolveBinding(parentBinding) {
         if (!(parentBinding instanceof 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);
     }
@@ -19171,7 +19140,7 @@ class VFXItem extends 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']}.`);
         }
         for (const component of this.components){
             component.onAttached();
@@ -19337,7 +19306,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);
@@ -19378,13 +19347,13 @@ class PluginSystem {
     createPluginItem(name, props, composition) {
         const 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.`);
         }
         const engine = composition.getEngine();
         const item = new CTRL(engine, props, composition);
         item.composition = composition;
         if (!(item instanceof VFXItem)) {
-            throw new Error(`plugin ${name} invalid constructor type`);
+            throw new Error(`The plugin '${name}' invalid constructor type.`);
         }
         return item;
     }
@@ -19437,7 +19406,7 @@ class PluginSystem {
         this.plugins = Object.keys(loaders).map((name)=>{
             const CTRL = pluginLoaderMap[name];
             if (!CTRL) {
-                throw new Error(`plugin '${name}' not found.` + getPluginUsageInfo(name));
+                throw new Error(`The plugin '${name}' not found.` + getPluginUsageInfo(name));
             }
             const loader = new CTRL();
             loader.name = name;
@@ -19633,7 +19602,7 @@ class SerializationHelper {
     }
     static 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 结构对象。
@@ -19664,7 +19633,7 @@ class SerializationHelper {
     static deserializePropertyAsync(property, engine, level, type) {
         return _async_to_generator(function*() {
             if (level > 14) {
-                console.error('序列化数据的内嵌对象层数大于上限');
+                console.error('The nested object layers of the serialized data exceed the maximum limit.');
                 return;
             }
             if (isArray(property)) {
@@ -19695,7 +19664,7 @@ class SerializationHelper {
     }
     static 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) {
@@ -19726,7 +19695,7 @@ class SerializationHelper {
     }
     static 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) {
@@ -19768,7 +19737,7 @@ class SerializationHelper {
         let effectsObject;
         const effectsObjectData = this.findData(guid);
         if (!effectsObjectData) {
-            console.error('未找到 uuid: ' + guid + '的对象数据');
+            console.error(`Object data with uuid: ${guid} not found.`);
             return undefined;
         }
         switch(effectsObjectData.dataType){
@@ -19790,7 +19759,7 @@ class SerializationHelper {
                 }
         }
         if (!effectsObject) {
-            console.error('未找到 DataType: ' + effectsObjectData.dataType + '的构造函数');
+            console.error(`Constructor for DataType: ${effectsObjectData.dataType} not found.`);
             return undefined;
         }
         effectsObject.setInstanceId(effectsObjectData.id);
@@ -19809,12 +19778,12 @@ class SerializationHelper {
             const effectsObjectData = _this.findData(guid);
             if (!effectsObjectData) {
                 if (!_this.engine.database) {
-                    console.error('未找到 uuid: ' + guid + '的对象数据');
+                    console.error(`Object data with uuid: ${guid} not found.`);
                     return undefined;
                 }
                 effectsObject = yield _this.engine.database.loadGUID(guid);
                 if (!effectsObject) {
-                    console.error('未找到 uuid: ' + guid + '的磁盘数据');
+                    console.error(`Disk data with uuid: ${guid} not found.`);
                     return undefined;
                 }
                 _this.engine.addInstance(effectsObject);
@@ -19839,7 +19808,7 @@ class SerializationHelper {
                     }
             }
             if (!effectsObject) {
-                console.error('未找到 DataType: ' + effectsObjectData.dataType + '的构造函数');
+                console.error(`Constructor for DataType: ${effectsObjectData.dataType} not found.`);
                 return undefined;
             }
             effectsObject.setInstanceId(effectsObjectData.id);
@@ -21236,7 +21205,7 @@ const standardVersion = /^(\d+)\.(\d+)$/;
 let 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);
@@ -21257,7 +21226,7 @@ function getStandardJSON(json) {
         }
         return json;
     }
-    throw Error('invalid json version ' + json.version);
+    throw new Error(`Invalid JSON version: ${json.version}.`);
 }
 let currentVersion = '1.0';
 function getStandardJSONFromV0(json) {
@@ -21343,7 +21312,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 = {}) {
     var _composition_meta;
@@ -21610,7 +21579,7 @@ function _combineImageTemplate() {
             image = url;
         }
         if (!image) {
-            throw new Error('image not provided.');
+            throw new Error('Image not provided.');
         }
         if (!template) {
             return image;
@@ -21684,7 +21653,7 @@ let seed = 1;
                     cancelLoading = true;
                     _this.removeTimer(loadTimer);
                     const 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);
             });
@@ -21696,7 +21665,7 @@ let seed = 1;
                         timeInfos.push(`[${label}: ${(performance.now() - st).toFixed(2)}]`);
                         return result;
                     } catch (e) {
-                        throw new Error(`Load error in ${label}, ${e}`);
+                        throw new Error(`Load error in ${label}, ${e}.`);
                     }
                 }
                 throw new Error('Load canceled.');
@@ -21767,7 +21736,7 @@ let seed = 1;
                     yield hookTimeInfo('processPlugins', ()=>pluginSystem.loadResources(scene, _this.options));
                 }
                 const 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;
@@ -21839,7 +21808,7 @@ let seed = 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 Promise.all(jobs);
         })();
@@ -21856,7 +21825,7 @@ let seed = 1;
                 if (font.fontURL && !AssetManager.fonts.has(font.fontFamily)) {
                     if (!isValidFontFamily(font.fontFamily)) {
                         // 在所有设备上提醒开发者
-                        console.warn(`Risky font family: ${font.fontFamily}`);
+                        console.warn(`Risky font family: ${font.fontFamily}.`);
                     }
                     try {
                         const url = new URL(font.fontURL, _this.baseUrl).href;
@@ -21868,7 +21837,7 @@ let seed = 1;
                         AssetManager.fonts.add(font.fontFamily);
                     // eslint-disable-next-line @typescript-eslint/no-unused-vars
                     } catch (e) {
-                        logger.warn(`Invalid font family or font source: ${JSON.stringify(font.fontURL)}`);
+                        logger.warn(`Invalid font family or font source: ${JSON.stringify(font.fontURL)}.`);
                     }
                 }
             }));
@@ -21910,7 +21879,7 @@ let seed = 1;
                             }
                         // eslint-disable-next-line @typescript-eslint/no-unused-vars
                         } catch (e) {
-                            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}.`);
                         }
                     }
                 } else if ('compressed' in img && useCompressedTexture && compressedTexture) {
@@ -21959,9 +21928,9 @@ let seed = 1;
                 }
                 if ('mipmaps' in texOpts) {
                     try {
-                        return yield deserializeMipmapTexture(texOpts, bins, jsonScene.bins, engine);
+                        return yield deserializeMipmapTexture(texOpts, bins, engine, jsonScene.bins);
                     } catch (e) {
-                        throw new Error(`load texture ${idx} fails, error message: ${e}`);
+                        throw new Error(`Load texture ${idx} fails, error message: ${e}.`);
                     }
                 }
                 const { source } = texOpts;
@@ -21978,7 +21947,7 @@ let seed = 1;
                     tex.dataType = DataType.Texture;
                     return tex.sourceType === exports.TextureSourceType.compressed ? tex : _extends({}, tex, texOpts);
                 }
-                throw new Error(`Invalid texture source: ${source}`);
+                throw new Error(`Invalid texture source: ${source}.`);
             }));
             return Promise.all(jobs);
         })();
@@ -22089,7 +22058,7 @@ function createTextureOptionsBySource(image, sourceFrom) {
             magFilter: glContext.NEAREST
         };
     }
-    throw new Error('Invalid texture options');
+    throw new Error('Invalid texture options.');
 }
 
 const tmpScale = new Vector3(1, 1, 1);
@@ -22396,7 +22365,7 @@ let listOrder = 0;
                 if (itemProps.type === ItemType.composition) {
                     const 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}.`);
                     }
                     const ref = this.getContent(this.refCompositions.get(refId));
                     if (!this.refCompositionProps.has(refId)) {
@@ -22490,7 +22459,7 @@ let listOrder = 0;
         const { jsonScene, renderLevel, textureOptions, pluginSystem, totalTime } = scene;
         const { compositions, imgUsage, compositionId } = jsonScene;
         if (!textureOptions) {
-            throw new Error('scene.textures expected');
+            throw new Error('scene.textures expected.');
         }
         const cachedTextures = textureOptions;
         for (const comp of compositions){
@@ -22501,7 +22470,7 @@ let 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;
@@ -22871,7 +22840,7 @@ let listOrder = 0;
                     }
                     parent.children.push(item);
                 } else {
-                    throw Error('元素引用了不存在的元素，请检查数据');
+                    throw new Error('The element references a non-existent element, please check the data.');
                 }
             }
         }
@@ -23102,7 +23071,7 @@ let listOrder = 0;
    * 合成整体在水平方向移动 x 像素，垂直方向移动 y 像素
    */ 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);
@@ -23116,7 +23085,7 @@ let listOrder = 0;
    * @param y - y 坐标
    */ 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);
@@ -23203,11 +23172,11 @@ let listOrder = 0;
         /**
    * 销毁状态位
    */ this.destroyed = false;
+        this.postLoaders = [];
         /**
    * 合成暂停/播放 标识
    */ this.paused = false;
         this.lastVideoUpdateTime = 0;
-        this.postLoaders = [];
         const { reusable = false, speed = 1, baseRenderOrder = 0, renderer, onPlayerPause, onMessageItem, onEnd, event, width, height } = props;
         this.compositionSourceManager = new CompositionSourceManager(scene, renderer.engine);
         scene.jsonScene.imgUsage = undefined;
@@ -23431,7 +23400,7 @@ let 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((pass)=>pass.dispose());
         this.meshes.forEach((mesh)=>mesh.dispose());
@@ -23556,7 +23525,7 @@ let listOrder = 0;
    * @param ticker - 定时器类
    */ 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);
     }
@@ -23723,7 +23692,7 @@ 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;
@@ -23827,7 +23796,6 @@ exports.setMaskMode = setMaskMode;
 exports.setMaxSpriteMeshItemCount = setMaxSpriteMeshItemCount;
 exports.setRayFromCamera = setRayFromCamera;
 exports.setSideMode = setSideMode;
-exports.setSpriteMeshMaxFragmentTextures = setSpriteMeshMaxFragmentTextures;
 exports.setSpriteMeshMaxItemCountByGPU = setSpriteMeshMaxItemCountByGPU;
 exports.sortByOrder = sortByOrder;
 exports.spec = index$1;