@galacean/engine-core 2.0.0-alpha.43 → 2.0.0-alpha.45

package/types/particle/ParticleGenerator.d.ts

@@ -1,5 +1,12 @@
 import { DataObject } from "../base/DataObject";
+import { BoundingBox, Color, Vector3 } from "@galacean/engine-math";
 import type { ICloneHook } from "../clone/ICloneHook";
+import { Primitive } from "../graphic/Primitive";
+import { SubMesh } from "../graphic/SubMesh";
+import { VertexBufferBinding } from "../graphic/VertexBufferBinding";
+import { ShaderData } from "../shader";
+import { ParticleRenderer } from "./ParticleRenderer";
+import { ParticleTransformFeedbackSimulator } from "./ParticleTransformFeedbackSimulator";
 import { ParticleStopMode } from "./enums/ParticleStopMode";
 import { ColorOverLifetimeModule } from "./modules/ColorOverLifetimeModule";
 import { CustomDataModule } from "./modules/CustomDataModule";
@@ -57,6 +64,32 @@ export declare class ParticleGenerator extends DataObject implements ICloneHook<
     readonly subEmitters: SubEmittersModule;
     /** Custom data module. */
     readonly customData: CustomDataModule;
+    /** @internal */
+    _currentParticleCount: number;
+    /** @internal */
+    _playTime: number;
+    /** @internal */
+    _firstNewElement: number;
+    /** @internal */
+    _firstActiveElement: number;
+    /** @internal */
+    _firstFreeElement: number;
+    /** @internal */
+    _firstRetiredElement: number;
+    /** @internal */
+    _primitive: Primitive;
+    /** @internal */
+    _vertexBufferBindings: VertexBufferBinding[];
+    /** @internal */
+    _subPrimitive: SubMesh;
+    /** @internal */
+    readonly _renderer: ParticleRenderer;
+    /** @internal */
+    _feedbackSimulator: ParticleTransformFeedbackSimulator;
+    /** @internal */
+    _useTransformFeedback: boolean;
+    /** @internal */
+    private _feedbackBindingIndex;
     private _feedbackReadback;
     private _isPlaying;
     private _instanceBufferResized;
@@ -89,6 +122,10 @@ export declare class ParticleGenerator extends DataObject implements ICloneHook<
      */
     get randomSeed(): number;
     set randomSeed(value: number);
+    /**
+     * @internal
+     */
+    constructor(renderer: ParticleRenderer);
     /**
      * Start emitting particles.
      * @param withChildren - Whether to start the particle generator of the child entity
@@ -105,12 +142,77 @@ export declare class ParticleGenerator extends DataObject implements ICloneHook<
      * @param count - Number of particles to emit
      */
     emit(count: number): void;
+    /**
+     * @internal
+     */
+    _emit(playTime: number, count: number, emitWorldPositionOverride?: Vector3): number;
+    /**
+     * @internal
+     */
+    _update(elapsedTime: number): void;
+    /**
+     * @internal
+     * Run Transform Feedback simulation pass.
+     */
+    _updateFeedback(shaderData: ShaderData, deltaTime: number): void;
+    /**
+     * @internal
+     */
+    _reorganizeGeometryBuffers(): void;
+    /**
+     * @internal
+     */
+    _resizeInstanceBuffer(isIncrease: boolean, increaseCount?: number): void;
+    /**
+     * @internal
+     */
+    _updateShaderData(shaderData: ShaderData): void;
+    /**
+     * @internal
+     */
+    _resetGlobalRandSeed(seed: number): void;
+    /**
+     * @internal
+     */
+    _setTransformFeedback(): void;
+    /**
+     * @internal
+     */
+    _getAliveParticleCount(): number;
+    /**
+     * @internal
+     */
+    _getNotRetiredParticleCount(): number;
     /**
      * @inheritdoc
      */
     _onClone(target: ParticleGenerator): void;
+    /**
+     * @internal
+     */
+    _destroy(): void;
+    /**
+     * @internal
+     */
+    _updateBoundsSimulationLocal(bounds: BoundingBox): void;
+    /**
+     * @internal
+     */
+    _updateBoundsSimulationWorld(bounds: BoundingBox): void;
+    /**
+     * @internal
+     */
+    _freeBoundsArray(): void;
+    /**
+     * @internal
+     */
+    _generateTransformedBounds(): void;
     private _addNewParticle;
     private _onParticleBirth;
+    /**
+     * @internal
+     */
+    _emitFromSubEmitter(count: number, worldPosition: Vector3, inheritColor: Color, inheritSize: Vector3, inheritRotation: Vector3, worldDirection?: Vector3): void;
     private _addFeedbackParticle;
     private _clearActiveParticles;
     private _retireActiveParticles;

package/types/particle/ParticleRenderer.d.ts

@@ -1,6 +1,8 @@
 import { BoundingBox, Vector3 } from "@galacean/engine-math";
+import { Entity } from "../Entity";
 import { RenderContext } from "../RenderPipeline/RenderContext";
 import { Renderer } from "../Renderer";
+import { TransformModifyFlags } from "../Transform";
 import { ModelMesh } from "../mesh/ModelMesh";
 import { ParticleGenerator } from "./ParticleGenerator";
 import { ParticleRenderMode } from "./enums/ParticleRenderMode";
@@ -25,6 +27,10 @@ export declare class ParticleRenderer extends Renderer {
     lengthScale: number;
     /** The pivot of particle. */
     pivot: Vector3;
+    /** @internal */
+    _generatorBounds: BoundingBox;
+    /** @internal */
+    _transformedBounds: BoundingBox;
     private _mesh;
     private _renderMode;
     private _currentRenderModeMacro;
@@ -40,6 +46,26 @@ export declare class ParticleRenderer extends Renderer {
      */
     get mesh(): ModelMesh;
     set mesh(value: ModelMesh);
+    /**
+     * @internal
+     */
+    constructor(entity: Entity);
+    /**
+     * @internal
+     */
+    _onEnable(): void;
+    /**
+     * @internal
+     */
+    _onDisable(): void;
+    /**
+     * @internal
+     */
+    _prepareRender(context: RenderContext): void;
+    /**
+     * @internal
+     */
+    _updateTransformShaderData(context: RenderContext, onlyMVP: boolean): void;
     protected _updateBounds(worldBounds: BoundingBox): void;
     protected _update(context: RenderContext): void;
     protected _render(context: RenderContext): void;
@@ -48,4 +74,33 @@ export declare class ParticleRenderer extends Renderer {
      * @inheritdoc
      */
     _onClone(target: ParticleRenderer): void;
+    /**
+     * @internal
+     */
+    _isContainDirtyFlag(type: number): boolean;
+    /**
+     * @internal
+     */
+    _setDirtyFlagFalse(type: number): void;
+    /**
+     * @internal
+     */
+    _onWorldVolumeChanged(): void;
+    /**
+     * @internal
+     */
+    _onGeneratorParamsChanged(): void;
+    /**
+     * @internal
+     */
+    _onTransformChanged(type: TransformModifyFlags): void;
+}
+/**
+ * @internal
+ */
+export declare enum ParticleUpdateFlags {
+    /** On World Transform Changed */
+    TransformVolume = 2,
+    /** On Generator Bounds Related Params Changed */
+    GeneratorVolume = 4
 }

package/types/particle/ParticleTransformFeedbackSimulator.d.ts

@@ -1 +1,52 @@
-export {};
+import { Vector3 } from "@galacean/engine-math";
+import { Engine } from "../Engine";
+import { VertexBufferBinding } from "../graphic/VertexBufferBinding";
+import { ShaderData } from "../shader/ShaderData";
+/**
+ * @internal
+ * Particle-specific Transform Feedback simulation.
+ */
+export declare class ParticleTransformFeedbackSimulator {
+    private static readonly _deltaTimeProperty;
+    /** @internal */
+    _instanceBinding: VertexBufferBinding;
+    private _simulator;
+    private _particleInitData;
+    private _oldReadBuffer;
+    private _oldWriteBuffer;
+    /**
+     * The current read buffer binding for the render pass.
+     */
+    get readBinding(): VertexBufferBinding;
+    constructor(engine: Engine);
+    /**
+     * Resize feedback buffers.
+     * Saves pre-resize buffers internally for subsequent `copyOldBufferData` / `destroyOldBuffers` calls.
+     * @param particleCount - Number of particles to allocate
+     * @param instanceBinding - New instance vertex buffer binding
+     */
+    resize(particleCount: number, instanceBinding: VertexBufferBinding): void;
+    /**
+     * Write initial position and velocity for a newly emitted particle.
+     */
+    writeParticleData(index: number, position: Vector3, vx: number, vy: number, vz: number): void;
+    /**
+     * Copy data from pre-resize buffers to current buffers.
+     * Must be called after `resize` which saves the old buffers.
+     */
+    copyOldBufferData(srcByteOffset: number, dstByteOffset: number, byteLength: number): void;
+    /**
+     * Destroy pre-resize buffers saved during `resize`.
+     */
+    destroyOldBuffers(): void;
+    /**
+     * Run one simulation step.
+     * @param shaderData - Shader data with current macros and uniforms
+     * @param particleCount - Total particle slot count
+     * @param firstActive - First active particle index in ring buffer
+     * @param firstFree - First free particle index in ring buffer
+     * @param deltaTime - Frame delta time
+     */
+    update(shaderData: ShaderData, particleCount: number, firstActive: number, firstFree: number, deltaTime: number): void;
+    destroy(): void;
+}

package/types/particle/enums/ParticleRandomSubSeeds.d.ts

@@ -1 +1,25 @@
-export {};
+/**
+ * @internal
+ */
+export declare enum ParticleRandomSubSeeds {
+    Burst = 592910910,
+    StartDelay = 322376503,
+    StartColor = 306581307,
+    StartSize = 1793934638,
+    StartRotation = 3737431713,
+    randomizeRotationDirection = 2527743459,
+    StartLifetime = 2368504881,
+    StartSpeed = 4085612399,
+    VelocityOverLifetime = 3774601268,
+    ColorOverLifetime = 326370691,
+    SizeOverLifetime = 1494990940,
+    RotationOverLifetime = 1089181156,
+    TextureSheetAnimation = 197469413,
+    Shape = 2941263940,
+    GravityModifier = 2759560269,
+    ForceOverLifetime = 3875246972,
+    LimitVelocityOverLifetime = 3047300990,
+    Noise = 4105357473,
+    SubEmitter = 2622110509,
+    EmissionRate = 2625893077
+}

package/types/particle/enums/attributes/BillboardParticleVertexAttribute.d.ts

@@ -1 +1,6 @@
-export {};
+/**
+ * @internal
+ */
+export declare enum ParticleBillboardVertexAttribute {
+    cornerTextureCoordinate = "a_CornerTextureCoordinate"
+}

package/types/particle/enums/attributes/ParticleFeedbackVertexAttribute.d.ts

@@ -1 +1,8 @@
-export {};
+/**
+ * @internal
+ * Vertex attributes for the Transform Feedback buffer.
+ */
+export declare enum ParticleFeedbackVertexAttribute {
+    Position = "a_FeedbackPosition",
+    Velocity = "a_FeedbackVelocity"
+}

package/types/particle/enums/attributes/ParticleInstanceVertexAttribute.d.ts

@@ -1 +1,17 @@
-export {};
+/**
+ * @internal
+ */
+export declare enum ParticleInstanceVertexAttribute {
+    ShapePositionStartLifeTime = "a_ShapePositionStartLifeTime",
+    DirectionTime = "a_DirectionTime",
+    StartColor = "a_StartColor",
+    StartSize = "a_StartSize",
+    StartRotation0 = "a_StartRotation0",
+    StartSpeed = "a_StartSpeed",
+    Random0 = "a_Random0",
+    Random1 = "a_Random1",
+    SimulationWorldPosition = "a_SimulationWorldPosition",
+    SimulationWorldRotation = "a_SimulationWorldRotation",
+    SimulationUV = "a_SimulationUV",
+    Random2 = "a_Random2"
+}

package/types/particle/modules/ColorOverLifetimeModule.d.ts

@@ -1,3 +1,5 @@
+import { Rand } from "@galacean/engine-math";
+import { ShaderData } from "../../shader/ShaderData";
 import { ShaderMacro } from "../../shader/ShaderMacro";
 import { ShaderProperty } from "../../shader/ShaderProperty";
 import { ParticleCompositeGradient } from "./ParticleCompositeGradient";
@@ -15,6 +17,16 @@ export declare class ColorOverLifetimeModule extends ParticleGeneratorModule {
     static readonly _gradientKeysCount: ShaderProperty;
     /** Color gradient over lifetime. */
     color: ParticleCompositeGradient;
+    /** @internal */
+    _colorGradientRand: Rand;
     private _gradientKeysCount;
     private _colorMacro;
+    /**
+     * @internal
+     */
+    _updateShaderData(shaderData: ShaderData): void;
+    /**
+     * @internal
+     */
+    _resetRandomSeed(seed: number): void;
 }

package/types/particle/modules/CustomDataModule.d.ts

@@ -1,3 +1,4 @@
+import { ShaderData } from "../../shader/ShaderData";
 import { ParticleCompositeCurve } from "./ParticleCompositeCurve";
 import { ParticleCompositeGradient } from "./ParticleCompositeGradient";
 import { ParticleGeneratorModule } from "./ParticleGeneratorModule";
@@ -77,6 +78,10 @@ export declare class CustomDataModule extends ParticleGeneratorModule {
      * Remove all custom data streams.
      */
     clear(): void;
+    /**
+     * @internal
+     */
+    _updateShaderData(shaderData: ShaderData): void;
     private _uploadCurveStream;
     private _uploadGradientStream;
     private _zeroCurveUniforms;

package/types/particle/modules/EmissionModule.d.ts

@@ -1,3 +1,5 @@
+import { Rand } from "@galacean/engine-math";
+import { ShaderData, ShaderMacro } from "../../shader";
 import { Burst } from "./Burst";
 import { ParticleCompositeCurve } from "./ParticleCompositeCurve";
 import { ParticleGeneratorModule } from "./ParticleGeneratorModule";
@@ -6,13 +8,21 @@ import { BaseShape } from "./shape/BaseShape";
  * The EmissionModule of a Particle Generator.
  */
 export declare class EmissionModule extends ParticleGeneratorModule {
+    /** @internal */
+    static readonly _emissionShapeMacro: ShaderMacro;
     private static _tempEmitPosition;
     /**  The rate of particle emission. */
     rateOverTime: ParticleCompositeCurve;
     /**  The rate at which the emitter spawns new particles over distance. */
     rateOverDistance: ParticleCompositeCurve;
     _shape: BaseShape;
+    /** @internal */
+    _shapeRand: Rand;
     private _shapeMacro;
+    /** @internal */
+    _rateRand: Rand;
+    /** @internal */
+    _frameRateTime: number;
     private _distanceAccumulator;
     private _lastEmitPosition;
     private _hasLastEmitPosition;
@@ -52,6 +62,24 @@ export declare class EmissionModule extends ParticleGeneratorModule {
      * Clear burst data.
      */
     clearBurst(): void;
+    /**
+     * @internal
+     */
+    _emit(lastPlayTime: number, playTime: number): void;
+    /**
+     * @internal
+     */
+    _updateShaderData(shaderData: ShaderData): void;
+    /**
+     * @internal
+     */
+    _resetRandomSeed(seed: number): void;
+    /** @internal */
+    _resyncCursors(playTime: number): void;
+    /**
+     * @internal
+     */
+    _destroy(): void;
     private _emitByRateOverTime;
     private _emitByRateOverDistance;
     private _evaluateRate;

package/types/particle/modules/ForceOverLifetimeModule.d.ts

@@ -1,4 +1,5 @@
-import { ShaderMacro, ShaderProperty } from "../../shader";
+import { Rand } from "@galacean/engine-math";
+import { ShaderData, ShaderMacro, ShaderProperty } from "../../shader";
 import { ParticleSimulationSpace } from "../enums/ParticleSimulationSpace";
 import { ParticleGenerator } from "../ParticleGenerator";
 import { ParticleCompositeCurve } from "./ParticleCompositeCurve";
@@ -19,6 +20,8 @@ export declare class ForceOverLifetimeModule extends ParticleGeneratorModule {
     static readonly _maxGradientYProperty: ShaderProperty;
     static readonly _maxGradientZProperty: ShaderProperty;
     static readonly _spaceProperty: ShaderProperty;
+    /** @internal */
+    _forceRand: Rand;
     private _forceMinConstant;
     private _forceMaxConstant;
     private _forceMacro;
@@ -48,4 +51,16 @@ export declare class ForceOverLifetimeModule extends ParticleGeneratorModule {
     get space(): ParticleSimulationSpace;
     set space(value: ParticleSimulationSpace);
     constructor(generator: ParticleGenerator);
+    /**
+     * @internal
+     */
+    _updateShaderData(shaderData: ShaderData): void;
+    /**
+     * @internal
+     */
+    _resetRandomSeed(seed: number): void;
+    /**
+     * @internal
+     */
+    _isRandomMode(): boolean;
 }

package/types/particle/modules/LimitVelocityOverLifetimeModule.d.ts

@@ -1,4 +1,5 @@
-import { ShaderMacro } from "../../shader";
+import { Rand } from "@galacean/engine-math";
+import { ShaderData, ShaderMacro } from "../../shader";
 import { ShaderProperty } from "../../shader/ShaderProperty";
 import { ParticleSimulationSpace } from "../enums/ParticleSimulationSpace";
 import { ParticleGenerator } from "../ParticleGenerator";
@@ -34,6 +35,8 @@ export declare class LimitVelocityOverLifetimeModule extends ParticleGeneratorMo
     static readonly _dragMaxCurveProperty: ShaderProperty;
     static readonly _dragMinCurveProperty: ShaderProperty;
     static readonly _spaceProperty: ShaderProperty;
+    /** @internal */
+    _speedRand: Rand;
     private _speedMinConstantVec;
     private _speedMaxConstantVec;
     private _dragConstantVec;
@@ -113,6 +116,22 @@ export declare class LimitVelocityOverLifetimeModule extends ParticleGeneratorMo
     get enabled(): boolean;
     set enabled(value: boolean);
     constructor(generator: ParticleGenerator);
+    /**
+     * @internal
+     */
+    _isDragRandomMode(): boolean;
+    /**
+     * @internal
+     */
+    _isSpeedRandomMode(): boolean;
+    /**
+     * @internal
+     */
+    _updateShaderData(shaderData: ShaderData): void;
+    /**
+     * @internal
+     */
+    _resetRandomSeed(seed: number): void;
     private _uploadScalarSpeed;
     private _uploadSeparateAxisSpeeds;
     private _uploadDrag;

package/types/particle/modules/MainModule.d.ts

@@ -1,6 +1,8 @@
 import { DataObject } from "../../base/DataObject";
-import { Rand } from "@galacean/engine-math";
+import { Rand, Vector3 } from "@galacean/engine-math";
 import type { ICloneHook } from "../../clone/ICloneHook";
+import { ShaderData } from "../../shader/ShaderData";
+import { ParticleGenerator } from "../ParticleGenerator";
 import { ParticleScaleMode } from "../enums/ParticleScaleMode";
 import { ParticleSimulationSpace } from "../enums/ParticleSimulationSpace";
 import { ParticleCompositeCurve } from "./ParticleCompositeCurve";
@@ -41,6 +43,20 @@ export declare class MainModule extends DataObject implements ICloneHook<MainMod
     scalingMode: ParticleScaleMode;
     /** If set to true, the Particle Generator automatically begins to play on startup. */
     playOnEnabled: boolean;
+    /** @internal */
+    _maxParticleBuffer: number;
+    /** @internal */
+    readonly _startDelayRand: Rand;
+    /** @internal */
+    readonly _startSpeedRand: Rand;
+    /** @internal */
+    readonly _startLifeTimeRand: Rand;
+    /** @internal */
+    readonly _startColorRand: Rand;
+    /** @internal */
+    readonly _startSizeRand: Rand;
+    /** @internal */
+    readonly _startRotationRand: Rand;
     readonly _gravityModifierRand: Rand;
     private _startLifetime;
     private _startSpeed;
@@ -101,6 +117,22 @@ export declare class MainModule extends DataObject implements ICloneHook<MainMod
      */
     get startSize(): ParticleCompositeCurve;
     set startSize(value: ParticleCompositeCurve);
+    /**
+     * @internal
+     */
+    constructor(generator: ParticleGenerator);
+    /**
+     * @internal
+     */
+    _resetRandomSeed(randomSeed: number): void;
+    /**
+     * @internal
+     */
+    _getPositionScale(): Vector3;
+    /**
+     * @internal
+     */
+    _updateShaderData(shaderData: ShaderData): void;
     /**
      * @inheritdoc
      */

package/types/particle/modules/NoiseModule.d.ts

@@ -1,4 +1,5 @@
-import { ShaderMacro, ShaderProperty } from "../../shader";
+import { Rand } from "@galacean/engine-math";
+import { ShaderData, ShaderMacro, ShaderProperty } from "../../shader";
 import { ParticleGenerator } from "../ParticleGenerator";
 import { ParticleCompositeCurve } from "./ParticleCompositeCurve";
 import { ParticleGeneratorModule } from "./ParticleGeneratorModule";
@@ -24,6 +25,8 @@ export declare class NoiseModule extends ParticleGeneratorModule {
     private _strengthCurveModeMacro;
     private _strengthIsRandomTwoModeMacro;
     private _separateAxesModeMacro;
+    /** @internal */
+    _noiseRand: Rand;
     private _noiseParams;
     private _noiseOctaveParams;
     private _strengthMinConst;
@@ -87,4 +90,12 @@ export declare class NoiseModule extends ParticleGeneratorModule {
     get enabled(): boolean;
     set enabled(value: boolean);
     constructor(generator: ParticleGenerator);
+    /**
+     * @internal
+     */
+    _updateShaderData(shaderData: ShaderData): void;
+    /**
+     * @internal
+     */
+    _resetRandomSeed(seed: number): void;
 }

package/types/particle/modules/ParticleCompositeCurve.d.ts

@@ -1,4 +1,5 @@
 import { DataObject } from "../../base/DataObject";
+import { Vector2 } from "@galacean/engine-math";
 import { ParticleCurveMode } from "../enums/ParticleCurveMode";
 import { ParticleCurve } from "./ParticleCurve";
 /**
@@ -77,6 +78,42 @@ export declare class ParticleCompositeCurve extends DataObject {
      * @returns - The result curve value
      */
     evaluate(time: number, lerpFactor: number): number;
+    /**
+     * @internal
+     */
+    _evaluateCumulative(normalizedAge: number, lerpFactor: number): number;
+    /**
+     * @internal
+     */
+    _getMax(): number;
+    /**
+     * @internal
+     */
+    _getMinMax(out: Vector2): void;
+    /**
+     * @internal
+     */
+    _isZero(): boolean;
+    /**
+     * @internal
+     */
+    _isCurveMode(): boolean;
+    /**
+     * @internal
+     */
+    _isRandomMode(): boolean;
+    /**
+     * @internal
+     */
+    _isRandomCurveMode(): boolean;
+    /**
+     * @internal
+     */
+    _registerOnValueChanged(listener: () => void): void;
+    /**
+     * @internal
+     */
+    _unRegisterOnValueChanged(listener: () => void): void;
     private _getKeyMinMax;
     private _onCurveChange;
 }

package/types/particle/modules/ParticleCurve.d.ts

@@ -38,6 +38,26 @@ export declare class ParticleCurve extends DataObject {
      * @param keys - The keys
      */
     setKeys(keys: CurveKey[]): void;
+    /**
+     * @internal
+     */
+    _evaluate(normalizedAge: number): number;
+    /**
+     * @internal
+     */
+    _evaluateCumulative(normalizedAge: number): number;
+    /**
+     * @internal
+     */
+    _getTypeArray(): Float32Array;
+    /**
+     * @internal
+     */
+    _registerOnValueChanged(listener: () => void): void;
+    /**
+     * @internal
+     */
+    _unRegisterOnValueChanged(listener: () => void): void;
     private _addKey;
 }
 /**
@@ -61,4 +81,12 @@ export declare class CurveKey extends DataObject {
      * Create a new key.
      */
     constructor(time: number, value: number);
+    /**
+     * @internal
+     */
+    _registerOnValueChanged(listener: () => void): void;
+    /**
+     * @internal
+     */
+    _unRegisterOnValueChanged(listener: () => void): void;
 }