@galacean/effects-core 2.0.0-alpha.27 → 2.0.0-alpha.28

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.27
+ * Version: v2.0.0-alpha.28
  */
 
 'use strict';
@@ -444,16 +444,27 @@ function isIOS() {
     // real ios device not in simulator
     return !!navigator.platform && /iPad|iPhone|iPod/.test(navigator.platform);
 }
+function isIOSByUA() {
+    var str = navigator.userAgent.toLowerCase();
+    var ver = str.match(/cpu (iphone )?os (.*?) like mac os/);
+    return ver ? parseInt(ver[2], 10) : 0;
+}
 function isAndroid() {
     return /\b[Aa]ndroid\b/.test(navigator.userAgent);
 }
 function isSimulatorCellPhone() {
     return isAndroid() || /\b(iPad|iPhone|iPod)\b/.test(navigator.userAgent);
 }
+function isMiniProgram() {
+    return isAlipayMiniApp() || isWechatMiniApp();
+}
 function isAlipayMiniApp() {
     var _my;
     return typeof my !== "undefined" && ((_my = my) == null ? void 0 : _my.renderTarget) === "web";
 }
+function isWechatMiniApp() {
+    return window.__wxjs_environment === "miniprogram";
+}
 
 function imageDataFromColor(value) {
     if (isString(value)) {
@@ -8133,31 +8144,35 @@ function deserializeMipmapTexture(textureOptions, bins, engine) {
 }
 function _deserializeMipmapTexture() {
     _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;
+        var mipmaps, target, jobs, loadedMipmaps, mipmaps1, target1, jobs1, loadedMipmaps1, bin;
         return __generator(this, function(_state) {
             switch(_state.label){
                 case 0:
                     if (files === void 0) files = [];
                     if (!(textureOptions.target === 34067)) return [
                         3,
-                        1
+                        2
                     ];
                     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;){
-                        level = _step.value;
-                        newLevel = [];
-                        for(_iterator1 = _create_for_of_iterator_helper_loose(level); !(_step1 = _iterator1()).done;){
-                            face = _step1.value;
-                            // @ts-expect-error
-                            loadedImageAsset = engine.assetLoader.loadGUID(face.id);
+                    jobs = mipmaps.map(function(mipmap) {
+                        return Promise.all(mipmap.map(function(pointer) {
                             // @ts-expect-error
-                            newLevel.push(loadedImageAsset.data);
-                        }
-                        loadedMipmaps.push(newLevel);
-                    }
-                    // const bin = files[mipmaps[0][0][1][0]].url;
+                            if (pointer.id) {
+                                // @ts-expect-error
+                                var loadedImageAsset = engine.assetLoader.loadGUID(pointer.id);
+                                // @ts-expect-error
+                                return loadedImageAsset.data;
+                            } else {
+                                return loadMipmapImage(pointer, bins);
+                            }
+                        }));
+                    });
+                    return [
+                        4,
+                        Promise.all(jobs)
+                    ];
+                case 1:
+                    loadedMipmaps = _state.sent();
                     return [
                         2,
                         _extends({
@@ -8171,17 +8186,17 @@ function _deserializeMipmapTexture() {
                             }
                         })
                     ];
-                case 1:
+                case 2:
                     // TODO: 补充测试用例
                     mipmaps1 = textureOptions.mipmaps, target1 = textureOptions.target;
-                    jobs = mipmaps1.map(function(pointer) {
+                    jobs1 = mipmaps1.map(function(pointer) {
                         return loadMipmapImage(pointer, bins);
                     });
                     return [
                         4,
-                        Promise.all(jobs)
+                        Promise.all(jobs1)
                     ];
-                case 2:
+                case 3:
                     loadedMipmaps1 = _state.sent();
                     bin = files[mipmaps1[0][1][0]].url;
                     return [
@@ -8204,7 +8219,7 @@ function _deserializeMipmapTexture() {
                             }
                         })
                     ];
-                case 3:
+                case 4:
                     return [
                         2
                     ];
@@ -11559,7 +11574,7 @@ var valueDefine = "#ifdef SHADER_VERTEX\n#define CURVE_VALUE_TEXTURE uVCurveValu
 
 var screenMeshVert = "precision highp float;attribute vec2 aPos;varying vec2 uv;void main(){gl_Position=vec4(aPos,0.,1.0);uv=(aPos+vec2(1.0))/2.;}";
 
-var colorGradingFrag = "precision highp float;\n#define HALF_MAX 60000.0\n#define ACEScc_MIDGRAY 0.4135884\nvarying vec2 uv;uniform sampler2D _GaussianTex;uniform sampler2D _SceneTex;uniform float _BloomIntensity;uniform float _Brightness;uniform float _Saturation;uniform float _Contrast;uniform bool _UseBloom;uniform bool _UseToneMapping;uniform vec3 _VignetteColor;uniform vec2 _VignetteCenter;uniform float _VignetteIntensity;uniform float _VignetteSmoothness;uniform float _VignetteRoundness;mat3 LinearToACES=mat3(0.59719,0.07600,0.02840,0.35458,0.90834,0.13383,0.04823,0.01566,0.83777);mat3 ACESToLinear=mat3(1.60475,-0.10208,-0.00327,-0.53108,1.10813,-0.07276,-0.07367,-0.00605,1.07602);float log10(float x){return log(x)/log(10.0);}vec3 log10(vec3 v){return vec3(log10(v.x),log10(v.y),log10(v.z));}vec3 LinearToLogC(vec3 x){return 0.244161*log10(5.555556*x+0.047996)+0.386036;}vec3 LogCToLinear(vec3 x){return(pow(vec3(10.0),(x-0.386036)/0.244161)-0.047996)/5.555556;}vec3 rrt_and_odt_fit(vec3 col){vec3 a=col*(col+0.0245786)-0.000090537;vec3 b=col*(0.983729*col+0.4329510)+0.238081;return a/b;}vec3 ACESToneMapping(vec3 col){vec3 aces=LinearToACES*col;aces=rrt_and_odt_fit(aces);col=ACESToLinear*aces;return col;}vec3 LinearToSrgb(vec3 c){return mix(1.055*pow(c,vec3(1./2.4))-0.055,12.92*c,step(c,vec3(0.0031308)));}vec3 GammaCorrection(vec3 c){return pow(c,vec3(1.0/2.2));}vec3 ApplyVignette(vec3 inputColor,vec2 uv,vec2 center,float intensity,float roundness,float smoothness,vec3 color){vec2 dist=abs(uv-center)*intensity;dist.x*=roundness;float vfactor=pow(clamp((1.0-dot(dist,dist)),0.0,1.0),smoothness);return inputColor*mix(color,vec3(1.0),vfactor);}void main(){vec4 hdrColor=texture2D(_SceneTex,uv);hdrColor.rgb=pow(hdrColor.rgb,vec3(2.2));vec3 finalColor=hdrColor.rgb;if(_UseBloom){vec4 bloomColor=texture2D(_GaussianTex,uv);bloomColor.rgb*=_BloomIntensity;finalColor+=bloomColor.rgb;}if(_VignetteIntensity>0.0){finalColor=ApplyVignette(finalColor,uv,_VignetteCenter,_VignetteIntensity,_VignetteRoundness,_VignetteSmoothness,_VignetteColor);}finalColor=finalColor*_Brightness;vec3 colorLog=LinearToLogC(finalColor);colorLog=(colorLog-ACEScc_MIDGRAY)*_Contrast+ACEScc_MIDGRAY;finalColor=LogCToLinear(colorLog);finalColor=max(finalColor,0.0);float luminance=0.2125*finalColor.r+0.7154*finalColor.g+0.0721*finalColor.b;vec3 luminanceColor=vec3(luminance,luminance,luminance);finalColor=(finalColor-luminanceColor)*_Saturation+luminanceColor;finalColor=max(finalColor,0.0);if(_UseToneMapping){finalColor=max(vec3(0.0),ACESToneMapping(finalColor));}gl_FragColor=vec4(clamp(GammaCorrection(finalColor),0.0,1.0),1.0);}";
+var colorGradingFrag = "precision highp float;\n#define HALF_MAX 60000.0\n#define ACEScc_MIDGRAY 0.4135884\nvarying vec2 uv;uniform sampler2D _GaussianTex;uniform sampler2D _SceneTex;uniform float _BloomIntensity;uniform float _Brightness;uniform float _Saturation;uniform float _Contrast;uniform bool _UseBloom;uniform bool _UseToneMapping;uniform vec3 _VignetteColor;uniform vec2 _VignetteCenter;uniform float _VignetteIntensity;uniform float _VignetteSmoothness;uniform float _VignetteRoundness;mat3 LinearToACES=mat3(0.59719,0.07600,0.02840,0.35458,0.90834,0.13383,0.04823,0.01566,0.83777);mat3 ACESToLinear=mat3(1.60475,-0.10208,-0.00327,-0.53108,1.10813,-0.07276,-0.07367,-0.00605,1.07602);float log10(float x){return log(x)/log(10.0);}vec3 log10(vec3 v){return vec3(log10(v.x),log10(v.y),log10(v.z));}vec3 LinearToLogC(vec3 x){return 0.244161*log10(5.555556*x+0.047996)+0.386036;}vec3 LogCToLinear(vec3 x){return(pow(vec3(10.0),(x-0.386036)/0.244161)-0.047996)/5.555556;}vec3 rrt_and_odt_fit(vec3 col){vec3 a=col*(col+0.0245786)-0.000090537;vec3 b=col*(0.983729*col+0.4329510)+0.238081;return a/b;}vec3 ACESToneMapping(vec3 col){vec3 aces=LinearToACES*col;aces=rrt_and_odt_fit(aces);col=ACESToLinear*aces;return col;}vec3 LinearToSrgb(vec3 c){return mix(1.055*pow(c,vec3(1./2.4))-0.055,12.92*c,step(c,vec3(0.0031308)));}vec3 GammaCorrection(vec3 c){return pow(c,vec3(1.0/2.2));}vec3 ApplyVignette(vec3 inputColor,vec2 uv,vec2 center,float intensity,float roundness,float smoothness,vec3 color){vec2 dist=abs(uv-center)*intensity;dist.x*=roundness;float vfactor=pow(clamp((1.0-dot(dist,dist)),0.0,1.0),smoothness);return inputColor*mix(color,vec3(1.0),vfactor);}void main(){vec4 hdrColor=texture2D(_SceneTex,uv);hdrColor*=hdrColor.a;hdrColor.rgb=pow(hdrColor.rgb,vec3(2.2));vec3 finalColor=hdrColor.rgb;if(_UseBloom){vec4 bloomColor=texture2D(_GaussianTex,uv);bloomColor.rgb*=_BloomIntensity;finalColor+=bloomColor.rgb;}if(_VignetteIntensity>0.0){finalColor=ApplyVignette(finalColor,uv,_VignetteCenter,_VignetteIntensity,_VignetteRoundness,_VignetteSmoothness,_VignetteColor);}finalColor=finalColor*_Brightness;vec3 colorLog=LinearToLogC(finalColor);colorLog=(colorLog-ACEScc_MIDGRAY)*_Contrast+ACEScc_MIDGRAY;finalColor=LogCToLinear(colorLog);finalColor=max(finalColor,0.0);float luminance=0.2125*finalColor.r+0.7154*finalColor.g+0.0721*finalColor.b;vec3 luminanceColor=vec3(luminance,luminance,luminance);finalColor=(finalColor-luminanceColor)*_Saturation+luminanceColor;finalColor=max(finalColor,0.0);if(_UseToneMapping){finalColor=max(vec3(0.0),ACESToneMapping(finalColor));}gl_FragColor=vec4(clamp(GammaCorrection(finalColor),0.0,1.0),1.0);}";
 
 var gaussianDown_frag = "precision highp float;varying vec2 uv;uniform sampler2D _MainTex;uniform vec2 _TextureSize;float GaussWeight2D(float x,float y,float sigma){float PI=3.14159265358;float E=2.71828182846;float sigma_2=pow(sigma,2.0);float a=-(x*x+y*y)/(2.0*sigma_2);return pow(E,a)/(2.0*PI*sigma_2);}vec3 GaussNxN(sampler2D tex,vec2 uv,vec2 stride,float sigma){vec3 color=vec3(0.,0.,0.);const int r=5/2;float weight=0.0;for(int i=-r;i<=r;i++){for(int j=-r;j<=r;j++){float w=GaussWeight2D(float(i),float(j),sigma);vec2 coord=uv+vec2(i,j)*stride;color+=texture2D(tex,coord).rgb*w;weight+=w;}}color/=weight;return color;}void main(){vec4 mainColor=texture2D(_MainTex,uv);vec3 color=mainColor.rgb;color=GaussNxN(_MainTex,uv,1.0/_TextureSize,1.0);gl_FragColor=vec4(color,1.0);}";
 
@@ -11847,7 +11862,7 @@ var ToneMappingPass = /*#__PURE__*/ function(RenderPass) {
         this.screenMesh.material.setFloat("_Brightness", brightness);
         this.screenMesh.material.setFloat("_Saturation", saturation);
         this.screenMesh.material.setFloat("_Contrast", contrast);
-        this.screenMesh.material.setInt("_UseBloom", useBloom);
+        this.screenMesh.material.setInt("_UseBloom", Number(useBloom));
         if (useBloom) {
             this.screenMesh.material.setTexture("_GaussianTex", this.mainTexture);
             this.screenMesh.material.setFloat("_BloomIntensity", bloomIntensity);
@@ -11859,7 +11874,7 @@ var ToneMappingPass = /*#__PURE__*/ function(RenderPass) {
             this.screenMesh.material.setVector2("_VignetteCenter", new Vector2(0.5, 0.5));
             this.screenMesh.material.setVector3("_VignetteColor", new Vector3(0.0, 0.0, 0.0));
         }
-        this.screenMesh.material.setInt("_UseToneMapping", useToneMapping);
+        this.screenMesh.material.setInt("_UseToneMapping", Number(useToneMapping));
         renderer.renderMeshes([
             this.screenMesh
         ]);
@@ -11871,9 +11886,8 @@ var ToneMappingPass = /*#__PURE__*/ function(RenderPass) {
  * 后处理配置
  */ var defaultGlobalVolume = {
     useHDR: false,
-    usePostProcessing: false,
     /***** Material Uniform *****/ // Bloom
-    useBloom: 1.0,
+    useBloom: true,
     threshold: 1.0,
     bloomIntensity: 1.0,
     // ColorAdjustments
@@ -11887,7 +11901,7 @@ var ToneMappingPass = /*#__PURE__*/ function(RenderPass) {
     vignetteSmoothness: 0.4,
     vignetteRoundness: 1.0,
     // ToneMapping
-    useToneMapping: 1
+    useToneMapping: true
 };
 
 var RENDER_PASS_NAME_PREFIX = "_effects_default_";
@@ -11956,20 +11970,36 @@ var seed$5 = 1;
         ];
         this.setRenderPasses(renderPasses);
         if (this.globalVolume) {
-            var useBloom = this.globalVolume.useBloom;
             var sceneTextureHandle = new RenderTargetHandle(engine); //保存后处理前的屏幕图像
-            if (useBloom) {
-                var gaussianStep = 7; // 高斯模糊的迭代次数，次数越高模糊范围越大
-                var viewport = [
-                    0,
-                    0,
-                    this.renderer.getWidth() / 2,
-                    this.renderer.getHeight() / 2
-                ];
-                var gaussianDownResults = new Array(gaussianStep); //存放多个高斯Pass的模糊结果，用于Bloom
-                var textureType1 = this.globalVolume.useHDR ? glContext.HALF_FLOAT : glContext.UNSIGNED_BYTE;
-                var bloomThresholdPass = new BloomThresholdPass(renderer, {
-                    name: "BloomThresholdPass",
+            var gaussianStep = 7; // 高斯模糊的迭代次数，次数越高模糊范围越大
+            var viewport = [
+                0,
+                0,
+                this.renderer.getWidth() / 2,
+                this.renderer.getHeight() / 2
+            ];
+            var gaussianDownResults = new Array(gaussianStep); //存放多个高斯Pass的模糊结果，用于Bloom
+            var textureType1 = this.globalVolume.useHDR ? glContext.HALF_FLOAT : glContext.UNSIGNED_BYTE;
+            var bloomThresholdPass = new BloomThresholdPass(renderer, {
+                name: "BloomThresholdPass",
+                attachments: [
+                    {
+                        texture: {
+                            format: glContext.RGBA,
+                            type: textureType1,
+                            minFilter: glContext.LINEAR,
+                            magFilter: glContext.LINEAR
+                        }
+                    }
+                ]
+            });
+            bloomThresholdPass.sceneTextureHandle = sceneTextureHandle;
+            this.addRenderPass(bloomThresholdPass);
+            for(var i = 0; i < gaussianStep; i++){
+                gaussianDownResults[i] = new RenderTargetHandle(engine);
+                var gaussianDownHPass = new HQGaussianDownSamplePass(renderer, "H", {
+                    name: "GaussianDownPassH" + i,
+                    viewport: viewport,
                     attachments: [
                         {
                             texture: {
@@ -11981,74 +12011,50 @@ var seed$5 = 1;
                         }
                     ]
                 });
-                bloomThresholdPass.sceneTextureHandle = sceneTextureHandle;
-                this.addRenderPass(bloomThresholdPass);
-                for(var i = 0; i < gaussianStep; i++){
-                    gaussianDownResults[i] = new RenderTargetHandle(engine);
-                    var gaussianDownHPass = new HQGaussianDownSamplePass(renderer, "H", {
-                        name: "GaussianDownPassH" + i,
-                        viewport: viewport,
-                        attachments: [
-                            {
-                                texture: {
-                                    format: glContext.RGBA,
-                                    type: textureType1,
-                                    minFilter: glContext.LINEAR,
-                                    magFilter: glContext.LINEAR
-                                }
-                            }
-                        ]
-                    });
-                    var gaussianDownVPass = new HQGaussianDownSamplePass(renderer, "V", {
-                        name: "GaussianDownPassV" + i,
-                        viewport: viewport,
-                        attachments: [
-                            {
-                                texture: {
-                                    format: glContext.RGBA,
-                                    type: textureType1,
-                                    minFilter: glContext.LINEAR,
-                                    magFilter: glContext.LINEAR
-                                }
+                var gaussianDownVPass = new HQGaussianDownSamplePass(renderer, "V", {
+                    name: "GaussianDownPassV" + i,
+                    viewport: viewport,
+                    attachments: [
+                        {
+                            texture: {
+                                format: glContext.RGBA,
+                                type: textureType1,
+                                minFilter: glContext.LINEAR,
+                                magFilter: glContext.LINEAR
                             }
-                        ]
-                    });
-                    gaussianDownVPass.gaussianResult = gaussianDownResults[i];
-                    this.addRenderPass(gaussianDownHPass);
-                    this.addRenderPass(gaussianDownVPass);
-                    viewport[2] /= 2;
-                    viewport[3] /= 2;
-                // TODO 限制最大迭代
-                }
-                viewport[2] *= 4;
-                viewport[3] *= 4;
-                for(var i1 = 0; i1 < gaussianStep - 1; i1++){
-                    var gaussianUpPass = new HQGaussianUpSamplePass(renderer, {
-                        name: "GaussianUpPass" + i1,
-                        viewport: viewport,
-                        attachments: [
-                            {
-                                texture: {
-                                    format: glContext.RGBA,
-                                    type: textureType1,
-                                    minFilter: glContext.LINEAR,
-                                    magFilter: glContext.LINEAR
-                                }
+                        }
+                    ]
+                });
+                gaussianDownVPass.gaussianResult = gaussianDownResults[i];
+                this.addRenderPass(gaussianDownHPass);
+                this.addRenderPass(gaussianDownVPass);
+                viewport[2] /= 2;
+                viewport[3] /= 2;
+            // TODO 限制最大迭代
+            }
+            viewport[2] *= 4;
+            viewport[3] *= 4;
+            for(var i1 = 0; i1 < gaussianStep - 1; i1++){
+                var gaussianUpPass = new HQGaussianUpSamplePass(renderer, {
+                    name: "GaussianUpPass" + i1,
+                    viewport: viewport,
+                    attachments: [
+                        {
+                            texture: {
+                                format: glContext.RGBA,
+                                type: textureType1,
+                                minFilter: glContext.LINEAR,
+                                magFilter: glContext.LINEAR
                             }
-                        ]
-                    });
-                    gaussianUpPass.gaussianDownSampleResult = gaussianDownResults[gaussianStep - 2 - i1];
-                    this.addRenderPass(gaussianUpPass);
-                    viewport[2] *= 2;
-                    viewport[3] *= 2;
-                }
-            }
-            var postProcessPass;
-            if (useBloom) {
-                postProcessPass = new ToneMappingPass(renderer, sceneTextureHandle);
-            } else {
-                postProcessPass = new ToneMappingPass(renderer);
+                        }
+                    ]
+                });
+                gaussianUpPass.gaussianDownSampleResult = gaussianDownResults[gaussianStep - 2 - i1];
+                this.addRenderPass(gaussianUpPass);
+                viewport[2] *= 2;
+                viewport[3] *= 2;
             }
+            var postProcessPass = new ToneMappingPass(renderer, sceneTextureHandle);
             this.addRenderPass(postProcessPass);
         }
         this.semantics = new SemanticMap(options.semantics);
@@ -13085,6 +13091,7 @@ exports.InteractComponent = /*#__PURE__*/ function(RendererComponent) {
             1
         ];
         /** 是否响应点击和拖拽交互事件 */ _this._interactive = true;
+        _this.hasBeenAddedToComposition = false;
         _this.getHitTestParams = function(force) {
             if (!_this.clickable) {
                 return;
@@ -13103,7 +13110,6 @@ exports.InteractComponent = /*#__PURE__*/ function(RendererComponent) {
     }
     var _proto = InteractComponent.prototype;
     _proto.start = function start() {
-        var _this = this;
         var options = this.item.props.content.options;
         var env = this.item.engine.renderer.env;
         var composition = this.item.composition;
@@ -13115,10 +13121,6 @@ exports.InteractComponent = /*#__PURE__*/ function(RendererComponent) {
                 this.previewContent = new InteractMesh(this.item.props.content, rendererOptions, this.transform, this.engine);
             }
         }
-        composition.addInteractiveItem(this.item, options.type);
-        this.item.onEnd = function() {
-            return composition.removeInteractiveItem(_this.item, options.type);
-        };
         if (options.type === InteractType.DRAG) {
             if (env !== PLAYER_OPTIONS_ENV_EDITOR || options.enableInEditor) {
                 composition.event && this.beginDragTarget(options, composition.event);
@@ -13133,6 +13135,11 @@ exports.InteractComponent = /*#__PURE__*/ function(RendererComponent) {
     _proto.update = function update(dt) {
         var _this_previewContent;
         (_this_previewContent = this.previewContent) == null ? void 0 : _this_previewContent.updateMesh();
+        if (!this.hasBeenAddedToComposition && this.item.composition) {
+            var options = this.item.props.content.options;
+            this.item.composition.addInteractiveItem(this.item, options.type);
+            this.hasBeenAddedToComposition = true;
+        }
         if (!this.dragEvent || !this.bouncingArg) {
             return;
         }
@@ -14856,8 +14863,7 @@ var RectangleEdge = /*#__PURE__*/ function() {
 }();
 var Edge = /*#__PURE__*/ function() {
     function Edge(args) {
-        // TODO: 为通过帧对比暂时使用老计算，修复粒子发射器直线宽度问题下面一行改为: this._d = args.width || 1 ;
-        this._d = (args.width || 1) / 2;
+        this._d = args.width || 1;
         this.arcMode = args.arcMode;
     }
     var _proto = Edge.prototype;
@@ -20182,6 +20188,105 @@ function geometryToTriangles(geometry) {
     return res;
 }
 
+exports.PostProcessVolume = /*#__PURE__*/ function(ItemBehaviour) {
+    _inherits(PostProcessVolume, ItemBehaviour);
+    function PostProcessVolume() {
+        var _this;
+        _this = ItemBehaviour.apply(this, arguments) || this;
+        _this.useHDR = true;
+        // Bloom
+        _this.useBloom = true;
+        _this.threshold = 1.0;
+        _this.bloomIntensity = 1.0;
+        // ColorAdjustments
+        _this.brightness = 1.0;
+        _this.saturation = 1.0;
+        _this.contrast = 1.0;
+        // Vignette
+        _this.vignetteIntensity = 0.2;
+        _this.vignetteSmoothness = 0.4;
+        _this.vignetteRoundness = 1.0;
+        // ToneMapping
+        _this.useToneMapping = true // 1: true, 0: false
+        ;
+        return _this;
+    }
+    var _proto = PostProcessVolume.prototype;
+    _proto.start = function start() {
+        var composition = this.item.composition;
+        if (composition) {
+            composition.globalVolume = {
+                useHDR: this.useHDR,
+                useBloom: this.useBloom,
+                threshold: this.threshold,
+                bloomIntensity: this.bloomIntensity,
+                brightness: this.brightness,
+                saturation: this.saturation,
+                contrast: this.contrast,
+                vignetteIntensity: this.vignetteIntensity,
+                vignetteSmoothness: this.vignetteSmoothness,
+                vignetteRoundness: this.vignetteRoundness,
+                useToneMapping: this.useToneMapping
+            };
+            composition.createRenderFrame();
+        }
+    };
+    _proto.update = function update(dt) {
+        var composition = this.item.composition;
+        if (composition) {
+            var globalVolume = composition.renderFrame.globalVolume;
+            globalVolume.useHDR = this.useHDR;
+            globalVolume.useBloom = this.useBloom;
+            globalVolume.threshold = this.threshold;
+            globalVolume.bloomIntensity = this.bloomIntensity;
+            globalVolume.brightness = this.brightness;
+            globalVolume.saturation = this.saturation;
+            globalVolume.contrast = this.contrast;
+            globalVolume.vignetteIntensity = this.vignetteIntensity;
+            globalVolume.vignetteSmoothness = this.vignetteSmoothness;
+            globalVolume.vignetteRoundness = this.vignetteRoundness;
+            globalVolume.useToneMapping = this.useToneMapping;
+        }
+    };
+    return PostProcessVolume;
+}(ItemBehaviour);
+__decorate([
+    serialize()
+], exports.PostProcessVolume.prototype, "useHDR", void 0);
+__decorate([
+    serialize()
+], exports.PostProcessVolume.prototype, "useBloom", void 0);
+__decorate([
+    serialize()
+], exports.PostProcessVolume.prototype, "threshold", void 0);
+__decorate([
+    serialize()
+], exports.PostProcessVolume.prototype, "bloomIntensity", void 0);
+__decorate([
+    serialize()
+], exports.PostProcessVolume.prototype, "brightness", void 0);
+__decorate([
+    serialize()
+], exports.PostProcessVolume.prototype, "saturation", void 0);
+__decorate([
+    serialize()
+], exports.PostProcessVolume.prototype, "contrast", void 0);
+__decorate([
+    serialize()
+], exports.PostProcessVolume.prototype, "vignetteIntensity", void 0);
+__decorate([
+    serialize()
+], exports.PostProcessVolume.prototype, "vignetteSmoothness", void 0);
+__decorate([
+    serialize()
+], exports.PostProcessVolume.prototype, "vignetteRoundness", void 0);
+__decorate([
+    serialize()
+], exports.PostProcessVolume.prototype, "useToneMapping", void 0);
+exports.PostProcessVolume = __decorate([
+    effectsClass("PostProcessVolume")
+], exports.PostProcessVolume);
+
 exports.VFXItem = /*#__PURE__*/ function(EffectsObject) {
     _inherits(VFXItem, EffectsObject);
     function VFXItem(engine, props) {
@@ -20405,7 +20510,7 @@ exports.VFXItem = /*#__PURE__*/ function(EffectsObject) {
     /**
    * 获取元素用于计算光线投射的面片类型和参数
    * @override
-   * @param force 元素没有开启交互也返回参数
+   * @param force - 元素没有开启交互也返回参数
    */ _proto.getHitTestParams = function getHitTestParams(force) {
     // OVERRIDE
     };
@@ -20655,42 +20760,6 @@ exports.Item = void 0;
     }
     Item.isNull = isNull;
 })(exports.Item || (exports.Item = {}));
-/**
- * (待废弃) 根据元素的类型创建对应的 `VFXItem` 实例
- * @param props
- * @param composition
- */ function createVFXItem(props, composition) {
-    var type = props.type;
-    var pluginName = props.pluginName;
-    if (!pluginName) {
-        switch(type){
-            case ItemType.null:
-                pluginName = "cal";
-                break;
-            case ItemType.sprite:
-                pluginName = "sprite";
-                break;
-            case ItemType.particle:
-                pluginName = "particle";
-                break;
-            case ItemType.interact:
-                pluginName = "interact";
-                break;
-            case ItemType.camera:
-                pluginName = "camera";
-                break;
-            case ItemType.text:
-                pluginName = "text";
-                break;
-            case ItemType.tree:
-                pluginName = "tree";
-                break;
-            default:
-                throw new Error("Invalid vfx item type.");
-        }
-    }
-    return composition.pluginSystem.createPluginItem(pluginName, props, composition);
-}
 
 var pluginLoaderMap = {};
 var defaultPlugins = [];
@@ -20703,6 +20772,9 @@ var pluginCtrlMap = {};
  * @param isDefault load
  */ // eslint-disable-next-line @typescript-eslint/no-unused-vars
 function registerPlugin(name, pluginClass, itemClass, isDefault) {
+    if (pluginCtrlMap[name]) {
+        logger.error("Duplicate registration for plugin " + name + ".");
+    }
     pluginCtrlMap[name] = itemClass;
     pluginLoaderMap[name] = pluginClass;
     if (isDefault) {
@@ -21281,8 +21353,8 @@ var SerializationHelper = /*#__PURE__*/ function() {
         if (this.engine.objectInstance[guid]) {
             return this.engine.objectInstance[guid];
         }
-        var effectsObject;
         var effectsObjectData = this.findData(guid);
+        var effectsObject;
         if (!effectsObjectData) {
             console.error("Object data with uuid: " + guid + " not found.");
             return undefined;
@@ -21318,7 +21390,7 @@ var SerializationHelper = /*#__PURE__*/ function() {
     _proto.loadGUIDAsync = function loadGUIDAsync(guid) {
         var _this = this;
         return _async_to_generator(function() {
-            var effectsObject, effectsObjectData, classConstructor;
+            var effectsObjectData, effectsObject, classConstructor;
             return __generator(this, function(_state) {
                 switch(_state.label){
                     case 0:
@@ -23583,14 +23655,6 @@ var seed = 1;
                     case 0:
                         // TODO: 后面切换到新的数据版本，就不用掉用 getStandardJSON 做转换了
                         jsonScene = getStandardJSON(json);
-                        // FIXME: hack globalVolume，specification 更新后需移除
-                        // @ts-expect-error
-                        json.compositions.forEach(function(composition, i) {
-                            if (composition.globalVolume) {
-                                // @ts-expect-error
-                                jsonScene.compositions[i].globalVolume = composition.globalVolume;
-                            }
-                        });
                         _jsonScene_plugins = jsonScene.plugins, plugins = _jsonScene_plugins === void 0 ? [] : _jsonScene_plugins, sceneCompositions = jsonScene.compositions, imgUsage = jsonScene.imgUsage, images = jsonScene.images;
                         pluginSystem = new PluginSystem(plugins);
                         return [
@@ -24378,9 +24442,7 @@ var listOrder = 0;
     }
     var _proto = CompositionSourceManager.prototype;
     _proto.getContent = function getContent(composition) {
-        // TODO: specification 中补充 globalVolume 类型
-        // @ts-expect-error
-        var id = composition.id, duration = composition.duration, name = composition.name, endBehavior = composition.endBehavior, camera = composition.camera, globalVolume = composition.globalVolume, _composition_startTime = composition.startTime, startTime = _composition_startTime === void 0 ? 0 : _composition_startTime;
+        var id = composition.id, duration = composition.duration, name = composition.name, endBehavior = composition.endBehavior, camera = composition.camera, _composition_startTime = composition.startTime, startTime = _composition_startTime === void 0 ? 0 : _composition_startTime;
         var items = this.assembleItems(composition);
         return _extends({}, composition, {
             id: id,
@@ -24390,8 +24452,7 @@ var listOrder = 0;
             // looping,
             items: items,
             camera: camera,
-            startTime: startTime,
-            globalVolume: globalVolume
+            startTime: startTime
         });
     };
     _proto.assembleItems = function assembleItems(composition) {
@@ -24553,7 +24614,6 @@ var listOrder = 0;
         this.rootComposition = this.rootItem.addComponent(CompositionComponent);
         this.rootComposition.data = sourceContent;
         var imageUsage = !reusable && imgUsage;
-        this.globalVolume = sourceContent.globalVolume;
         this.width = width;
         this.height = height;
         this.renderOrder = baseRenderOrder;
@@ -26758,7 +26818,10 @@ var FBGeometryDataT = /*#__PURE__*/ function() {
     return FBGeometryDataT;
 }();
 
-var EffectsPackage = /*#__PURE__*/ function() {
+/**
+ * @since 2.0.0
+ * @internal
+ */ var EffectsPackage = /*#__PURE__*/ function() {
     function EffectsPackage() {
         this.exportObjectDatas = [];
     }
@@ -26783,8 +26846,7 @@ var EffectsPackage = /*#__PURE__*/ function() {
         }
         effectsPackage.exportObjects = exportObjects;
         FBEffectsPackageData.finishFBEffectsPackageDataBuffer(fbb, effectsPackage.pack(fbb));
-        var buffer = fbb.asUint8Array(); // Of type `Uint8Array`.
-        return buffer;
+        return fbb.asUint8Array(); // Of type `Uint8Array`.
     };
     _proto.deserializeFromBinary = function deserializeFromBinary(buffer) {
         var buf = new ByteBuffer(buffer);
@@ -26812,37 +26874,35 @@ var EffectsPackage = /*#__PURE__*/ function() {
     _proto.geometryDataToBinary = function geometryDataToBinary(geometryData) {
         var fbb = new Builder(1);
         var fbGeometryData = new FBGeometryDataT();
-        fbGeometryData.indexFormat = geometryData.indexFormat;
-        fbGeometryData.indexOffset = geometryData.indexOffset;
-        fbGeometryData.mode = geometryData.mode;
-        fbGeometryData.id = geometryData.id;
-        var _geometryData_boneNames;
-        fbGeometryData.boneNames = (_geometryData_boneNames = geometryData.boneNames) != null ? _geometryData_boneNames : [];
-        var _geometryData_rootBoneName;
-        fbGeometryData.rootBoneName = (_geometryData_rootBoneName = geometryData.rootBoneName) != null ? _geometryData_rootBoneName : "";
-        var _geometryData_inverseBindMatrices;
-        fbGeometryData.inverseBindMatrices = (_geometryData_inverseBindMatrices = geometryData.inverseBindMatrices) != null ? _geometryData_inverseBindMatrices : [];
-        var _geometryData_binaryData;
-        fbGeometryData.binaryData = (_geometryData_binaryData = geometryData.binaryData) != null ? _geometryData_binaryData : [];
+        var indexFormat = geometryData.indexFormat, indexOffset = geometryData.indexOffset, mode = geometryData.mode, id = geometryData.id, vertexData = geometryData.vertexData, _geometryData_boneNames = geometryData.boneNames, boneNames = _geometryData_boneNames === void 0 ? [] : _geometryData_boneNames, _geometryData_rootBoneName = geometryData.rootBoneName, rootBoneName = _geometryData_rootBoneName === void 0 ? "" : _geometryData_rootBoneName, _geometryData_inverseBindMatrices = geometryData.inverseBindMatrices, inverseBindMatrices = _geometryData_inverseBindMatrices === void 0 ? [] : _geometryData_inverseBindMatrices, _geometryData_binaryData = geometryData.binaryData, binaryData = _geometryData_binaryData === void 0 ? [] : _geometryData_binaryData;
+        fbGeometryData.indexFormat = indexFormat;
+        fbGeometryData.indexOffset = indexOffset;
+        fbGeometryData.mode = mode;
+        fbGeometryData.id = id;
+        fbGeometryData.boneNames = boneNames;
+        fbGeometryData.rootBoneName = rootBoneName;
+        fbGeometryData.inverseBindMatrices = inverseBindMatrices;
+        fbGeometryData.binaryData = binaryData;
         var fbVertexdata = new FBVertexDataT();
-        fbVertexdata.vertexCount = geometryData.vertexData.vertexCount;
+        fbVertexdata.vertexCount = vertexData.vertexCount;
         fbVertexdata.channels = [];
-        for(var _iterator = _create_for_of_iterator_helper_loose(geometryData.vertexData.channels), _step; !(_step = _iterator()).done;){
+        for(var _iterator = _create_for_of_iterator_helper_loose(vertexData.channels), _step; !(_step = _iterator()).done;){
             var channel = _step.value;
-            var fbChannel = new FBVertexChannelT(channel.semantic, channel.offset, channel.format, channel.dimension, channel.normalize);
+            var semantic = channel.semantic, offset = channel.offset, format = channel.format, dimension = channel.dimension, normalize = channel.normalize;
+            var fbChannel = new FBVertexChannelT(semantic, offset, format, dimension, normalize);
             fbVertexdata.channels.push(fbChannel);
         }
         fbGeometryData.vertexData = fbVertexdata;
         var fbSubMeshes = [];
         for(var _iterator1 = _create_for_of_iterator_helper_loose(geometryData.subMeshes), _step1; !(_step1 = _iterator1()).done;){
             var subMesh = _step1.value;
-            var fbSubMesh = new FBSubMeshT(subMesh.offset, subMesh.indexCount, subMesh.vertexCount);
+            var offset1 = subMesh.offset, indexCount = subMesh.indexCount, vertexCount = subMesh.vertexCount;
+            var fbSubMesh = new FBSubMeshT(offset1, indexCount, vertexCount);
             fbSubMeshes.push(fbSubMesh);
         }
         fbGeometryData.subMeshes = fbSubMeshes;
         FBEffectsPackageData.finishFBEffectsPackageDataBuffer(fbb, fbGeometryData.pack(fbb));
-        var buffer = fbb.asUint8Array(); // Of type `Uint8Array`.
-        return buffer;
+        return fbb.asUint8Array(); // Of type `Uint8Array`.
     };
     _proto.binaryToGeometryData = function binaryToGeometryData(buffer) {
         var buf = new ByteBuffer(buffer);
@@ -26864,7 +26924,8 @@ var EffectsPackage = /*#__PURE__*/ function() {
                     semantic: (_channel_semantic = channel.semantic()) != null ? _channel_semantic : "",
                     offset: channel.offset(),
                     format: channel.format(),
-                    dimension: channel.dimension()
+                    dimension: channel.dimension(),
+                    normalize: channel.normalize()
                 };
                 vertexData.channels.push(vertexChannel);
             }
@@ -26877,7 +26938,8 @@ var EffectsPackage = /*#__PURE__*/ function() {
             }
             var subMesh = {
                 offset: fbSubMesh.offset(),
-                vertexCount: fbSubMesh.vertexCount()
+                vertexCount: fbSubMesh.vertexCount(),
+                indexCount: fbSubMesh.indexCount()
             };
             subMeshes.push(subMesh);
         }
@@ -27306,7 +27368,7 @@ registerPlugin("sprite", SpriteLoader, exports.VFXItem, true);
 registerPlugin("particle", ParticleLoader, exports.VFXItem, true);
 registerPlugin("cal", CalculateLoader, exports.VFXItem, true);
 registerPlugin("interact", InteractLoader, exports.VFXItem, true);
-var version = "2.0.0-alpha.27";
+var version = "2.0.0-alpha.28";
 logger.info("Core version: " + version + ".");
 
 exports.AbstractPlugin = AbstractPlugin;
@@ -27429,7 +27491,6 @@ exports.createGLContext = createGLContext;
 exports.createKeyFrameMeta = createKeyFrameMeta;
 exports.createShaderWithMacros = createShaderWithMacros;
 exports.createShape = createShape;
-exports.createVFXItem = createVFXItem;
 exports.createValueGetter = createValueGetter;
 exports.decimalEqual = decimalEqual;
 exports.defaultGlobalVolume = defaultGlobalVolume;
@@ -27485,6 +27546,8 @@ exports.isArray = isArray;
 exports.isCanvas = isCanvas;
 exports.isFunction = isFunction;
 exports.isIOS = isIOS;
+exports.isIOSByUA = isIOSByUA;
+exports.isMiniProgram = isMiniProgram;
 exports.isObject = isObject;
 exports.isSceneJSON = isSceneJSON;
 exports.isSceneURL = isSceneURL;
@@ -27495,6 +27558,7 @@ exports.isUniformStruct = isUniformStruct;
 exports.isUniformStructArray = isUniformStructArray;
 exports.isValidFontFamily = isValidFontFamily;
 exports.isWebGL2 = isWebGL2;
+exports.isWechatMiniApp = isWechatMiniApp;
 exports.itemFrag = itemFrag;
 exports.itemFrameFrag = itemFrameFrag;
 exports.itemVert = itemVert;