@galacean/effects-plugin-model 2.0.0-alpha.6 → 2.0.0-alpha.7

package/dist/gltf/loader-ecs-ext.d.ts

@@ -0,0 +1,24 @@
+import type { GLTFResources } from '@vvfx/resource-detection';
+import type { Player, spec } from '@galacean/effects';
+import type { LoadSceneOptions, LoadSceneECSResult } from './protocol';
+import { LoaderECS } from './loader-ecs';
+export declare class LoaderECSEx extends LoaderECS {
+    loadScene(options: LoadSceneOptions): Promise<LoadSceneECSResult>;
+    /**
+     * 检查序列化和反序列逻辑，排查渲染场景中渲染正常和编辑器中渲染错误的问题。
+     * 针对Image、Texture、Material、Mesh、Scene、Animation和IBL的检查。
+     *
+     * @param res 加载的GLTF场景资源
+     */
+    checkSerializer(res: GLTFResources): Promise<void>;
+}
+export interface LoadGLTFSceneECSOptions {
+    url: string;
+    player: Player;
+    playAnimation?: number | string;
+    camera?: {
+        position?: spec.vec3;
+        rotation?: spec.vec3;
+    };
+}
+export declare function loadGLTFSceneECS(options: LoadGLTFSceneECSOptions): Promise<spec.JSONScene>;

package/dist/gltf/loader-ecs.d.ts

@@ -0,0 +1,86 @@
+import type { Texture, Engine } from '@galacean/effects';
+import { spec } from '@galacean/effects';
+import type { LoaderOptions, SkyboxType, LoadSceneOptions, LoadSceneECSResult } from './protocol';
+import type { ModelAnimationOptions, ModelCameraOptions, ModelLightOptions, ModelSkyboxOptions, ModelTreeOptions } from '../index';
+import type { GLTFImage, GLTFMaterial, GLTFTexture, GLTFScene, GLTFLight, GLTFCamera, GLTFAnimation } from '@vvfx/resource-detection';
+import { PSkyboxType } from '../runtime/skybox';
+export declare class LoaderECS {
+    private sceneOptions;
+    private loaderOptions;
+    private gltfScene;
+    private gltfSkins;
+    private gltfMeshs;
+    private gltfLights;
+    private gltfCameras;
+    private gltfImages;
+    private gltfTextures;
+    private gltfMaterials;
+    private gltfAnimations;
+    composition: spec.Composition;
+    images: spec.Image[];
+    textures: spec.TextureDefine[];
+    items: spec.VFXItemData[];
+    components: spec.ComponentData[];
+    materials: spec.MaterialData[];
+    shaders: spec.ShaderData[];
+    geometries: spec.GeometryData[];
+    engine: Engine;
+    constructor(composition?: spec.Composition);
+    initial(engine: Engine, options?: LoaderOptions): void;
+    loadScene(options: LoadSceneOptions): Promise<LoadSceneECSResult>;
+    getLoadResult(): LoadSceneECSResult;
+    addLight(data: ModelLight): void;
+    addCamera(camera: ModelCamera): void;
+    processMaterial(materials: GLTFMaterial[], fromGLTF: boolean): void;
+    createTreeOptions(scene: GLTFScene): ModelTreeOptions;
+    createAnimations(animations: GLTFAnimation[]): ModelAnimationOptions[];
+    createTexture2D(image: GLTFImage, texture: GLTFTexture, isBaseColor: boolean): Promise<Texture>;
+    createDefaultSkybox(typeName: SkyboxType): Promise<ModelSkyboxOptions>;
+    scaleColorVal(val: number, fromGLTF: boolean): number;
+    scaleColorVec(vec: number[], fromGLTF: boolean): number[];
+    createLightOptions(light: GLTFLight): ModelLightOptions;
+    createCameraOptions(camera: GLTFCamera): ModelCameraOptions | undefined;
+    private clear;
+    /**
+     * 按照传入的动画播放参数，计算需要播放的动画索引
+     *
+     * @param treeOptions 节点树属性，需要初始化animations列表。
+     * @returns 返回计算的动画索引，-1表示没有动画需要播放，-88888888表示播放所有动画。
+     */
+    getPlayAnimationIndex(treeOptions: ModelTreeOptions): number;
+    isPlayAnimation(): boolean;
+    isPlayAllAnimation(): boolean;
+    getRemarkString(): string;
+    isTiny3dMode(): boolean;
+    getItemDuration(): number;
+    getItemEndBehavior(): spec.ItemEndBehavior;
+    getSkyboxType(): PSkyboxType | undefined;
+    isSkyboxVis(): boolean;
+    ignoreSkybox(): boolean;
+    isEnvironmentTest(): boolean;
+}
+export interface ModelCamera {
+    fov: number;
+    near: number;
+    far: number;
+    clipMode: spec.CameraClipMode;
+    name: string;
+    position: spec.vec3;
+    rotation: spec.vec3;
+    duration: number;
+    endBehavior: spec.ItemEndBehavior;
+}
+export interface ModelLight {
+    lightType: spec.LightType;
+    color: spec.ColorData;
+    intensity: number;
+    range?: number;
+    innerConeAngle?: number;
+    outerConeAngle?: number;
+    name: string;
+    position: spec.vec3;
+    rotation: spec.vec3;
+    scale: spec.vec3;
+    duration: number;
+    endBehavior: spec.ItemEndBehavior;
+}

package/dist/gltf/protocol.d.ts

@@ -1,6 +1,6 @@
 import type { GLTFMaterial, GLTFPrimitive, GLTFLight, GLTFScene, GLTFImage, GLTFTexture, GLTFCamera, GLTFAnimation, GLTFImageBasedLight } from '@vvfx/resource-detection';
 import type { CubeImage } from '@vvfx/resource-detection/dist/src/gltf-tools/gltf-image-based-light';
-import type { GLTFResources } from '@vvfx/resource-detection/dist/src/gltf-tools';
+import type { GLTFResources } from '@vvfx/resource-detection';
 import type { spec, Renderer, Texture, Geometry } from '@galacean/effects';
 import type { ModelAnimationOptions, ModelMaterialOptions, ModelSkyboxOptions, ModelTreeOptions, ModelBaseItem } from '../index';
 /**
@@ -68,6 +68,14 @@ export interface LoadSceneResult {
         max: spec.vec3;
     };
 }
+export interface LoadSceneECSResult {
+    source: string;
+    jsonScene: spec.JSONScene;
+    sceneAABB: {
+        min: spec.vec3;
+        max: spec.vec3;
+    };
+}
 export interface LoaderOptions {
     compatibleMode?: 'gltf' | 'tiny3d' | 'oasis';
 }

package/dist/helper/index.d.ts

@@ -1,2 +1,3 @@
 export * from '../gltf/loader-ext';
+export * from '../gltf/loader-ecs-ext';
 export * from '../gesture/controller';