@galacean/engine-core 2.0.0-alpha.16 → 2.0.0-alpha.18

package/package.json

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

package/types/graphic/Buffer.d.ts

@@ -10,7 +10,6 @@ export declare class Buffer extends GraphicsResource {
     private _type;
     private _byteLength;
     private _bufferUsage;
-    private _platformBuffer;
     private _readable;
     private _data;
     /**
@@ -106,6 +105,14 @@ export declare class Buffer extends GraphicsResource {
      * @param dataLength - Output data length
      */
     getData(data: ArrayBufferView, bufferByteOffset: number, dataOffset: number, dataLength: number): void;
+    /**
+     * Copy data from another buffer on the GPU.
+     * @param srcBuffer - Source buffer
+     * @param srcByteOffset - Byte offset in the source buffer
+     * @param dstByteOffset - Byte offset in this buffer
+     * @param byteLength - Number of bytes to copy
+     */
+    copyFromBuffer(srcBuffer: Buffer, srcByteOffset: number, dstByteOffset: number, byteLength: number): void;
     /**
      * Mark buffer as readable, the `data` property will be not accessible anymore.
      */

package/types/graphic/TransformFeedback.d.ts

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

package/types/graphic/TransformFeedbackPrimitive.d.ts

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

package/types/graphic/TransformFeedbackShader.d.ts

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

package/types/graphic/TransformFeedbackSimulator.d.ts

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

package/types/graphic/enums/BufferBindFlag.d.ts

@@ -2,8 +2,8 @@
  * Buffer binding flag.
  */
 export declare enum BufferBindFlag {
-    /** Vertex buffer binding flag */
+    /** Vertex buffer binding flag. */
     VertexBuffer = 0,
-    /** Index buffer binding flag */
+    /** Index buffer binding flag. */
     IndexBuffer = 1
 }

package/types/particle/ParticleGenerator.d.ts

@@ -2,6 +2,7 @@ import { ParticleStopMode } from "./enums/ParticleStopMode";
 import { ColorOverLifetimeModule } from "./modules/ColorOverLifetimeModule";
 import { EmissionModule } from "./modules/EmissionModule";
 import { ForceOverLifetimeModule } from "./modules/ForceOverLifetimeModule";
+import { LimitVelocityOverLifetimeModule } from "./modules/LimitVelocityOverLifetimeModule";
 import { MainModule } from "./modules/MainModule";
 import { RotationOverLifetimeModule } from "./modules/RotationOverLifetimeModule";
 import { SizeOverLifetimeModule } from "./modules/SizeOverLifetimeModule";
@@ -16,11 +17,13 @@ export declare class ParticleGenerator {
     private static _tempVector22;
     private static _tempVector30;
     private static _tempVector31;
+    private static _tempVector32;
     private static _tempMat;
     private static _tempColor0;
     private static _tempParticleRenderers;
     private static readonly _particleIncreaseCount;
     private static readonly _transformedBoundsIncreaseCount;
+    private static readonly _transformFeedbackMacro;
     /** Use auto random seed. */
     useAutoRandomSeed: boolean;
     /** Main module. */
@@ -31,6 +34,8 @@ export declare class ParticleGenerator {
     readonly velocityOverLifetime: VelocityOverLifetimeModule;
     /** Force over lifetime module. */
     readonly forceOverLifetime: ForceOverLifetimeModule;
+    /** Limit velocity over lifetime module. */
+    readonly limitVelocityOverLifetime: LimitVelocityOverLifetimeModule;
     /** Size over lifetime module. */
     readonly sizeOverLifetime: SizeOverLifetimeModule;
     /** Rotation over lifetime module. */
@@ -80,6 +85,8 @@ export declare class ParticleGenerator {
      */
     emit(count: number): void;
     private _addNewParticle;
+    private _addFeedbackParticle;
+    private _clearActiveParticles;
     private _retireActiveParticles;
     private _freeRetiredParticles;
     private _addActiveParticlesToVertexBuffer;

package/types/particle/ParticleTransformFeedbackSimulator.d.ts

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

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

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

package/types/particle/index.d.ts

@@ -19,4 +19,5 @@ export { RotationOverLifetimeModule } from "./modules/RotationOverLifetimeModule
 export { SizeOverLifetimeModule } from "./modules/SizeOverLifetimeModule";
 export { TextureSheetAnimationModule } from "./modules/TextureSheetAnimationModule";
 export { VelocityOverLifetimeModule } from "./modules/VelocityOverLifetimeModule";
+export { LimitVelocityOverLifetimeModule } from "./modules/LimitVelocityOverLifetimeModule";
 export * from "./modules/shape/index";

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

@@ -0,0 +1,119 @@
+import { ShaderMacro } from "../../shader";
+import { ShaderProperty } from "../../shader/ShaderProperty";
+import { ParticleSimulationSpace } from "../enums/ParticleSimulationSpace";
+import { ParticleGenerator } from "../ParticleGenerator";
+import { ParticleCompositeCurve } from "./ParticleCompositeCurve";
+import { ParticleGeneratorModule } from "./ParticleGeneratorModule";
+/**
+ * Limit velocity over lifetime module.
+ */
+export declare class LimitVelocityOverLifetimeModule extends ParticleGeneratorModule {
+    static readonly _enabledMacro: ShaderMacro;
+    static readonly _separateAxesMacro: ShaderMacro;
+    static readonly _speedConstantModeMacro: ShaderMacro;
+    static readonly _speedCurveModeMacro: ShaderMacro;
+    static readonly _speedIsRandomMacro: ShaderMacro;
+    static readonly _dragCurveModeMacro: ShaderMacro;
+    static readonly _dragIsRandomMacro: ShaderMacro;
+    static readonly _multiplyDragBySizeMacro: ShaderMacro;
+    static readonly _multiplyDragByVelocityMacro: ShaderMacro;
+    static readonly _speedMaxConstProperty: ShaderProperty;
+    static readonly _speedMinConstProperty: ShaderProperty;
+    static readonly _speedMaxCurveProperty: ShaderProperty;
+    static readonly _speedMinCurveProperty: ShaderProperty;
+    static readonly _speedMaxConstVecProperty: ShaderProperty;
+    static readonly _speedMinConstVecProperty: ShaderProperty;
+    static readonly _speedXMaxCurveProperty: ShaderProperty;
+    static readonly _speedXMinCurveProperty: ShaderProperty;
+    static readonly _speedYMaxCurveProperty: ShaderProperty;
+    static readonly _speedYMinCurveProperty: ShaderProperty;
+    static readonly _speedZMaxCurveProperty: ShaderProperty;
+    static readonly _speedZMinCurveProperty: ShaderProperty;
+    static readonly _dampenProperty: ShaderProperty;
+    static readonly _dragConstantProperty: ShaderProperty;
+    static readonly _dragMaxCurveProperty: ShaderProperty;
+    static readonly _dragMinCurveProperty: ShaderProperty;
+    static readonly _spaceProperty: ShaderProperty;
+    private _speedMinConstantVec;
+    private _speedMaxConstantVec;
+    private _dragConstantVec;
+    private _enabledModuleMacro;
+    private _separateAxesCachedMacro;
+    private _speedModeMacro;
+    private _speedRandomMacro;
+    private _dragCurveCachedMacro;
+    private _dragRandomCachedMacro;
+    private _dragSizeMacro;
+    private _dragVelocityMacro;
+    private _separateAxes;
+    private _speedX;
+    private _speedY;
+    private _speedZ;
+    private _dampen;
+    private _drag;
+    private _multiplyDragByParticleSize;
+    private _multiplyDragByParticleVelocity;
+    private _space;
+    /**
+     * Whether to limit velocity on each axis separately.
+     */
+    get separateAxes(): boolean;
+    set separateAxes(value: boolean);
+    /**
+     * Speed limit when separateAxes is false.
+     */
+    get speed(): ParticleCompositeCurve;
+    set speed(value: ParticleCompositeCurve);
+    /**
+     * Speed limit for the x-axis (or overall limit when separateAxes is false).
+     */
+    get speedX(): ParticleCompositeCurve;
+    set speedX(value: ParticleCompositeCurve);
+    /**
+     * Speed limit for the y-axis.
+     */
+    get speedY(): ParticleCompositeCurve;
+    set speedY(value: ParticleCompositeCurve);
+    /**
+     * Speed limit for the z-axis.
+     */
+    get speedZ(): ParticleCompositeCurve;
+    set speedZ(value: ParticleCompositeCurve);
+    /**
+     * Controls how much the velocity is dampened when it exceeds the limit.
+     * @remarks Value is clamped to [0, 1]. 0 means no damping, 1 means full damping.
+     */
+    get dampen(): number;
+    set dampen(value: number);
+    /**
+     * Controls the amount of drag applied to particle velocities.
+     */
+    get drag(): ParticleCompositeCurve;
+    set drag(value: ParticleCompositeCurve);
+    /**
+     * Adjust the amount of drag based on particle sizes.
+     */
+    get multiplyDragByParticleSize(): boolean;
+    set multiplyDragByParticleSize(value: boolean);
+    /**
+     * Adjust the amount of drag based on particle speeds.
+     */
+    get multiplyDragByParticleVelocity(): boolean;
+    set multiplyDragByParticleVelocity(value: boolean);
+    /**
+     * Specifies if the velocity limits are in local space or world space.
+     * @remarks Only takes effect when 'separateAxes' is enabled.
+     */
+    get space(): ParticleSimulationSpace;
+    set space(value: ParticleSimulationSpace);
+    /**
+     * Specifies whether the module is enabled.
+     * @remarks This module requires WebGL2, On WebGL1, enabling will be silently ignored.
+     */
+    get enabled(): boolean;
+    set enabled(value: boolean);
+    constructor(generator: ParticleGenerator);
+    private _uploadScalarSpeed;
+    private _uploadSeparateAxisSpeeds;
+    private _uploadDrag;
+}

package/types/renderingHardwareInterface/IPlatformBuffer.d.ts

@@ -3,5 +3,6 @@ export interface IPlatformBuffer {
     bind(): void;
     setData(byteLength: number, data: ArrayBuffer | ArrayBufferView, bufferByteOffset?: number, dataOffset?: number, dataLength?: number, options?: SetDataOptions): void;
     getData(data: ArrayBufferView, bufferByteOffset?: number, dataOffset?: number, dataLength?: number): void;
+    copyFromBuffer(srcBuffer: IPlatformBuffer, srcByteOffset: number, dstByteOffset: number, byteLength: number): void;
     destroy(): void;
 }

package/types/renderingHardwareInterface/IPlatformTransformFeedback.d.ts

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

package/types/renderingHardwareInterface/IPlatformTransformFeedbackPrimitive.d.ts

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

package/types/renderingHardwareInterface/index.d.ts

@@ -4,3 +4,5 @@ export type { IPlatformTexture } from "./IPlatformTexture";
 export type { IPlatformTexture2D } from "./IPlatformTexture2D";
 export type { IPlatformTexture2DArray } from "./IPlatformTexture2DArray";
 export type { IPlatformTextureCube } from "./IPlatformTextureCube";
+export type { IPlatformTransformFeedback } from "./IPlatformTransformFeedback";
+export type { IPlatformTransformFeedbackPrimitive } from "./IPlatformTransformFeedbackPrimitive";

package/types/shader/ShaderPass.d.ts

@@ -3,7 +3,6 @@ import { ShaderPart } from "./ShaderPart";
  * Shader pass containing vertex and fragment source.
  */
 export declare class ShaderPass extends ShaderPart {
-    private static _shaderPassCounter;
     private _vertexSource;
     private _fragmentSource;
     /**
@@ -22,4 +21,5 @@ export declare class ShaderPass extends ShaderPart {
      */
     constructor(vertexSource: string, fragmentSource: string, tags?: Record<string, number | string | boolean>);
     private _getCanonicalShaderProgram;
+    private _getShaderLabProgram;
 }

package/types/shaderlib/ShaderLib.d.ts

@@ -6,6 +6,8 @@ export declare const ShaderLib: {
     color_over_lifetime_module: string;
     texture_sheet_animation_module: string;
     force_over_lifetime_module: string;
+    limit_velocity_over_lifetime_module: string;
+    particle_feedback_simulation: string;
     sphere_billboard: string;
     stretched_billboard: string;
     vertical_billboard: string;

package/types/shaderlib/particle/index.d.ts

@@ -6,6 +6,8 @@ declare const _default: {
     color_over_lifetime_module: string;
     texture_sheet_animation_module: string;
     force_over_lifetime_module: string;
+    limit_velocity_over_lifetime_module: string;
+    particle_feedback_simulation: string;
     sphere_billboard: string;
     stretched_billboard: string;
     vertical_billboard: string;