@galacean/effects-threejs 2.2.0-alpha.0 → 2.2.0

package/dist/index.js

@@ -3,7 +3,7 @@
  * Description: Galacean Effects runtime threejs plugin for the web
  * Author: Ant Group CO., Ltd.
  * Contributors: 燃然,飂兮,十弦,云垣,茂安,意绮
- * Version: v2.2.0-alpha.0
+ * Version: v2.2.0
  */
 
 'use strict';
@@ -5743,22 +5743,6 @@ exports.TextureSourceType = void 0;
     TextureSourceType[TextureSourceType["mipmaps"] = 7] = "mipmaps";
 })(exports.TextureSourceType || (exports.TextureSourceType = {}));
 
-var RUNTIME_ENV = "runtime_env";
-var RENDER_PREFER_LOOKUP_TEXTURE = "lookup_texture";
-// 文本元素使用 offscreen canvas 绘制
-var TEMPLATE_USE_OFFSCREEN_CANVAS = "offscreen_canvas";
-// 后处理配置相关
-var POST_PROCESS_SETTINGS = "post_process_settings";
-// 加载图片时是否使用 ImageBitmap
-var LOAD_PREFER_IMAGE_BITMAP = "load_image_bitmap";
-var config = {};
-function getConfig(name) {
-    return config[name];
-}
-function setConfig(name, value) {
-    return config[name] = value;
-}
-
 /**
  * 负责下载各种资源，并提供了一些异步加载和缓存管理的功能
  */ var Downloader = /*#__PURE__*/ function() {
@@ -5847,11 +5831,11 @@ var avifFailed = false;
  * 异步加载一个 WebP 图片文件，如果不支持 WebP，则加载 PNG 图片文件
  * @param png - PNG 图片文件的 URL
  * @param webp - WebP 图片文件的 URL
- */ function loadWebPOptional(png, webp, options) {
+ */ function loadWebPOptional(png, webp) {
     return _loadWebPOptional.apply(this, arguments);
 }
 function _loadWebPOptional() {
-    _loadWebPOptional = _async_to_generator(function(png, webp, options) {
+    _loadWebPOptional = _async_to_generator(function(png, webp) {
         var image, image1, image2;
         return __generator(this, function(_state) {
             switch(_state.label){
@@ -5862,7 +5846,7 @@ function _loadWebPOptional() {
                     ];
                     return [
                         4,
-                        loadImageBitmap(png, options)
+                        loadImage(png)
                     ];
                 case 1:
                     image = _state.sent();
@@ -5882,7 +5866,7 @@ function _loadWebPOptional() {
                     ]);
                     return [
                         4,
-                        loadImageBitmap(webp, options)
+                        loadImage(webp)
                     ];
                 case 3:
                     image1 = _state.sent();
@@ -5898,7 +5882,7 @@ function _loadWebPOptional() {
                     webPFailed = true;
                     return [
                         4,
-                        loadImageBitmap(png, options)
+                        loadImage(png)
                     ];
                 case 5:
                     image2 = _state.sent();
@@ -5922,11 +5906,11 @@ function _loadWebPOptional() {
  * 异步加载一个 AVIF 图片文件，如果不支持 AVIF，则加载 PNG 图片文件
  * @param png - PNG 图片文件的 URL
  * @param avif - AVIF 图片文件的 URL
- */ function loadAVIFOptional(png, avif, options) {
+ */ function loadAVIFOptional(png, avif) {
     return _loadAVIFOptional.apply(this, arguments);
 }
 function _loadAVIFOptional() {
-    _loadAVIFOptional = _async_to_generator(function(png, avif, options) {
+    _loadAVIFOptional = _async_to_generator(function(png, avif) {
         var image, image1, image2;
         return __generator(this, function(_state) {
             switch(_state.label){
@@ -5937,7 +5921,7 @@ function _loadAVIFOptional() {
                     ];
                     return [
                         4,
-                        loadImageBitmap(png, options)
+                        loadImage(png)
                     ];
                 case 1:
                     image = _state.sent();
@@ -5957,7 +5941,7 @@ function _loadAVIFOptional() {
                     ]);
                     return [
                         4,
-                        loadImageBitmap(avif, options)
+                        loadImage(avif)
                     ];
                 case 3:
                     image1 = _state.sent();
@@ -5973,7 +5957,7 @@ function _loadAVIFOptional() {
                     avifFailed = true;
                     return [
                         4,
-                        loadImageBitmap(png, options)
+                        loadImage(png)
                     ];
                 case 5:
                     image2 = _state.sent();
@@ -6188,80 +6172,6 @@ function _loadMedia() {
     });
     return _loadMedia.apply(this, arguments);
 }
-var imageBitMapAvailable = typeof createImageBitmap === "function";
-/**
- * 异步加载一个图片文件，如果支持 ImageBitmap 则返回 ImageBitmap 对象
- * @param source
- * @param options
- * @returns
- */ function loadImageBitmap(source, options) {
-    return _loadImageBitmap.apply(this, arguments);
-}
-function _loadImageBitmap() {
-    _loadImageBitmap = _async_to_generator(function(source, options) {
-        var blob;
-        return __generator(this, function(_state) {
-            switch(_state.label){
-                case 0:
-                    if (!(imageBitMapAvailable && getConfig(LOAD_PREFER_IMAGE_BITMAP))) return [
-                        3,
-                        4
-                    ];
-                    if (!(typeof source === "string")) return [
-                        3,
-                        2
-                    ];
-                    return [
-                        4,
-                        loadBlob(source)
-                    ];
-                case 1:
-                    blob = _state.sent();
-                    return [
-                        3,
-                        3
-                    ];
-                case 2:
-                    if (_instanceof1(source, Blob)) {
-                        blob = source;
-                    } else {
-                        return [
-                            2,
-                            loadImage(source)
-                        ];
-                    }
-                    _state.label = 3;
-                case 3:
-                    return [
-                        2,
-                        createImageBitmap(blob, options)
-                    ];
-                case 4:
-                    return [
-                        2,
-                        loadImage(source)
-                    ];
-                case 5:
-                    return [
-                        2
-                    ];
-            }
-        });
-    });
-    return _loadImageBitmap.apply(this, arguments);
-}
-/**
- * 关闭 ImageBitMap，释放内存
- * @param imgs
- */ function closeImageBitMap(imgs) {
-    if (imageBitMapAvailable) {
-        if (_instanceof1(imgs, ImageBitmap)) {
-            imgs.close();
-        } else if (_instanceof1(imgs, Array)) {
-            imgs.forEach(closeImageBitMap);
-        }
-    }
-}
 
 function deserializeMipmapTexture(textureOptions, bins, assets) {
     return _deserializeMipmapTexture.apply(this, arguments);
@@ -17916,7 +17826,7 @@ exports.VFXItem = /*#__PURE__*/ function(EffectsObject) {
     };
     /**
    * 添加组件
-   * @param classConstructor - 要添加的组件类型
+   * @param classConstructor - 要添加的组件
    */ _proto.addComponent = function addComponent(classConstructor) {
         var newComponent = new classConstructor(this.engine);
         this.components.push(newComponent);
@@ -18159,7 +18069,7 @@ exports.VFXItem = /*#__PURE__*/ function(EffectsObject) {
     };
     _proto.fromData = function fromData(data) {
         EffectsObject.prototype.fromData.call(this, data);
-        var id = data.id, name = data.name, delay = data.delay, parentId = data.parentId, endBehavior = data.endBehavior, transform = data.transform, _data_listIndex = data.listIndex, listIndex = _data_listIndex === void 0 ? 0 : _data_listIndex, _data_duration = data.duration, duration = _data_duration === void 0 ? 0 : _data_duration;
+        var id = data.id, name = data.name, delay = data.delay, parentId = data.parentId, endBehavior = data.endBehavior, transform = data.transform, _data_duration = data.duration, duration = _data_duration === void 0 ? 0 : _data_duration;
         this.props = data;
         //@ts-expect-error
         this.type = data.type;
@@ -18221,8 +18131,6 @@ exports.VFXItem = /*#__PURE__*/ function(EffectsObject) {
                 this.rendererComponents.push(component.renderer);
             }
         }
-        // renderOrder 在 component 初始化后设置。确保能拿到 rendererComponent。
-        this.renderOrder = listIndex;
     };
     _proto.toData = function toData() {
         var _this_parent;
@@ -18830,6 +18738,20 @@ exports.SpriteComponent = __decorate([
     effectsClass(DataType.SpriteComponent)
 ], exports.SpriteComponent);
 
+var RUNTIME_ENV = "runtime_env";
+var RENDER_PREFER_LOOKUP_TEXTURE = "lookup_texture";
+// 文本元素使用 offscreen canvas 绘制
+var TEMPLATE_USE_OFFSCREEN_CANVAS = "offscreen_canvas";
+// 后处理配置相关
+var POST_PROCESS_SETTINGS = "post_process_settings";
+var config = {};
+function getConfig(name) {
+    return config[name];
+}
+function setConfig(name, value) {
+    return config[name] = value;
+}
+
 var Cone = /*#__PURE__*/ function() {
     function Cone(props) {
         var _this = this;
@@ -23901,6 +23823,20 @@ var SerializationHelper = /*#__PURE__*/ function() {
         }
         return regions;
     };
+    /**
+   * 设置当前合成子元素的渲染顺序
+   * @internal
+   */ _proto.setChildrenRenderOrder = function setChildrenRenderOrder(startOrder) {
+        for(var _iterator = _create_for_of_iterator_helper_loose(this.items), _step; !(_step = _iterator()).done;){
+            var item = _step.value;
+            item.renderOrder = startOrder++;
+            var subCompositionComponent = item.getComponent(CompositionComponent);
+            if (subCompositionComponent) {
+                startOrder = subCompositionComponent.setChildrenRenderOrder(startOrder);
+            }
+        }
+        return startOrder;
+    };
     _proto.fromData = function fromData(data) {
         Behaviour.prototype.fromData.call(this, data);
         this.items = data.items;
@@ -24715,7 +24651,7 @@ var TextLayout = /*#__PURE__*/ function() {
     function TextLayout(options) {
         this.width = 0;
         this.height = 0;
-        var _options_textHeight = options.textHeight, textHeight = _options_textHeight === void 0 ? 100 : _options_textHeight, _options_textWidth = options.textWidth, textWidth = _options_textWidth === void 0 ? 100 : _options_textWidth, _options_textOverflow = options.textOverflow, textOverflow = _options_textOverflow === void 0 ? TextOverflow.display : _options_textOverflow, _options_textBaseline = options.textBaseline, textBaseline = _options_textBaseline === void 0 ? TextBaseline.top : _options_textBaseline, _options_textAlign = options.textAlign, textAlign = _options_textAlign === void 0 ? TextAlignment.left : _options_textAlign, _options_text = options.text, text = _options_text === void 0 ? " " : _options_text, _options_letterSpace = options.letterSpace, letterSpace = _options_letterSpace === void 0 ? 0 : _options_letterSpace, _options_autoWidth = options.autoWidth, autoWidth = _options_autoWidth === void 0 ? false : _options_autoWidth, fontSize = options.fontSize, _options_lineHeight = options.lineHeight, lineHeight = _options_lineHeight === void 0 ? fontSize : _options_lineHeight;
+        var _options_textHeight = options.textHeight, textHeight = _options_textHeight === void 0 ? 100 : _options_textHeight, _options_textWidth = options.textWidth, textWidth = _options_textWidth === void 0 ? 100 : _options_textWidth, _options_textOverflow = options.textOverflow, textOverflow = _options_textOverflow === void 0 ? TextOverflow.clip : _options_textOverflow, _options_textBaseline = options.textBaseline, textBaseline = _options_textBaseline === void 0 ? TextBaseline.top : _options_textBaseline, _options_textAlign = options.textAlign, textAlign = _options_textAlign === void 0 ? TextAlignment.left : _options_textAlign, _options_text = options.text, text = _options_text === void 0 ? " " : _options_text, _options_letterSpace = options.letterSpace, letterSpace = _options_letterSpace === void 0 ? 0 : _options_letterSpace, _options_autoWidth = options.autoWidth, autoWidth = _options_autoWidth === void 0 ? false : _options_autoWidth, fontSize = options.fontSize, _options_lineHeight = options.lineHeight, lineHeight = _options_lineHeight === void 0 ? fontSize : _options_lineHeight;
         var tempWidth = fontSize + letterSpace;
         this.autoWidth = autoWidth;
         this.maxTextWidth = text.length * tempWidth;
@@ -27337,7 +27273,6 @@ var seed$1 = 1;
         this.downloader = downloader;
         this.assets = {};
         this.sourceFrom = {};
-        this.imageBitmapOptions = {};
         this.id = seed$1++;
         this.timers = [];
         this.updateOptions(options);
@@ -27595,12 +27530,12 @@ var seed$1 = 1;
     _proto.processJSON = function processJSON(json) {
         var _this = this;
         return _async_to_generator(function() {
-            var jsonScene, _jsonScene_plugins, plugins, textures, pluginSystem;
+            var jsonScene, _jsonScene_plugins, plugins, pluginSystem;
             return __generator(this, function(_state) {
                 switch(_state.label){
                     case 0:
                         jsonScene = getStandardJSON(json);
-                        _jsonScene_plugins = jsonScene.plugins, plugins = _jsonScene_plugins === void 0 ? [] : _jsonScene_plugins, textures = jsonScene.textures;
+                        _jsonScene_plugins = jsonScene.plugins, plugins = _jsonScene_plugins === void 0 ? [] : _jsonScene_plugins;
                         pluginSystem = new PluginSystem(plugins);
                         return [
                             4,
@@ -27608,7 +27543,6 @@ var seed$1 = 1;
                         ];
                     case 1:
                         _state.sent();
-                        _this.assignImageBitmapOptions(textures);
                         return [
                             2,
                             {
@@ -27840,7 +27774,7 @@ var seed$1 = 1;
                                         ];
                                         return [
                                             4,
-                                            loadAVIFOptional(imageURL, avifURL, _this.imageBitmapOptions[id])
+                                            loadAVIFOptional(imageURL, avifURL)
                                         ];
                                     case 10:
                                         _tmp = _state.sent();
@@ -27851,7 +27785,7 @@ var seed$1 = 1;
                                     case 11:
                                         return [
                                             4,
-                                            loadWebPOptional(imageURL, webpURL, _this.imageBitmapOptions[id])
+                                            loadWebPOptional(imageURL, webpURL)
                                         ];
                                     case 12:
                                         _tmp = _state.sent();
@@ -28063,21 +27997,6 @@ var seed$1 = 1;
             this.assets[images[i].id] = loadedImages[i];
         }
     };
-    _proto.assignImageBitmapOptions = function assignImageBitmapOptions(textures) {
-        var _this = this;
-        if (textures === void 0) textures = [];
-        textures.forEach(function(texture) {
-            if (!(_instanceof1(texture, Texture) || "mipmaps" in texture)) {
-                var source = texture.source;
-                if (isObject(source)) {
-                    _this.imageBitmapOptions[source.id] = {
-                        imageOrientation: texture.flipY ? "flipY" : "none",
-                        premultiplyAlpha: texture.premultiplyAlpha ? "premultiply" : "none"
-                    };
-                }
-            }
-        });
-    };
     _proto.removeTimer = function removeTimer(id) {
         var index = this.timers.indexOf(id);
         if (index !== -1) {
@@ -28087,15 +28006,11 @@ var seed$1 = 1;
     /**
    * 销毁方法
    */ _proto.dispose = function dispose() {
-        var _this = this;
         if (this.timers.length) {
             this.timers.map(function(id) {
                 return window.clearTimeout(id);
             });
         }
-        closeImageBitMap(Object.keys(this.assets).map(function(key) {
-            return _this.assets[key];
-        }));
         this.assets = {};
         this.sourceFrom = {};
         this.timers = [];
@@ -28112,7 +28027,7 @@ function createTextureOptionsBySource(image, sourceFrom, id) {
     };
     if (_instanceof1(image, Texture)) {
         return _extends({}, image.source, options);
-    } else if (_instanceof1(image, HTMLImageElement) || _instanceof1(image, ImageBitmap) || isCanvas(image)) {
+    } else if (_instanceof1(image, HTMLImageElement) || isCanvas(image)) {
         return _extends({
             image: image,
             sourceType: exports.TextureSourceType.image,
@@ -28439,7 +28354,6 @@ var tmpScale = new Vector3(1, 1, 1);
     return Camera;
 }();
 
-var listOrder = 0;
 /**
  * 合成资源管理
  */ var CompositionSourceManager = /*#__PURE__*/ function() {
@@ -28472,7 +28386,6 @@ var listOrder = 0;
         this.pluginSystem = pluginSystem;
         this.totalTime = totalTime != null ? totalTime : 0;
         this.textures = cachedTextures;
-        listOrder = 0;
         this.sourceContent = this.getContent(this.composition);
     }
     var _proto = CompositionSourceManager.prototype;
@@ -28503,7 +28416,6 @@ var listOrder = 0;
             var sourceItemData = this.engine.jsonSceneData[itemDataPath.id];
             var itemProps = sourceItemData;
             if (passRenderLevel(sourceItemData.renderLevel, this.renderLevel)) {
-                itemProps.listIndex = listOrder++;
                 if (itemProps.type === ItemType.sprite || itemProps.type === ItemType.particle || itemProps.type === ItemType.spine || //@ts-expect-error
                 itemProps.type === ItemType.shape) {
                     for(var _iterator2 = _create_for_of_iterator_helper_loose(itemProps.components), _step2; !(_step2 = _iterator2()).done;){
@@ -28806,6 +28718,7 @@ var LateUpdateTickData = /*#__PURE__*/ function(TickData) {
         SerializationHelper.deserialize(sourceContent, _this.rootComposition);
         _this.rootComposition.createContent();
         _this.buildItemTree(_this.rootItem);
+        _this.rootComposition.setChildrenRenderOrder(0);
         _this.pluginSystem.resetComposition(_assert_this_initialized(_this), _this.renderFrame);
         return _this;
     }
@@ -31445,7 +31358,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$1 = "2.2.0-alpha.0";
+var version$1 = "2.2.0";
 logger.info("Core version: " + version$1 + ".");
 
 var _obj;
@@ -31502,6 +31415,7 @@ var _obj3;
         /**
    * 储存 uniform 变量名及对应的 THREE uniform 对象
    */ _this.uniforms = {};
+        _this.macrosDirty = true;
         var shader = props == null ? void 0 : props.shader;
         var level = engine.gpuCapability.level;
         _this.shader = new exports.Shader(engine);
@@ -31741,15 +31655,20 @@ var _obj3;
         var uniform = new THREE__namespace.Uniform(value);
         this.uniforms[name] = this.material.uniforms[name] = uniform;
     };
-    // 下列三个方法暂时不需要实现
-    _proto.enableMacro = function enableMacro(keyword) {
-        throw new Error("Method not implemented.");
+    _proto.enableMacro = function enableMacro(keyword, value) {
+        if (!this.isMacroEnabled(keyword) || this.enabledMacros[keyword] !== value) {
+            this.enabledMacros[keyword] = value != null ? value : true;
+            this.macrosDirty = true;
+        }
     };
     _proto.disableMacro = function disableMacro(keyword) {
-        throw new Error("Method not implemented.");
+        if (this.isMacroEnabled(keyword)) {
+            delete this.enabledMacros[keyword];
+            this.macrosDirty = true;
+        }
     };
     _proto.isMacroEnabled = function isMacroEnabled(keyword) {
-        throw new Error("Method not implemented.");
+        return this.enabledMacros[keyword] !== undefined;
     };
     _proto.clone = function clone(props) {
         //FIXME: 暂时不实现
@@ -33072,7 +32991,7 @@ setMaxSpriteMeshItemCount(8);
  */ Mesh.create = function(engine, props) {
     return new ThreeMesh(engine, props);
 };
-var version = "2.2.0-alpha.0";
+var version = "2.2.0";
 logger.info("THREEJS plugin version: " + version + ".");
 
 exports.AbstractPlugin = AbstractPlugin;
@@ -33126,7 +33045,6 @@ exports.HELP_LINK = HELP_LINK;
 exports.InteractLoader = InteractLoader;
 exports.InteractMesh = InteractMesh;
 exports.KTXTexture = KTXTexture;
-exports.LOAD_PREFER_IMAGE_BITMAP = LOAD_PREFER_IMAGE_BITMAP;
 exports.LineSegments = LineSegments;
 exports.LinearValue = LinearValue;
 exports.Material = Material;
@@ -33203,7 +33121,6 @@ exports.base64ToFile = base64ToFile;
 exports.blend = blend;
 exports.calculateTranslation = calculateTranslation;
 exports.canvasPool = canvasPool;
-exports.closeImageBitMap = closeImageBitMap;
 exports.colorGradingFrag = colorGradingFrag;
 exports.colorStopsFromGradient = colorStopsFromGradient;
 exports.colorToArr = colorToArr$1;
@@ -33282,7 +33199,6 @@ exports.loadAVIFOptional = loadAVIFOptional;
 exports.loadBinary = loadBinary;
 exports.loadBlob = loadBlob;
 exports.loadImage = loadImage;
-exports.loadImageBitmap = loadImageBitmap;
 exports.loadMedia = loadMedia;
 exports.loadVideo = loadVideo;
 exports.loadWebPOptional = loadWebPOptional;