@galacean/engine-loader 1.2.0-beta.5 → 1.2.0-beta.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galacean/engine-loader",
-  "version": "1.2.0-beta.5",
+  "version": "1.2.0-beta.7",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
@@ -15,9 +15,9 @@
     "types/**/*"
   ],
   "dependencies": {
-    "@galacean/engine-math": "1.2.0-beta.5",
-    "@galacean/engine-rhi-webgl": "1.2.0-beta.5",
-    "@galacean/engine-core": "1.2.0-beta.5"
+    "@galacean/engine-math": "1.2.0-beta.7",
+    "@galacean/engine-rhi-webgl": "1.2.0-beta.7",
+    "@galacean/engine-core": "1.2.0-beta.7"
   },
   "scripts": {
     "b:types": "tsc"

package/types/PrefabLoader.d.ts

@@ -0,0 +1,5 @@
+import { AssetPromise, Loader, LoadItem, ResourceManager } from "@galacean/engine-core";
+import { PrefabResource } from "./prefab/PrefabResource";
+export declare class PrefabLoader extends Loader<PrefabResource> {
+    load(item: LoadItem, resourceManager: ResourceManager): AssetPromise<PrefabResource>;
+}

package/types/gltf/GLTFSchema.d.ts

@@ -694,7 +694,7 @@ export interface IScene extends IChildRootProperty {
     /**
      * The indices of each root node
      */
-    nodes: number[];
+    nodes?: number[];
 }
 /**
  * Joints and matrices defining a skin

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

@@ -1,11 +1,24 @@
 declare module "@galacean/engine-core" {
     interface EngineConfiguration {
-        /** glTF loader options. */
+        glTFLoader?: {
+            /** Meshopt options. If set this option and workCount is great than 0, workers will be created. */
+            meshOpt?: {
+                /**
+                 * Worker count for transcoder.
+                 * @defaultValue 4
+                 */
+                workerCount?: number;
+            };
+        };
+        /** @deprecated glTF loader options. */
         glTF?: {
             /** Meshopt options. If set this option and workCount is great than 0, workers will be created. */
             meshOpt?: {
-                /** Worker count for transcoder, default is 4. */
-                workerCount: number;
+                /**
+                 * Worker count for transcoder.
+                 * @defaultValue 4
+                 */
+                workerCount?: number;
             };
         };
     }

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

@@ -1,8 +1,12 @@
-declare const MeshoptDecoder: {
+export declare let ready: Promise<{
     workerCount: number;
-    ready: Promise<void>;
-    useWorkers: () => void;
+    useWorkers: (count?: number) => void;
     decodeGltfBuffer: (count: any, stride: any, source: any, mode: any, filter: any) => Promise<Uint8Array>;
-    release(): void;
-};
-export { MeshoptDecoder };
+    release: () => void;
+}>;
+export declare function getMeshoptDecoder(): Promise<{
+    workerCount: number;
+    useWorkers: (count?: number) => void;
+    decodeGltfBuffer: (count: any, stride: any, source: any, mode: any, filter: any) => Promise<Uint8Array>;
+    release: () => void;
+}>;

package/types/prefab/PrefabParser.d.ts

@@ -0,0 +1,11 @@
+import { Engine, Entity } from "@galacean/engine-core";
+import { HierarchyParser } from "../resource-deserialize/resources/parser/HierarchyParser";
+import { PrefabResource } from "./PrefabResource";
+import { IHierarchyFile, ParserContext } from "../resource-deserialize";
+export declare class PrefabParser extends HierarchyParser<PrefabResource, ParserContext<IHierarchyFile, Entity>> {
+    readonly prefabResource: PrefabResource;
+    static parse(engine: Engine, url: string, data: IHierarchyFile): Promise<PrefabResource>;
+    constructor(data: IHierarchyFile, context: ParserContext<IHierarchyFile, Entity>, prefabResource: PrefabResource);
+    protected _handleRootEntity(id: string): void;
+    protected _clearAndResolve(): PrefabResource;
+}

package/types/prefab/PrefabResource.d.ts

@@ -0,0 +1,25 @@
+import { Engine, Entity, ReferResource } from "@galacean/engine-core";
+/**
+ * The Prefab resource.
+ */
+export declare class PrefabResource extends ReferResource {
+    readonly url: string;
+    /** @internal */
+    _root: Entity;
+    private _dependenceAssets;
+    /**
+     * @internal
+     * @param url - The url of the prefab
+     */
+    constructor(engine: Engine, url: string);
+    /**
+     * Instantiate prefab.
+     * @returns prefab's root entity
+     */
+    instantiate(): Entity;
+    /**
+     * @internal
+     */
+    _addDependenceAsset(resource: ReferResource): void;
+    protected _onDestroy(): void;
+}

package/types/resource-deserialize/resources/parser/CustomParser.d.ts

@@ -0,0 +1,6 @@
+import { Engine, Scene } from "@galacean/engine-core";
+import { IScene } from "../schema";
+import { ParserContext } from "./ParserContext";
+export declare abstract class CustomParser {
+    onSceneParse(engine: Engine, context: ParserContext<IScene, Scene>, data: IScene): Promise<void>;
+}

package/types/resource-deserialize/resources/scene/ISceneCustomParser.d.ts

@@ -0,0 +1,6 @@
+import { Engine, Scene } from "@galacean/engine-core";
+import { IScene } from "../schema";
+export interface ISceneCustomParser {
+    onBeforeParse(engine: Engine, data: IScene): void;
+    onAfterParse(engine: Engine, data: IScene, scene: Scene): void;
+}

package/types/resource-deserialize/resources/schema/SceneSchema.d.ts

@@ -1,4 +1,4 @@
-import { BackgroundMode, DiffuseMode, FogMode, ShadowCascadesMode, ShadowResolution } from "@galacean/engine-core";
+import { BackgroundMode, BackgroundTextureFillMode, DiffuseMode, FogMode, ShadowCascadesMode, ShadowResolution } from "@galacean/engine-core";
 import type { IReferable } from "@galacean/engine-core/types/asset/IReferable";
 import type { IColor, IPrefabFile, IVector3 } from "./BasicSchema";
 export declare enum SpecularMode {
@@ -11,6 +11,7 @@ export interface IScene extends IPrefabFile {
             mode: BackgroundMode;
             color: IColor;
             texture?: IReferable;
+            textureFillMode?: BackgroundTextureFillMode;
             skyMesh?: IReferable;
             skyMaterial?: IReferable;
         };

package/types/gltf/GLTFParser.d.ts

@@ -1,9 +0,0 @@
-import { AssetPromise } from "@galacean/engine-core";
-import { GLTFResource } from "./GLTFResource";
-import { ParserContext } from "./parser/ParserContext";
-export declare class GLTFParser {
-    static defaultPipeline: GLTFParser;
-    private _pipes;
-    private constructor();
-    parse(context: ParserContext): AssetPromise<GLTFResource>;
-}

package/types/gltf/GLTFPipeline.d.ts

@@ -1,23 +0,0 @@
-import { AssetPromise } from "@galacean/engine-core";
-import { GLTFResource } from "./GLTFResource";
-import { GLTFParser } from "./parser/GLTFParser";
-import { GLTFParserContext } from "./parser/GLTFParserContext";
-/**
- * GLTF pipeline.
- */
-export declare class GLTFPipeline {
-    /**
-     * Default pipeline.
-     */
-    static defaultPipeline: GLTFPipeline;
-    private _parsers;
-    /**
-     * Constructor of GLTFPipeline.
-     * @param parsers - Parsers to be executed in order
-     */
-    constructor(...parsers: (new () => GLTFParser)[]);
-    /**
-     * @internal
-     */
-    _parse(context: GLTFParserContext): AssetPromise<GLTFResource>;
-}

package/types/gltf/GLTFUtil.d.ts

@@ -1,53 +0,0 @@
-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";
-/**
- * @internal
- */
-export declare class GLTFUtil {
-    static floatBufferToVector2Array(buffer: Float32Array): Vector2[];
-    static floatBufferToVector3Array(buffer: Float32Array): Vector3[];
-    static floatBufferToVector4Array(buffer: Float32Array): Vector4[];
-    static floatBufferToColorArray(buffer: Float32Array, isColor3: boolean): Color[];
-    /**
-     * Parse binary text for glb loader.
-     */
-    static decodeText(array: Uint8Array): string;
-    /**
-     * Get the number of bytes occupied by accessor type.
-     */
-    static getAccessorTypeSize(accessorType: AccessorType): number;
-    /**
-     * Get the TypedArray corresponding to the component type.
-     */
-    static getComponentType(componentType: AccessorComponentType): Int8ArrayConstructor | Uint8ArrayConstructor | Int16ArrayConstructor | Uint16ArrayConstructor | Uint32ArrayConstructor | Float32ArrayConstructor;
-    static getNormalizedComponentScale(componentType: AccessorComponentType): number;
-    static getAccessorBuffer(context: ParserContext, gltf: IGLTF, accessor: IAccessor): BufferInfo;
-    /**
-     * @deprecated
-     * Get accessor data.
-     */
-    static getAccessorData(gltf: IGLTF, accessor: IAccessor, buffers: ArrayBuffer[]): TypedArray;
-    static getBufferViewData(bufferView: IBufferView, buffers: ArrayBuffer[]): ArrayBuffer;
-    /**
-     * Get accessor data.
-     */
-    static processingSparseData(gltf: IGLTF, accessor: IAccessor, buffers: ArrayBuffer[], originData: TypedArray): TypedArray;
-    static getIndexFormat(type: AccessorComponentType): IndexFormat;
-    static getElementFormat(type: AccessorComponentType, size: number, normalized?: boolean): VertexElementFormat;
-    /**
-     * Load image buffer
-     */
-    static loadImageBuffer(imageBuffer: ArrayBuffer, type: string): Promise<HTMLImageElement>;
-    static isAbsoluteUrl(url: string): boolean;
-    static parseRelativeUrl(baseUrl: string, relativeUrl: string): string;
-    /**
-     * Parse the glb format.
-     */
-    static parseGLB(glb: ArrayBuffer): {
-        gltf: IGLTF;
-        buffers: ArrayBuffer[];
-    };
-    private static _formatRelativePath;
-}