@galacean/engine-loader 1.1.0-alpha.1 → 1.1.0-alpha.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galacean/engine-loader",
-  "version": "1.1.0-alpha.1",
+  "version": "1.1.0-alpha.3",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
@@ -15,10 +15,10 @@
     "types/**/*"
   ],
   "dependencies": {
-    "@galacean/engine-draco": "1.1.0-alpha.1",
-    "@galacean/engine-rhi-webgl": "1.1.0-alpha.1",
-    "@galacean/engine-math": "1.1.0-alpha.1",
-    "@galacean/engine-core": "1.1.0-alpha.1"
+    "@galacean/engine-draco": "1.1.0-alpha.3",
+    "@galacean/engine-rhi-webgl": "1.1.0-alpha.3",
+    "@galacean/engine-core": "1.1.0-alpha.3",
+    "@galacean/engine-math": "1.1.0-alpha.3"
   },
   "scripts": {
     "b:types": "tsc"

package/types/GLTFLoader.d.ts

@@ -1,8 +1,7 @@
 import { AssetPromise, Loader, LoadItem, ResourceManager } from "@galacean/engine-core";
-import { GLTFPipeline } from "./gltf/GLTFPipeline";
 import { GLTFResource } from "./gltf/GLTFResource";
 export declare class GLTFLoader extends Loader<GLTFResource> {
-    load(item: LoadItem, resourceManager: ResourceManager): Record<string, AssetPromise<any>>;
+    load(item: LoadItem, resourceManager: ResourceManager): AssetPromise<GLTFResource>;
 }
 /**
  * GlTF loader params.
@@ -12,7 +11,5 @@ export interface GLTFParams {
      * @beta Now only contains vertex information, need to improve.
      * Keep raw mesh data for glTF parser, default is false.
      */
-    keepMeshData: boolean;
-    /** Custom glTF pipeline. */
-    pipeline: GLTFPipeline;
+    keepMeshData?: boolean;
 }

package/types/gltf/GLTFUtil.d.ts

@@ -1,7 +1,7 @@
 import { IndexFormat, TypedArray, VertexElementFormat } from "@galacean/engine-core";
 import { Color, Vector2, Vector3, Vector4 } from "@galacean/engine-math";
-import { BufferInfo, ParserContext } from "./parser/ParserContext";
-import { AccessorComponentType, AccessorType, IAccessor, IBufferView, IGLTF } from "./Schema";
+import { AccessorComponentType, AccessorType, IAccessor, IBufferView, IGLTF } from "./GLTFSchema";
+import { BufferInfo, GLTFParserContext } from "./parser/GLTFParserContext";
 /**
  * @internal
  */
@@ -23,7 +23,7 @@ export declare class GLTFUtil {
      */
     static getComponentType(componentType: AccessorComponentType): Int8ArrayConstructor | Uint8ArrayConstructor | Int16ArrayConstructor | Uint16ArrayConstructor | Uint32ArrayConstructor | Float32ArrayConstructor;
     static getNormalizedComponentScale(componentType: AccessorComponentType): number;
-    static getAccessorBuffer(context: ParserContext, gltf: IGLTF, accessor: IAccessor): BufferInfo;
+    static getAccessorBuffer(context: GLTFParserContext, gltf: IGLTF, accessor: IAccessor): BufferInfo;
     /**
      * @deprecated
      * Get accessor data.

package/types/gltf/extensions/GLTFExtensionParser.d.ts

@@ -11,12 +11,6 @@ export declare abstract class GLTFExtensionParser {
      * The extension mode.
      */
     _mode: GLTFExtensionMode;
-    /**
-     * Initialize the parser.
-     * @remarks Some plugins require initialization.
-     * @returns The void or promise
-     */
-    initialize(): void | Promise<void>;
     /**
      * Create and parse the resource.
      * @remarks This method overrides the default resource creation.

package/types/gltf/extensions/index.d.ts

@@ -6,7 +6,7 @@ import "./KHR_materials_pbrSpecularGlossiness";
 import "./KHR_materials_sheen";
 import "./KHR_materials_transmission";
 import "./KHR_materials_unlit";
-export type { IGLTFExtensionVariants } from "./KHR_materials_variants";
+import "./KHR_materials_variants";
 import "./KHR_materials_volume";
 import "./KHR_mesh_quantization";
 import "./KHR_texture_basisu";

package/types/gltf/index.d.ts

@@ -1,4 +1,3 @@
-export { GLTFPipeline } from "./GLTFPipeline";
 export { GLTFResource } from "./GLTFResource";
 export { GLTFUtils } from "./GLTFUtils";
 export * from "./parser";

package/types/gltf/parser/GLTFAnimationParser.d.ts

@@ -1,4 +1,4 @@
-import { AnimationClip, AssetPromise } from "@galacean/engine-core";
+import { AnimationClip } from "@galacean/engine-core";
 import { IAnimation } from "../GLTFSchema";
 import { GLTFParser } from "./GLTFParser";
 import { GLTFParserContext } from "./GLTFParserContext";
@@ -6,7 +6,7 @@ export declare class GLTFAnimationParser extends GLTFParser {
     /**
      * @internal
      */
-    static _parseStandardProperty(context: GLTFParserContext, animationClip: AnimationClip, animationInfo: IAnimation): Promise<void>;
+    static _parseStandardProperty(context: GLTFParserContext, animationClip: AnimationClip, animationInfo: IAnimation): Promise<AnimationClip>;
     private static _addCurve;
-    parse(context: GLTFParserContext): AssetPromise<AnimationClip[]> | void;
+    parse(context: GLTFParserContext, index: number): Promise<AnimationClip>;
 }

package/types/gltf/parser/GLTFBufferParser.d.ts

@@ -1,7 +1,6 @@
-import { AssetPromise } from "@galacean/engine-core";
 import { GLTFParser } from "./GLTFParser";
 import { GLTFParserContext } from "./GLTFParserContext";
 export declare class GLTFBufferParser extends GLTFParser {
-    parse(context: GLTFParserContext): AssetPromise<void>;
-    private _isGLB;
+    parse(context: GLTFParserContext, index: number): Promise<ArrayBuffer>;
+    private _parseSingleBuffer;
 }

package/types/gltf/parser/GLTFEntityParser.d.ts

@@ -1,9 +1,6 @@
+import { Entity } from "@galacean/engine-core";
 import { GLTFParser } from "./GLTFParser";
 import { GLTFParserContext } from "./GLTFParserContext";
 export declare class GLTFEntityParser extends GLTFParser {
-    /** @internal */
-    static _defaultName: String;
-    parse(context: GLTFParserContext): void;
-    private _buildEntityTree;
-    private _createSceneRoots;
+    parse(context: GLTFParserContext, index: number): Entity;
 }

package/types/gltf/parser/GLTFMaterialParser.d.ts

@@ -1,8 +1,11 @@
-import { AssetPromise, Material, PBRMaterial, PBRSpecularMaterial, UnlitMaterial } from "@galacean/engine-core";
+import { BlinnPhongMaterial, Engine, Material, PBRMaterial, PBRSpecularMaterial, UnlitMaterial } from "@galacean/engine-core";
 import { IMaterial, ITextureInfo } from "../GLTFSchema";
 import { GLTFParser } from "./GLTFParser";
 import { GLTFParserContext } from "./GLTFParserContext";
 export declare class GLTFMaterialParser extends GLTFParser {
+    /** @internal */
+    static _getDefaultMaterial(engine: Engine): BlinnPhongMaterial;
+    private static _defaultMaterial;
     /**
      * @internal
      */
@@ -11,5 +14,5 @@ export declare class GLTFMaterialParser extends GLTFParser {
      * @internal
      */
     static _parseStandardProperty(context: GLTFParserContext, material: UnlitMaterial | PBRMaterial | PBRSpecularMaterial, materialInfo: IMaterial): void;
-    parse(context: GLTFParserContext): AssetPromise<Material[]>;
+    parse(context: GLTFParserContext, index: number): Promise<Material>;
 }

package/types/gltf/parser/GLTFMeshParser.d.ts

@@ -1,4 +1,4 @@
-import { AssetPromise, ModelMesh, TypedArray } from "@galacean/engine-core";
+import { ModelMesh, TypedArray } from "@galacean/engine-core";
 import { ModelMeshRestoreInfo } from "../../GLTFContentRestorer";
 import type { IAccessor, IGLTF, IMesh, IMeshPrimitive } from "../GLTFSchema";
 import { GLTFParser } from "./GLTFParser";
@@ -15,5 +15,5 @@ export declare class GLTFMeshParser extends GLTFParser {
     static _createBlendShape(mesh: ModelMesh, meshRestoreInfo: ModelMeshRestoreInfo, glTFMesh: IMesh, accessors: IAccessor[], glTFTargets: {
         [name: string]: number;
     }[], getBlendShapeData: (semantic: string, shapeIndex: number) => Promise<BufferInfo>): Promise<void[]>;
-    parse(context: GLTFParserContext): AssetPromise<ModelMesh[][]> | void;
+    parse(context: GLTFParserContext, index: number): Promise<ModelMesh[]>;
 }

package/types/gltf/parser/GLTFParser.d.ts

@@ -1,18 +1,12 @@
-import { AnimationClip, AssetPromise, EngineObject, Material, Mesh } from "@galacean/engine-core";
-import { GLTFExtensionMode, GLTFExtensionParser } from "../extensions/GLTFExtensionParser";
+import { EngineObject } from "@galacean/engine-core";
 import type { GLTFExtensionOwnerSchema } from "../GLTFSchema";
+import { GLTFExtensionMode, GLTFExtensionParser } from "../extensions/GLTFExtensionParser";
 import { GLTFParserContext } from "./GLTFParserContext";
 /**
  * Base class of glTF parser.
  */
 export declare abstract class GLTFParser {
     private static readonly _extensionParsers;
-    /**
-     * Execute all parses of extension to initialize plugin.
-     * @remarks Some plugins require initialization.
-     * @returns The void or promise
-     */
-    static executeExtensionsInitialize(extensionName: string): void | Promise<void>;
     /**
      * Execute all parses of extension to create resource.
      * @param extensions - Related extensions field
@@ -54,7 +48,7 @@ export declare abstract class GLTFParser {
     static _addExtensionParser(extensionName: string, extensionParser: GLTFExtensionParser): void;
     private static _createAndParse;
     private static _additiveParse;
-    abstract parse(context: GLTFParserContext): AssetPromise<any> | void | Material | AnimationClip | Mesh;
+    abstract parse(context: GLTFParserContext, index?: number): any;
 }
 /**
  * Declare ExtensionParser's decorator.

package/types/gltf/parser/GLTFParserContext.d.ts

@@ -1,33 +1,31 @@
-import { AnimationClip, AssetPromise, Buffer, Entity, Material, ModelMesh, Texture2D, TypedArray } from "@galacean/engine-core";
+import { Buffer, Entity, ResourceManager, TypedArray } from "@galacean/engine-core";
 import { BufferDataRestoreInfo, GLTFContentRestorer } from "../../GLTFContentRestorer";
 import { GLTFResource } from "../GLTFResource";
 import type { IGLTF } from "../GLTFSchema";
+import { GLTFParser } from "./GLTFParser";
 /**
  * @internal
  */
 export declare class GLTFParserContext {
-    glTF: IGLTF;
     glTFResource: GLTFResource;
+    resourceManager: ResourceManager;
     keepMeshData: boolean;
-    hasSkinned: boolean;
-    chainPromises: AssetPromise<any>[];
+    private static readonly _parsers;
+    static addParser(parserType: GLTFParserType, parser: GLTFParser): void;
+    glTF: IGLTF;
     accessorBufferCache: Record<string, BufferInfo>;
-    texturesPromiseInfo: PromiseInfo<Texture2D[]>;
-    materialsPromiseInfo: PromiseInfo<Material[]>;
-    meshesPromiseInfo: PromiseInfo<ModelMesh[][]>;
-    animationClipsPromiseInfo: PromiseInfo<AnimationClip[]>;
-    defaultSceneRootPromiseInfo: PromiseInfo<Entity>;
-    masterPromiseInfo: PromiseInfo<GLTFResource>;
-    promiseMap: Record<string, AssetPromise<any>>;
     contentRestorer: GLTFContentRestorer;
-    /** @internal */
-    _buffers: ArrayBuffer[] | Promise<ArrayBuffer[]>;
-    constructor(url: string);
-    /**
-     * Get all the buffer data.
-     */
-    getBuffers(): Promise<ArrayBuffer[]>;
-    private _initPromiseInfo;
+    buffers?: ArrayBuffer[];
+    private _resourceCache;
+    constructor(glTFResource: GLTFResource, resourceManager: ResourceManager, keepMeshData: boolean);
+    get<T>(type: GLTFParserType.Entity, index: number): Entity;
+    get<T>(type: GLTFParserType.Entity): Entity[];
+    get<T>(type: GLTFParserType.Schema): Promise<T>;
+    get<T>(type: GLTFParserType.Validator): Promise<T>;
+    get<T>(type: GLTFParserType, index: number): Promise<T>;
+    get<T>(type: GLTFParserType): Promise<T[]>;
+    parse(): Promise<GLTFResource>;
+    private _handleSubAsset;
 }
 /**
  * @internal
@@ -41,13 +39,16 @@ export declare class BufferInfo {
     restoreInfo: BufferDataRestoreInfo;
     constructor(data: TypedArray, interleaved: boolean, stride: number);
 }
-/**
- * @internal
- */
-export declare class PromiseInfo<T> {
-    promise: AssetPromise<T>;
-    resolve: (value?: T | PromiseLike<T>) => void;
-    reject: (reason?: any) => void;
-    setProgress: (progress: number) => void;
-    onCancel: (callback: () => void) => void;
+export declare enum GLTFParserType {
+    Schema = 0,
+    Validator = 1,
+    Scene = 2,
+    Buffer = 3,
+    Texture = 4,
+    Material = 5,
+    Mesh = 6,
+    Entity = 7,
+    Skin = 8,
+    Animation = 9
 }
+export declare function registerGLTFParser(pipeline: GLTFParserType): (Parser: new () => GLTFParser) => void;

package/types/gltf/parser/GLTFSceneParser.d.ts

@@ -1,10 +1,9 @@
-import { AssetPromise, Entity } from "@galacean/engine-core";
+import { Entity } from "@galacean/engine-core";
 import { GLTFParser } from "./GLTFParser";
 import { GLTFParserContext } from "./GLTFParserContext";
 export declare class GLTFSceneParser extends GLTFParser {
-    private static _defaultMaterial;
-    private static _getDefaultMaterial;
-    parse(context: GLTFParserContext): AssetPromise<Entity> | void;
+    parse(context: GLTFParserContext, index: number): Promise<Entity>;
+    private _parseEntityComponent;
     private _createCamera;
     private _createRenderer;
     private _createAnimator;

package/types/gltf/parser/GLTFSchemaParser.d.ts

@@ -0,0 +1,7 @@
+import { IGLTF } from "../GLTFSchema";
+import { GLTFParser } from "./GLTFParser";
+import { GLTFParserContext } from "./GLTFParserContext";
+export declare class GLTFSchemaParser extends GLTFParser {
+    parse(context: GLTFParserContext): Promise<IGLTF>;
+    private _isGLB;
+}

package/types/gltf/parser/GLTFSkinParser.d.ts

@@ -1,7 +1,7 @@
-import { AssetPromise } from "@galacean/engine-core";
-import { GLTFParserContext } from ".";
+import { Skin } from "@galacean/engine-core";
 import { GLTFParser } from "./GLTFParser";
+import { GLTFParserContext } from "./GLTFParserContext";
 export declare class GLTFSkinParser extends GLTFParser {
-    parse(context: GLTFParserContext): AssetPromise<void>;
+    parse(context: GLTFParserContext, index: number): Promise<Skin>;
     private _findSkeletonRootBone;
 }

package/types/gltf/parser/GLTFTextureParser.d.ts

@@ -1,4 +1,4 @@
-import { AssetPromise, Texture2D, TextureWrapMode } from "@galacean/engine-core";
+import { Texture, TextureWrapMode } from "@galacean/engine-core";
 import { GLTFParser } from "./GLTFParser";
 import { GLTFParserContext } from "./GLTFParserContext";
 export declare class GLTFTextureParser extends GLTFParser {
@@ -8,5 +8,5 @@ export declare class GLTFTextureParser extends GLTFParser {
         33648: TextureWrapMode;
         10497: TextureWrapMode;
     };
-    parse(context: GLTFParserContext): AssetPromise<Texture2D[]> | void;
+    parse(context: GLTFParserContext, index: number): Promise<Texture>;
 }

package/types/gltf/parser/GLTFValidator.d.ts

@@ -1,6 +1,5 @@
-import { AssetPromise } from "@galacean/engine-core";
 import { GLTFParser } from "./GLTFParser";
 import { GLTFParserContext } from "./GLTFParserContext";
 export declare class GLTFValidator extends GLTFParser {
-    parse(context: GLTFParserContext): AssetPromise<void>;
+    parse(context: GLTFParserContext): Promise<void>;
 }

package/types/gltf/parser/index.d.ts

@@ -1,3 +1,4 @@
+export { GLTFSchemaParser } from "./GLTFSchemaParser";
 export { GLTFAnimationParser } from "./GLTFAnimationParser";
 export { GLTFBufferParser } from "./GLTFBufferParser";
 export { GLTFEntityParser } from "./GLTFEntityParser";
@@ -8,4 +9,4 @@ export { GLTFSceneParser } from "./GLTFSceneParser";
 export { GLTFSkinParser } from "./GLTFSkinParser";
 export { GLTFTextureParser } from "./GLTFTextureParser";
 export { GLTFValidator } from "./GLTFValidator";
-export { GLTFParserContext } from "./GLTFParserContext";
+export { GLTFParserContext, GLTFParserType, registerGLTFParser } from "./GLTFParserContext";

package/types/ktx2/BinomialLLCTranscoder/BinomialLLCTranscoder.d.ts

@@ -0,0 +1,13 @@
+import { KTX2TargetFormat } from "../KTX2TargetFormat";
+import { TranscodeResult } from "../TranscodeResult";
+/** @internal */
+export declare class BinomialLLCTranscoder {
+    readonly workerLimit: number;
+    static MessageId: number;
+    private _transcodeWorkerPool;
+    private _initPromise;
+    constructor(workerLimit: number);
+    init(): Promise<any>;
+    transcode(buffer: ArrayBuffer, format: KTX2TargetFormat): Promise<TranscodeResult>;
+    destroy(): void;
+}

package/types/ktx2/BinomialLLCTranscoder/TranscodeWorkerCode.d.ts

@@ -0,0 +1,33 @@
+type MessageType = "init" | "transcode";
+export interface IBaseMessage {
+    type: MessageType;
+}
+export interface IInitMessage extends IBaseMessage {
+    type: "init";
+    transcoderWasm: ArrayBuffer;
+}
+export interface ITranscodeMessage extends IBaseMessage {
+    type: "transcode";
+    format: number;
+    buffer: ArrayBuffer;
+}
+export type IMessage = IInitMessage | ITranscodeMessage;
+export type TranscodeResult = {
+    width: number;
+    height: number;
+    hasAlpha: boolean;
+    format: number;
+    faces: Array<{
+        data: Uint8Array;
+        width: number;
+        height: number;
+    }>[];
+    faceCount: number;
+};
+export type TranscodeResponse = {
+    id: number;
+    type: "transcoded";
+} & TranscodeResult;
+/** @internal */
+export declare function TranscodeWorkerCode(): void;
+export {};

package/types/ktx2/KhronosTranscoder/KhronosTranscoder.d.ts

@@ -0,0 +1,17 @@
+import { KTX2Container } from "../KTX2Container";
+import { KTX2TargetFormat } from "../KTX2TargetFormat";
+import { TranscodeResult } from "./TranscoderWorkerCode";
+/** @internal */
+export declare class KhronosTranscoder {
+    readonly workerLimit: number;
+    readonly type: KTX2TargetFormat;
+    static transcoderMap: {
+        0: string;
+    };
+    private _transcodeWorkerPool;
+    private _initPromise;
+    constructor(workerLimit: number, type: KTX2TargetFormat);
+    init(): Promise<any>;
+    transcode(ktx2Container: KTX2Container): Promise<TranscodeResult>;
+    destroy(): void;
+}

package/types/ktx2/KhronosTranscoder/TranscoderWorkerCode.d.ts

@@ -0,0 +1,34 @@
+export interface EncodedData {
+    buffer: Uint8Array;
+    levelWidth: number;
+    levelHeight: number;
+    uncompressedByteLength: number;
+}
+type MessageType = "init" | "transcode";
+export interface IBaseMessage {
+    type: MessageType;
+}
+export interface IInitMessage extends IBaseMessage {
+    type: "init";
+    transcoderWasm: ArrayBuffer;
+}
+export interface ITranscodeMessage extends IBaseMessage {
+    type: "transcode";
+    format: number;
+    needZstd: boolean;
+    data: EncodedData[][];
+}
+export type IMessage = IInitMessage | ITranscodeMessage;
+export type TranscodeResult = {
+    data: Array<{
+        data: Uint8Array;
+        width: number;
+        height: number;
+    }>;
+};
+export type TranscodeResponse = {
+    id: number;
+    type: "transcoded";
+} & TranscodeResult;
+export declare function TranscodeWorkerCode(): void;
+export {};

package/types/ktx2/TranscodeResult.d.ts

@@ -0,0 +1,10 @@
+export interface TranscodeResult {
+    width: number;
+    height: number;
+    hasAlpha: boolean;
+    mipmaps: Array<{
+        data: Uint8Array;
+        width: number;
+        height: number;
+    }>;
+}

package/types/ktx2/constants.d.ts

@@ -0,0 +1,7 @@
+export declare enum SupercompressionScheme {
+    None = 0,
+    BasisLZ = 1,
+    Zstd = 2,
+    ZLib = 3
+}
+export declare const KHR_DF_SAMPLE_DATATYPE_SIGNED = 64;

package/types/ktx2/zstddec.d.ts

@@ -0,0 +1,62 @@
+/**
+ * From https://github.com/donmccurdy/zstddec by Don McCurdy
+ */
+interface DecoderExports {
+    memory: Uint8Array;
+    ZSTD_findDecompressedSize: (compressedPtr: number, compressedSize: number) => number;
+    ZSTD_decompress: (uncompressedPtr: number, uncompressedSize: number, compressedPtr: number, compressedSize: number) => number;
+    malloc: (ptr: number) => number;
+    free: (ptr: number) => void;
+}
+/**
+ * ZSTD (Zstandard) decoder.
+ */
+export declare class ZSTDDecoder {
+    static heap: Uint8Array;
+    static IMPORT_OBJECT: {
+        env: {
+            emscripten_notify_memory_growth: () => void;
+        };
+    };
+    static instance: {
+        exports: DecoderExports;
+    };
+    static WasmModuleURL: string;
+    _initPromise: Promise<any>;
+    init(): Promise<void>;
+    _init(result: WebAssembly.WebAssemblyInstantiatedSource): void;
+    decode(array: Uint8Array, uncompressedSize?: number): Uint8Array;
+}
+export {};
+/**
+ * BSD License
+ *
+ * For Zstandard software
+ *
+ * Copyright (c) 2016-present, Yann Collet, Facebook, Inc. All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without modification,
+ * are permitted provided that the following conditions are met:
+ *
+ *  * Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ *  * Redistributions in binary form must reproduce the above copyright notice,
+ *    this list of conditions and the following disclaimer in the documentation
+ *    and/or other materials provided with the distribution.
+ *
+ *  * Neither the name Facebook nor the names of its contributors may be used to
+ *    endorse or promote products derived from this software without specific
+ *    prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+ * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */