@galacean/effects-core 2.0.0-alpha.3 → 2.0.0-alpha.31

package/dist/plugins/timeline/playables/activation-mixer-playable.d.ts

@@ -0,0 +1,7 @@
+import type { FrameContext } from '../../cal/playable-graph';
+import { Playable } from '../../cal/playable-graph';
+export declare class ActivationMixerPlayable extends Playable {
+    processFrame(context: FrameContext): void;
+    private hideRendererComponents;
+    private showRendererComponents;
+}

package/dist/plugins/timeline/playables/sub-composition-clip-playable.d.ts

@@ -0,0 +1,5 @@
+import type { FrameContext } from '../../cal/playable-graph';
+import { Playable } from '../../cal/playable-graph';
+export declare class SubCompositionClipPlayable extends Playable {
+    processFrame(context: FrameContext): void;
+}

package/dist/plugins/timeline/playables/sub-composition-playable-asset.d.ts

@@ -0,0 +1,5 @@
+import type { Playable, PlayableGraph } from '../../cal/playable-graph';
+import { PlayableAsset } from '../../cal/playable-graph';
+export declare class SubCompositionPlayableAsset extends PlayableAsset {
+    createPlayable(graph: PlayableGraph): Playable;
+}

package/dist/plugins/timeline/track.d.ts

@@ -0,0 +1,72 @@
+import { EndBehavior } from '@galacean/effects-specification';
+import type { PlayableGraph } from '../cal/playable-graph';
+import { Playable, PlayableAsset, PlayableOutput } from '../cal/playable-graph';
+import { ParticleSystem } from '../particle/particle-system';
+import type { Constructor } from '../../utils';
+/**
+ * @since 2.0.0
+ * @internal
+ */
+export declare class TimelineClip {
+    id: string;
+    name: string;
+    start: number;
+    duration: number;
+    asset: PlayableAsset;
+    endBehavior: EndBehavior;
+    constructor();
+    toLocalTime(time: number): number;
+}
+/**
+ * @since 2.0.0
+ * @internal
+ */
+export declare class TrackAsset extends PlayableAsset {
+    name: string;
+    binding: object;
+    trackType: TrackType;
+    private clipSeed;
+    private clips;
+    protected children: TrackAsset[];
+    /**
+     * 重写该方法以获取自定义对象绑定
+     */
+    resolveBinding(parentBinding: object): object;
+    /**
+     * 重写该方法以创建自定义混合器
+     */
+    createTrackMixer(graph: PlayableGraph): Playable;
+    createOutput(): PlayableOutput;
+    createPlayableGraph(graph: PlayableGraph, runtimeClips: RuntimeClip[]): Playable;
+    createMixerPlayableGraph(graph: PlayableGraph, runtimeClips: RuntimeClip[]): Playable;
+    compileClips(graph: PlayableGraph, timelineClips: TimelineClip[], runtimeClips: RuntimeClip[]): Playable;
+    createPlayable(graph: PlayableGraph): Playable;
+    getChildTracks(): TrackAsset[];
+    addChild(child: TrackAsset): void;
+    createClip<T extends PlayableAsset>(classConstructor: Constructor<T>, name?: string): TimelineClip;
+    getClips(): TimelineClip[];
+    findClip(name: string): TimelineClip | undefined;
+    addClip(clip: TimelineClip): void;
+    private createClipPlayable;
+}
+export declare enum TrackType {
+    MasterTrack = 0,
+    ObjectTrack = 1
+}
+export declare class RuntimeClip {
+    clip: TimelineClip;
+    playable: Playable;
+    parentMixer: Playable;
+    track: TrackAsset;
+    particleSystem: ParticleSystem;
+    constructor(clip: TimelineClip, clipPlayable: Playable, parentMixer: Playable, track: TrackAsset);
+    set enable(value: boolean);
+    evaluateAt(localTime: number): void;
+}
+/**
+ * @since 2.0.0
+ * @internal
+ */
+export interface TimelineClipData {
+    asset: PlayableAsset;
+}

package/dist/plugins/timeline/tracks/activation-track.d.ts

@@ -0,0 +1,5 @@
+import type { PlayableGraph, Playable } from '../../cal/playable-graph';
+import { TrackAsset } from '../track';
+export declare class ActivationTrack extends TrackAsset {
+    createTrackMixer(graph: PlayableGraph): Playable;
+}

package/dist/plugins/timeline/tracks/sprite-color-track.d.ts

@@ -0,0 +1,3 @@
+import { TrackAsset } from '../track';
+export declare class SpriteColorTrack extends TrackAsset {
+}

package/dist/plugins/timeline/tracks/sub-composition-track.d.ts

@@ -0,0 +1,4 @@
+import { TrackAsset } from '../track';
+export declare class SubCompositionTrack extends TrackAsset {
+    resolveBinding(parentBinding: object): object;
+}

package/dist/plugins/timeline/tracks/transform-track.d.ts

@@ -0,0 +1,3 @@
+import { TrackAsset } from '../track';
+export declare class TransformTrack extends TrackAsset {
+}

package/dist/render/create-copy-shader.d.ts

@@ -2,5 +2,5 @@ import type { SharedShaderWithSource } from './shader';
 export declare const EFFECTS_COPY_MESH_NAME = "effects-internal-copy";
 export declare const COPY_MESH_SHADER_ID = "effects-internal-copy-mesh";
 export declare const COPY_VERTEX_SHADER = "\n#ifdef WEBGL2\n#define vsIn in\n#define vsOut out\n#else\n#define vsIn attribute\n#define vsOut varying\n#endif\nprecision highp float;\nvsIn vec2 aPos;\nvsOut vec2 vTex;\nvoid main(){\n    gl_Position = vec4(aPos,0.,1.0);\n    vTex = (aPos + vec2(1.0))/2.;\n}";
-export declare const COPY_FRAGMENT_SHADER: string;
+export declare const COPY_FRAGMENT_SHADER = "precision mediump float;\n#ifdef WEBGL2\n#define fsIn in\n#define fsOut out\n#define texture2D texture\n#else\n#define fsIn varying\n#endif\nfsIn vec2 vTex;\n#ifdef WEBGL2\nlayout (location = 0) out vec4 fragColor;\n#else\n#define fragColor gl_FragColor\n#endif\n\n#ifdef DEPTH_TEXTURE\nuniform sampler2D uDepth;\n#ifndef WEBGL2\n#extension GL_EXT_frag_depth : enable\n#define gl_FragDepth gl_FragDepthEXT\n#endif\n#endif\nvoid main(){\n    #ifdef DEPTH_TEXTURE\n    gl_FragDepth = texture2D(uDepth,vTex).r;\n    #endif\n}\n";
 export declare function createCopyShader(level: number, writeDepth?: boolean): SharedShaderWithSource;

package/dist/render/{frame-buffer.d.ts → framebuffer.d.ts}

@@ -1,9 +1,9 @@
 import type { Texture } from '../texture';
-import type { RenderBuffer } from './render-buffer';
+import type { Renderbuffer } from './renderbuffer';
 import type { RenderPassAttachmentStorageType, RenderPassDepthStencilAttachmentOptions } from './render-pass';
 import type { RenderPassDestroyAttachmentType, RenderPassStoreAction } from './render-pass';
 import type { Renderer } from './renderer';
-export interface FrameBufferProps {
+export interface FramebufferProps {
     attachments: Texture[];
     depthStencilAttachment?: RenderPassDepthStencilAttachmentOptions;
     isCustomViewport?: boolean;
@@ -23,7 +23,7 @@ export declare enum RenderTextureFormat {
 /**
  *
  */
-export declare class FrameBuffer {
+export declare class Framebuffer {
     depthStencilStorageType: RenderPassAttachmentStorageType;
     name: string;
     viewportScale: number;
@@ -32,17 +32,17 @@ export declare class FrameBuffer {
     externalStorage: boolean;
     storeAction: RenderPassStoreAction;
     isCustomViewport: boolean;
-    static create: (props: FrameBufferProps, renderer: Renderer) => FrameBuffer;
+    static create: (props: FramebufferProps, renderer: Renderer) => Framebuffer;
     resize(x: number, y: number, width: number, height: number): void;
     resetColorTextures(textures: Texture[]): void;
     unbind(): void;
     bind(): void;
-    get stencilStorage(): RenderBuffer | undefined;
-    get depthStorage(): RenderBuffer | undefined;
+    get stencilStorage(): Renderbuffer | undefined;
+    get depthStorage(): Renderbuffer | undefined;
     getDepthTexture(): Texture | undefined;
     getStencilTexture(): Texture | undefined;
     getColorTextures(): Texture[];
-    dispose(opt?: {
+    dispose(options?: {
         depthStencilAttachment?: RenderPassDestroyAttachmentType;
     }): void;
 }

package/dist/render/geometry.d.ts

@@ -24,6 +24,11 @@ export interface GeometryProps {
      */
     maxVertex?: number;
 }
+export interface SkinProps {
+    boneNames?: string[];
+    rootBoneName?: string;
+    inverseBindMatrices?: number[];
+}
 /**
  * Geometry 抽象类
  */
@@ -32,6 +37,10 @@ export declare abstract class Geometry extends EffectsObject {
      * Geometry 的名称
      */
     name: string;
+    /**
+     * 子网格数据
+     */
+    subMeshes: spec.SubMesh[];
     /**
      * Geometry 创建函数
      */
@@ -96,6 +105,10 @@ export declare abstract class Geometry extends EffectsObject {
      * 获取当前 Geometry 的 drawcount
      */
     abstract getDrawCount(): number;
+    /**
+     * 获取当前 Geometry 关联的蒙皮数据
+     */
+    abstract getSkinProps(): SkinProps;
     /**
      * 初始化 GPU 资源
      * @override
@@ -106,4 +119,4 @@ export declare abstract class Geometry extends EffectsObject {
      */
     flush(): void;
 }
-export declare function generateEmptyTypedArray(type: number): Float32Array | Int32Array | Int16Array;
+export declare function generateEmptyTypedArray(type: number): Float32Array | Int16Array | Int32Array;

package/dist/render/global-volume.d.ts

@@ -1,15 +1,17 @@
 /**
  * 后处理配置
  */
-export interface GlobalVolume {
-    usePostProcessing: boolean;
+export interface PostProcessVolumeData {
     useHDR: boolean;
-    useBloom: number;
+    useBloom: boolean;
     threshold: number;
     bloomIntensity: number;
     brightness: number;
     saturation: number;
     contrast: number;
-    useToneMapping: number;
+    vignetteIntensity: number;
+    vignetteSmoothness: number;
+    vignetteRoundness: number;
+    useToneMapping: boolean;
 }
-export declare const defaultGlobalVolume: GlobalVolume;
+export declare const defaultGlobalVolume: PostProcessVolumeData;

package/dist/render/gpu-capability.d.ts

@@ -1,5 +1,5 @@
+import type { GLType } from '../gl';
 import type { Immutable } from '../utils';
-export type GLType = 'webgl' | 'webgl2';
 export interface GPUCapabilityDetail {
     floatTexture: number;
     halfFloatTexture: number;
@@ -42,8 +42,8 @@ export declare class GPUCapability {
     drawBuffers(gl: WebGLRenderingContext | WebGL2RenderingContext, bufferStates: boolean[]): void;
     setTextureAnisotropic(gl: WebGLRenderingContext | WebGL2RenderingContext, target: GLenum, level: number): void;
 }
-export declare const COMPRESSED_TEXTURE: {
-    NONE: number;
-    PVRTC: number;
-    ASTC: number;
-};
+export declare enum COMPRESSED_TEXTURE {
+    NONE = 0,
+    PVRTC = 1,
+    ASTC = 2
+}

package/dist/render/index.d.ts

@@ -1,12 +1,13 @@
 export * from './create-copy-shader';
 export * from './render-frame';
-export * from './render-buffer';
+export * from './renderbuffer';
 export * from './render-pass';
 export * from './shader';
 export * from './gpu-capability';
 export * from './mesh';
 export * from './types';
 export * from './geometry';
-export * from './frame-buffer';
+export * from './framebuffer';
 export * from './renderer';
 export * from './global-volume';
+export * from './semantic-map';

package/dist/render/render-frame.d.ts

@@ -1,11 +1,12 @@
 import type { vec4 } from '@galacean/effects-specification';
-import type { Matrix4 } from '@galacean/effects-math/es/core/index';
-import { Vector2, Vector4 } from '@galacean/effects-math/es/core/index';
+import type { Matrix4 } from '@galacean/effects-math/es/core/matrix4';
+import { Vector2 } from '@galacean/effects-math/es/core/vector2';
+import { Vector4 } from '@galacean/effects-math/es/core/vector4';
 import type { Camera } from '../camera';
 import type { UniformValue } from '../material';
 import { PassTextureCache } from '../paas-texture-cache';
-import type { SemanticFunc } from '../semantic-map';
-import { SemanticMap } from '../semantic-map';
+import type { SemanticFunc } from './semantic-map';
+import { SemanticMap } from './semantic-map';
 import { Texture } from '../texture';
 import type { Disposable } from '../utils';
 import { DestroyOptions } from '../utils';
@@ -13,8 +14,7 @@ import { Mesh } from './mesh';
 import type { RenderPassClearAction, RenderPassColorAttachmentOptions, RenderPassDepthStencilAttachment, RenderPassDestroyOptions, RenderPassStoreAction } from './render-pass';
 import { RenderPass } from './render-pass';
 import type { Renderer } from './renderer';
-import type { GlobalVolume } from './global-volume';
-import type { RendererComponent } from '../components';
+import type { PostProcessVolume, RendererComponent } from '../components';
 /**
  * 渲染数据，保存了当前渲染使用到的数据。
  */
@@ -69,11 +69,11 @@ export interface RenderPassInfo {
  */
 export interface RenderFrameResource {
     /**
-     * 纹理对象，用于 FrameBuffer 的颜色 Attachment
+     * 纹理对象，用于 Framebuffer 的颜色 Attachment
      */
     color_a: Texture;
     /**
-     * 纹理对象，用于 FrameBuffer 的颜色 Attachment
+     * 纹理对象，用于 Framebuffer 的颜色 Attachment
      */
     color_b: Texture;
     /**
@@ -127,7 +127,7 @@ export interface RenderFrameOptions {
     /**
      * 后处理渲染配置
      */
-    globalVolume?: Partial<GlobalVolume>;
+    globalVolume?: PostProcessVolume;
     /**
      * 名称
      */
@@ -165,7 +165,7 @@ export declare class RenderFrame implements Disposable {
     /**
      * 存放后处理的属性设置
      */
-    globalVolume: GlobalVolume;
+    globalVolume: PostProcessVolume;
     renderer: Renderer;
     resource: RenderFrameResource;
     keepColorBuffer?: boolean;
@@ -210,7 +210,7 @@ export declare class RenderFrame implements Disposable {
      */
     dispose(options?: RenderFrameDestroyOptions): void;
     /**
-     * 重置 RenderPass ColorAttachment，解决 FrameBuffer 即读又写的问题
+     * 重置 RenderPass ColorAttachment，解决 Framebuffer 即读又写的问题
      * @param renderPasses - RenderPass 对象数组
      * @param startIndex - 开始重置的索引
      */
@@ -239,7 +239,7 @@ export declare class RenderFrame implements Disposable {
     createResource(): void;
     /**
      * 创建拷贝 RenderPass 用到的 Mesh 对象
-     * @param semantics - RenderPass 渲染时 FrameBuffer 的颜色和深度纹理、大小和是否混合
+     * @param semantics - RenderPass 渲染时 Framebuffer 的颜色和深度纹理、大小和是否混合
      */
     createCopyMesh(semantics?: {
         tex?: string;

package/dist/render/render-pass.d.ts

@@ -4,14 +4,14 @@ import type { Camera } from '../camera';
 import type { RendererComponent } from '../components';
 import type { Engine } from '../engine';
 import type { MeshDestroyOptions, Renderer } from '../render';
-import { FrameBuffer } from '../render';
-import type { SemanticGetter } from '../semantic-map';
-import { SemanticMap } from '../semantic-map';
+import { Framebuffer } from '../render';
+import type { SemanticGetter } from './semantic-map';
+import { SemanticMap } from './semantic-map';
 import type { TextureConfigOptions, TextureLoadAction } from '../texture';
 import { Texture } from '../texture';
 import type { Disposable, Sortable } from '../utils';
 import { DestroyOptions, OrderType } from '../utils';
-import type { RenderBuffer } from './render-buffer';
+import type { Renderbuffer } from './renderbuffer';
 import type { RenderingData } from './render-frame';
 export declare const RenderPassPriorityPrepare = 0;
 export declare const RenderPassPriorityNormal = 1000;
@@ -76,9 +76,9 @@ export interface RenderPassColorAttachmentOptions {
     /**
      * ColorAttachment 的 Buffer 参数
      */
-    buffer?: RenderBuffer;
+    buffer?: Renderbuffer;
     /**
-     * WebGL2 下 RenderBuffer 超采数目。默认是0，即不启用超采。
+     * WebGL2 下 Renderbuffer 超采数目。默认是0，即不启用超采。
      * @default 0
      */
     multiSample?: number;
@@ -102,12 +102,12 @@ export declare class RenderTargetHandle implements Disposable {
 }
 export interface RenderPassDepthStencilAttachment {
     readonly storageType: RenderPassAttachmentStorageType;
-    readonly storage?: RenderBuffer;
+    readonly storage?: Renderbuffer;
     readonly texture?: Texture;
 }
 export interface RenderPassDepthStencilAttachmentOptions {
     storageType: RenderPassAttachmentStorageType;
-    storage?: RenderBuffer;
+    storage?: Renderbuffer;
     texture?: Texture;
 }
 /**
@@ -209,7 +209,7 @@ export declare class RenderPass implements Disposable, Sortable {
      * ColorAttachment 数组
      */
     attachments: RenderTargetHandle[];
-    frameBuffer?: FrameBuffer;
+    framebuffer: Framebuffer | null;
     /**
      * 名称
      */
@@ -227,7 +227,7 @@ export declare class RenderPass implements Disposable, Sortable {
      */
     readonly camera?: Camera;
     /**
-     * 深度和蒙版 Attachment 类型，注意区分纹理和 RenderBuffer
+     * 深度和蒙版 Attachment 类型，注意区分纹理和 Renderbuffer
      */
     readonly depthStencilType: RenderPassAttachmentStorageType;
     /**

package/dist/render/{render-buffer.d.ts → renderbuffer.d.ts}

@@ -1,19 +1,19 @@
 import type { Disposable } from '../utils';
 import type { RenderPassAttachmentStorageType } from './render-pass';
-export interface RenderBufferProps {
+export interface RenderbufferProps {
     storageType: RenderPassAttachmentStorageType;
     format: GLenum;
     attachment: GLenum;
 }
-export declare abstract class RenderBuffer implements Disposable {
+export declare abstract class Renderbuffer implements Disposable {
     readonly size: [x: number, y: number];
     readonly multiSample = 1;
     readonly storageType: RenderPassAttachmentStorageType;
     readonly format: GLenum;
     readonly attachment: GLenum;
     protected destroyed: boolean;
-    static create: (props: RenderBufferProps) => RenderBuffer;
-    constructor(props: RenderBufferProps);
+    static create: (props: RenderbufferProps) => Renderbuffer;
+    constructor(props: RenderbufferProps);
     get isDestroyed(): boolean;
     abstract setSize(width: number, height: number): void;
     abstract dispose(): void;

package/dist/render/renderer.d.ts

@@ -3,13 +3,14 @@ import type { RendererComponent } from '../components/renderer-component';
 import type { Engine } from '../engine';
 import type { Material } from '../material';
 import type { LostHandler, RestoreHandler } from '../utils';
-import type { FilterMode, FrameBuffer, RenderTextureFormat } from './frame-buffer';
+import type { FilterMode, Framebuffer, RenderTextureFormat } from './framebuffer';
 import type { Geometry } from './geometry';
 import type { RenderFrame, RenderingData } from './render-frame';
 import type { RenderPassClearAction, RenderPassStoreAction } from './render-pass';
 import type { ShaderLibrary } from './shader';
+import type { GLType } from '../gl';
 export declare class Renderer implements LostHandler, RestoreHandler {
-    static create: (canvas: HTMLCanvasElement | OffscreenCanvas, framework: 'webgl' | 'webgl2', renderOptions?: WebGLContextAttributes) => Renderer;
+    static create: (canvas: HTMLCanvasElement | OffscreenCanvas, framework: GLType, renderOptions?: WebGLContextAttributes) => Renderer;
     engine: Engine;
     env: string;
     /**
@@ -20,8 +21,8 @@ export declare class Renderer implements LostHandler, RestoreHandler {
     setGlobalFloat(name: string, value: number): void;
     setGlobalInt(name: string, value: number): void;
     setGlobalMatrix(name: string, value: Matrix4): void;
-    getFrameBuffer(): FrameBuffer | null;
-    setFrameBuffer(frameBuffer: FrameBuffer | null): void;
+    getFramebuffer(): Framebuffer | null;
+    setFramebuffer(framebuffer: Framebuffer | null): void;
     setViewport(x: number, y: number, width: number, height: number): void;
     resize(canvasWidth: number, canvasHeight: number): void;
     clear(action: RenderPassClearAction | RenderPassStoreAction): void;
@@ -56,7 +57,7 @@ export declare class Renderer implements LostHandler, RestoreHandler {
     getShaderLibrary(): ShaderLibrary | undefined;
     renderRenderFrame(renderFrame: RenderFrame): void;
     renderMeshes(meshes: RendererComponent[]): void;
-    drawGeometry(geometry: Geometry, material: Material): void;
-    getTemporaryRT(name: string, width: number, height: number, depthBuffer: number, filter: FilterMode, format: RenderTextureFormat): FrameBuffer | null;
+    drawGeometry(geometry: Geometry, material: Material, subMeshIndex?: number): void;
+    getTemporaryRT(name: string, width: number, height: number, depthBuffer: number, filter: FilterMode, format: RenderTextureFormat): Framebuffer | null;
     dispose(haltGL?: boolean): void;
 }

package/dist/render/semantic-map.d.ts

@@ -0,0 +1,14 @@
+import type { UniformValue } from '../material';
+import type { RenderingData } from '.';
+import type { Disposable } from '../utils';
+export type SemanticFunc = (state: RenderingData) => UniformValue | undefined;
+export type SemanticGetter = UniformValue | SemanticFunc;
+export declare class SemanticMap implements Disposable {
+    readonly semantics: Record<string, SemanticGetter>;
+    constructor(semantics?: Record<string, SemanticGetter>);
+    toObject(): Record<string, SemanticGetter>;
+    setSemantic(name: string, value?: SemanticGetter): void;
+    getSemanticValue(name: string, state: RenderingData): number | Float32Array | Float64Array | Uint8Array | Uint32Array | Uint16Array | Int8Array | Int16Array | Int32Array | number[] | number[][] | import("@galacean/effects-core").Texture | import("@galacean/effects-math/es/core").Vector2 | import("@galacean/effects-math/es/core").Vector3 | import("@galacean/effects-math/es/core").Vector4 | import("@galacean/effects-math/es/core").Matrix3 | import("@galacean/effects-math/es/core").Matrix4 | import("@galacean/effects-core").Texture[] | import("packages/effects-core/src/material/types").UniformStruct | import("packages/effects-core/src/material/types").UniformStruct[] | SemanticFunc | undefined;
+    hasSemanticValue(name: string): boolean;
+    dispose(): void;
+}

package/dist/render/shader.d.ts

@@ -1,6 +1,7 @@
+import type * as spec from '@galacean/effects-specification';
 import { EffectsObject } from '../effects-object';
 import type { Engine } from '../engine';
-export type ShaderMarcos = [key: string, value: string | number | boolean][];
+export type ShaderMacros = [key: string, value: string | number | boolean][];
 export declare enum ShaderCompileResultStatus {
     noShader = 0,
     success = 1,
@@ -38,7 +39,7 @@ export interface InstancedShaderWithSource {
     /**
      * shader的宏定义
      */
-    marcos?: ShaderMarcos;
+    macros?: ShaderMacros;
     /**
      * shader是否共享
      */
@@ -64,7 +65,7 @@ export interface SharedShaderWithSource {
     /**
      * shader的宏定义
      */
-    marcos?: ShaderMarcos;
+    macros?: ShaderMacros;
     /**
      * 是否共用GLProgram
      * shared为true时，
@@ -78,16 +79,22 @@ export interface SharedShaderWithSource {
     cacheId?: string;
 }
 export type ShaderWithSource = InstancedShaderWithSource | SharedShaderWithSource;
-export declare abstract class Shader extends EffectsObject {
+export declare abstract class ShaderVariant extends EffectsObject {
     readonly source: ShaderWithSource;
+    shader: Shader;
     constructor(engine: Engine, source: ShaderWithSource);
 }
+export declare class Shader extends EffectsObject {
+    shaderData: spec.ShaderData;
+    createVariant(macros?: Record<string, number | boolean>): ShaderVariant;
+    fromData(data: spec.ShaderData): void;
+}
 export interface ShaderLibrary {
     readonly shaderResults: {
         [cacheId: string]: ShaderCompileResult;
     };
     addShader(shader: ShaderWithSource): void;
-    createShader(shaderSource: ShaderWithSource): Shader;
+    createShader(shaderSource: ShaderWithSource, macros?: ShaderMacros): ShaderVariant;
     /**
      * @param cacheId
      */

package/dist/scene.d.ts

@@ -1,16 +1,17 @@
 import type * as spec from '@galacean/effects-specification';
-import type { SceneType } from './asset-manager';
 import type { Texture } from './texture';
 import type { PluginSystem } from './plugin-system';
+import type { PickEnum } from './utils';
 export type ImageSource = spec.TemplateImage | spec.Image | spec.CompressedImage;
+export type SceneRenderLevel = PickEnum<spec.RenderLevel, spec.RenderLevel.A | spec.RenderLevel.B | spec.RenderLevel.S>;
 /**
- *
+ * 场景类型
  */
 export interface Scene {
     readonly jsonScene: spec.JSONScene;
     readonly bins: ArrayBuffer[];
     readonly pluginSystem: PluginSystem;
-    readonly renderLevel?: spec.RenderLevel;
+    readonly renderLevel?: SceneRenderLevel;
     readonly storage: Record<string, any>;
     textureOptions: Record<string, any>[];
     images: ImageSource[];
@@ -24,7 +25,88 @@ export interface Scene {
      * 加载开始时间
      */
     startTime?: number;
+    /**
+     * 加载分段时长
+     */
+    timeInfos: Record<string, number>;
     url: SceneType;
     usedImages: Record<number, boolean>;
 }
-export declare function isScene(scene: any): scene is Scene;
+/**
+ * 场景加载参数
+ */
+export interface SceneLoadOptions {
+    /**
+     * 动态数据的参数
+     * key 是 JSON 中配置的字段名
+     * value 是要使用的值，图片使用 url 链接
+     * 图片链接可以使用数组传递，如果第一个加载失败，将尝试使用第二个地址
+     *
+     * @example
+     * ``` ts
+     * {
+     *   variables: {
+     *     bg: ['url','fallback_url'], // 如果两个图片都失败，将会触发加载失败
+     *     fg: 'url' // 如果图片加载失败，将会触发加载失败,
+     *     amount: 88.8,
+     *     name: 'abc'
+     *   }
+     * }
+     * ```
+     */
+    variables?: spec.TemplateVariables;
+    /**
+     * 是否使用压缩纹理
+     */
+    useCompressedTexture?: boolean;
+    /**
+     * 渲染分级。
+     * 分级之后，只会加载当前渲染等级的资源。
+     * 当渲染等级被设置为 B 后，player 的 fps 会降到 30 帧
+     * @default 'S'
+     */
+    renderLevel?: SceneRenderLevel;
+    /**
+     * 资源加载超时，时间单位秒
+     * @default 10s
+     */
+    timeout?: number;
+    /***
+     * 用于给 plugin 的加载数据
+     * key/value 的内容由 plugin 自己实现
+     */
+    pluginData?: Record<string, any>;
+    /**
+     * 场景加载时的环境（加载后把 env 结果写入 scene）
+     * @default '' - 编辑器中为 'editor'
+     */
+    env?: string;
+    /**
+     * 加载后是否自动播放
+     * @default true
+     */
+    autoplay?: boolean;
+    /**
+     * 合成播放完成后是否需要再使用，是的话生命周期结束后不会 `dispose`
+     * @default false
+     */
+    reusable?: boolean;
+    /**
+     * 播放速度，当速度为负数时，合成倒播
+     */
+    speed?: number;
+}
+/**
+ * 接受用于加载的数据类型
+ */
+export type SceneURLType = {
+    url: string;
+};
+export type SceneType = string | Scene | SceneURLType | Record<string, any>;
+export type SceneWithOptionsType = {
+    options: SceneLoadOptions;
+};
+export type SceneLoadType = SceneType | SceneWithOptionsType;
+export declare function isSceneJSON(scene: any): scene is Scene;
+export declare function isSceneURL(scene: any): scene is Scene;
+export declare function isSceneWithOptions(scene: any): scene is SceneWithOptionsType;