@galacean/effects-plugin-model 2.3.0-alpha.2 → 2.3.0-beta.0

package/dist/loader.mjs

@@ -3,11 +3,11 @@
  * Description: Galacean Effects player model plugin
  * Author: Ant Group CO., Ltd.
  * Contributors: 飂兮
- * Version: v2.3.0-alpha.2
+ * Version: v2.3.0-beta.0
  */
 
 import * as EFFECTS from '@galacean/effects';
-import { math, Transform, spec, PLAYER_OPTIONS_ENV_EDITOR, glContext, Material, Mesh, Geometry, ShaderFactory, effectsClass, VFXItem, GLSLVersion, Behaviour, AbstractPlugin, registerPlugin, logger, RendererComponent, HitTestType, AnimationClip, TextureSourceType, Texture, RenderPass, TextureLoadAction, DestroyOptions, RenderPassDestroyAttachmentType, getDefaultTextureFactory, Player, loadImage, Renderer, generateGUID, addItem, removeItem, glType2VertexFormatType, Downloader, getStandardJSON, isObject } from '@galacean/effects';
+import { math, Transform, spec, PLAYER_OPTIONS_ENV_EDITOR, glContext, Material, Mesh, Geometry, ShaderFactory, effectsClass, VFXItem, GLSLVersion, Behaviour, AbstractPlugin, registerPlugin, logger, RendererComponent, HitTestType, AnimationClip, TextureSourceType, Texture, RenderPass, TextureLoadAction, DestroyOptions, RenderPassDestroyAttachmentType, getDefaultTextureFactory, Player, loadImage, generateGUID, addItem, removeItem, glType2VertexFormatType, Downloader, getStandardJSON, isObject } from '@galacean/effects';
 
 var Vector2 = math.Vector2, Vector3 = math.Vector3, Vector4 = math.Vector4, Matrix3 = math.Matrix3, Matrix4 = math.Matrix4, Color = math.Color, Euler = math.Euler, EulerOrder = math.EulerOrder, Quaternion = math.Quaternion, Box3 = math.Box3; math.Sphere; math.Ray; var DEG2RAD = math.DEG2RAD;
 
@@ -1370,8 +1370,6 @@ function getQuadFilterVS() {
         var engine = composition.renderer.engine;
         this.cache = new CompositionCache(engine);
         this.cache.setup(false);
-    // FIXME: 先注释元素参数的配置
-    //PluginHelper.setupItem3DOptions(scene, this.cache, composition);
     };
     /**
    * 每次播放都会执行，包括重播，所以这里执行“小的销毁”和新的初始化
@@ -2098,7 +2096,7 @@ var CameraGestureHandlerImp = /*#__PURE__*/ function() {
 registerPlugin("model", ModelPlugin, VFXItem);
 /**
  * 插件版本号
- */ var version = "2.3.0-alpha.2";
+ */ var version = "2.3.0-beta.0";
 logger.info("Plugin model version: " + version + ".");
 if (version !== EFFECTS.version) {
     console.error("注意：请统一 Model 插件与 Player 版本，不统一的版本混用会有不可预知的后果！", "\nAttention: Please ensure the Model plugin is synchronized with the Player version. Mixing and matching incompatible versions may result in unpredictable consequences!");
@@ -3789,86 +3787,6 @@ var normal = new Vector3();
         }
     };
     /**
-   * 设置 3D 元素参数，在播放器创建 3D 元素前
-   * @param scene - 场景
-   * @param cache - 缓存
-   * @param composition - 合成
-   * @returns
-   */ PluginHelper.setupItem3DOptions = function setupItem3DOptions(scene, cache, composition) {
-        var _this = this;
-        if (scene === undefined || scene.bins.length <= 0) {
-            return;
-        }
-        var jsonScene = scene.jsonScene;
-        var compIndexSet = new Set();
-        if (jsonScene.compositionId === undefined) {
-            compIndexSet.add(0);
-        }
-        jsonScene.compositions.forEach(function(comp, index) {
-            if (comp.id === jsonScene.compositionId || composition.refCompositionProps.has(comp.id)) {
-                compIndexSet.add(index);
-            }
-        });
-        compIndexSet.forEach(function(compIndex) {
-            var sceneComp = jsonScene.compositions[compIndex];
-            sceneComp.items.forEach(function(data) {
-                var itemId = data.id;
-                var item = composition.getEngine().jsonSceneData[itemId];
-                if (item.type === spec.ItemType.mesh) {
-                    var meshItem = item;
-                    var skin = meshItem.content.options.skin;
-                    var primitives = meshItem.content.options.primitives;
-                    primitives.forEach(function(prim, primId) {
-                        if (_instanceof1(prim.geometry, Geometry)) {
-                            // 可能已经创建，直接返回
-                            return;
-                        }
-                        var name = "Geom_C" + compIndex + "_I" + itemId + "_P" + primId;
-                        var riGeometry = cache.getOrCreateGeometry(name, prim.geometry, scene.bins);
-                        var studioPrim = prim;
-                        studioPrim.geometry = riGeometry;
-                        var material = prim.material;
-                        if (material.type === spec.MaterialType.pbr) {
-                            var studioMat = studioPrim.material;
-                            studioMat.baseColorTexture = _this.getTextureObj(composition.textures, material.baseColorTexture);
-                            studioMat.metallicRoughnessTexture = _this.getTextureObj(composition.textures, material.metallicRoughnessTexture);
-                            studioMat.normalTexture = _this.getTextureObj(composition.textures, material.normalTexture);
-                            studioMat.occlusionTexture = _this.getTextureObj(composition.textures, material.occlusionTexture);
-                            studioMat.emissiveTexture = _this.getTextureObj(composition.textures, material.emissiveTexture);
-                        } else {
-                            var studioMat1 = studioPrim.material;
-                            studioMat1.baseColorTexture = _this.getTextureObj(composition.textures, material.baseColorTexture);
-                        }
-                    });
-                    if (skin !== undefined && skin.inverseBindMatrices !== undefined) {
-                        var studioSkin = skin;
-                        var inverseBindMatrices = typedArrayFromBinary(scene.bins, skin.inverseBindMatrices);
-                        if (_instanceof1(inverseBindMatrices, Float32Array)) {
-                            studioSkin.inverseBindMatrices = inverseBindMatrices;
-                        } else {
-                            console.error("setupItem3DOptions: Invalid inverseBindMatrices type, " + inverseBindMatrices + ".");
-                        }
-                    }
-                } else if (item.type === spec.ItemType.skybox) {
-                    var skybox = item;
-                    var studioSkybox = item;
-                    var options = skybox.content.options;
-                    var studioOptions = studioSkybox.content.options;
-                    var specularImage = _this.getTextureObj(composition.textures, options.specularImage);
-                    if (specularImage === undefined) {
-                        console.error("setupItem3DOptions: skybox specualrImage is undefined, " + CheckerHelper.stringify(options) + ".");
-                    }
-                    studioOptions.specularImage = specularImage;
-                    //
-                    var diffuseImage = _this.getTextureObj(composition.textures, options.diffuseImage);
-                    if (diffuseImage !== undefined) {
-                        studioOptions.diffuseImage = diffuseImage;
-                    }
-                }
-            });
-        });
-    };
-    /**
    * 创建几何体，根据几何参数描述 JSON 和数据数组
    * @param engine - 引擎
    * @param geomJson - 几何参数描述 JSON
@@ -4483,863 +4401,6 @@ var AttributeArray = /*#__PURE__*/ function() {
     };
     return HitTestingProxy;
 }();
-/**
- * 检查辅助类，负责 3D 插件元素数据格式检查和报错
- */ var CheckerHelper = /*#__PURE__*/ function() {
-    function CheckerHelper() {}
-    /**
-   * 检查数值
-   * @param v - 数值
-   * @returns
-   */ CheckerHelper.checkNumber = function checkNumber(v) {
-        return typeof v === "number";
-    };
-    /**
-   * 检查数值或未定义
-   * @param v - 数值或未定义
-   * @returns
-   */ CheckerHelper.checkNumberUndef = function checkNumberUndef(v) {
-        return v === undefined ? true : this.checkNumber(v);
-    };
-    /**
-   * 检查 0 和 1 之间数值
-   * @param v - 数值
-   * @returns
-   */ CheckerHelper.checkNumber01 = function checkNumber01(v) {
-        return this.checkNumber(v) && v >= 0 && v <= 1;
-    };
-    /**
-   * 检查 0 和 1 之间数值或未定义
-   * @param v - 数值或未定义
-   * @returns
-   */ CheckerHelper.checkNumber01Undef = function checkNumber01Undef(v) {
-        return v === undefined ? true : this.checkNumber01(v);
-    };
-    /**
-   * 检查正数
-   * @param v - 数值
-   * @returns
-   */ CheckerHelper.checkPositive = function checkPositive(v) {
-        return this.checkNumber(v) && v > 0;
-    };
-    /**
-   * 检查非负数
-   * @param v - 数值
-   * @returns
-   */ CheckerHelper.checkNonnegative = function checkNonnegative(v) {
-        return this.checkNumber(v) && v >= 0;
-    };
-    /**
-   * 检查非负数或未定义
-   * @param v - 数值
-   * @returns
-   */ CheckerHelper.checkNonnegativeUndef = function checkNonnegativeUndef(v) {
-        return v === undefined ? true : this.checkNonnegative(v);
-    };
-    /**
-   * 检查布尔类型
-   * @param v - 布尔值
-   * @returns
-   */ CheckerHelper.checkBoolean = function checkBoolean(v) {
-        return typeof v === "boolean";
-    };
-    /**
-   * 检查布尔类型或未定义
-   * @param v - 布尔值或未定义
-   * @returns
-   */ CheckerHelper.checkBooleanUndef = function checkBooleanUndef(v) {
-        return v === undefined ? true : this.checkBoolean(v);
-    };
-    /**
-   * 检查字符串类型
-   * @param v - 字符串
-   * @returns
-   */ CheckerHelper.checkString = function checkString(v) {
-        return typeof v === "string";
-    };
-    /**
-   * 检查字符串类型或未定义
-   * @param v - 字符串或未定义
-   * @returns
-   */ CheckerHelper.checkStringUndef = function checkStringUndef(v) {
-        return v === undefined ? true : this.checkString(v);
-    };
-    /**
-   * 检查浮点数组
-   * @param v - 浮点数组
-   * @returns
-   */ CheckerHelper.checkFloat32Array = function checkFloat32Array(v) {
-        return _instanceof1(v, Float32Array);
-    };
-    /**
-   * 检查浮点数组或未定义
-   * @param v - 浮点数组或未定义
-   * @returns
-   */ CheckerHelper.checkFloat32ArrayUndef = function checkFloat32ArrayUndef(v) {
-        return v === undefined ? true : this.checkFloat32Array(v);
-    };
-    /**
-   * 检查父节点索引
-   * @param v - 数值或未定义
-   * @returns
-   */ CheckerHelper.checkParent = function checkParent(v) {
-        if (v === undefined) {
-            return true;
-        }
-        if (!this.checkNumber(v)) {
-            return false;
-        }
-        return v >= 0;
-    };
-    /**
-   * 检查纹理坐标
-   * @param v - 纹理坐标或未定义
-   * @returns
-   */ CheckerHelper.checkTexCoord = function checkTexCoord(v) {
-        if (v === undefined) {
-            return true;
-        }
-        if (!this.checkNumber(v)) {
-            return false;
-        }
-        return v >= 0 && v <= 1;
-    };
-    /**
-   * 检查二维向量
-   * @param v - 二维向量
-   * @returns
-   */ CheckerHelper.checkVec2 = function checkVec2(v) {
-        var _this = this;
-        if (!Array.isArray(v)) {
-            return false;
-        }
-        if (v.length != 2) {
-            return false;
-        }
-        return v.every(function(v) {
-            return _this.checkNumber(v);
-        });
-    };
-    /**
-   * 检查二维向量或未定义
-   * @param v - 二维向量或未定义
-   * @returns
-   */ CheckerHelper.checkVec2Undef = function checkVec2Undef(v) {
-        return v === undefined ? true : this.checkVec2(v);
-    };
-    /**
-   * 检查三维向量
-   * @param v - 三维向量
-   * @returns
-   */ CheckerHelper.checkVec3 = function checkVec3(v) {
-        var _this = this;
-        if (!Array.isArray(v)) {
-            return false;
-        }
-        if (v.length != 3) {
-            return false;
-        }
-        return v.every(function(v) {
-            return _this.checkNumber(v);
-        });
-    };
-    /**
-   * 检查三维非负向量
-   * @param v - 三维向量
-   * @returns
-   */ CheckerHelper.checkNonnegative3 = function checkNonnegative3(v) {
-        var _this = this;
-        if (!Array.isArray(v)) {
-            return false;
-        }
-        if (v.length != 3) {
-            return false;
-        }
-        return v.every(function(v) {
-            return _this.checkNonnegative(v);
-        });
-    };
-    /**
-   * 检查四维向量
-   * @param v - 四维向量
-   * @returns
-   */ CheckerHelper.checkVec4 = function checkVec4(v) {
-        var _this = this;
-        if (!Array.isArray(v)) {
-            return false;
-        }
-        if (v.length != 4) {
-            return false;
-        }
-        return v.every(function(v) {
-            return _this.checkNumber(v);
-        });
-    };
-    /**
-   * 检查四维向量或未定义
-   * @param v - 四维向量或未定义
-   * @returns
-   */ CheckerHelper.checkNonnegative4 = function checkNonnegative4(v) {
-        var _this = this;
-        if (!Array.isArray(v)) {
-            return false;
-        }
-        if (v.length != 4) {
-            return false;
-        }
-        return v.every(function(v) {
-            return _this.checkNonnegative(v);
-        });
-    };
-    /**
-   * 检查数值数组
-   * @param v - 数值数组
-   * @returns
-   */ CheckerHelper.checkNumberArray = function checkNumberArray(v) {
-        var _this = this;
-        if (!Array.isArray(v)) {
-            return false;
-        }
-        return v.every(function(v) {
-            return _this.checkNumber(v);
-        });
-    };
-    /**
-   * 检查纹理对象
-   * @param v - 纹理对象
-   * @returns
-   */ CheckerHelper.checkTexture = function checkTexture(v) {
-        if (_instanceof1(v, Texture)) {
-            if (v.isDestroyed) {
-                console.error("Texture is destroyed, " + v.name + ".");
-            }
-            return !v.isDestroyed;
-        } else {
-            return false;
-        }
-    };
-    /**
-   * 检查纹理对象或未定义
-   * @param v - 纹理对象或未定义
-   * @returns
-   */ CheckerHelper.checkTextureUndef = function checkTextureUndef(v) {
-        return v === undefined ? true : this.checkTexture(v);
-    };
-    /**
-   * 检查纹理变换参数
-   * @param v - 纹理变换参数
-   * @returns
-   */ CheckerHelper.checkTexTransform = function checkTexTransform(v) {
-        if (!this.checkVec2Undef(v.offset)) {
-            return false;
-        }
-        if (!this.checkNumberUndef(v.rotation)) {
-            return false;
-        }
-        if (!this.checkVec2Undef(v.scale)) {
-            return false;
-        }
-        if (v.scale !== undefined) {
-            if (Math.abs(v.scale[0]) < 1e-5 || Math.abs(v.scale[1]) < 1e-5) {
-                // check scale range
-                return false;
-            }
-        }
-        return true;
-    };
-    /**
-   * 检查纹理变换参数或未定义
-   * @param v - 纹理变换参数或未定义
-   * @returns
-   */ CheckerHelper.checkTexTransformUndef = function checkTexTransformUndef(v) {
-        return v === undefined ? true : this.checkTexTransform(v);
-    };
-    /**
-   * 检查材质混合参数或未定义
-   * @param v - 材质混合参数或未定义
-   * @returns
-   */ CheckerHelper.checkMatBlending = function checkMatBlending(v) {
-        return v === undefined || v === spec.MaterialBlending.opaque || v === spec.MaterialBlending.masked || v === spec.MaterialBlending.translucent || v === spec.MaterialBlending.additive;
-    };
-    /**
-   * 检查材质单双面模式或未定义
-   * @param v - 材质单双面模式或未定义
-   * @returns
-   */ CheckerHelper.checkMatSide = function checkMatSide(v) {
-        return v === undefined || v === spec.SideMode.BACK || v === spec.SideMode.DOUBLE || v === spec.SideMode.FRONT;
-    };
-    /**
-   * 检查动画路径模式
-   * @param v - 动画路径模式
-   * @returns
-   */ CheckerHelper.checkAnimPath = function checkAnimPath(v) {
-        return v === "translation" || v === "rotation" || v === "scale" || v === "weights";
-    };
-    /**
-   * 检查动画插值模式
-   * @param v - 动画插值模式
-   * @returns
-   */ CheckerHelper.checkAnimInterp = function checkAnimInterp(v) {
-        return v === "LINEAR" || v === "STEP" || v === "CUBICSPLINE";
-    };
-    /**
-   * 检查几何体
-   * @param v - 几何体
-   * @param s - 蒙皮参数
-   */ CheckerHelper.assertGeometry = function assertGeometry(v, s) {
-        if (!_instanceof1(v, Geometry)) {
-            console.error("Invalid geometry type " + this.stringify(v) + ".");
-        }
-        // @ts-expect-error
-        if (v.isDestroyed === true) {
-            console.error("Geometry object is destroyed.");
-        }
-        if (!this.checkNonnegative(v.getDrawStart())) {
-            console.error("Invalid geometry draw start: " + v.getDrawStart() + ", " + this.stringify(v) + ".");
-        }
-    // // drawCount不再为负
-    // if (!this.checkPositive(v.getDrawCount())) {
-    //   throw new Error(`Invalid geometry draw count: ${v.getDrawCount()}, ${this.stringify(v)}`);
-    // }
-    // Geometry具体内容检查，先忽略
-    // const opts = v.options;
-    // const drawCount = Math.abs(v.getDrawCount());
-    // if (opts !== undefined && drawCount > 0) {
-    //   let maxLength = v.drawStart + drawCount;
-    //   if (opts.index !== undefined) {
-    //     const indexArray = opts.index.data;
-    //     if (indexArray.length < maxLength) {
-    //       throw new Error(`Index length(${indexArray.length}) is less than draw count(${maxLength}), ${this.stringify(v)}`);
-    //     }
-    //     let maxIndex = 0;
-    //     for (let i = 0; i < drawCount; i++) {
-    //       maxIndex = Math.max(indexArray[v.drawStart + i], maxIndex);
-    //     }
-    //     maxLength = maxIndex + 1;
-    //   }
-    //   const positionAttrib = opts.attributes['aPos'] as Attribute;
-    //   if (positionAttrib === undefined) {
-    //     throw new Error(`Position attribute is required, ${this.stringify(v)}`);
-    //   }
-    //   this.assertGeometryBuffer(v, 'aPos', maxLength);
-    //   this.assertGeometryBuffer(v, 'aNormal', maxLength);
-    //   this.assertGeometryBuffer(v, 'aTangent', maxLength);
-    //   this.assertGeometryBuffer(v, 'aUV', maxLength);
-    //   this.assertGeometryBuffer(v, 'aJoints', maxLength);
-    //   this.assertGeometryBuffer(v, 'aWeights', maxLength);
-    //   // 索引检查
-    //   if(s !== undefined){
-    //     const matLen = s.inverseBindMatrices?.length ?? 0;
-    //     if(matLen > 0){
-    //       const jointArray = this.createAttributeArray(v, "aJoints");
-    //       if(jointArray !== undefined){
-    //         for(let i = 0; i < maxLength; i++){
-    //           const data = jointArray.getData(i);
-    //           if(data === undefined) continue;
-    //           if(Math.max(...data) >= matLen){
-    //             throw new Error(`Joint index out of range: ${this.stringify(data)}, matrices: ${matLen}`);
-    //           }
-    //         }
-    //       }
-    //     }
-    //   }
-    // }
-    };
-    /**
-   * 检查几何体缓冲区
-   * @param v - 几何体
-   * @param name - 名称
-   * @param drawCount - 渲染数目
-   */ CheckerHelper.assertGeometryBuffer = function assertGeometryBuffer(v, name, drawCount) {
-        var attribArray = this.createAttributeArray(v, name);
-        if (attribArray !== undefined) {
-            if (attribArray.getLength() < drawCount) {
-                console.error(name + " Length(" + attribArray.getLength() + ") is less than draw count(" + drawCount + "), " + this.stringify(v) + ".");
-            }
-        }
-    };
-    /**
-   * 创建属性数组
-   * @param v - 几何体
-   * @param name - 名称
-   * @returns
-   */ CheckerHelper.createAttributeArray = function createAttributeArray(v, name) {
-        // @ts-expect-error
-        var attributes = v.attributes;
-        if (attributes === undefined) {
-            return;
-        }
-        var dataAttrib = attributes[name];
-        if (dataAttrib === undefined) {
-            return;
-        }
-        var dataArray = v.getAttributeData(name);
-        if (dataArray === undefined) {
-            return;
-        }
-        //
-        var attribArray = new AttributeArray();
-        attribArray.create(dataAttrib, dataArray);
-        return attribArray;
-    };
-    /**
-   * 检查蒙皮参数
-   * @param v - 蒙皮参数
-   */ CheckerHelper.assertModelSkinOptions = function assertModelSkinOptions(v) {
-        if (!this.checkStringUndef(v.name)) {
-            console.error("Invalid skin name " + v.name + ", " + this.stringify(v) + ".");
-        }
-        if (!this.checkNumberArray(v.joints)) {
-            console.error("Invalid skin joints " + v.joints + ", " + this.stringify(v) + ".");
-        }
-        if (!this.checkNumberUndef(v.skeleton)) {
-            console.error("Invalid skin skeleton " + v.skeleton + ", " + this.stringify(v) + ".");
-        }
-        if (!this.checkFloat32ArrayUndef(v.inverseBindMatrices)) {
-            console.error("Invalid skin inverseBindMatrices " + v.inverseBindMatrices + ", " + this.stringify(v) + ".");
-        }
-        //
-        if (v.inverseBindMatrices !== undefined) {
-            if (v.inverseBindMatrices.length <= 0 || v.inverseBindMatrices.length % 16 !== 0) {
-                console.error("Invalid skin inverseBindMatrices length " + v.inverseBindMatrices + ", " + this.stringify(v) + ".");
-            }
-            if (v.joints.length * 16 !== v.inverseBindMatrices.length) {
-                console.error("Mismatch: skin joints and inverseBindMatrices length, " + v.joints + ", " + v.inverseBindMatrices + ", " + this.stringify(v) + ".");
-            }
-            var mat = new Matrix4();
-            for(var i = 0; i < v.inverseBindMatrices.length; i += 16){
-                for(var j = 0; j < 16; j++){
-                    mat.elements[j] = v.inverseBindMatrices[i + j];
-                }
-                if (Math.abs(mat.determinant()) < 1e-5) {
-                    console.error("Determinant of inverseBindMatrices is too small " + mat.determinant() + ", index " + i / 16 + ", " + this.stringify(v) + ".");
-                }
-            }
-        } else {
-            if (v.joints.length <= 0) {
-                console.error("Invalid skin joints length " + v.joints + ", " + this.stringify(v) + ".");
-            }
-        }
-    };
-    /**
-   * 检查材质参数
-   * @param v - 材质参数
-   */ CheckerHelper.assertMatOptions = function assertMatOptions(v) {
-        if (v.type === spec.MaterialType.unlit) {
-            if (!this.checkString(v.name)) {
-                console.error("Invalid material name " + v.name + ", " + this.stringify(v) + ".");
-            }
-            //
-            if (!this.checkNonnegative4(v.baseColorFactor)) {
-                console.error("Invalid material baseColorFactor " + v.baseColorFactor + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkTextureUndef(v.baseColorTexture)) {
-                console.error("Invalid material baseColorTexture " + v.baseColorTexture + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkTexTransformUndef(v.baseColorTextureTransform)) {
-                console.error("Invalid material baseColorTextureTransform " + v.baseColorTextureTransform + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkTexCoord(v.baseColorTextureCoordinate)) {
-                console.error("Invalid material baseColorTextureCoordinate " + v.baseColorTextureCoordinate + ", " + this.stringify(v) + ".");
-            }
-            //
-            if (!this.checkBooleanUndef(v.depthMask)) {
-                console.error("Invalid material depthMask " + v.depthMask + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkMatBlending(v.blending)) {
-                console.error("Invalid material blending " + v.blending + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkMatSide(v.side)) {
-                console.error("Invalid material side " + v.side + ", " + this.stringify(v) + ".");
-            }
-            if (v.blending === spec.MaterialBlending.masked) {
-                if (v.alphaCutOff === undefined) {
-                    console.error("Material alphaCutOff is required for mask, " + this.stringify(v) + ".");
-                }
-            }
-            if (!this.checkNumber01Undef(v.alphaCutOff)) {
-                console.error("Invalid material alphaCutOff " + v.alphaCutOff + ", " + this.stringify(v) + ".");
-            }
-        } else if (v.type === spec.MaterialType.pbr) {
-            if (!this.checkString(v.name)) {
-                console.error("Invalid material name " + v.name + ", " + this.stringify(v) + ".");
-            }
-            //
-            if (!this.checkNonnegative4(v.baseColorFactor)) {
-                console.error("Invalid material baseColorFactor " + v.baseColorFactor + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkTextureUndef(v.baseColorTexture)) {
-                console.error("Invalid material baseColorTexture " + v.baseColorTexture + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkTexTransformUndef(v.baseColorTextureTransform)) {
-                console.error("Invalid material baseColorTextureTransform " + v.baseColorTextureTransform + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkTexCoord(v.baseColorTextureCoordinate)) {
-                console.error("Invalid material baseColorTextureCoordinate " + v.baseColorTextureCoordinate + ", " + this.stringify(v) + ".");
-            }
-            //
-            if (!this.checkBooleanUndef(v.useSpecularAA)) {
-                console.error("Invalid material useSpecularAA " + v.useSpecularAA + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkNumber01(v.metallicFactor)) {
-                console.error("Invalid material metallicFactor " + v.metallicFactor + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkNonnegative(v.roughnessFactor)) {
-                console.error("Invalid material roughnessFactor " + v.roughnessFactor + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkTextureUndef(v.metallicRoughnessTexture)) {
-                console.error("Invalid material metallicRoughnessTexture " + v.metallicRoughnessTexture + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkTexTransformUndef(v.metallicRoughnessTextureTransform)) {
-                console.error("Invalid material metallicRoughnessTextureTransform " + v.metallicRoughnessTextureTransform + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkTexCoord(v.metallicRoughnessTextureCoordinate)) {
-                console.error("Invalid material metallicRoughnessTextureCoordinate " + v.metallicRoughnessTextureCoordinate + ", " + this.stringify(v) + ".");
-            }
-            //
-            if (!this.checkTextureUndef(v.normalTexture)) {
-                console.error("Invalid material normalTexture " + v.normalTexture + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkNonnegativeUndef(v.normalTextureScale)) {
-                console.error("Invalid material normalTextureScale " + v.normalTextureScale + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkTexTransformUndef(v.normalTextureTransform)) {
-                console.error("Invalid material normalTextureTransform " + v.normalTextureTransform + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkTexCoord(v.normalTextureCoordinate)) {
-                console.error("Invalid material normalTextureCoordinate " + v.normalTextureCoordinate + ", " + this.stringify(v) + ".");
-            }
-            //
-            if (!this.checkTextureUndef(v.occlusionTexture)) {
-                console.error("Invalid material occlusionTexture " + v.occlusionTexture + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkNumber01Undef(v.occlusionTextureStrength)) {
-                console.error("Invalid material occlusionTextureStrength " + v.occlusionTextureStrength + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkTexTransformUndef(v.occlusionTextureTransform)) {
-                console.error("Invalid material occlusionTextureTransform " + v.occlusionTextureTransform + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkTexCoord(v.occlusionTextureCoordinate)) {
-                console.error("Invalid material occlusionTextureCoordinate " + v.occlusionTextureCoordinate + ", " + this.stringify(v) + ".");
-            }
-            //
-            //
-            if (!this.checkNonnegative4(v.emissiveFactor)) {
-                console.error("Invalid material emissiveFactor " + v.emissiveFactor + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkNonnegative(v.emissiveIntensity)) {
-                console.error("Invalid material emissiveIntensity " + v.emissiveIntensity + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkTextureUndef(v.emissiveTexture)) {
-                console.error("Invalid material emissiveTexture " + v.emissiveTexture + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkTexTransformUndef(v.emissiveTextureTransform)) {
-                console.error("Invalid material emissiveTextureTransform " + v.emissiveTextureTransform + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkTexCoord(v.emissiveTextureCoordinate)) {
-                console.error("Invalid material emissiveTextureCoordinate " + v.emissiveTextureCoordinate + ", " + this.stringify(v) + ".");
-            }
-            //
-            if (!this.checkBooleanUndef(v.depthMask)) {
-                console.error("Invalid material depthMask " + v.depthMask + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkMatBlending(v.blending)) {
-                console.error("Invalid material blending " + v.blending + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkMatSide(v.side)) {
-                console.error("Invalid material side " + v.side + ", " + this.stringify(v) + ".");
-            }
-            if (v.blending === spec.MaterialBlending.masked) {
-                if (v.alphaCutOff === undefined) {
-                    console.error("Material alphaCutOff is required for mask, " + this.stringify(v) + ".");
-                }
-            }
-            if (!this.checkNumber01Undef(v.alphaCutOff)) {
-                console.error("Invalid material alphaCutOff " + v.alphaCutOff + ", " + this.stringify(v) + ".");
-            }
-        } else {
-            console.error("Invalid material type " + this.stringify(v) + ".");
-        }
-    };
-    /**
-   * 检查 Primitive 参数
-   * @param v - Primitive 参数
-   * @param s - 蒙皮参数
-   * @returns
-   */ CheckerHelper.assertPrimOptions = function assertPrimOptions(v, s) {
-        this.assertGeometry(v.geometry, s);
-        this.assertMatOptions(v.material);
-        return true;
-    };
-    /**
-   * 检查 Model 插件 Mesh 参数
-   * @param v - Model 插件 Mesh 参数
-   */ CheckerHelper.assertModelMeshOptions = function assertModelMeshOptions(v) {
-        if (!this.checkParent(v.parent)) {
-            console.error("Invalid mesh parent " + v.parent + ", " + this.stringify(v) + ".");
-        }
-        if (v.skin !== undefined) {
-            this.assertModelSkinOptions(v.skin);
-        }
-        var morphList = [];
-        for(var i = 0; i < v.primitives.length; i++){
-            var prim = v.primitives[i];
-            if (!this.assertPrimOptions(prim)) {
-                console.error("Invalid primitive " + prim + ", " + this.stringify(v) + ".");
-            }
-            var morph = new PMorph();
-            morph.create(prim.geometry);
-            morphList.push(morph);
-        }
-        for(var i1 = 1; i1 < morphList.length; i1++){
-            var morph0 = morphList[i1 - 1];
-            var morph1 = morphList[i1];
-            if (!morph0.equals(morph1)) {
-                console.error("Morph states mismatch: " + this.stringify(morph0) + ", " + this.stringify(morph1) + ", " + this.stringify(v) + ".");
-            }
-        }
-        if (!this.checkBooleanUndef(v.hide)) {
-            console.error("Invalid mesh hide " + v.hide + ", " + this.stringify(v) + ".");
-        }
-    };
-    /**
-   * 检查 Model 插件相机参数
-   * @param v - Model 插件相机参数
-   */ CheckerHelper.assertModelCameraOptions = function assertModelCameraOptions(v) {
-        if (!this.checkParent(v.parent)) {
-            console.error("Invalid camera parent " + v.parent + ", " + this.stringify(v) + ".");
-        }
-        if (!this.checkNumberUndef(v.aspect)) {
-            console.error("Invalid camera aspect " + v.aspect + ", " + this.stringify(v) + ".");
-        }
-        if (!this.checkPositive(v.near)) {
-            console.error("Invalid camera near " + v.near + ", " + this.stringify(v) + ".");
-        }
-        if (!this.checkPositive(v.far) || v.far <= v.near) {
-            console.error("Invalid camera far " + v.far + ", " + this.stringify(v) + ".");
-        }
-        if (!this.checkPositive(v.fov)) {
-            console.error("Invalid camera fov " + v.fov + ", " + this.stringify(v) + ".");
-        }
-        if (!this.checkNumber01(v.clipMode)) {
-            console.error("Invalid camera clipMode " + v.clipMode + ", " + this.stringify(v) + ".");
-        }
-    };
-    /**
-   * 检查 Model 插件灯光参数
-   * @param v - Model 插件灯光参数
-   */ CheckerHelper.assertModelLightOptions = function assertModelLightOptions(v) {
-        if (v.lightType === "directional") {
-            if (!this.checkParent(v.parent)) {
-                console.error("Invalid light parent " + v.parent + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkNonnegative4(v.color)) {
-                console.error("Invalid light color " + v.color + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkNonnegative(v.intensity)) {
-                console.error("Invalid light intensity " + v.intensity + ", " + this.stringify(v) + ".");
-            }
-        } else if (v.lightType === "point") {
-            if (!this.checkParent(v.parent)) {
-                console.error("Invalid light parent " + v.parent + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkNonnegative4(v.color)) {
-                console.error("Invalid light color " + v.color + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkNonnegative(v.intensity)) {
-                console.error("Invalid light intensity " + v.intensity + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkNonnegative(v.range)) {
-                console.error("Invalid light range " + v.range + ", " + this.stringify(v) + ".");
-            }
-        } else if (v.lightType === "spot") {
-            if (!this.checkParent(v.parent)) {
-                console.error("Invalid light parent " + v.parent + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkNonnegative4(v.color)) {
-                console.error("Invalid light color " + v.color + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkNonnegative(v.intensity)) {
-                console.error("Invalid light intensity " + v.intensity + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkNonnegative(v.range)) {
-                console.error("Invalid light range " + v.range + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkNonnegative(v.innerConeAngle)) {
-                console.error("Invalid light innerConeAngle " + v.innerConeAngle + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkNonnegative(v.outerConeAngle)) {
-                console.error("Invalid light outerConeAngle " + v.outerConeAngle + ", " + this.stringify(v) + ".");
-            }
-        } else if (v.lightType === "ambient") {
-            if (!this.checkParent(v.parent)) {
-                console.error("Invalid light parent " + v.parent + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkNonnegative4(v.color)) {
-                console.error("Invalid light color " + v.color + ", " + this.stringify(v) + ".");
-            }
-            if (!this.checkNonnegative(v.intensity)) {
-                console.error("Invalid light intensity " + v.intensity + ", " + this.stringify(v) + ".");
-            }
-        } else {
-            console.error("Invalid light type " + this.stringify(v) + ".");
-        }
-    };
-    /**
-   * 检查 Model 插件天空盒参数
-   * @param v - Model 插件天空盒参数
-   */ CheckerHelper.assertModelSkyboxOptions = function assertModelSkyboxOptions(v) {
-        var _this = this;
-        if (!this.checkBoolean(v.renderable)) {
-            console.error("Invalid skybox renderable " + v.renderable + ", " + this.stringify(v) + ".");
-        }
-        if (!this.checkNonnegative(v.intensity)) {
-            console.error("Invalid skybox intensity " + v.intensity + ", " + this.stringify(v) + ".");
-        }
-        if (!this.checkNonnegative(v.reflectionsIntensity)) {
-            console.error("Invalid skybox reflectionsIntensity " + v.reflectionsIntensity + ", " + this.stringify(v) + ".");
-        }
-        //
-        var c = v.irradianceCoeffs;
-        if (c !== undefined) {
-            if (!Array.isArray(c) || c.length != 9) {
-                console.error("Invalid skybox irradianceCoeffs " + c + ", " + this.stringify(v) + ".");
-            }
-            c.forEach(function(v) {
-                if (!_this.checkVec3(v)) {
-                    console.error("Invalid skybox irradianceCoeffs " + c + ", " + _this.stringify(v) + ".");
-                }
-            });
-        } else if (v.diffuseImage !== undefined) {
-            if (!this.checkTexture(v.diffuseImage)) {
-                console.error("Invalid skybox diffuseImage " + v.diffuseImage + ", " + this.stringify(v) + ".");
-            }
-        } else {
-            console.error("Invalid skybox, irradianceCoeffs or diffuseImage should give one, " + this.stringify(v) + ".");
-        }
-        if (!this.checkTexture(v.specularImage)) {
-            console.error("Invalid skybox specularImage " + v.specularImage + ", " + this.stringify(v) + ".");
-        }
-        if (!this.checkPositive(v.specularImageSize)) {
-            console.error("Invalid skybox specularImageSize " + v.specularImageSize + ", " + this.stringify(v) + ".");
-        }
-        if (!this.checkPositive(v.specularMipCount)) {
-            console.error("Invalid skybox specularMipCount " + v.specularMipCount + ", " + this.stringify(v) + ".");
-        }
-        if (this.pow2(v.specularMipCount) > v.specularImageSize) {
-            console.error("Invalid skybox specularMipCount or specularImageSize, " + this.stringify(v) + ".");
-        }
-    };
-    /**
-   * 检查 Model 插件动画轨道参数
-   * @param v - Model 插件动画轨道参数
-   * @returns
-   */ CheckerHelper.checkModelAnimTrackOptions = function checkModelAnimTrackOptions(v) {
-        if (!this.checkNonnegative(v.node)) {
-            console.error("Invalid track node " + v.node + ", " + this.stringify(v));
-            return false;
-        }
-        if (!this.checkFloat32Array(v.input)) {
-            console.error("Invalid track input " + v.input + ", " + this.stringify(v));
-            return false;
-        }
-        if (!this.checkFloat32Array(v.output)) {
-            console.error("Invalid track input " + v.output + ", " + this.stringify(v));
-            return false;
-        }
-        if (!this.checkAnimPath(v.path)) {
-            console.error("Invalid track path " + v.path + ", " + this.stringify(v));
-            return false;
-        }
-        if (!this.checkAnimInterp(v.interpolation)) {
-            console.error("Invalid track interpolation " + v.interpolation + ", " + this.stringify(v));
-            return false;
-        }
-        return true;
-    };
-    /**
-   * 检查 Model 插件动画参数
-   * @param v - Model 插件动画参数
-   */ CheckerHelper.assertModelAnimOptions = function assertModelAnimOptions(v) {
-        var _this = this;
-        if (!this.checkStringUndef(v.name)) {
-            console.error("Invalid animation name " + v.name + ", " + this.stringify(v) + ".");
-        }
-        if (!Array.isArray(v.tracks)) {
-            console.error("Invalid animation tracks " + v.tracks + ", " + this.stringify(v) + ".");
-        }
-        v.tracks.forEach(function(t) {
-            if (!_this.checkModelAnimTrackOptions(t)) {
-                console.error("Invalid animation track " + t + ", " + _this.stringify(v) + ".");
-            }
-        });
-    };
-    /**
-   * 检查场景树参数
-   * @param v - 场景树参数
-   */ CheckerHelper.assertTreeOptions = function assertTreeOptions(v) {
-        var _this = this;
-        if (!this.checkNumberUndef(v.animation)) {
-            console.error("Invalid tree animation " + v.animation + ", " + this.stringify(v) + ".");
-        }
-        if (v.animations !== undefined) {
-            if (!Array.isArray(v.animations)) {
-                console.error("Invalid tree animations " + v.animations + ", " + this.stringify(v) + ".");
-            }
-            v.animations.forEach(function(anim) {
-                _this.assertModelAnimOptions(anim);
-            });
-            if (v.animation !== undefined) {
-                if (v.animation < -1 || v.animation >= v.animations.length) {
-                    console.error("Invalid tree animations " + v.animations + ", " + this.stringify(v) + ".");
-                }
-            }
-        }
-    };
-    /**
-   * 将对象转成 JSON 字符串，需要忽略函数和渲染相关的对象
-   * @param object - 目标对象
-   * @returns
-   */ CheckerHelper.stringify = function stringify(object) {
-        var simpleObject = {};
-        for(var prop in object){
-            // if (typeof(object[prop]) == 'object'){
-            //     continue;
-            // }
-            if (prop === "internal") {
-                continue;
-            }
-            if (typeof object[prop] == "function") {
-                continue;
-            }
-            if (_instanceof1(object[prop], Texture)) {
-                simpleObject[prop] = object[prop].name;
-                continue;
-            }
-            if (_instanceof1(object[prop], Geometry)) {
-                simpleObject[prop] = object[prop].name;
-                continue;
-            }
-            if (_instanceof1(object[prop], Renderer)) {
-                continue;
-            }
-            simpleObject[prop] = object[prop];
-        }
-        return JSON.stringify(simpleObject);
-    };
-    /**
-   * 获取 2 的 index 指数结果
-   * @param index - 指数
-   * @returns
-   */ CheckerHelper.pow2 = function pow2(index) {
-        var res = 1;
-        while(index-- > 0){
-            res *= 2;
-        }
-        return res;
-    };
-    return CheckerHelper;
-}();
 /**
  * 半精度浮点数组类
  */ var Float16ArrayWrapper = /*#__PURE__*/ function() {