@galacean/engine-core 1.0.0 → 1.0.1

package/types/input/interface/IInput.d.ts

@@ -2,7 +2,7 @@ export interface IInput {
     /**
      * Handler function updated every frame.
      */
-    _update(frameCount?: number): void;
+    _update(): void;
     /**
      * Function called when the engine is destroyed.
      */

package/types/lighting/AmbientLight.d.ts

@@ -1,10 +1,12 @@
 import { Color, SphericalHarmonics3 } from "@galacean/engine-math";
 import { TextureCube } from "../texture";
 import { DiffuseMode } from "./enums/DiffuseMode";
+import { ReferResource } from "../asset/ReferResource";
+import { Engine } from "../Engine";
 /**
  * Ambient light.
  */
-export declare class AmbientLight {
+export declare class AmbientLight extends ReferResource {
     private static _shMacro;
     private static _specularMacro;
     private static _decodeRGBMMacro;
@@ -60,6 +62,7 @@ export declare class AmbientLight {
      */
     get specularIntensity(): number;
     set specularIntensity(value: number);
+    constructor(engine: Engine);
     private _setDiffuseMode;
     private _setSpecularTexture;
     private _setSpecularTextureDecodeRGBM;

package/types/lighting/DirectLight.d.ts

@@ -8,7 +8,6 @@ export declare class DirectLight extends Light {
     private static _colorProperty;
     private static _directionProperty;
     private static _combinedData;
-    private _forward;
     private _reverseDirection;
     /**
      * Get direction.

package/types/lighting/Light.d.ts

@@ -44,5 +44,4 @@ export declare abstract class Light extends Component {
      * Inverse view matrix.
      */
     get inverseViewMatrix(): Matrix;
-    protected _getLightColor(): Color;
 }

package/types/lighting/LightManager.d.ts

@@ -2,4 +2,5 @@
  * Light manager.
  */
 export declare class LightManager {
+    private _getSunLightIndex;
 }

package/types/lighting/SpotLight.d.ts

@@ -18,7 +18,6 @@ export declare class SpotLight extends Light {
     angle: number;
     /** Angle, in radians, from falloff begins to ends. */
     penumbra: number;
-    private _forward;
     private _inverseDirection;
     private _projectMatrix;
     /**

package/types/material/BaseMaterial.d.ts

@@ -1,21 +1,21 @@
 import { Engine } from "../Engine";
-import { Shader } from "../shader";
+import { Shader, ShaderProperty } from "../shader";
 import { ShaderMacro } from "../shader/ShaderMacro";
 import { BlendMode } from "./enums/BlendMode";
 import { RenderFace } from "./enums/RenderFace";
 import { Material } from "./Material";
 export declare class BaseMaterial extends Material {
-    protected static _baseColorProp: import("../shader").ShaderProperty;
-    protected static _baseTextureProp: import("../shader").ShaderProperty;
     protected static _baseTextureMacro: ShaderMacro;
-    protected static _tilingOffsetProp: import("../shader").ShaderProperty;
-    protected static _normalTextureProp: import("../shader").ShaderProperty;
-    protected static _normalIntensityProp: import("../shader").ShaderProperty;
     protected static _normalTextureMacro: ShaderMacro;
-    protected static _emissiveColorProp: import("../shader").ShaderProperty;
-    protected static _emissiveTextureProp: import("../shader").ShaderProperty;
     protected static _emissiveTextureMacro: ShaderMacro;
     protected static _transparentMacro: ShaderMacro;
+    protected static _baseColorProp: ShaderProperty;
+    protected static _baseTextureProp: ShaderProperty;
+    protected static _tilingOffsetProp: ShaderProperty;
+    protected static _normalTextureProp: ShaderProperty;
+    protected static _normalIntensityProp: ShaderProperty;
+    protected static _emissiveColorProp: ShaderProperty;
+    protected static _emissiveTextureProp: ShaderProperty;
     private static _alphaCutoffProp;
     private static _alphaCutoffMacro;
     private _renderFace;
@@ -75,12 +75,10 @@ export declare class BaseMaterial extends Material {
      */
     setRenderFace(passIndex: number, renderFace: RenderFace): void;
     /**
-     * @override
      * Clone and return the instance.
      */
     clone(): BaseMaterial;
     /**
-     * @override
      * Clone to the target material.
      * @param target - target material
      */

package/types/material/BlinnPhongMaterial.d.ts

@@ -64,8 +64,5 @@ export declare class BlinnPhongMaterial extends BaseMaterial {
      * @param engine - Engine to which the material belongs
      */
     constructor(engine: Engine);
-    /**
-     * @override
-     */
     clone(): BlinnPhongMaterial;
 }

package/types/material/Material.d.ts

@@ -1,17 +1,20 @@
 import { IClone } from "@galacean/engine-design";
-import { RefObject } from "../asset/RefObject";
 import { Engine } from "../Engine";
+import { ReferResource } from "../asset/ReferResource";
 import { Shader } from "../shader/Shader";
 import { ShaderData } from "../shader/ShaderData";
 import { RenderState } from "../shader/state/RenderState";
 /**
  * Material.
  */
-export declare class Material extends RefObject implements IClone {
+export declare class Material extends ReferResource implements IClone {
     /** Name. */
     name: string;
-    /** Shader data. */
-    readonly shaderData: ShaderData;
+    private _shaderData;
+    /**
+     *  Shader data.
+     */
+    get shaderData(): ShaderData;
     /**
      * Shader used by the material.
      */
@@ -40,10 +43,7 @@ export declare class Material extends RefObject implements IClone {
      * @param target - target material
      */
     cloneTo(target: Material): void;
-    /**
-     * @override
-     */
-    _addRefCount(value: number): void;
+    _addReferCount(value: number): void;
     /**
      * @override
      */

package/types/material/PBRMaterial.d.ts

@@ -8,13 +8,22 @@ export declare class PBRMaterial extends PBRBaseMaterial {
     private static _metallicProp;
     private static _roughnessProp;
     private static _roughnessMetallicTextureProp;
+    private static _iorProp;
     /**
-     * Metallic, default 1.0.
+     * Index Of Refraction.
+     * @defaultValue `1.5`
+     */
+    get ior(): number;
+    set ior(v: number);
+    /**
+     * Metallic.
+     * @defaultValue `1.0`
      */
     get metallic(): number;
     set metallic(value: number);
     /**
-     * Roughness, default 1.0.
+     * Roughness. default 1.0.
+     * @defaultValue `1.0`
      */
     get roughness(): number;
     set roughness(value: number);
@@ -30,7 +39,7 @@ export declare class PBRMaterial extends PBRBaseMaterial {
      */
     constructor(engine: Engine);
     /**
-     * @override
+     * @inheritdoc
      */
     clone(): PBRMaterial;
 }

package/types/material/PBRSpecularMaterial.d.ts

@@ -32,7 +32,7 @@ export declare class PBRSpecularMaterial extends PBRBaseMaterial {
      */
     constructor(engine: Engine);
     /**
-     * @override
+     * @inheritdoc
      */
     clone(): PBRSpecularMaterial;
 }

package/types/material/UnlitMaterial.d.ts

@@ -27,7 +27,7 @@ export declare class UnlitMaterial extends BaseMaterial {
      */
     constructor(engine: Engine);
     /**
-     * @override
+     * @inheritdoc
      */
     clone(): UnlitMaterial;
 }

package/types/mesh/BlendShape.d.ts

@@ -6,7 +6,6 @@ import { BlendShapeFrame } from "./BlendShapeFrame";
 export declare class BlendShape {
     /** Name of BlendShape. */
     name: string;
-    private _dataChangeManager;
     private _frames;
     /**
      * Frames of BlendShape.
@@ -36,4 +35,5 @@ export declare class BlendShape {
     clearFrames(): void;
     private _addFrame;
     private _updateUseNormalAndTangent;
+    private _frameDataChangeListener;
 }

package/types/mesh/BlendShapeFrame.d.ts

@@ -5,12 +5,28 @@ import { Vector3 } from "@galacean/engine-math";
 export declare class BlendShapeFrame {
     /** Weight of BlendShapeFrame. */
     readonly weight: number;
-    /** Delta positions for the frame being added. */
-    readonly deltaPositions: Readonly<Readonly<Vector3>[]>;
-    /** Delta normals for the frame being added. */
-    readonly deltaNormals: Readonly<Readonly<Vector3[]> | null>;
-    /** Delta tangents for the frame being added. */
-    readonly deltaTangents: Readonly<Readonly<Vector3[]> | null>;
+    private _dirty;
+    private _deltaPositions;
+    private _deltaNormals;
+    private _deltaTangents;
+    /**
+     * Delta positions for the frame being added.
+     * @remarks Need to re-assign after modification to ensure that the modification takes effect.
+     */
+    get deltaPositions(): Vector3[];
+    set deltaPositions(value: Vector3[]);
+    /**
+     * Delta normals for the frame being added.
+     * @remarks Need to re-assign after modification to ensure that the modification takes effect.
+     */
+    get deltaNormals(): Vector3[];
+    set deltaNormals(value: Vector3[]);
+    /**
+     * Delta tangents for the frame being added.
+     * @remarks Need to re-assign after modification to ensure that the modification takes effect.
+     */
+    get deltaTangents(): Vector3[];
+    set deltaTangents(value: Vector3[]);
     /**
      * Create a BlendShapeFrame.
      * @param weight - Weight of BlendShapeFrame
@@ -20,3 +36,9 @@ export declare class BlendShapeFrame {
      */
     constructor(weight: number, deltaPositions: Vector3[], deltaNormals?: Vector3[], deltaTangents?: Vector3[]);
 }
+export declare enum BlendShapeFrameDirty {
+    Position = 1,
+    Normal = 2,
+    Tangent = 4,
+    All = 7
+}

package/types/mesh/MeshRenderer.d.ts

@@ -1,30 +1,25 @@
-import { BoundingBox } from "@galacean/engine-math";
-import { ICustomClone } from "../clone/ComponentCloner";
-import { Mesh } from "../graphic/Mesh";
 import { Renderer } from "../Renderer";
-import { RenderContext } from "../RenderPipeline/RenderContext";
+import { Mesh } from "../graphic/Mesh";
 /**
  * MeshRenderer Component.
  */
-export declare class MeshRenderer extends Renderer implements ICustomClone {
+export declare class MeshRenderer extends Renderer {
     private static _uvMacro;
     private static _uv1Macro;
     private static _normalMacro;
     private static _tangentMacro;
-    private static _vertexColorMacro;
+    private static _enableVertexColorMacro;
+    private _enableVertexColor;
     /**
      * Mesh assigned to the renderer.
      */
     get mesh(): Mesh;
     set mesh(value: Mesh);
     /**
-     * @override
-     */
-    protected _updateBounds(worldBounds: BoundingBox): void;
-    /**
-     * @override
+     * Whether enable vertex color.
      */
-    protected _render(context: RenderContext): void;
+    get enableVertexColor(): boolean;
+    set enableVertexColor(value: boolean);
     private _setMesh;
     private _onMeshChanged;
 }

package/types/mesh/ModelMesh.d.ts

@@ -15,7 +15,7 @@ export declare class ModelMesh extends Mesh {
     private static _tempVec3;
     private static _tempVec4;
     private _vertexCount;
-    private _accessible;
+    private _readable;
     private _verticesFloat32;
     private _verticesUint8;
     private _indices;
@@ -42,9 +42,9 @@ export declare class ModelMesh extends Mesh {
     private _customVertexElements;
     private _vertexCountChanged;
     /**
-     * Whether to access data of the mesh.
+     * Whether to read data of the mesh.
      */
-    get accessible(): boolean;
+    get readable(): boolean;
     /**
      * Vertex count of current mesh.
      */
@@ -207,9 +207,9 @@ export declare class ModelMesh extends Mesh {
     getBlendShapeName(index: number): string;
     /**
      * Upload Mesh Data to GPU.
-     * @param noLongerAccessible - Whether to access data later. If true, you'll never access data anymore (free memory cache)
+     * @param noLongerReadable - Whether to read data later. If true, you'll never read data anymore (free memory cache)
      */
-    uploadData(noLongerAccessible: boolean): void;
+    uploadData(noLongerReadable: boolean): void;
     /**
      * Calculate mesh tangent.
      * @remark need to set positions(with or not with indices), normals, uv before calculation.

package/types/mesh/PrimitiveMesh.d.ts

@@ -63,8 +63,8 @@ export declare class PrimitiveMesh {
      * @param engine - Engine
      * @param radius - The radius of cap
      * @param height - The height of torso
-     * @param radialSegments - Cylinder radial segments
-     * @param heightSegments - Cylinder height segments
+     * @param radialSegments - Cone radial segments
+     * @param heightSegments - Cone height segments
      * @param noLongerAccessible - No longer access the vertices of the mesh after creation
      * @returns Cone model mesh
      */
@@ -80,6 +80,8 @@ export declare class PrimitiveMesh {
      * @returns Capsule model mesh
      */
     static createCapsule(engine: Engine, radius?: number, height?: number, radialSegments?: number, heightSegments?: number, noLongerAccessible?: boolean): ModelMesh;
+    static _setCylinderData(cylinderMesh: ModelMesh, radiusTop: number, radiusBottom: number, height: number, radialSegments: number, heightSegments: number, noLongerAccessible: boolean, isRestoreMode: boolean): void;
+    static _setCapsuleData(capsuleMesh: ModelMesh, radius: number, height: number, radialSegments: number, heightSegments: number, noLongerAccessible: boolean, isRestoreMode: boolean): void;
     private static _initialize;
     private static _generateIndices;
     private static _createCapsuleCap;

package/types/mesh/PrimitiveMeshRestorer.d.ts

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

package/types/mesh/SkinnedMeshRenderer.d.ts

@@ -1,13 +1,11 @@
 import { BoundingBox } from "@galacean/engine-math";
 import { Entity } from "../Entity";
-import { RenderContext } from "../RenderPipeline/RenderContext";
 import { MeshRenderer } from "./MeshRenderer";
 import { Skin } from "./Skin";
 /**
  * SkinnedMeshRenderer.
  */
 export declare class SkinnedMeshRenderer extends MeshRenderer {
-    private static _tempMatrix;
     private static _jointCountProperty;
     private static _jointSamplerProperty;
     private static _jointMatrixProperty;
@@ -42,18 +40,6 @@ export declare class SkinnedMeshRenderer extends MeshRenderer {
      */
     get rootBone(): Entity;
     set rootBone(value: Entity);
-    /**
-     * @override
-     */
-    protected _updateShaderData(context: RenderContext): void;
-    /**
-     * @override
-     */
-    protected _registerEntityTransformListener(): void;
-    /**
-     * @override
-     */
-    protected _updateBounds(worldBounds: BoundingBox): void;
     private _initSkin;
     private _computeApproximateBindMatrix;
     private _findByEntityName;

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;
+}