@galacean/engine-core 1.0.0 → 1.1.0-alpha.0

package/types/RenderPipeline/Basic2DBatcher.d.ts

@@ -1,19 +1,18 @@
 import { Camera } from "../Camera";
 import { Engine } from "../Engine";
-import { Material } from "../material";
-import { SpriteElement } from "./SpriteElement";
-import { SpriteMaskElement } from "./SpriteMaskElement";
-import { TextRenderElement } from "./TextRenderElement";
+import { ShaderTagKey } from "../shader/ShaderTagKey";
+import { RenderElement } from "./RenderElement";
 export declare abstract class Basic2DBatcher {
+    protected static _disableBatchTag: ShaderTagKey;
     /** The maximum number of vertex. */
     static MAX_VERTEX_COUNT: number;
     static _canUploadSameBuffer: boolean;
     constructor(engine: Engine);
-    drawElement(element: SpriteMaskElement | SpriteElement | TextRenderElement, camera: Camera, replaceMaterial: Material): void;
-    private _drawSubElement;
-    flush(camera: Camera, replaceMaterial: Material): void;
+    drawElement(element: RenderElement, camera: Camera): void;
+    flush(camera: Camera): void;
     clear(): void;
     destroy(): void;
+    private _drawSubElement;
     private _createMesh;
     private _updateData;
     private _getSubMeshFromPool;

package/types/RenderPipeline/BasicRenderPipeline.d.ts

@@ -3,14 +3,14 @@ import { Layer } from "../Layer";
 import { Material } from "../material";
 import { RenderTarget, TextureCubeFace } from "../texture";
 import { RenderContext } from "./RenderContext";
-import { RenderElement } from "./RenderElement";
+import { RenderData } from "./RenderData";
 import { RenderPass } from "./RenderPass";
 /**
  * Basic render pipeline.
  */
 export declare class BasicRenderPipeline {
-    private static _tempVector0;
-    private static _tempVector1;
+    private static _shadowCasterPipelineStageTagValue;
+    private static _forwardPipelineStageTagValue;
     private _camera;
     private _defaultPass;
     private _renderPassArray;
@@ -57,10 +57,12 @@ export declare class BasicRenderPipeline {
     render(context: RenderContext, cubeFace?: TextureCubeFace, mipLevel?: number): void;
     private _drawRenderPass;
     /**
-     * Push a render element to the render queue.
-     * @param element - Render element
+     * Push render data to render queue.
+     * @param context - Render context
+     * @param data - Render data
      */
-    pushPrimitive(element: RenderElement): void;
+    pushRenderData(context: RenderContext, data: RenderData): void;
+    private pushRenderDataWihShader;
     private _drawBackgroundTexture;
     private _callRender;
 }

package/types/RenderPipeline/MeshRenderData.d.ts

@@ -0,0 +1,15 @@
+import { Mesh } from "../graphic/Mesh";
+import { SubMesh } from "../graphic/SubMesh";
+import { Material } from "../material/Material";
+import { Renderer } from "../Renderer";
+import { RenderData } from "./RenderData";
+/**
+ * Render element.
+ */
+export declare class MeshRenderData extends RenderData {
+    /** Mesh. */
+    mesh: Mesh;
+    /** Sub mesh. */
+    subMesh: SubMesh;
+    set(component: Renderer, material: Material, mesh: Mesh, subMesh: SubMesh): void;
+}

package/types/RenderPipeline/RenderData.d.ts

@@ -0,0 +1,7 @@
+import { Material } from "../material";
+import { Renderer } from "../Renderer";
+export declare class RenderData {
+    component: Renderer;
+    material: Material;
+    multiRenderData: boolean;
+}

package/types/RenderPipeline/RenderElement.d.ts

@@ -1,11 +1,9 @@
-import { Material } from "../material/Material";
-import { Renderer } from "../Renderer";
-import { ShaderPass } from "../shader";
+import { ShaderPass } from "../shader/ShaderPass";
 import { RenderState } from "../shader/state/RenderState";
+import { RenderData } from "./RenderData";
 export declare class RenderElement {
-    component: Renderer;
-    material: Material;
-    multiRenderData: boolean;
-    renderState: RenderState;
+    data: RenderData;
     shaderPass: ShaderPass;
+    renderState: RenderState;
+    set(data: RenderData, shaderPass: ShaderPass, renderState: RenderState): void;
 }

package/types/RenderPipeline/RenderPass.d.ts

@@ -23,7 +23,7 @@ declare class RenderPass {
      * @param name - Pass name
      * @param priority - Priority, less than 0 before the default pass, greater than 0 after the default pass
      * @param renderTarget - The specified Render Target
-     * @param replaceMaterial -  Replaced material
+     * @param replaceMaterial - Replaced material
      * @param mask - Perform bit and operations with Entity.Layer to filter the objects that this Pass needs to render
      */
     constructor(name?: string, priority?: number, renderTarget?: any, replaceMaterial?: any, mask?: any);

package/types/RenderPipeline/RenderQueue.d.ts

@@ -1,21 +1,19 @@
 import { Camera } from "../Camera";
 import { Engine } from "../Engine";
 import { Layer } from "../Layer";
-import { Material } from "../material/Material";
-import { Shader } from "../shader";
 import { RenderElement } from "./RenderElement";
 /**
  * Render queue.
  */
 export declare class RenderQueue {
-    readonly items: RenderElement[];
+    readonly elements: RenderElement[];
     private _spriteBatcher;
     constructor(engine: Engine);
     /**
      * Push a render element.
      */
-    pushPrimitive(element: RenderElement): void;
-    render(camera: Camera, replaceMaterial: Material, mask: Layer, customShader: Shader): void;
+    pushRenderElement(element: RenderElement): void;
+    render(camera: Camera, mask: Layer): void;
     /**
      * Clear collection.
      */

package/types/RenderPipeline/SpriteMaskBatcher.d.ts

@@ -1,10 +1,11 @@
 import { Camera } from "../Camera";
 import { VertexElement } from "../graphic/VertexElement";
 import { Basic2DBatcher } from "./Basic2DBatcher";
-import { SpriteMaskElement } from "./SpriteMaskElement";
+import { RenderElement } from "./RenderElement";
+import { SpriteMaskRenderData } from "./SpriteMaskRenderData";
 export declare class SpriteMaskBatcher extends Basic2DBatcher {
     createVertexElements(vertexElements: VertexElement[]): number;
-    canBatch(preElement: SpriteMaskElement, curElement: SpriteMaskElement): boolean;
-    updateVertices(element: SpriteMaskElement, vertices: Float32Array, vertexIndex: number): number;
+    canBatch(preElement: RenderElement, curElement: RenderElement): boolean;
+    updateVertices(element: SpriteMaskRenderData, vertices: Float32Array, vertexIndex: number): number;
     drawBatches(camera: Camera): void;
 }

package/types/RenderPipeline/SpriteMaskRenderData.d.ts

@@ -0,0 +1,10 @@
+import { VertexData2D } from "../2d/data/VertexData2D";
+import { Material } from "../material/Material";
+import { Renderer } from "../Renderer";
+import { RenderData } from "./RenderData";
+export declare class SpriteMaskRenderData extends RenderData {
+    isAdd: boolean;
+    verticesData: VertexData2D;
+    constructor();
+    set(component: Renderer, material: Material, verticesData: VertexData2D): void;
+}

package/types/RenderPipeline/SpriteRenderData.d.ts

@@ -0,0 +1,12 @@
+import { VertexData2D } from "../2d/data/VertexData2D";
+import { Material } from "../material/Material";
+import { Renderer } from "../Renderer";
+import { Texture2D } from "../texture";
+import { RenderData } from "./RenderData";
+export declare class SpriteRenderData extends RenderData {
+    verticesData: VertexData2D;
+    texture: Texture2D;
+    dataIndex: number;
+    constructor();
+    set(component: Renderer, material: Material, verticesData: VertexData2D, texture: Texture2D, dataIndex?: number): void;
+}

package/types/RenderPipeline/TextRenderData.d.ts

@@ -0,0 +1,6 @@
+import { RenderData } from "./RenderData";
+import { SpriteRenderData } from "./SpriteRenderData";
+export declare class TextRenderData extends RenderData {
+    charsData: SpriteRenderData[];
+    constructor();
+}

package/types/RenderPipeline/enums/PipelineStage.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Pipeline stage.
+ */
+export declare enum PipelineStage {
+    /** Shadow caster stage. */
+    ShadowCaster = "ShadowCaster",
+    /** Forward shading stage. */
+    Forward = "Forward"
+}

package/types/RenderPipeline/index.d.ts

@@ -0,0 +1,4 @@
+export { BasicRenderPipeline } from "./BasicRenderPipeline";
+export { PipelineStage } from "./enums/PipelineStage";
+export { RenderPass } from "./RenderPass";
+export { RenderQueue } from "./RenderQueue";

package/types/Renderer.d.ts

@@ -1,14 +1,13 @@
-import { BoundingBox, Matrix, Vector4 } from "@galacean/engine-math";
+import { BoundingBox, Vector4 } from "@galacean/engine-math";
 import { Component } from "./Component";
-import { RenderContext } from "./RenderPipeline/RenderContext";
-import { TransformModifyFlags } from "./Transform";
-import { Material } from "./material/Material";
+import { ICustomClone } from "./clone/ComponentCloner";
+import { Material } from "./material";
 import { ShaderData } from "./shader/ShaderData";
 /**
  * Basis for all renderers.
- * @decorator `@dependentComponents(Transform)`
+ * @decorator `@dependentComponents(Transform, DependentMode.CheckOnly)`
  */
-export declare class Renderer extends Component {
+export declare class Renderer extends Component implements ICustomClone {
     private static _tempVector0;
     private static _receiveShadowMacro;
     private static _localMatrixProperty;
@@ -108,12 +107,5 @@ export declare class Renderer extends Component {
      */
     setMaterials(materials: Material[]): void;
     update(deltaTime: number): void;
-    protected _updateShaderData(context: RenderContext): void;
-    protected _updateTransformShaderData(context: RenderContext, worldMatrix: Matrix): void;
-    protected _registerEntityTransformListener(): void;
-    protected _updateBounds(worldBounds: BoundingBox): void;
-    protected _render(context: RenderContext): void;
-    private _createInstanceMaterial;
     private _setMaterial;
-    protected _onTransformChanged(type: TransformModifyFlags): void;
 }

package/types/SafeLoopArray.d.ts

@@ -0,0 +1,37 @@
+export declare class SafeLoopArray<T> {
+    private _array;
+    private _loopArray;
+    private _loopArrayDirty;
+    /**
+     * Get the length of the array.
+     */
+    get length(): number;
+    /**
+     * Push item to the array.
+     * @param item - The item which want to be pushed
+     */
+    push(item: T): void;
+    /**
+     * Splice the array.
+     * @param index - The index of the array
+     * @param deleteCount - The count of the array which want to be deleted
+     * @param item - The item which want to be added
+     */
+    splice(index: number, deleteCount: number, item?: T): void;
+    /**
+     * The index of the item.
+     * @param item - The item which want to get the index
+     * @returns Index of the item
+     */
+    indexOf(item: T): number;
+    /**
+     * Get the array.
+     * @returns The array
+     */
+    getArray(): ReadonlyArray<T>;
+    /**
+     * Get the array use for loop.
+     * @returns The array use for loop
+     */
+    getLoopArray(): ReadonlyArray<T>;
+}

package/types/Scene.d.ts

@@ -1,10 +1,11 @@
 import { Color, Vector3 } from "@galacean/engine-math";
 import { Background } from "./Background";
-import { EngineObject } from "./base";
 import { Engine } from "./Engine";
 import { Entity } from "./Entity";
+import { EngineObject } from "./base";
 import { FogMode } from "./enums/FogMode";
 import { AmbientLight } from "./lighting/AmbientLight";
+import { PhysicsScene } from "./physics/PhysicsScene";
 import { ShaderData } from "./shader/ShaderData";
 import { ShadowCascadesMode } from "./shadow/enum/ShadowCascadesMode";
 import { ShadowResolution } from "./shadow/enum/ShadowResolution";
@@ -14,8 +15,12 @@ import { ShadowResolution } from "./shadow/enum/ShadowResolution";
 export declare class Scene extends EngineObject {
     private static _fogColorProperty;
     private static _fogParamsProperty;
+    private static _sunlightColorProperty;
+    private static _sunlightDirectionProperty;
     /** Scene name. */
     name: string;
+    /** Physics. */
+    readonly physics: PhysicsScene;
     /** The background of the scene. */
     readonly background: Background;
     /** Scene-related shader data. */
@@ -132,10 +137,6 @@ export declare class Scene extends EngineObject {
      * @returns Entity
      */
     findEntityByPath(path: string): Entity | null;
-    /**
-     * Destroy this scene.
-     */
-    destroy(): void;
     private _addToRootEntityList;
     private _computeLinearFogParams;
     private _computeExponentialFogParams;

package/types/SceneManager.d.ts

@@ -1,20 +1,35 @@
-import { AssetPromise } from "./asset/AssetPromise";
 import { Engine } from "./Engine";
 import { Scene } from "./Scene";
+import { AssetPromise } from "./asset/AssetPromise";
 /**
  * Scene manager.
  */
 export declare class SceneManager {
     readonly engine: Engine;
     /**
-     * Get the activated scene.
+     * Get the scene list.
      */
-    get activeScene(): Scene;
-    set activeScene(scene: Scene);
+    get scenes(): ReadonlyArray<Scene>;
+    /**
+     * Add scene.
+     * @param scene - The scene which want to be added
+     */
+    addScene(scene: Scene): void;
+    /**
+     * Add scene at specified index.
+     * @param index - specified index
+     * @param child - The scene which want to be added
+     */
+    addScene(index: number, scene: Scene): void;
+    /**
+     * Remove scene.
+     * @param scene - The scene which want to be removed
+     */
+    removeScene(scene: Scene): void;
     /**
      * Load and activate scene.
      * @param url - the path of the scene
-     * @param destroyOldScene - whether to destroy old scene information
+     * @param destroyOldScene - whether to destroy old scene
      * @returns scene promise
      */
     loadScene(url: string, destroyOldScene?: boolean): AssetPromise<Scene>;
@@ -25,4 +40,12 @@ export declare class SceneManager {
      * @param destScene - target scene
      */
     mergeScenes(sourceScene: Scene, destScene: Scene): void;
+    /**
+     * @deprecated
+     * Please use `scenes` instead.
+     *
+     * Get the first scene.
+     */
+    get activeScene(): Scene;
+    set activeScene(scene: Scene);
 }

package/types/Script.d.ts

@@ -2,6 +2,7 @@ import { Camera } from "./Camera";
 import { Component } from "./Component";
 import { Pointer } from "./input";
 import { ColliderShape } from "./physics";
+import { Collision } from "./physics/Collision";
 /**
  * Script class, used for logic writing.
  */
@@ -22,12 +23,12 @@ export declare class Script extends Component {
     onStart(): void;
     /**
      * The main loop, called frame by frame.
-     * @param deltaTime - The deltaTime when the script update.
+     * @param deltaTime - The delta time since last frame in seconds
      */
     onUpdate(deltaTime: number): void;
     /**
      * Called after the onUpdate finished, called frame by frame.
-     * @param deltaTime - The deltaTime when the script update.
+     * @param deltaTime - The delta time since last frame in seconds
      */
     onLateUpdate(deltaTime: number): void;
     /**
@@ -45,37 +46,39 @@ export declare class Script extends Component {
      */
     onPhysicsUpdate(): void;
     /**
-     * Called when the collision enter.
+     * Called when the trigger enter.
      * @param other - ColliderShape
      */
     onTriggerEnter(other: ColliderShape): void;
     /**
-     * Called when the collision stay.
-     * @remarks onTriggerStay is called every frame while the collision stay.
+     * Called when the trigger exit.
      * @param other - ColliderShape
      */
     onTriggerExit(other: ColliderShape): void;
     /**
-     * Called when the collision exit.
+     * Called when the trigger stay.
+     * @remarks onTriggerStay is called every frame while the trigger stay.
      * @param other - ColliderShape
      */
     onTriggerStay(other: ColliderShape): void;
     /**
      * Called when the collision enter.
-     * @param other - ColliderShape
+     * @param other - The Collision data associated with this collision event
+     * @remarks The Collision data will be invalid after this call, you should copy the data if needed.
      */
-    onCollisionEnter(other: ColliderShape): void;
+    onCollisionEnter(other: Collision): void;
     /**
-     * Called when the collision stay.
-     * @remarks onTriggerStay is called every frame while the collision stay.
-     * @param other - ColliderShape
+     * Called when the collision exit.
+     * @param other - The Collision data associated with this collision event
+     * @remarks The Collision data will be invalid after this call, you should copy the data if needed.
      */
-    onCollisionExit(other: ColliderShape): void;
+    onCollisionExit(other: Collision): void;
     /**
-     * Called when the collision exit.
-     * @param other - ColliderShape
+     * Called when the collision stay.
+     * @param other - The Collision data associated with this collision event
+     * @remarks The Collision data will be invalid after this call, you should copy the data if needed.
      */
-    onCollisionStay(other: ColliderShape): void;
+    onCollisionStay(other: Collision): void;
     /**
      * Called when the pointer is down while over the ColliderShape.
      * @param pointer - The pointer that triggered

package/types/Transform.d.ts

@@ -24,6 +24,9 @@ export declare class Transform extends Component {
     private _lossyWorldScale;
     private _localMatrix;
     private _worldMatrix;
+    private _worldForward;
+    private _worldRight;
+    private _worldUp;
     private _isParentDirty;
     private _parentTransformCache;
     private _dirtyFlag;
@@ -135,23 +138,17 @@ export declare class Transform extends Component {
      */
     setWorldRotationQuaternion(x: number, y: number, z: number, w: number): void;
     /**
-     * Get the forward direction in world space.
-     * @param forward - Forward vector
-     * @returns Forward vector
+     * The forward direction in world space.
      */
-    getWorldForward(forward: Vector3): Vector3;
+    get worldForward(): Vector3;
     /**
-     * Get the right direction in world space.
-     * @param right - Right vector
-     * @returns Right vector
+     * The right direction in world space.
      */
-    getWorldRight(right: Vector3): Vector3;
+    get worldRight(): Vector3;
     /**
-     * Get the up direction in world space.
-     * @param up - Up vector
-     * @returns Up vector
+     * The up direction in world space.
      */
-    getWorldUp(up: Vector3): Vector3;
+    get worldUp(): Vector3;
     /**
      * Translate in the direction and distance of the translation.
      * @param translation - Direction and distance of translation

package/types/Utils.d.ts

@@ -1,3 +1,31 @@
 export declare class Utils {
+    /**
+     * Fast remove an element from array.
+     * @param array - Array
+     * @param item - Element
+     */
+    static removeFromArray(array: any[], item: any): boolean;
+    /**
+     * Decodes a given Uint8Array into a string.
+     */
+    static decodeText(array: Uint8Array): string;
+    /**
+     * Judge whether the url is absolute url.
+     * @param url - The url to be judged.
+     * @returns Whether the url is absolute url.
+     */
+    static isAbsoluteUrl(url: string): boolean;
+    /**
+     * Get the values of an object.
+     */
+    static objectValues(obj: any): any[];
+    /**
+     * Convert a relative URL to an absolute URL based on a given base URL.
+     * @param baseUrl - The base url.
+     * @param relativeUrl - The relative url.
+     * @returns The resolved url.
+     */
+    static resolveAbsoluteUrl(baseUrl: string, relativeUrl: string): string;
     private static _stringToPath;
+    private static _formatRelativePath;
 }

package/types/animation/AnimationClip.d.ts

@@ -1,3 +1,4 @@
+import { EngineObject } from "../base/EngineObject";
 import { Component } from "../Component";
 import { Entity } from "../Entity";
 import { AnimationClipCurveBinding } from "./AnimationClipCurveBinding";
@@ -7,7 +8,7 @@ import { KeyframeValueType } from "./Keyframe";
 /**
  * Stores keyframe based animations.
  */
-export declare class AnimationClip {
+export declare class AnimationClip extends EngineObject {
     readonly name: string;
     private _length;
     private _events;

package/types/animation/Animator.d.ts

@@ -14,8 +14,7 @@ export declare class Animator extends Component {
     protected _animatorController: AnimatorController;
     protected _controllerUpdateFlag: BoolUpdateFlag;
     private _animatorLayersData;
-    private _crossOwnerCollection;
-    private _animationCurveOwners;
+    private _curveOwnerPool;
     private _animationEventHandlerPool;
     private _tempAnimatorStateInfo;
     private _controlledRenderers;
@@ -61,7 +60,7 @@ export declare class Animator extends Component {
     private _saveAnimatorStateData;
     private _saveAnimatorEventHandlers;
     private _clearCrossData;
-    private _addCrossCurveData;
+    private _addCrossOwner;
     private _prepareCrossFading;
     private _prepareStandbyCrossFading;
     private _prepareFixedPoseCrossFading;

package/types/animation/animationCurve/AnimationFloatArrayCurve.d.ts

@@ -6,7 +6,6 @@ import { AnimationCurve } from "./AnimationCurve";
 export declare class AnimationFloatArrayCurve extends AnimationCurve<Float32Array> {
     /**
      * @inheritdoc
-     * @override
      */
     addKey(key: Keyframe<Float32Array>): void;
 }

package/types/animation/internal/AnimationCurveLayerOwner.d.ts

@@ -0,0 +1 @@
+export {};

package/types/animation/internal/AnimationCurveOwnerLayerData.d.ts

@@ -0,0 +1 @@
+export {};

package/types/asset/AssetType.d.ts

@@ -6,47 +6,47 @@ export declare enum AssetType {
      * Plain text.
      * @remarks Will not be cached based on url in ResourceManager.
      */
-    Text = "text",
+    Text = "Text",
     /**
      * JSON.
      * @remarks Will not be cached based on url in ResourceManager.
      */
-    JSON = "json",
+    JSON = "JSON",
     /**
      * ArrayBuffer.
      * @remarks Will not be cached based on url in ResourceManager.
      */
-    Buffer = "buffer",
+    Buffer = "Buffer",
     /** 2D Texture. */
-    Texture2D = "texture2d",
+    Texture2D = "Texture2D",
     /** Cube Texture. */
-    TextureCube = "texture-cube",
+    TextureCube = "TextureCube",
     /** Material. */
-    Material = "material",
+    Material = "Material",
     /** Mesh. */
-    Mesh = "mesh",
+    Mesh = "Mesh",
     /** AnimationClip. */
     AnimationClip = "AnimationClip",
     /** AnimatorController. */
     AnimatorController = "AnimatorController",
     /** Prefab.*/
-    Prefab = "prefab",
+    GLTF = "GLTF",
     /** Compress Texture. */
-    KTX = "ktx",
+    KTX = "KTX",
     /** Cube Compress Texture. */
-    KTXCube = "ktx-cube",
+    KTXCube = "KTXCube",
     /** Sprite. */
-    Sprite = "sprite",
+    Sprite = "Sprite",
     /** Sprite Atlas. */
-    SpriteAtlas = "sprite-atlas",
+    SpriteAtlas = "SpriteAtlas",
     /** Ambient light. */
-    Env = "environment",
+    Env = "Environment",
     /** Scene. */
-    Scene = "scene",
+    Scene = "Scene",
     /** HDR to cube. */
     HDR = "HDR",
     /** Font. */
-    Font = "font",
+    Font = "Font",
     /** Source Font, include ttf、 otf and woff. */
-    SourceFont = "source-font"
+    SourceFont = "SourceFont"
 }

package/types/asset/ContentRestorer.d.ts

@@ -0,0 +1,17 @@
+import { EngineObject } from "../base";
+import { AssetPromise } from "./AssetPromise";
+/**
+ * ContentRestorer is a base class for all content restore info classes.
+ */
+export declare abstract class ContentRestorer<T extends EngineObject> {
+    resource: T;
+    /**
+     * @param resource - The resource object of the content restorer
+     */
+    constructor(resource: T);
+    /**
+     * Restore the content of the resource.
+     * @returns The promise of the restored content if the content is restored asynchronously, otherwise returns undefined
+     */
+    abstract restoreContent(): AssetPromise<T> | void;
+}

package/types/asset/GraphicsResource.d.ts

@@ -0,0 +1,5 @@
+import { Engine } from "../Engine";
+import { ReferResource } from "./ReferResource";
+export declare abstract class GraphicsResource extends ReferResource {
+    protected constructor(engine: Engine);
+}