@galacean/engine-core 1.1.0-alpha.1 → 1.1.0-alpha.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galacean/engine-core",
-  "version": "1.1.0-alpha.1",
+  "version": "1.1.0-alpha.3",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
@@ -15,10 +15,10 @@
     "types/**/*"
   ],
   "dependencies": {
-    "@galacean/engine-math": "1.1.0-alpha.1"
+    "@galacean/engine-math": "1.1.0-alpha.3"
   },
   "devDependencies": {
-    "@galacean/engine-design": "1.1.0-alpha.1"
+    "@galacean/engine-design": "1.1.0-alpha.3"
   },
   "scripts": {
     "b:types": "tsc"

package/types/ComponentsManager.d.ts

@@ -10,7 +10,6 @@ export declare class ComponentsManager {
     private _onUpdateScripts;
     private _onLateUpdateScripts;
     private _onPhysicsUpdateScripts;
-    private _disableScripts;
     private _pendingDestroyScripts;
     private _disposeDestroyScripts;
     private _onUpdateAnimations;
@@ -30,7 +29,6 @@ export declare class ComponentsManager {
     removeOnUpdateAnimations(animation: Component): void;
     addOnUpdateRenderers(renderer: Renderer): void;
     removeOnUpdateRenderers(renderer: Renderer): void;
-    addDisableScript(component: Script): void;
     addPendingDestroyScript(component: Script): void;
     callScriptOnStart(): void;
     callScriptOnUpdate(deltaTime: number): void;

package/types/DisorderedArray.d.ts

@@ -2,18 +2,23 @@
  * High-performance unordered array, delete uses exchange method to improve performance, internal capacity only increases.
  */
 export declare class DisorderedArray<T> {
-    _elements: T[];
     length: number;
+    _elements: T[];
+    private _isLooping;
+    private _blankCount;
     constructor(count?: number);
     add(element: T): void;
     delete(element: T): void;
     set(index: number, element: T): void;
     get(index: number): T;
+    startLoop(): void;
     /**
      * Delete the element at the specified index.
      * @param index - The index of the element to be deleted
      * @returns The replaced item is used to reset its index
      */
     deleteByIndex(index: number): T;
+    endLoop(): void;
+    endLoopAndClear(): void;
     garbageCollection(): void;
 }

package/types/RenderPipeline/MeshRenderElement.d.ts

@@ -4,16 +4,14 @@ import { Material } from "../material/Material";
 import { Renderer } from "../Renderer";
 import { ShaderPass } from "../shader/ShaderPass";
 import { RenderState } from "../shader/state/RenderState";
-import { IPoolElement } from "./IPoolElement";
 import { RenderElement } from "./RenderElement";
 /**
  * Render element.
  */
-export declare class MeshRenderElement extends RenderElement implements IPoolElement {
+export declare class MeshRenderElement extends RenderElement {
     /** Mesh. */
     mesh: Mesh;
     /** Sub mesh. */
     subMesh: SubMesh;
     setValue(component: Renderer, mesh: Mesh, subMesh: SubMesh, material: Material, renderState: RenderState, shaderPass: ShaderPass): void;
-    dispose(): void;
 }

package/types/RenderPipeline/RenderElementX.d.ts

@@ -0,0 +1,12 @@
+import { Renderer } from "../Renderer";
+import { Primitive } from "../graphic/Primitive";
+import { Material } from "../material/Material";
+import { ShaderPass } from "../shader/ShaderPass";
+import { IPoolElement } from "./IPoolElement";
+export declare class RenderElementX implements IPoolElement {
+    shaderPasses: ReadonlyArray<ShaderPass>;
+    component: Renderer;
+    material: Material;
+    primitive: Primitive;
+    dispose(): void;
+}

package/types/RenderPipeline/SpriteElement.d.ts

@@ -4,12 +4,10 @@ import { Renderer } from "../Renderer";
 import { ShaderPass } from "../shader";
 import { RenderState } from "../shader/state/RenderState";
 import { Texture2D } from "../texture";
-import { IPoolElement } from "./IPoolElement";
 import { RenderElement } from "./RenderElement";
-export declare class SpriteElement extends RenderElement implements IPoolElement {
+export declare class SpriteElement extends RenderElement {
     renderData: RenderData2D;
     texture: Texture2D;
     constructor();
     setValue(component: Renderer, renderDate: RenderData2D, material: Material, texture: Texture2D, renderState: RenderState, shaderPass: ShaderPass): void;
-    dispose(): void;
 }

package/types/RenderPipeline/SpriteMaskElement.d.ts

@@ -1,12 +1,10 @@
 import { RenderData2D } from "../2d/data/RenderData2D";
 import { Material } from "../material/Material";
 import { Renderer } from "../Renderer";
-import { IPoolElement } from "./IPoolElement";
 import { RenderElement } from "./RenderElement";
-export declare class SpriteMaskElement extends RenderElement implements IPoolElement {
+export declare class SpriteMaskElement extends RenderElement {
     renderData: RenderData2D;
     isAdd: boolean;
     constructor();
     setValue(component: Renderer, renderData: RenderData2D, material: Material): void;
-    dispose(): void;
 }

package/types/RenderPipeline/TextRenderElement.d.ts

@@ -1,8 +1,6 @@
-import { IPoolElement } from "./IPoolElement";
 import { RenderElement } from "./RenderElement";
 import { SpriteElement } from "./SpriteElement";
-export declare class TextRenderElement extends RenderElement implements IPoolElement {
+export declare class TextRenderElement extends RenderElement {
     charElements: SpriteElement[];
     constructor();
-    dispose(): 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/Script.d.ts

@@ -8,7 +8,6 @@ import { Collision } from "./physics/Collision";
  */
 export declare class Script extends Component {
     _entityScriptsIndex: number;
-    _waitHandlingInValid: boolean;
     /**
      * Called when be enabled first time, only once.
      */

package/types/Ticker.d.ts

@@ -0,0 +1,30 @@
+export declare class Ticker {
+    private _vSyncCount;
+    private _vSyncCounter;
+    private _requestId;
+    private _animationLoop;
+    private _requestAnimationFrame;
+    private _cancelAnimationFrame;
+    /**
+     * The number of vertical synchronization means the number of vertical blanking for one frame.
+     * @remarks 0 means that the vertical synchronization is turned off.
+     */
+    get vSyncCount(): number;
+    set vSyncCount(value: number);
+    get requestAnimationFrame(): (...params: any[]) => any;
+    set requestAnimationFrame(func: (...params: any[]) => any);
+    get cancelAnimationFrame(): (...params: any[]) => any;
+    set cancelAnimationFrame(func: (...params: any[]) => any);
+    get animationLoop(): (...params: any[]) => any;
+    set animationLoop(func: (...params: any[]) => any);
+    /**
+     * Pause the engine.
+     */
+    pause(): void;
+    /**
+     * Resume the engine.
+     */
+    resume(): void;
+    private _onAnimationFrame;
+    constructor();
+}

package/types/Transform.d.ts

@@ -195,6 +195,7 @@ export declare class Transform extends Component {
      * @returns Change flag
      */
     registerWorldChangeFlag(): BoolUpdateFlag;
+    protected _onDestroy(): void;
     /**
      * Get worldMatrix: Will trigger the worldMatrix update of itself and all parent entities.
      * Get worldPosition: Will trigger the worldMatrix, local position update of itself and the worldMatrix update of all parent entities.

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

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

package/types/asset/Loader.d.ts

@@ -27,6 +27,6 @@ export declare abstract class Loader<T> {
     private static _engineObjects;
     constructor(useCache: boolean);
     initialize?(engine: Engine, configuration: EngineConfiguration): Promise<void>;
-    abstract load(item: LoadItem, resourceManager: ResourceManager): AssetPromise<T> | Record<string, AssetPromise<any>>;
+    abstract load(item: LoadItem, resourceManager: ResourceManager): AssetPromise<T>;
     request: <U>(url: string, config: RequestConfig) => AssetPromise<U>;
 }

package/types/asset/ResourceManager.d.ts

@@ -26,6 +26,7 @@ export declare class ResourceManager {
     private _graphicResourcePool;
     /** Restorable resource information pool, key is the `instanceID` of resource. */
     private _contentRestorerPool;
+    private _subAssetPromiseCallbacks;
     /**
      * Create a ResourceManager.
      * @param engine - Engine to which the current ResourceManager belongs
@@ -61,6 +62,12 @@ export declare class ResourceManager {
      * @returns Resource object
      */
     getFromCache<T>(url: string): T;
+    /**
+     * Find the resource by type.
+     * @param type - Resource type
+     * @returns - Resource collection
+     */
+    findResourcesByType<T extends EngineObject>(type: new (...args: any[]) => T): T[];
     /**
      * Get asset url from instanceId.
      * @param instanceId - Engine instance id
@@ -93,6 +100,7 @@ export declare class ResourceManager {
     addContentRestorer<T extends EngineObject>(restorer: ContentRestorer<T>): void;
     private _assignDefaultOptions;
     private _loadSingleItem;
+    private _pushSubAssetPromiseCallback;
     private _gc;
     private _getResolveResource;
     private _parseURL;

package/types/graphic/Primitive.d.ts

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

package/types/graphic/PrimitiveVertexBinding.d.ts

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

package/types/graphic/SubPrimitive.d.ts

@@ -0,0 +1,9 @@
+import { MeshTopology } from "./enums/MeshTopology";
+export declare class SubPrimitive {
+    /** Start drawing offset. */
+    start: number;
+    /** Drawing count. */
+    count: number;
+    /** Drawing topology. */
+    topology: MeshTopology;
+}

package/types/index.d.ts

@@ -22,7 +22,7 @@ export { AssetPromise } from "./asset/AssetPromise";
 export type { LoadItem } from "./asset/LoadItem";
 export { AssetType } from "./asset/AssetType";
 export { ReferResource } from "./asset/ReferResource";
-export * from "./RenderPipeline/Index";
+export * from "./RenderPipeline/index";
 export * from "./base";
 export { Background } from "./Background";
 export { BackgroundMode } from "./enums/BackgroundMode";

package/types/particle/ParticleBufferUtils.d.ts

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

package/types/particle/ParticleData.d.ts

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

package/types/particle/ParticleGenerator.d.ts

@@ -0,0 +1,72 @@
+import { ParticleRenderer } from "./ParticleRenderer";
+import { ParticleStopMode } from "./enums/ParticleStopMode";
+import { ColorOverLifetimeModule } from "./modules/ColorOverLifetimeModule";
+import { EmissionModule } from "./modules/EmissionModule";
+import { MainModule } from "./modules/MainModule";
+import { RotationOverLifetimeModule } from "./modules/RotationOverLifetimeModule";
+import { SizeOverLifetimeModule } from "./modules/SizeOverLifetimeModule";
+import { TextureSheetAnimationModule } from "./modules/TextureSheetAnimationModule";
+import { VelocityOverLifetimeModule } from "./modules/VelocityOverLifetimeModule";
+/**
+ * Particle Generator.
+ */
+export declare class ParticleGenerator {
+    private static readonly _particleIncreaseCount;
+    /** Use auto random seed. */
+    useAutoRandomSeed: boolean;
+    /** Main module. */
+    readonly main: MainModule;
+    /** Emission module. */
+    readonly emission: EmissionModule;
+    /** Velocity over lifetime module. */
+    readonly velocityOverLifetime: VelocityOverLifetimeModule;
+    /** Size over lifetime module. */
+    readonly sizeOverLifetime: SizeOverLifetimeModule;
+    /** Rotation over lifetime module. */
+    readonly rotationOverLifetime: RotationOverLifetimeModule;
+    /** Color over lifetime module. */
+    readonly colorOverLifetime: ColorOverLifetimeModule;
+    /** Texture sheet animation module. */
+    readonly textureSheetAnimation: TextureSheetAnimationModule;
+    private _isPlaying;
+    private _instanceBufferResized;
+    private _waitProcessRetiredElementCount;
+    private _instanceVertexBufferBinding;
+    private _instanceVertices;
+    private _randomSeed;
+    /**
+     * Whether the particle generator is contain alive or is still creating particles.
+     */
+    get isAlive(): boolean;
+    /**
+     * Random seed.
+     *
+     * @remarks
+     * If `useAutoRandomSeed` is true, this value will be random changed when play.
+     * If you set this value custom, `useAutoRandomSeed` will be false.
+     */
+    get randomSeed(): number;
+    set randomSeed(value: number);
+    constructor(renderer: ParticleRenderer);
+    /**
+     * Start emitting particles.
+     * @param withChildren - Whether to start the particle generator of the child entity
+     */
+    play(withChildren?: boolean): void;
+    /**
+     * Stop emitting particles.
+     * @param withChildren - Whether to stop the particle generator of the child entity
+     * @param stopMode - Stop mode
+     */
+    stop(withChildren?: boolean, stopMode?: ParticleStopMode): void;
+    /**
+     * Manually emit certain number of particles immediately.
+     * @param count - Number of particles to emit
+     */
+    emit(count: number): void;
+    private _addNewParticle;
+    private _retireActiveParticles;
+    private _freeRetiredParticles;
+    private _addActiveParticlesToVertexBuffer;
+    private _addVertexBufferBindingsFilterDuplicate;
+}

package/types/particle/ParticleMaterial.d.ts

@@ -0,0 +1,28 @@
+import { Color } from "@galacean/engine-math";
+import { Engine } from "../Engine";
+import { BaseMaterial } from "../material/BaseMaterial";
+import { Texture2D } from "../texture/Texture2D";
+/**
+ * Particle Material.
+ */
+export declare class ParticleMaterial extends BaseMaterial {
+    /**
+     * Base color.
+     */
+    get baseColor(): Color;
+    set baseColor(value: Color);
+    /**
+     * Base texture.
+     */
+    get baseTexture(): Texture2D;
+    set baseTexture(value: Texture2D);
+    /**
+     * Create a unlit material instance.
+     * @param engine - Engine to which the material belongs
+     */
+    constructor(engine: Engine);
+    /**
+     * @inheritdoc
+     */
+    clone(): ParticleMaterial;
+}