@galacean/effects-plugin-model 2.0.0-alpha.9 → 2.0.0-beta.0

package/dist/plugin/model-item.d.ts

@@ -1,10 +1,10 @@
-import type { HitTestBoxParams, HitTestCustomParams, HitTestSphereParams, Engine, Renderer } from '@galacean/effects';
-import { ItemBehaviour, RendererComponent, TimelineComponent } from '@galacean/effects';
-import { Vector3 } from '../runtime/math';
-import type { Euler } from '../runtime/math';
-import type { ModelItemBounding, ModelMeshComponentData, ModelCameraComponentData, ModelSkyboxComponentData, ModelLightComponentData } from '../index';
+import type { Engine, HitTestBoxParams, HitTestCustomParams, HitTestSphereParams, Renderer, VFXItem } from '@galacean/effects';
+import { Behaviour, RendererComponent, AnimationClip } from '@galacean/effects';
+import type { ModelCameraComponentData, ModelItemBounding, ModelLightComponentData, ModelMeshComponentData, ModelSkyboxComponentData, AnimationComponentData } from '../index';
 import type { PSceneManager } from '../runtime';
 import { PCamera, PLight, PMesh, PSkybox } from '../runtime';
+import type { Euler } from '../runtime/math';
+import { Vector3 } from '../runtime/math';
 /**
  * 插件 Mesh 组件类，支持 3D Mesh 渲染能力
  * @since 2.0.0
@@ -27,6 +27,10 @@ export declare class ModelMeshComponent extends RendererComponent {
      * 场景管理器
      */
     sceneManager?: PSceneManager;
+    /**
+     * morph 动画权重
+     */
+    morphWeights: number[];
     /**
      * 构造函数，只保存传入参数，不在这里创建内部对象
      * @param engine - 引擎
@@ -42,6 +46,11 @@ export declare class ModelMeshComponent extends RendererComponent {
      * @param dt - 更新间隔
      */
     update(dt: number): void;
+    /**
+     * 组件晚更新，晚更新内部对象状态
+     * @param dt - 更新间隔
+     */
+    lateUpdate(dt: number): void;
     /**
      * 组件渲染，需要检查可见性
      * @param renderer - 渲染器
@@ -144,7 +153,7 @@ export declare class ModelSkyboxComponent extends RendererComponent {
  * @since 2.0.0
  * @internal
  */
-export declare class ModelLightComponent extends ItemBehaviour {
+export declare class ModelLightComponent extends Behaviour {
     /**
      * 内部灯光对象
      */
@@ -196,7 +205,7 @@ export declare class ModelLightComponent extends ItemBehaviour {
  * @since 2.0.0
  * @internal
  */
-export declare class ModelCameraComponent extends ItemBehaviour {
+export declare class ModelCameraComponent extends Behaviour {
     /**
      * 内部相机对象
      */
@@ -205,10 +214,6 @@ export declare class ModelCameraComponent extends ItemBehaviour {
      * 参数
      */
     data?: ModelCameraComponentData;
-    /**
-     * 时间轴组件
-     */
-    timeline?: TimelineComponent;
     /**
      * 构造函数，只保存传入参数，不在这里创建内部对象
      * @param engine - 引擎
@@ -248,3 +253,47 @@ export declare class ModelCameraComponent extends ItemBehaviour {
      */
     setTransform(position?: Vector3, rotation?: Euler): void;
 }
+/**
+ * 插件动画组件类，支持 3D 动画能力
+ * @since 2.0.0
+ * @internal
+ */
+export declare class AnimationComponent extends Behaviour {
+    /**
+     * 参数
+     */
+    data?: AnimationComponentData;
+    elapsedTime: number;
+    animation: number;
+    clips: ModelAnimationClip[];
+    /**
+     * 构造函数，只保存传入参数，不在这里创建内部对象
+     * @param engine - 引擎
+     */
+    constructor(engine: Engine);
+    /**
+     * 组件开始，需要创建内部对象和添加到场景管理器中
+     */
+    start(): void;
+    /**
+     * 组件更新，更新内部对象状态
+     * @param dt - 更新间隔
+     */
+    update(dt: number): void;
+    /**
+     * 组件销毁
+     */
+    onDestroy(): void;
+    /**
+     * 反序列化，记录传入参数
+     * @param data - 组件参数
+     */
+    fromData(data: AnimationComponentData): void;
+}
+declare class ModelAnimationClip extends AnimationClip {
+    path2Node: Record<string, VFXItem>;
+    sampleAnimation(vfxItem: VFXItem, time: number): void;
+    setFromAnimationClip(clip: AnimationClip): void;
+    getTargetItem(rootItem: VFXItem, path: string): VFXItem;
+}
+export {};

package/dist/plugin/model-plugin.d.ts

@@ -1,5 +1,5 @@
 import type { Scene, SceneLoadOptions, Composition, RenderFrame, Engine, Component, Renderer } from '@galacean/effects';
-import { AbstractPlugin, spec, ItemBehaviour } from '@galacean/effects';
+import { AbstractPlugin, spec, Behaviour } from '@galacean/effects';
 import { CompositionCache } from '../runtime/cache';
 import { PSceneManager } from '../runtime';
 /**
@@ -51,7 +51,7 @@ export interface ModelPluginOptions {
  * @since 2.0.0
  * @internal
  */
-export declare class ModelPluginComponent extends ItemBehaviour {
+export declare class ModelPluginComponent extends Behaviour {
     private runtimeEnv;
     private compatibleMode;
     private renderSkybox;
@@ -99,7 +99,7 @@ export declare class ModelPluginComponent extends ItemBehaviour {
      * 反序列化，创建场景管理器
      * @param date - 组件参数
      */
-    fromData(data: any): void;
+    fromData(data: ModelPluginOptions): void;
     /**
      * 组件初始化，初始化场景管理器并更新合成相机
      * @param sceneParams - 场景参数
@@ -113,6 +113,7 @@ export declare class ModelPluginComponent extends ItemBehaviour {
      */
     private updateSceneCamera;
     private getLightItemCount;
+    private getMaxJointCount;
 }
 /**
  * 获取场景管理器，从合成中查找

package/dist/plugin/model-tree-item.d.ts

@@ -1,6 +1,6 @@
-import { Transform, ItemBehaviour } from '@galacean/effects';
-import type { TimelineComponent, VFXItemContent, Engine, VFXItem } from '@galacean/effects';
-import type { ModelTreeOptions, ModelTreeContent } from '../index';
+import type { Engine, VFXItem } from '@galacean/effects';
+import { Behaviour, Transform } from '@galacean/effects';
+import type { ModelTreeContent, ModelTreeOptions } from '../index';
 import { PAnimationManager } from '../runtime';
 /**
  * 场景树节点描述
@@ -47,7 +47,7 @@ export declare class ModelTreeItem {
      * @param props - 场景树数据
      * @param owner - 场景树元素
      */
-    constructor(props: ModelTreeOptions, owner: VFXItem<VFXItemContent>);
+    constructor(props: ModelTreeOptions, owner: VFXItem);
     /**
      * 场景树更新，主要是动画更新
      * @param dt - 时间间隔
@@ -87,7 +87,7 @@ export declare class ModelTreeItem {
  * @since 2.0.0
  * @internal
  */
-export declare class ModelTreeComponent extends ItemBehaviour {
+export declare class ModelTreeComponent extends Behaviour {
     /**
      * 内部节点树元素
      */
@@ -96,10 +96,6 @@ export declare class ModelTreeComponent extends ItemBehaviour {
      * 参数
      */
     options?: ModelTreeContent;
-    /**
-     * 时间轴组件
-     */
-    timeline?: TimelineComponent;
     /**
      * 构造函数，创建节点树元素
      * @param engine

package/dist/runtime/animation.d.ts

@@ -1,6 +1,6 @@
-import type { Geometry, Engine, VFXItemContent, VFXItem } from '@galacean/effects';
+import type { Geometry, Engine, VFXItem, SkinProps } from '@galacean/effects';
 import { Texture } from '@galacean/effects';
-import type { ModelSkinOptions, ModelAnimTrackOptions, ModelAnimationOptions, ModelTreeOptions } from '../index';
+import type { ModelAnimTrackOptions, ModelAnimationOptions, ModelTreeOptions } from '../index';
 import { Matrix4 } from './math';
 import { PObject } from './object';
 import type { PSceneManager } from './scene';
@@ -19,7 +19,7 @@ export declare class PSkin extends PObject {
     /**
      * 场景树父元素
      */
-    parentItem?: VFXItem<VFXItemContent>;
+    rootBoneItem?: VFXItem;
     /**
      * 骨骼索引
      */
@@ -27,7 +27,7 @@ export declare class PSkin extends PObject {
     /**
      * 关节索引
      */
-    jointList: number[];
+    jointItem: VFXItem[];
     /**
      * 逆绑定矩阵
      */
@@ -40,13 +40,17 @@ export declare class PSkin extends PObject {
      * 纹理数据模式
      */
     textureDataMode: TextureDataMode;
+    /**
+     * 最大骨骼数目
+     */
+    maxJointCount: number;
     /**
      * 创建蒙皮对象
-     * @param options - 蒙皮相关数据
+     * @param props - 蒙皮相关数据
      * @param engine - 引擎对象
-     * @param parentItem - 场景树父元素
+     * @param rootBoneItem - 场景树父元素
      */
-    create(options: ModelSkinOptions, engine: Engine, parentItem?: VFXItem<VFXItemContent>): void;
+    create(props: SkinProps, engine: Engine, rootBoneItem: VFXItem, maxJointCount: number): void;
     /**
      * 更新蒙皮矩阵
      */
@@ -62,7 +66,7 @@ export declare class PSkin extends PObject {
      * 更新父元素
      * @param parentItem - 场景树父元素
      */
-    updateParentItem(parentItem: VFXItem<VFXItemContent>): void;
+    updateParentItem(parentItem: VFXItem): void;
     /**
      * 获取关节点数
      * @returns
@@ -78,6 +82,9 @@ export declare class PSkin extends PObject {
      */
     dispose(): void;
     private getTextureDataMode;
+    private getJointItems;
+    private genNodeName;
+    private genNodeNameDFS;
 }
 /**
  * Morph 动画类
@@ -95,7 +102,7 @@ export declare class PMorph extends PObject {
      * weights 数组的具体数据，来自动画控制器的每帧更新
      * 数组的长度必须和 morphWeightsLength 相同，否则会出错。
      */
-    morphWeightsArray?: Float32Array;
+    morphWeightsArray: number[];
     /**
      * 是否有 Position 相关的 Morph 动画，shader 中需要知道
      */
@@ -114,12 +121,12 @@ export declare class PMorph extends PObject {
      * @returns 是否创建成功
      */
     create(geometry: Geometry): boolean;
-    dispose(): void;
     /**
      * 初始化 Morph target 的权重数组
      * @param weights - glTF Mesh 的权重数组，长度必须严格一致
      */
     initWeights(weights: number[]): void;
+    updateWeights(weights: number[]): void;
     /**
      * 当前状态是否有 Morph 动画：
      * 需要判断 weights 数组长度，以及 Position、Normal 和 Tangent 是否有动画
@@ -133,7 +140,7 @@ export declare class PMorph extends PObject {
      * @returns 返回两个 Morph 动画状态是否相等
      */
     equals(morph: PMorph): boolean;
-    getMorphWeightsArray(): Float32Array;
+    getMorphWeightsArray(): number[];
     /**
      * 统计 Geometry 中 Attribute 名称个数：
      * 主要用于统计 Morph 动画中新增的 Attribute 名称的个数，会作为最终的 weights 数组长度使用
@@ -216,7 +223,7 @@ export declare class PAnimTrack {
      * @param treeItem - 节点树元素
      * @param sceneManager - 3D 场景管理器
      */
-    tick(time: number, treeItem: VFXItem<VFXItemContent>, sceneManager?: PSceneManager): void;
+    tick(time: number, treeItem: VFXItem, sceneManager?: PSceneManager): void;
     /**
      * 获取动画结束时间
      * @returns
@@ -290,7 +297,7 @@ export declare class PAnimation extends PObject {
      * @param treeItem - 场景树元素
      * @param sceneManager - 3D 场景管理器
      */
-    tick(time: number, treeItem: VFXItem<VFXItemContent>, sceneManager?: PSceneManager): void;
+    tick(time: number, treeItem: VFXItem, sceneManager?: PSceneManager): void;
     /**
      * 销毁
      */
@@ -312,7 +319,7 @@ export declare class PAnimationManager extends PObject {
      * @param treeOptions - 场景树参数
      * @param ownerItem - 场景树所属元素
      */
-    constructor(treeOptions: ModelTreeOptions, ownerItem: VFXItem<VFXItemContent>);
+    constructor(treeOptions: ModelTreeOptions, ownerItem: VFXItem);
     /**
      * 设置场景管理器
      * @param sceneManager - 场景管理器
@@ -337,5 +344,5 @@ export declare class PAnimationManager extends PObject {
      * 获取场景树元素
      * @returns
      */
-    getTreeItem(): VFXItem<VFXItemContent>;
+    getTreeItem(): VFXItem;
 }

package/dist/runtime/cache.d.ts

@@ -72,10 +72,9 @@ export declare class CompositionCache {
      * 获取滤波 Mesh
      * @param name - 名称
      * @param material - 材质
-     * @param uniformSemantics - Uniform 语义信息
      * @returns
      */
-    getFilterMesh(name: string, material: PMaterialBase, uniformSemantics: Record<string, any>): Mesh;
+    getFilterMesh(name: string, material: PMaterialBase): Mesh;
     getShadowBasePass(name: string, priority: number, meshList: Mesh[], fboOptions: FBOOptions): RenderPass;
     getShadowFilterPass(name: string, priority: number, meshList: Mesh[], fboOptions: FBOOptions): RenderPass;
     /**

package/dist/runtime/camera.d.ts

@@ -34,6 +34,10 @@ export declare class PCamera extends PEntity {
      * Y 轴上视角
      */
     fov: number;
+    /**
+     * 视图矩阵
+     */
+    viewportMatrix: math.Matrix4;
     /**
      * 纵横比
      */
@@ -134,7 +138,8 @@ export declare class PCameraManager {
     dispose(): void;
     /**
      * 更新默认相机状态，并计算新的透视和相机矩阵
-     * @param fovy - 视角
+     * @param fov - 视角
+     * @param viewportMatrix - 视图矩阵
      * @param aspect - 纵横比
      * @param nearPlane - 近裁剪平面
      * @param farPlane - 远裁剪平面
@@ -142,7 +147,7 @@ export declare class PCameraManager {
      * @param rotation - 旋转
      * @param clipMode - 剪裁模式
      */
-    updateDefaultCamera(fovy: number, aspect: number, nearPlane: number, farPlane: number, position: Vector3, rotation: Quaternion, clipMode: number): void;
+    updateDefaultCamera(fov: number, viewportMatrix: Matrix4, aspect: number, nearPlane: number, farPlane: number, position: Vector3, rotation: Quaternion, clipMode: number): void;
     /**
      * 获取相机对象列表
      * @returns

package/dist/runtime/index.d.ts

@@ -10,3 +10,4 @@ export * from './object';
 export * from './scene';
 export * from './shader';
 export * from './skybox';
+export * from './math';

package/dist/runtime/material.d.ts

@@ -5,16 +5,6 @@ import type { Matrix3 } from './math';
 import { Vector3, Vector4, Color } from './math';
 import { PMaterialType } from './common';
 import { PObject } from './object';
-export declare enum RenderType {
-    Opaque = "Opaque",
-    Mask = "Mask",
-    Blend = "Blend"
-}
-export declare enum CullMode {
-    Front = "Front",
-    Back = "Back",
-    Double = "Double"
-}
 /**
  * 3D 材质基础类，支持公共的材质功能
  */
@@ -43,15 +33,19 @@ export declare abstract class PMaterialBase extends PObject {
     /**
      * 渲染类型，默认是不透明
      */
-    renderType: RenderType;
+    renderType: spec.RenderType;
+    /**
+     * 是否 Alpha 裁剪，默认关闭
+     */
+    alphaClip: boolean;
     /**
      * Alpha 测试截断值
      */
-    alphaCutOff: number;
+    alphaCutoff: number;
     /**
      * 面侧模式，默认是正面
      */
-    cullMode: CullMode;
+    renderFace: spec.RenderFace;
     /**
      * 获取着色器特性列表，根据材质状态
      * @returns 特性列表
@@ -92,15 +86,15 @@ export declare abstract class PMaterialBase extends PObject {
      */
     isOpaque(): boolean;
     /**
-     * 是否遮罩
+     * 是否 Alpha 裁剪
      * @returns
      */
-    isMasked(): boolean;
+    isAlphaClip(): boolean;
     /**
      * 是否半透明
      * @returns
      */
-    isBlend(): boolean;
+    isTransparent(): boolean;
     /**
      * 是否正面模式
      * @returns
@@ -115,7 +109,7 @@ export declare abstract class PMaterialBase extends PObject {
      * 是否双面模式
      * @returns
      */
-    isDoubleSide(): boolean;
+    isBothSide(): boolean;
 }
 /**
  * 无光照材质类，负责无关照或者不接受光照情况下的物体材质效果

package/dist/runtime/mesh.d.ts

@@ -1,6 +1,6 @@
-import type { Engine, math, VFXItemContent, VFXItem, Renderer, Geometry } from '@galacean/effects';
-import { spec, Mesh, Material } from '@galacean/effects';
-import type { ModelMeshComponentData, ModelMeshPrimitiveData } from '../index';
+import type { Engine, math, VFXItem, Renderer, Geometry } from '@galacean/effects';
+import { spec, Material } from '@galacean/effects';
+import type { ModelMeshComponentData } from '../index';
 import { PEntity } from './object';
 import type { PMaterial } from './material';
 import { Matrix4, Vector3, Box3 } from './math';
@@ -26,11 +26,12 @@ export declare class PMesh extends PEntity {
     /**
      * 父元素
      */
-    parentItem?: VFXItem<VFXItemContent>;
+    parentItem?: VFXItem;
     /**
      * 父元素索引
      */
     parentItemId?: string;
+    rootBoneItem?: VFXItem;
     /**
      * 蒙皮
      */
@@ -42,7 +43,7 @@ export declare class PMesh extends PEntity {
     /**
      * primitive 对象数组
      */
-    primitives: PPrimitive[];
+    subMeshes: PSubMesh[];
     /**
      * 是否隐藏，默认是隐藏
      */
@@ -80,7 +81,7 @@ export declare class PMesh extends PEntity {
      * @param parentId - 父元素索引
      * @param parent - 父元素
      */
-    constructor(engine: Engine, name: string, meshData: ModelMeshComponentData, owner?: ModelMeshComponent, parentId?: string, parent?: VFXItem<VFXItemContent>);
+    constructor(engine: Engine, name: string, meshData: ModelMeshComponentData, owner: ModelMeshComponent, parentId?: string, parent?: VFXItem);
     /**
      * 创建 GE 的 Mesh、Geometry 和 Material 对象
      * @param scene - 场景管理器
@@ -91,6 +92,10 @@ export declare class PMesh extends PEntity {
      * 更新变换数据和蒙皮数据
      */
     update(): void;
+    /**
+     * 更新骨骼动画
+     */
+    lateUpdate(): void;
     /**
      * 渲染 Mesh 对象，需要将内部相关数据传给渲染器
      * @param scene - 场景
@@ -115,7 +120,7 @@ export declare class PMesh extends PEntity {
      * @param parentId - 父元素索引
      * @param parentItem - 父 VFX 元素
      */
-    updateParentInfo(parentId: string, parentItem: VFXItem<VFXItemContent>): void;
+    updateParentInfo(parentId: string, parentItem: VFXItem): void;
     /**
      * 根据当前场景状态更新内部材质数据
      * @param scene - 场景管理器
@@ -144,15 +149,11 @@ export declare class PMesh extends PEntity {
      * 是否有蒙皮
      */
     get hasSkin(): boolean;
-    /**
-     * 获取 GE Mesh 数组
-     */
-    get mriMeshs(): Mesh[];
 }
 /**
- * Primitive 类，负责 Sub Mesh相关的功能，支持骨骼动画和 PBR 渲染
+ * PSubMesh 类，负责 Sub Mesh相关的功能，支持骨骼动画和 PBR 渲染
  */
-export declare class PPrimitive {
+export declare class PSubMesh {
     private engine;
     /**
      * 宿主 Mesh，包含了当前 Primitive
@@ -173,10 +174,6 @@ export declare class PPrimitive {
      * 名称
      */
     name: string;
-    /**
-     * GE Mesh
-     */
-    effectsMesh: Mesh;
     /**
      * 渲染优先级
      */
@@ -195,17 +192,13 @@ export declare class PPrimitive {
      * @param data - Primitive 参数
      * @param parent - 所属 Mesh 对象
      */
-    create(data: ModelMeshPrimitiveData, parent: PMesh): void;
+    create(geometry: Geometry, material: Material, parent: PMesh): void;
     /**
      * 创建 GE Mesh、Geometry 和 Material 对象，用于后面的渲染
-     * 着色器部分 Uniform 数据来自 uniformSemantics
      * @param lightCount - 灯光数目
-     * @param uniformSemantics - Uniform 语义数据
      * @param skybox - 天空盒
      */
-    build(lightCount: number, uniformSemantics: {
-        [k: string]: any;
-    }, skybox?: PSkybox): void;
+    build(lightCount: number, skybox?: PSkybox): void;
     private getFeatureList;
     private getMacroList;
     /**
@@ -266,7 +259,7 @@ export declare class PPrimitive {
      * 获取 GE 材质
      * @returns
      */
-    getModelMaterial(): Material;
+    getEffectsMaterial(): Material;
     /**
      * 是否无光照材质
      * @returns

package/dist/runtime/scene.d.ts

@@ -4,7 +4,8 @@ import { PMesh } from './mesh';
 import type { PCamera } from './camera';
 import { PCameraManager } from './camera';
 import { PLight, PLightManager } from './light';
-import { Vector3, Matrix4, Box3 } from './math';
+import type { Vector3 } from './math';
+import { Matrix4, Box3 } from './math';
 import { PSkybox } from './skybox';
 import type { CompositionCache } from './cache';
 import type { PEntity } from './object';
@@ -63,6 +64,10 @@ export interface PSceneOptions {
      * 灯光元素数目
      */
     lightItemCount: number;
+    /**
+     * 最大骨骼数目
+     */
+    maxJointCount: number;
 }
 /**
  * 场景状态接口，每次场景管理器 Tick 时都会生成
@@ -112,6 +117,10 @@ export interface PSceneStates {
      * 最大灯光数目
      */
     maxLightCount: number;
+    /**
+     * 最大骨骼数目
+     */
+    maxJointCount: number;
     /**
      * 天空盒对象
      */
@@ -174,6 +183,10 @@ export declare class PSceneManager {
      * 最多灯光数目
      */
     maxLightCount: number;
+    /**
+     * 最大骨骼数目
+     */
+    maxJointCount: number;
     /**
      * 场景状态
      */
@@ -209,7 +222,7 @@ export declare class PSceneManager {
      * 更新默认相机状态，根据传入的相机参数
      * @param camera - 相机参数
      */
-    updateDefaultCamera(camera: CameraOptionsEx): void;
+    updateDefaultCamera(camera: CameraOptionsEx, viewportMatrix: Matrix4): void;
     /**
      * 更新插件场景，需要更新内部的相关的插件对象，特别是 Mesh 对象的骨骼动画
      * 并将需要渲染的对象添加到渲染对象集合中

package/dist/runtime/shader-libs/standard-shader-source.d.ts

@@ -9,6 +9,5 @@ export declare namespace StandardShaderSource {
      * @param isWebGL2 - 是否 WebGL2
      * @returns 最终代码
      */
-    function build(source: string, features: string[], isWebGL2: boolean): string;
-    function getSourceCode(source: string, isWebGL2?: boolean): string;
+    function build(source: string, features: string[]): string;
 }

package/dist/runtime/shader-libs/standard-shader.d.ts

@@ -20,11 +20,11 @@ export declare class StandardShader {
      * @returns
      */
     static getFragmentShaderCode(context: PShaderContext): string;
-    static genVertexShaderCode(materialType: PMaterialType, isWebGL2?: boolean): string;
+    static genVertexShaderCode(materialType: PMaterialType): string;
     /**
      * 获取片段着色器代码
      * @param materialType - 材质类型
      * @returns
      */
-    static genFragmentShaderCode(materialType: PMaterialType, isWebGL2?: boolean): string;
+    static genFragmentShaderCode(materialType: PMaterialType): string;
 }

package/dist/runtime/skybox.d.ts

@@ -1,5 +1,5 @@
 import type { Mesh, Material, TextureSourceOptions, Engine, Renderer } from '@galacean/effects';
-import { Texture } from '@galacean/effects';
+import { spec, Texture } from '@galacean/effects';
 import type { ModelSkyboxComponentData, ModelSkyboxOptions } from '../index';
 import { PEntity } from './object';
 import { PMaterialBase } from './material';
@@ -212,7 +212,7 @@ export interface PSkyboxBaseParams {
     /**
      * 辐射照度系数
      */
-    irradianceCoeffs?: number[][];
+    irradianceCoeffs?: number[];
     /**
      * 高光贴图 Mip 层数
      */
@@ -286,6 +286,17 @@ export declare class PSkyboxCreator {
      * @returns 天空盒选项
      */
     static createSkyboxOptions(engine: Engine, params: PSkyboxParams): Promise<ModelSkyboxOptions>;
+    /**
+     * 创建天空盒选项
+     * @param engine - 引擎
+     * @param params - 天空盒参数
+     * @returns 天空盒选项
+     */
+    static createSkyboxComponentData(params: PSkyboxParams): {
+        imageList: spec.Image[];
+        textureOptionsList: TextureSourceOptions[];
+        component: spec.SkyboxComponentData;
+    };
     /**
      * 创建高光 Cube Map 纹理
      * @param engine - 引擎
@@ -293,6 +304,10 @@ export declare class PSkyboxCreator {
      * @returns 纹理
      */
     static createSpecularCubeMap(engine: Engine, params: PSkyboxParams): Promise<Texture>;
+    static getSpecularCubeMapData(params: PSkyboxParams): {
+        images: spec.Image[];
+        textureOptions: TextureSourceOptions;
+    };
     /**
      * 创建漫反射纹理
      * @param engine - 引擎
@@ -300,6 +315,10 @@ export declare class PSkyboxCreator {
      * @returns 纹理或未定义
      */
     static createDiffuseCubeMap(engine: Engine, params: PSkyboxParams): Promise<Texture | null>;
+    static getDiffuseCubeMapData(params: PSkyboxParams): {
+        images: spec.Image[];
+        textureOptions: TextureSourceOptions;
+    } | undefined;
     /**
      * 创建天空盒参数
      * @param skyboxType - 天空盒类型