add ts module

cocos/particle/Impl.ts

@@ -1,4 +1,4 @@
-import { CustomDataMode, BoxShapeEmitFrom, PlaybackState } from './define';
+import { CustomDataMode, BoxShapeEmitFrom, PlaybackState, NoiseQuality, ConeShapeEmitFrom } from './define';
 
 export declare namespace Impl {
     export class ParticleSystem {
@@ -91,13 +91,42 @@ export declare namespace Impl {
         getColor(): GradientRange;
     }
 
+    export class ConeShape extends DistributableShape {
+        setRadius(radius: number): void;
+        setAngle(angle: number): void;
+        setArc(arc: number): void;
+        setLength(length: number): void;
+        setEmitFrom(emitFrom: ConeShapeEmitFrom): void;
+    }
+
     export class CustomData extends ParticleSystemModule {
         getComponent(stream: number, component: number): CurveRange;
         getColor(stream: number): GradientRange;
         setMode(stream: number, mode: CustomDataMode);
         setComponentNum(stream: number, num: number);
     }
 
+    export class CurlNoiseOverLifetime extends ParticleSystemModule {
+        setSeparateAxes(separateAxes: boolean): void;
+        getStrengthX(): CurveRange;
+        getStrengthY(): CurveRange;
+        getStrengthZ(): CurveRange;
+        getScrollSpeed(): CurveRange;
+        getRemapCurveX(): CurveRange;
+        getRemapCurveY(): CurveRange;
+        getRemapCurveZ(): CurveRange;
+        setOctaves(octave: number): void;
+        setOctaveMultiplier(octaveMultiplier: number): void;
+        setOctaveScale(octaveScale: number): void;
+        setFrequency(frequency: number): void;
+        setDamping(damping: boolean): void;
+        setRemap(remap: boolean): void;
+        setQuality(quality: NoiseQuality): void;
+        getPositionAmount(): CurveRange;
+        getRotationAmount(): CurveRange;
+        getSizeAmount(): CurveRange;
+    }
+
     export class DragOverLifetime extends ParticleSystemModule {
         getDrag(): CurveRange;
         setMultiplyBySize(multiplyBySize: boolean): void;

cocos/particle/define.ts

@@ -48,6 +48,17 @@ export enum PlaybackState {
     STOPPED,
 }
 
+export enum NoiseQuality {
+    HIGH,
+    MEDIUM,
+    LOW
+}
+
+export enum ConeShapeEmitFrom {
+    BASE,
+    VOLUME,
+}
+
 /**
  * @en The way the particles are spawned along the arc.
  * @zh 粒子沿着弧的发射方式。

cocos/particle/dynamic-buffer-manager.ts

@@ -3,7 +3,7 @@ import { meshPosition, meshUv } from './define';
 import { js, System } from '../core';
 import { Director, director } from '../game/director';
 
-export class VFXDynamicBuffer {
+export class SharedDynamicBuffer {
     get buffer () {
         return this._buffer;
     }
@@ -115,7 +115,7 @@ export class DynamicBufferManager extends System {
     private _sharedSpriteIndexBuffer: Buffer | null = null;
     private _sharedSpriteVertexCount = 4;
     private _sharedSpriteIndexCount = 6;
-    private _sharedDynamicBufferMap: Record<string, VFXDynamicBuffer> = {};
+    private _sharedDynamicBufferMap: Record<string, SharedDynamicBuffer> = {};
 
     init (): void {
         director.on(Director.EVENT_UPLOAD_DYNAMIC_VBO, this.updateBuffer);

cocos/particle/line.ts

@@ -27,8 +27,8 @@ import { Material, Texture2D } from '../asset/assets';
 import { Vec3, cclegacy, Vec4, Vec2, CCBoolean } from '../core';
 import { LineModel } from './models/line-model';
 import { builtinResMgr } from '../asset/asset-manager';
-import CurveRange from './animator/curve-range';
-import GradientRange from './animator/gradient-range';
+import { CurveRange } from './curve-range';
+import { GradientRange } from './gradient-range';
 import { ModelRenderer } from '../misc';
 
 const CC_USE_WORLD_SPACE = 'CC_USE_WORLD_SPACE';

cocos/particle/models/line-model.ts

@@ -28,8 +28,8 @@ import { DRAW_INFO_SIZE, Buffer, Attribute, BufferInfo, DrawInfo,
     AttributeName, BufferUsageBit, Format, FormatInfos, MemoryUsageBit, PrimitiveMode } from '../../gfx';
 import { Vec3 } from '../../core';
 import { scene } from '../../render-scene';
-import CurveRange from '../animator/curve-range';
-import GradientRange from '../animator/gradient-range';
+import { CurveRange } from '../curve-range';
+import { GradientRange } from '../gradient-range';
 import { Material } from '../../asset/assets';
 
 const _vertex_attrs = [

cocos/particle/modules/box-shape.ts

@@ -1,5 +1,5 @@
 import { Enum } from '../../core';
-import { ccclass, tooltip, type } from '../../core/data/class-decorator';
+import { ccclass, serializable, tooltip, type } from '../../core/data/class-decorator';
 import { BoxShapeEmitFrom } from '../define';
 import { Impl } from '../impl';
 import { Shape } from './shape';
@@ -28,6 +28,7 @@ export class BoxShape extends Shape {
         return this._impl as Impl.BoxShape | null;
     }
 
+    @serializable
     private _emitFrom: BoxShapeEmitFrom = BoxShapeEmitFrom.VOLUME;
 
     /**

cocos/particle/modules/circle-shape.ts

@@ -1,21 +1,71 @@
-import { ccclass } from '../../core/data/class-decorator';
+import { CCFloat, clamp, clamp01 } from '../../core';
+import { ccclass, range, rangeStep, serializable, tooltip, type } from '../../core/data/class-decorator';
+import { rangeMin } from '../../core/data/decorators';
 import { Impl } from '../impl';
-import { Shape } from './shape';
+import { DistributableShape } from './distributable-shape';
 
 @ccclass('cc.CircleShape')
-export class CircleShape extends Shape {
+export class CircleShape extends DistributableShape {
+    @type(CCFloat)
+    @tooltip('i18n:ParticleSystem.CircleShape.radius')
+    @rangeMin(0.0001)
+    public get radius (): number {
+        return this._radius;
+    }
+
+    public set radius (radius: number) {
+        this._radius = Math.max(radius, 0.0001);
+        this.impl?.setRadius(this._radius);
+    }
+
+    @type(CCFloat)
+    @tooltip('i18n:ParticleSystem.CircleShape.radiusThickness')
+    @range([0, 1])
+    public get radiusThickness (): number {
+        return this._radiusThickness;
+    }
+
+    public set radiusThickness (radiusThickness: number) {
+        this._radiusThickness = clamp01(radiusThickness);
+        this.impl?.setRadiusThickness(this._radiusThickness);
+    }
+
+    @type(CCFloat)
+    @tooltip('i18n:ParticleSystem.CircleShape.arc')
+    @range([0, 360])
+    public get arc (): number {
+        return this._arc;
+    }
+
+    public set arc (arc: number) {
+        this._arc = clamp(arc, 0, 360);
+        this.impl?.setArc(this._arc);
+    }
+
     /**
      * @engineInternal
      */
     public get impl (): Impl.CircleShape | null {
         return this._impl as Impl.CircleShape | null;
     }
 
+    @serializable
+    private _radius = 1;
+    @serializable
+    private _radiusThickness = 1;
+    @serializable
+    private _arc = 360;
+
     /**
      * @engineInternal
      */
     public initialize (): void {
         super.initialize();
+        if (this.impl) {
+            this.impl.setRadius(this._radius);
+            this.impl.setRadiusThickness(this._radiusThickness);
+            this.impl.setArc(this._arc);
+        }
     }
 
     /**

cocos/particle/modules/color-by-speed.ts

@@ -33,8 +33,8 @@ export class ColorBySpeed extends ParticleSystemModule {
      * @en Maps the velocity of particles to a color within the specified range.
      */
     @type(Vec2)
+    @tooltip('i18n:ParticleSystem.ColorBySpeed.speedRange')
     @rangeMin(0)
-    @rangeStep(0.01)
     public get speedRange (): Readonly<Vec2> {
         return this._speedRange;
     }

cocos/particle/modules/color-over-lifetime.ts

@@ -22,7 +22,7 @@
  THE SOFTWARE.
 */
 
-import { ccclass, type, serializable } from 'cc.decorator';
+import { ccclass, type, serializable, tooltip } from 'cc.decorator';
 import { ParticleSystemModule } from '../particle-system-module';
 import { GradientRange } from '../gradient-range';
 import { Impl } from '../impl';
@@ -40,10 +40,33 @@ export class ColorOverLifetime extends ParticleSystemModule {
      * @zh 颜色随时间变化的参数，各个 key 之间线性插值变化。
      */
     @type(GradientRange)
+    @tooltip('i18n:ParticleSystem.ColorOverLifetime.color')
+    public get color (): Readonly<GradientRange> {
+        return this._color;
+    }
+
+    public set color (val: Readonly<GradientRange>) {
+        this._color.set(val);
+        if (this.impl) {
+            this._color.copyToLowLevelGradientRange(this.impl.getColor());
+        }
+    }
+
+    public get impl (): Impl.ColorOverLifetime | null {
+        return this._impl as Impl.ColorOverLifetime | null;
+    }
+
     @serializable
-    public color = new GradientRange();
+    private _color = new GradientRange();
 
     protected createImpl (): Impl.ParticleSystemModule {
-        throw new Error('Method not implemented.');
+        return new Impl.ColorOverLifetime();
+    }
+
+    public initialize (): void {
+        super.initialize();
+        if (this.impl) {
+            this._color.copyToLowLevelGradientRange(this.impl.getColor());
+        }
     }
 }