@babylonjs/core 8.16.0 → 8.16.2

package/Particles/IParticleSystem.js.map

@@ -1 +1 @@
-{"version":3,"file":"IParticleSystem.js","sourceRoot":"","sources":["../../../../dev/core/src/Particles/IParticleSystem.ts"],"names":[],"mappings":"","sourcesContent":["import type { Immutable, Nullable } from \"../types\";\r\nimport type { Vector2, Vector3, Matrix } from \"../Maths/math.vector\";\r\nimport type { Color3, Color4 } from \"../Maths/math.color\";\r\nimport type { BaseTexture } from \"../Materials/Textures/baseTexture\";\r\nimport type {\r\n    BoxParticleEmitter,\r\n    IParticleEmitterType,\r\n    PointParticleEmitter,\r\n    HemisphericParticleEmitter,\r\n    SphereParticleEmitter,\r\n    SphereDirectedParticleEmitter,\r\n    CylinderParticleEmitter,\r\n    CylinderDirectedParticleEmitter,\r\n    ConeParticleEmitter,\r\n    ConeDirectedParticleEmitter,\r\n} from \"../Particles/EmitterTypes/index\";\r\nimport type { Scene } from \"../scene\";\r\nimport type { ColorGradient, FactorGradient, Color3Gradient } from \"../Misc/gradients\";\r\nimport type { Effect } from \"../Materials/effect\";\r\nimport type { Observable } from \"../Misc/observable\";\r\nimport type { VertexBuffer } from \"../Buffers/buffer\";\r\nimport type { DataBuffer } from \"../Buffers/dataBuffer\";\r\n\r\nimport type { Animation } from \"../Animations/animation\";\r\nimport type { AbstractMesh } from \"../Meshes/abstractMesh\";\r\n\r\n/**\r\n * Interface representing a particle system in Babylon.js.\r\n * This groups the common functionalities that needs to be implemented in order to create a particle system.\r\n * A particle system represents a way to manage particles from their emission to their animation and rendering.\r\n */\r\nexport interface IParticleSystem {\r\n    /**\r\n     * List of animations used by the particle system.\r\n     */\r\n    animations: Animation[];\r\n    /**\r\n     * The id of the Particle system.\r\n     */\r\n    id: string;\r\n    /**\r\n     * The name of the Particle system.\r\n     */\r\n    name: string;\r\n    /**\r\n     * The emitter represents the Mesh or position we are attaching the particle system to.\r\n     */\r\n    emitter: Nullable<AbstractMesh | Vector3>;\r\n    /**\r\n     * Gets or sets a boolean indicating if the particles must be rendered as billboard or aligned with the direction\r\n     */\r\n    isBillboardBased: boolean;\r\n    /**\r\n     * The rendering group used by the Particle system to chose when to render.\r\n     */\r\n    renderingGroupId: number;\r\n    /**\r\n     * The layer mask we are rendering the particles through.\r\n     */\r\n    layerMask: number;\r\n\r\n    /**\r\n     * The overall motion speed (0.01 is default update speed, faster updates = faster animation)\r\n     */\r\n    updateSpeed: number;\r\n\r\n    /**\r\n     * The amount of time the particle system is running (depends of the overall update speed).\r\n     */\r\n    targetStopDuration: number;\r\n\r\n    /**\r\n     * The texture used to render each particle. (this can be a spritesheet)\r\n     */\r\n    particleTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Blend mode use to render the particle. It can be any of the ParticleSystem.BLENDMODE_* constants\r\n     */\r\n    blendMode: number;\r\n\r\n    /**\r\n     * Minimum life time of emitting particles.\r\n     */\r\n    minLifeTime: number;\r\n    /**\r\n     * Maximum life time of emitting particles.\r\n     */\r\n    maxLifeTime: number;\r\n\r\n    /**\r\n     * Minimum Size of emitting particles.\r\n     */\r\n    minSize: number;\r\n    /**\r\n     * Maximum Size of emitting particles.\r\n     */\r\n    maxSize: number;\r\n\r\n    /**\r\n     * Minimum scale of emitting particles on X axis.\r\n     */\r\n    minScaleX: number;\r\n    /**\r\n     * Maximum scale of emitting particles on X axis.\r\n     */\r\n    maxScaleX: number;\r\n\r\n    /**\r\n     * Minimum scale of emitting particles on Y axis.\r\n     */\r\n    minScaleY: number;\r\n    /**\r\n     * Maximum scale of emitting particles on Y axis.\r\n     */\r\n    maxScaleY: number;\r\n\r\n    /**\r\n     * Random color of each particle after it has been emitted, between color1 and color2 vectors.\r\n     */\r\n    color1: Color4;\r\n    /**\r\n     * Random color of each particle after it has been emitted, between color1 and color2 vectors.\r\n     */\r\n    color2: Color4;\r\n\r\n    /**\r\n     * Color the particle will have at the end of its lifetime.\r\n     */\r\n    colorDead: Color4;\r\n\r\n    /**\r\n     * The maximum number of particles to emit per frame until we reach the activeParticleCount value\r\n     */\r\n    emitRate: number;\r\n\r\n    /**\r\n     * You can use gravity if you want to give an orientation to your particles.\r\n     */\r\n    gravity: Vector3;\r\n\r\n    /**\r\n     * Minimum power of emitting particles.\r\n     */\r\n    minEmitPower: number;\r\n    /**\r\n     * Maximum power of emitting particles.\r\n     */\r\n    maxEmitPower: number;\r\n    /**\r\n     * Minimum angular speed of emitting particles (Z-axis rotation for each particle).\r\n     */\r\n    minAngularSpeed: number;\r\n    /**\r\n     * Maximum angular speed of emitting particles (Z-axis rotation for each particle).\r\n     */\r\n    maxAngularSpeed: number;\r\n    /**\r\n     * Gets or sets the minimal initial rotation in radians.\r\n     */\r\n    minInitialRotation: number;\r\n    /**\r\n     * Gets or sets the maximal initial rotation in radians.\r\n     */\r\n    maxInitialRotation: number;\r\n    /**\r\n     * The particle emitter type defines the emitter used by the particle system.\r\n     * It can be for example box, sphere, or cone...\r\n     */\r\n    particleEmitterType: Nullable<IParticleEmitterType>;\r\n    /**\r\n     * Defines the delay in milliseconds before starting the system (0 by default)\r\n     */\r\n    startDelay: number;\r\n    /**\r\n     * Gets or sets a value indicating how many cycles (or frames) must be executed before first rendering (this value has to be set before starting the system). Default is 0\r\n     */\r\n    preWarmCycles: number;\r\n    /**\r\n     * Gets or sets a value indicating the time step multiplier to use in pre-warm mode (default is 1)\r\n     */\r\n    preWarmStepOffset: number;\r\n\r\n    /**\r\n     * If using a spritesheet (isAnimationSheetEnabled) defines the speed of the sprite loop (default is 1 meaning the animation will play once during the entire particle lifetime)\r\n     */\r\n    spriteCellChangeSpeed: number;\r\n    /**\r\n     * If using a spritesheet (isAnimationSheetEnabled) defines the first sprite cell to display\r\n     */\r\n    // eslint-disable-next-line @typescript-eslint/naming-convention\r\n    startSpriteCellID: number;\r\n    /**\r\n     * If using a spritesheet (isAnimationSheetEnabled) defines the last sprite cell to display\r\n     */\r\n    // eslint-disable-next-line @typescript-eslint/naming-convention\r\n    endSpriteCellID: number;\r\n    /**\r\n     * If using a spritesheet (isAnimationSheetEnabled), defines whether the sprite animation is looping\r\n     */\r\n    spriteCellLoop: boolean;\r\n    /**\r\n     * If using a spritesheet (isAnimationSheetEnabled), defines the sprite cell width to use\r\n     */\r\n    spriteCellWidth: number;\r\n    /**\r\n     * If using a spritesheet (isAnimationSheetEnabled), defines the sprite cell height to use\r\n     */\r\n    spriteCellHeight: number;\r\n    /**\r\n     * This allows the system to random pick the start cell ID between startSpriteCellID and endSpriteCellID\r\n     */\r\n    spriteRandomStartCell: boolean;\r\n\r\n    /**\r\n     * Gets or sets a boolean indicating if a spritesheet is used to animate the particles texture\r\n     */\r\n    isAnimationSheetEnabled: boolean;\r\n\r\n    /** Gets or sets a Vector2 used to move the pivot (by default (0,0)) */\r\n    translationPivot: Vector2;\r\n\r\n    /**\r\n     * Gets or sets a texture used to add random noise to particle positions\r\n     */\r\n    noiseTexture: Nullable<BaseTexture>;\r\n\r\n    /** Gets or sets the strength to apply to the noise value (default is (10, 10, 10)) */\r\n    noiseStrength: Vector3;\r\n\r\n    /**\r\n     * Gets or sets the billboard mode to use when isBillboardBased = true.\r\n     * Value can be: ParticleSystem.BILLBOARDMODE_ALL, ParticleSystem.BILLBOARDMODE_Y, ParticleSystem.BILLBOARDMODE_STRETCHED\r\n     */\r\n    billboardMode: number;\r\n\r\n    /**\r\n     * Gets or sets a boolean enabling the use of logarithmic depth buffers, which is good for wide depth buffers.\r\n     */\r\n    useLogarithmicDepth: boolean;\r\n\r\n    /** Gets or sets a value indicating the damping to apply if the limit velocity factor is reached */\r\n    limitVelocityDamping: number;\r\n\r\n    /**\r\n     * Gets or sets a boolean indicating that hosted animations (in the system.animations array) must be started when system.start() is called\r\n     */\r\n    beginAnimationOnStart: boolean;\r\n\r\n    /**\r\n     * Gets or sets the frame to start the animation from when beginAnimationOnStart is true\r\n     */\r\n    beginAnimationFrom: number;\r\n\r\n    /**\r\n     * Gets or sets the frame to end the animation on when beginAnimationOnStart is true\r\n     */\r\n    beginAnimationTo: number;\r\n\r\n    /**\r\n     * Gets or sets a boolean indicating if animations must loop when beginAnimationOnStart is true\r\n     */\r\n    beginAnimationLoop: boolean;\r\n\r\n    /**\r\n     * Specifies whether the particle system will be disposed once it reaches the end of the animation.\r\n     */\r\n    disposeOnStop: boolean;\r\n\r\n    /**\r\n     * If you want to launch only a few particles at once, that can be done, as well.\r\n     */\r\n    manualEmitCount: number;\r\n\r\n    /**\r\n     * Specifies if the particles are updated in emitter local space or world space\r\n     */\r\n    isLocal: boolean;\r\n\r\n    /** Snippet ID if the particle system was created from the snippet server */\r\n    snippetId: string;\r\n\r\n    /** Gets or sets a matrix to use to compute projection */\r\n    defaultProjectionMatrix: Matrix;\r\n\r\n    /** Indicates that the update of particles is done in the animate function (and not in render) */\r\n    updateInAnimate: boolean;\r\n\r\n    /** @internal */\r\n    _wasDispatched: boolean;\r\n\r\n    /**\r\n     * Returns true if the particle system was generated by a node particle system set\r\n     */\r\n    isNodeGenerated: boolean;\r\n\r\n    /**\r\n     * Gets the maximum number of particles active at the same time.\r\n     * @returns The max number of active particles.\r\n     */\r\n    getCapacity(): number;\r\n\r\n    /**\r\n     * Gets the number of particles active at the same time.\r\n     * @returns The number of active particles.\r\n     */\r\n    getActiveCount(): number;\r\n\r\n    /**\r\n     * Gets if the system has been started. (Note: this will still be true after stop is called)\r\n     * @returns True if it has been started, otherwise false.\r\n     */\r\n    isStarted(): boolean;\r\n\r\n    /**\r\n     * Animates the particle system for this frame.\r\n     */\r\n    animate(): void;\r\n    /**\r\n     * Renders the particle system in its current state.\r\n     * @returns the current number of particles\r\n     */\r\n    render(): number;\r\n    /**\r\n     * Dispose the particle system and frees its associated resources.\r\n     * @param disposeTexture defines if the particle texture must be disposed as well (true by default)\r\n     * @param disposeAttachedSubEmitters defines if the attached sub-emitters must be disposed as well (false by default)\r\n     * @param disposeEndSubEmitters defines if the end type sub-emitters must be disposed as well (false by default)\r\n     */\r\n    dispose(disposeTexture?: boolean, disposeAttachedSubEmitters?: boolean, disposeEndSubEmitters?: boolean): void;\r\n    /**\r\n     * An event triggered when the system is disposed\r\n     */\r\n    onDisposeObservable: Observable<IParticleSystem>;\r\n    /**\r\n     * An event triggered when the system is stopped\r\n     */\r\n    onStoppedObservable: Observable<IParticleSystem>;\r\n    /**\r\n     * An event triggered when the system is started\r\n     */\r\n    onStartedObservable: Observable<IParticleSystem>;\r\n    /**\r\n     * Clones the particle system.\r\n     * @param name The name of the cloned object\r\n     * @param newEmitter The new emitter to use\r\n     * @returns the cloned particle system\r\n     */\r\n    clone(name: string, newEmitter: any): Nullable<IParticleSystem>;\r\n    /**\r\n     * Serializes the particle system to a JSON object\r\n     * @param serializeTexture defines if the texture must be serialized as well\r\n     * @returns the JSON object\r\n     */\r\n    serialize(serializeTexture: boolean): any;\r\n    /**\r\n     * Rebuild the particle system\r\n     */\r\n    rebuild(): void;\r\n\r\n    /** Force the system to rebuild all gradients that need to be resync */\r\n    forceRefreshGradients(): void;\r\n\r\n    /**\r\n     * Starts the particle system and begins to emit\r\n     * @param delay defines the delay in milliseconds before starting the system (0 by default)\r\n     */\r\n    start(delay?: number): void;\r\n\r\n    /**\r\n     * Stops the particle system.\r\n     */\r\n    stop(): void;\r\n\r\n    /**\r\n     * Remove all active particles\r\n     */\r\n    reset(): void;\r\n\r\n    /**\r\n     * Gets a boolean indicating that the system is stopping\r\n     * @returns true if the system is currently stopping\r\n     */\r\n    isStopping(): boolean;\r\n\r\n    /**\r\n     * Is this system ready to be used/rendered\r\n     * @returns true if the system is ready\r\n     */\r\n    isReady(): boolean;\r\n    /**\r\n     * Returns the string \"ParticleSystem\"\r\n     * @returns a string containing the class name\r\n     */\r\n    getClassName(): string;\r\n    /**\r\n     * Gets the custom effect used to render the particles\r\n     * @param blendMode Blend mode for which the effect should be retrieved\r\n     * @returns The effect\r\n     */\r\n    getCustomEffect(blendMode: number): Nullable<Effect>;\r\n    /**\r\n     * Sets the custom effect used to render the particles\r\n     * @param effect The effect to set\r\n     * @param blendMode Blend mode for which the effect should be set\r\n     */\r\n    setCustomEffect(effect: Nullable<Effect>, blendMode: number): void;\r\n\r\n    /**\r\n     * Fill the defines array according to the current settings of the particle system\r\n     * @param defines Array to be updated\r\n     * @param blendMode blend mode to take into account when updating the array\r\n     * @param fillImageProcessing fills the image processing defines\r\n     */\r\n    fillDefines(defines: Array<string>, blendMode: number, fillImageProcessing?: boolean): void;\r\n    /**\r\n     * Fill the uniforms, attributes and samplers arrays according to the current settings of the particle system\r\n     * @param uniforms Uniforms array to fill\r\n     * @param attributes Attributes array to fill\r\n     * @param samplers Samplers array to fill\r\n     */\r\n    fillUniformsAttributesAndSamplerNames(uniforms: Array<string>, attributes: Array<string>, samplers: Array<string>): void;\r\n    /**\r\n     * Observable that will be called just before the particles are drawn\r\n     */\r\n    onBeforeDrawParticlesObservable: Observable<Nullable<Effect>>;\r\n    /**\r\n     * Gets the name of the particle vertex shader\r\n     */\r\n    vertexShaderName: string;\r\n\r\n    /**\r\n     * Gets the vertex buffers used by the particle system\r\n     */\r\n    vertexBuffers: Immutable<{ [key: string]: VertexBuffer }>;\r\n    /**\r\n     * Gets the index buffer used by the particle system (or null if no index buffer is used)\r\n     */\r\n    indexBuffer: Nullable<DataBuffer>;\r\n\r\n    /**\r\n     * Adds a new color gradient\r\n     * @param gradient defines the gradient to use (between 0 and 1)\r\n     * @param color1 defines the color to affect to the specified gradient\r\n     * @param color2 defines an additional color used to define a range ([color, color2]) with main color to pick the final color from\r\n     * @returns the current particle system\r\n     */\r\n    addColorGradient(gradient: number, color1: Color4, color2?: Color4): IParticleSystem;\r\n    /**\r\n     * Remove a specific color gradient\r\n     * @param gradient defines the gradient to remove\r\n     * @returns the current particle system\r\n     */\r\n    removeColorGradient(gradient: number): IParticleSystem;\r\n    /**\r\n     * Adds a new size gradient\r\n     * @param gradient defines the gradient to use (between 0 and 1)\r\n     * @param factor defines the size factor to affect to the specified gradient\r\n     * @param factor2 defines an additional factor used to define a range ([factor, factor2]) with main value to pick the final value from\r\n     * @returns the current particle system\r\n     */\r\n    addSizeGradient(gradient: number, factor: number, factor2?: number): IParticleSystem;\r\n    /**\r\n     * Remove a specific size gradient\r\n     * @param gradient defines the gradient to remove\r\n     * @returns the current particle system\r\n     */\r\n    removeSizeGradient(gradient: number): IParticleSystem;\r\n    /**\r\n     * Gets the current list of color gradients.\r\n     * You must use addColorGradient and removeColorGradient to update this list\r\n     * @returns the list of color gradients\r\n     */\r\n    getColorGradients(): Nullable<Array<ColorGradient>>;\r\n    /**\r\n     * Gets the current list of size gradients.\r\n     * You must use addSizeGradient and removeSizeGradient to update this list\r\n     * @returns the list of size gradients\r\n     */\r\n    getSizeGradients(): Nullable<Array<FactorGradient>>;\r\n    /**\r\n     * Gets the current list of angular speed gradients.\r\n     * You must use addAngularSpeedGradient and removeAngularSpeedGradient to update this list\r\n     * @returns the list of angular speed gradients\r\n     */\r\n    getAngularSpeedGradients(): Nullable<Array<FactorGradient>>;\r\n    /**\r\n     * Adds a new angular speed gradient\r\n     * @param gradient defines the gradient to use (between 0 and 1)\r\n     * @param factor defines the angular speed to affect to the specified gradient\r\n     * @param factor2 defines an additional factor used to define a range ([factor, factor2]) with main value to pick the final value from\r\n     * @returns the current particle system\r\n     */\r\n    addAngularSpeedGradient(gradient: number, factor: number, factor2?: number): IParticleSystem;\r\n    /**\r\n     * Remove a specific angular speed gradient\r\n     * @param gradient defines the gradient to remove\r\n     * @returns the current particle system\r\n     */\r\n    removeAngularSpeedGradient(gradient: number): IParticleSystem;\r\n    /**\r\n     * Gets the current list of velocity gradients.\r\n     * You must use addVelocityGradient and removeVelocityGradient to update this list\r\n     * @returns the list of velocity gradients\r\n     */\r\n    getVelocityGradients(): Nullable<Array<FactorGradient>>;\r\n    /**\r\n     * Adds a new velocity gradient\r\n     * @param gradient defines the gradient to use (between 0 and 1)\r\n     * @param factor defines the velocity to affect to the specified gradient\r\n     * @param factor2 defines an additional factor used to define a range ([factor, factor2]) with main value to pick the final value from\r\n     * @returns the current particle system\r\n     */\r\n    addVelocityGradient(gradient: number, factor: number, factor2?: number): IParticleSystem;\r\n    /**\r\n     * Remove a specific velocity gradient\r\n     * @param gradient defines the gradient to remove\r\n     * @returns the current particle system\r\n     */\r\n    removeVelocityGradient(gradient: number): IParticleSystem;\r\n    /**\r\n     * Gets the current list of limit velocity gradients.\r\n     * You must use addLimitVelocityGradient and removeLimitVelocityGradient to update this list\r\n     * @returns the list of limit velocity gradients\r\n     */\r\n    getLimitVelocityGradients(): Nullable<Array<FactorGradient>>;\r\n    /**\r\n     * Adds a new limit velocity gradient\r\n     * @param gradient defines the gradient to use (between 0 and 1)\r\n     * @param factor defines the limit velocity to affect to the specified gradient\r\n     * @param factor2 defines an additional factor used to define a range ([factor, factor2]) with main value to pick the final value from\r\n     * @returns the current particle system\r\n     */\r\n    addLimitVelocityGradient(gradient: number, factor: number, factor2?: number): IParticleSystem;\r\n    /**\r\n     * Remove a specific limit velocity gradient\r\n     * @param gradient defines the gradient to remove\r\n     * @returns the current particle system\r\n     */\r\n    removeLimitVelocityGradient(gradient: number): IParticleSystem;\r\n    /**\r\n     * Adds a new drag gradient\r\n     * @param gradient defines the gradient to use (between 0 and 1)\r\n     * @param factor defines the drag to affect to the specified gradient\r\n     * @param factor2 defines an additional factor used to define a range ([factor, factor2]) with main value to pick the final value from\r\n     * @returns the current particle system\r\n     */\r\n    addDragGradient(gradient: number, factor: number, factor2?: number): IParticleSystem;\r\n    /**\r\n     * Remove a specific drag gradient\r\n     * @param gradient defines the gradient to remove\r\n     * @returns the current particle system\r\n     */\r\n    removeDragGradient(gradient: number): IParticleSystem;\r\n    /**\r\n     * Gets the current list of drag gradients.\r\n     * You must use addDragGradient and removeDragGradient to update this list\r\n     * @returns the list of drag gradients\r\n     */\r\n    getDragGradients(): Nullable<Array<FactorGradient>>;\r\n    /**\r\n     * Adds a new emit rate gradient (please note that this will only work if you set the targetStopDuration property)\r\n     * @param gradient defines the gradient to use (between 0 and 1)\r\n     * @param factor defines the emit rate to affect to the specified gradient\r\n     * @param factor2 defines an additional factor used to define a range ([factor, factor2]) with main value to pick the final value from\r\n     * @returns the current particle system\r\n     */\r\n    addEmitRateGradient(gradient: number, factor: number, factor2?: number): IParticleSystem;\r\n    /**\r\n     * Remove a specific emit rate gradient\r\n     * @param gradient defines the gradient to remove\r\n     * @returns the current particle system\r\n     */\r\n    removeEmitRateGradient(gradient: number): IParticleSystem;\r\n    /**\r\n     * Gets the current list of emit rate gradients.\r\n     * You must use addEmitRateGradient and removeEmitRateGradient to update this list\r\n     * @returns the list of emit rate gradients\r\n     */\r\n    getEmitRateGradients(): Nullable<Array<FactorGradient>>;\r\n\r\n    /**\r\n     * Adds a new start size gradient (please note that this will only work if you set the targetStopDuration property)\r\n     * @param gradient defines the gradient to use (between 0 and 1)\r\n     * @param factor defines the start size to affect to the specified gradient\r\n     * @param factor2 defines an additional factor used to define a range ([factor, factor2]) with main value to pick the final value from\r\n     * @returns the current particle system\r\n     */\r\n    addStartSizeGradient(gradient: number, factor: number, factor2?: number): IParticleSystem;\r\n    /**\r\n     * Remove a specific start size gradient\r\n     * @param gradient defines the gradient to remove\r\n     * @returns the current particle system\r\n     */\r\n    removeStartSizeGradient(gradient: number): IParticleSystem;\r\n    /**\r\n     * Gets the current list of start size gradients.\r\n     * You must use addStartSizeGradient and removeStartSizeGradient to update this list\r\n     * @returns the list of start size gradients\r\n     */\r\n    getStartSizeGradients(): Nullable<Array<FactorGradient>>;\r\n\r\n    /**\r\n     * Adds a new life time gradient\r\n     * @param gradient defines the gradient to use (between 0 and 1)\r\n     * @param factor defines the life time factor to affect to the specified gradient\r\n     * @param factor2 defines an additional factor used to define a range ([factor, factor2]) with main value to pick the final value from\r\n     * @returns the current particle system\r\n     */\r\n    addLifeTimeGradient(gradient: number, factor: number, factor2?: number): IParticleSystem;\r\n    /**\r\n     * Remove a specific life time gradient\r\n     * @param gradient defines the gradient to remove\r\n     * @returns the current particle system\r\n     */\r\n    removeLifeTimeGradient(gradient: number): IParticleSystem;\r\n    /**\r\n     * Gets the current list of life time gradients.\r\n     * You must use addLifeTimeGradient and removeLifeTimeGradient to update this list\r\n     * @returns the list of life time gradients\r\n     */\r\n    getLifeTimeGradients(): Nullable<Array<FactorGradient>>;\r\n\r\n    /**\r\n     * Gets the current list of color gradients.\r\n     * You must use addColorGradient and removeColorGradient to update this list\r\n     * @returns the list of color gradients\r\n     */\r\n    getColorGradients(): Nullable<Array<ColorGradient>>;\r\n\r\n    /**\r\n     * Adds a new ramp gradient used to remap particle colors\r\n     * @param gradient defines the gradient to use (between 0 and 1)\r\n     * @param color defines the color to affect to the specified gradient\r\n     * @returns the current particle system\r\n     */\r\n    addRampGradient(gradient: number, color: Color3): IParticleSystem;\r\n    /**\r\n     * Gets the current list of ramp gradients.\r\n     * You must use addRampGradient and removeRampGradient to update this list\r\n     * @returns the list of ramp gradients\r\n     */\r\n    getRampGradients(): Nullable<Array<Color3Gradient>>;\r\n\r\n    /** Gets or sets a boolean indicating that ramp gradients must be used\r\n     * @see https://doc.babylonjs.com/features/featuresDeepDive/particles/particle_system/ramps_and_blends\r\n     */\r\n    useRampGradients: boolean;\r\n\r\n    /**\r\n     * Adds a new color remap gradient\r\n     * @param gradient defines the gradient to use (between 0 and 1)\r\n     * @param min defines the color remap minimal range\r\n     * @param max defines the color remap maximal range\r\n     * @returns the current particle system\r\n     */\r\n    addColorRemapGradient(gradient: number, min: number, max: number): IParticleSystem;\r\n    /**\r\n     * Gets the current list of color remap gradients.\r\n     * You must use addColorRemapGradient and removeColorRemapGradient to update this list\r\n     * @returns the list of color remap gradients\r\n     */\r\n    getColorRemapGradients(): Nullable<Array<FactorGradient>>;\r\n\r\n    /**\r\n     * Adds a new alpha remap gradient\r\n     * @param gradient defines the gradient to use (between 0 and 1)\r\n     * @param min defines the alpha remap minimal range\r\n     * @param max defines the alpha remap maximal range\r\n     * @returns the current particle system\r\n     */\r\n    addAlphaRemapGradient(gradient: number, min: number, max: number): IParticleSystem;\r\n    /**\r\n     * Gets the current list of alpha remap gradients.\r\n     * You must use addAlphaRemapGradient and removeAlphaRemapGradient to update this list\r\n     * @returns the list of alpha remap gradients\r\n     */\r\n    getAlphaRemapGradients(): Nullable<Array<FactorGradient>>;\r\n\r\n    /**\r\n     * Creates a Point Emitter for the particle system (emits directly from the emitter position)\r\n     * @param direction1 Particles are emitted between the direction1 and direction2 from within the box\r\n     * @param direction2 Particles are emitted between the direction1 and direction2 from within the box\r\n     * @returns the emitter\r\n     */\r\n    createPointEmitter(direction1: Vector3, direction2: Vector3): PointParticleEmitter;\r\n\r\n    /**\r\n     * Creates a Hemisphere Emitter for the particle system (emits along the hemisphere radius)\r\n     * @param radius The radius of the hemisphere to emit from\r\n     * @param radiusRange The range of the hemisphere to emit from [0-1] 0 Surface Only, 1 Entire Radius\r\n     * @returns the emitter\r\n     */\r\n    createHemisphericEmitter(radius: number, radiusRange: number): HemisphericParticleEmitter;\r\n\r\n    /**\r\n     * Creates a Sphere Emitter for the particle system (emits along the sphere radius)\r\n     * @param radius The radius of the sphere to emit from\r\n     * @param radiusRange The range of the sphere to emit from [0-1] 0 Surface Only, 1 Entire Radius\r\n     * @returns the emitter\r\n     */\r\n    createSphereEmitter(radius: number, radiusRange: number): SphereParticleEmitter;\r\n\r\n    /**\r\n     * Creates a Directed Sphere Emitter for the particle system (emits between direction1 and direction2)\r\n     * @param radius The radius of the sphere to emit from\r\n     * @param direction1 Particles are emitted between the direction1 and direction2 from within the sphere\r\n     * @param direction2 Particles are emitted between the direction1 and direction2 from within the sphere\r\n     * @returns the emitter\r\n     */\r\n    createDirectedSphereEmitter(radius: number, direction1: Vector3, direction2: Vector3): SphereDirectedParticleEmitter;\r\n\r\n    /**\r\n     * Creates a Cylinder Emitter for the particle system (emits from the cylinder to the particle position)\r\n     * @param radius The radius of the emission cylinder\r\n     * @param height The height of the emission cylinder\r\n     * @param radiusRange The range of emission [0-1] 0 Surface only, 1 Entire Radius\r\n     * @param directionRandomizer How much to randomize the particle direction [0-1]\r\n     * @returns the emitter\r\n     */\r\n    createCylinderEmitter(radius: number, height: number, radiusRange: number, directionRandomizer: number): CylinderParticleEmitter;\r\n\r\n    /**\r\n     * Creates a Directed Cylinder Emitter for the particle system (emits between direction1 and direction2)\r\n     * @param radius The radius of the cylinder to emit from\r\n     * @param height The height of the emission cylinder\r\n     * @param radiusRange the range of the emission cylinder [0-1] 0 Surface only, 1 Entire Radius (1 by default)\r\n     * @param direction1 Particles are emitted between the direction1 and direction2 from within the cylinder\r\n     * @param direction2 Particles are emitted between the direction1 and direction2 from within the cylinder\r\n     * @returns the emitter\r\n     */\r\n    createDirectedCylinderEmitter(radius: number, height: number, radiusRange: number, direction1: Vector3, direction2: Vector3): CylinderDirectedParticleEmitter;\r\n\r\n    /**\r\n     * Creates a Cone Emitter for the particle system (emits from the cone to the particle position)\r\n     * @param radius The radius of the cone to emit from\r\n     * @param angle The base angle of the cone\r\n     * @returns the emitter\r\n     */\r\n    createConeEmitter(radius: number, angle: number): ConeParticleEmitter;\r\n\r\n    createDirectedConeEmitter(radius: number, angle: number, direction1: Vector3, direction2: Vector3): ConeDirectedParticleEmitter;\r\n\r\n    /**\r\n     * Creates a Box Emitter for the particle system. (emits between direction1 and direction2 from withing the box defined by minEmitBox and maxEmitBox)\r\n     * @param direction1 Particles are emitted between the direction1 and direction2 from within the box\r\n     * @param direction2 Particles are emitted between the direction1 and direction2 from within the box\r\n     * @param minEmitBox Particles are emitted from the box between minEmitBox and maxEmitBox\r\n     * @param maxEmitBox  Particles are emitted from the box between minEmitBox and maxEmitBox\r\n     * @returns the emitter\r\n     */\r\n    createBoxEmitter(direction1: Vector3, direction2: Vector3, minEmitBox: Vector3, maxEmitBox: Vector3): BoxParticleEmitter;\r\n\r\n    /**\r\n     * Get hosting scene\r\n     * @returns the scene\r\n     */\r\n    getScene(): Nullable<Scene>;\r\n}\r\n"]}
+{"version":3,"file":"IParticleSystem.js","sourceRoot":"","sources":["../../../../dev/core/src/Particles/IParticleSystem.ts"],"names":[],"mappings":"","sourcesContent":["import type { Immutable, Nullable } from \"../types\";\r\nimport type { Vector2, Vector3, Matrix } from \"../Maths/math.vector\";\r\nimport type { Color3, Color4 } from \"../Maths/math.color\";\r\nimport type { BaseTexture } from \"../Materials/Textures/baseTexture\";\r\nimport type {\r\n    BoxParticleEmitter,\r\n    IParticleEmitterType,\r\n    PointParticleEmitter,\r\n    HemisphericParticleEmitter,\r\n    SphereParticleEmitter,\r\n    SphereDirectedParticleEmitter,\r\n    CylinderParticleEmitter,\r\n    CylinderDirectedParticleEmitter,\r\n    ConeParticleEmitter,\r\n    ConeDirectedParticleEmitter,\r\n} from \"../Particles/EmitterTypes/index\";\r\nimport type { Scene } from \"../scene\";\r\nimport type { ColorGradient, FactorGradient, Color3Gradient } from \"../Misc/gradients\";\r\nimport type { Effect } from \"../Materials/effect\";\r\nimport type { Observable } from \"../Misc/observable\";\r\nimport type { VertexBuffer } from \"../Buffers/buffer\";\r\nimport type { DataBuffer } from \"../Buffers/dataBuffer\";\r\n\r\nimport type { Animation } from \"../Animations/animation\";\r\nimport type { AbstractMesh } from \"../Meshes/abstractMesh\";\r\n\r\n/**\r\n * Interface representing a particle system in Babylon.js.\r\n * This groups the common functionalities that needs to be implemented in order to create a particle system.\r\n * A particle system represents a way to manage particles from their emission to their animation and rendering.\r\n */\r\nexport interface IParticleSystem {\r\n    /**\r\n     * Gets or sets the unique id of the particle system.\r\n     */\r\n    uniqueId: number;\r\n\r\n    /**\r\n     * List of animations used by the particle system.\r\n     */\r\n    animations: Animation[];\r\n    /**\r\n     * The id of the Particle system.\r\n     */\r\n    id: string;\r\n    /**\r\n     * The name of the Particle system.\r\n     */\r\n    name: string;\r\n    /**\r\n     * The emitter represents the Mesh or position we are attaching the particle system to.\r\n     */\r\n    emitter: Nullable<AbstractMesh | Vector3>;\r\n    /**\r\n     * Gets or sets a boolean indicating if the particles must be rendered as billboard or aligned with the direction\r\n     */\r\n    isBillboardBased: boolean;\r\n    /**\r\n     * The rendering group used by the Particle system to chose when to render.\r\n     */\r\n    renderingGroupId: number;\r\n    /**\r\n     * The layer mask we are rendering the particles through.\r\n     */\r\n    layerMask: number;\r\n\r\n    /**\r\n     * The overall motion speed (0.01 is default update speed, faster updates = faster animation)\r\n     */\r\n    updateSpeed: number;\r\n\r\n    /**\r\n     * The amount of time the particle system is running (depends of the overall update speed).\r\n     */\r\n    targetStopDuration: number;\r\n\r\n    /**\r\n     * The texture used to render each particle. (this can be a spritesheet)\r\n     */\r\n    particleTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Blend mode use to render the particle. It can be any of the ParticleSystem.BLENDMODE_* constants\r\n     */\r\n    blendMode: number;\r\n\r\n    /**\r\n     * Minimum life time of emitting particles.\r\n     */\r\n    minLifeTime: number;\r\n    /**\r\n     * Maximum life time of emitting particles.\r\n     */\r\n    maxLifeTime: number;\r\n\r\n    /**\r\n     * Minimum Size of emitting particles.\r\n     */\r\n    minSize: number;\r\n    /**\r\n     * Maximum Size of emitting particles.\r\n     */\r\n    maxSize: number;\r\n\r\n    /**\r\n     * Minimum scale of emitting particles on X axis.\r\n     */\r\n    minScaleX: number;\r\n    /**\r\n     * Maximum scale of emitting particles on X axis.\r\n     */\r\n    maxScaleX: number;\r\n\r\n    /**\r\n     * Minimum scale of emitting particles on Y axis.\r\n     */\r\n    minScaleY: number;\r\n    /**\r\n     * Maximum scale of emitting particles on Y axis.\r\n     */\r\n    maxScaleY: number;\r\n\r\n    /**\r\n     * Random color of each particle after it has been emitted, between color1 and color2 vectors.\r\n     */\r\n    color1: Color4;\r\n    /**\r\n     * Random color of each particle after it has been emitted, between color1 and color2 vectors.\r\n     */\r\n    color2: Color4;\r\n\r\n    /**\r\n     * Color the particle will have at the end of its lifetime.\r\n     */\r\n    colorDead: Color4;\r\n\r\n    /**\r\n     * The maximum number of particles to emit per frame until we reach the activeParticleCount value\r\n     */\r\n    emitRate: number;\r\n\r\n    /**\r\n     * You can use gravity if you want to give an orientation to your particles.\r\n     */\r\n    gravity: Vector3;\r\n\r\n    /**\r\n     * Minimum power of emitting particles.\r\n     */\r\n    minEmitPower: number;\r\n    /**\r\n     * Maximum power of emitting particles.\r\n     */\r\n    maxEmitPower: number;\r\n    /**\r\n     * Minimum angular speed of emitting particles (Z-axis rotation for each particle).\r\n     */\r\n    minAngularSpeed: number;\r\n    /**\r\n     * Maximum angular speed of emitting particles (Z-axis rotation for each particle).\r\n     */\r\n    maxAngularSpeed: number;\r\n    /**\r\n     * Gets or sets the minimal initial rotation in radians.\r\n     */\r\n    minInitialRotation: number;\r\n    /**\r\n     * Gets or sets the maximal initial rotation in radians.\r\n     */\r\n    maxInitialRotation: number;\r\n    /**\r\n     * The particle emitter type defines the emitter used by the particle system.\r\n     * It can be for example box, sphere, or cone...\r\n     */\r\n    particleEmitterType: Nullable<IParticleEmitterType>;\r\n    /**\r\n     * Defines the delay in milliseconds before starting the system (0 by default)\r\n     */\r\n    startDelay: number;\r\n    /**\r\n     * Gets or sets a value indicating how many cycles (or frames) must be executed before first rendering (this value has to be set before starting the system). Default is 0\r\n     */\r\n    preWarmCycles: number;\r\n    /**\r\n     * Gets or sets a value indicating the time step multiplier to use in pre-warm mode (default is 1)\r\n     */\r\n    preWarmStepOffset: number;\r\n\r\n    /**\r\n     * If using a spritesheet (isAnimationSheetEnabled) defines the speed of the sprite loop (default is 1 meaning the animation will play once during the entire particle lifetime)\r\n     */\r\n    spriteCellChangeSpeed: number;\r\n    /**\r\n     * If using a spritesheet (isAnimationSheetEnabled) defines the first sprite cell to display\r\n     */\r\n    // eslint-disable-next-line @typescript-eslint/naming-convention\r\n    startSpriteCellID: number;\r\n    /**\r\n     * If using a spritesheet (isAnimationSheetEnabled) defines the last sprite cell to display\r\n     */\r\n    // eslint-disable-next-line @typescript-eslint/naming-convention\r\n    endSpriteCellID: number;\r\n    /**\r\n     * If using a spritesheet (isAnimationSheetEnabled), defines whether the sprite animation is looping\r\n     */\r\n    spriteCellLoop: boolean;\r\n    /**\r\n     * If using a spritesheet (isAnimationSheetEnabled), defines the sprite cell width to use\r\n     */\r\n    spriteCellWidth: number;\r\n    /**\r\n     * If using a spritesheet (isAnimationSheetEnabled), defines the sprite cell height to use\r\n     */\r\n    spriteCellHeight: number;\r\n    /**\r\n     * This allows the system to random pick the start cell ID between startSpriteCellID and endSpriteCellID\r\n     */\r\n    spriteRandomStartCell: boolean;\r\n\r\n    /**\r\n     * Gets or sets a boolean indicating if a spritesheet is used to animate the particles texture\r\n     */\r\n    isAnimationSheetEnabled: boolean;\r\n\r\n    /** Gets or sets a Vector2 used to move the pivot (by default (0,0)) */\r\n    translationPivot: Vector2;\r\n\r\n    /**\r\n     * Gets or sets a texture used to add random noise to particle positions\r\n     */\r\n    noiseTexture: Nullable<BaseTexture>;\r\n\r\n    /** Gets or sets the strength to apply to the noise value (default is (10, 10, 10)) */\r\n    noiseStrength: Vector3;\r\n\r\n    /**\r\n     * Gets or sets the billboard mode to use when isBillboardBased = true.\r\n     * Value can be: ParticleSystem.BILLBOARDMODE_ALL, ParticleSystem.BILLBOARDMODE_Y, ParticleSystem.BILLBOARDMODE_STRETCHED\r\n     */\r\n    billboardMode: number;\r\n\r\n    /**\r\n     * Gets or sets a boolean enabling the use of logarithmic depth buffers, which is good for wide depth buffers.\r\n     */\r\n    useLogarithmicDepth: boolean;\r\n\r\n    /** Gets or sets a value indicating the damping to apply if the limit velocity factor is reached */\r\n    limitVelocityDamping: number;\r\n\r\n    /**\r\n     * Gets or sets a boolean indicating that hosted animations (in the system.animations array) must be started when system.start() is called\r\n     */\r\n    beginAnimationOnStart: boolean;\r\n\r\n    /**\r\n     * Gets or sets the frame to start the animation from when beginAnimationOnStart is true\r\n     */\r\n    beginAnimationFrom: number;\r\n\r\n    /**\r\n     * Gets or sets the frame to end the animation on when beginAnimationOnStart is true\r\n     */\r\n    beginAnimationTo: number;\r\n\r\n    /**\r\n     * Gets or sets a boolean indicating if animations must loop when beginAnimationOnStart is true\r\n     */\r\n    beginAnimationLoop: boolean;\r\n\r\n    /**\r\n     * Specifies whether the particle system will be disposed once it reaches the end of the animation.\r\n     */\r\n    disposeOnStop: boolean;\r\n\r\n    /**\r\n     * If you want to launch only a few particles at once, that can be done, as well.\r\n     */\r\n    manualEmitCount: number;\r\n\r\n    /**\r\n     * Specifies if the particles are updated in emitter local space or world space\r\n     */\r\n    isLocal: boolean;\r\n\r\n    /** Snippet ID if the particle system was created from the snippet server */\r\n    snippetId: string;\r\n\r\n    /** Gets or sets a matrix to use to compute projection */\r\n    defaultProjectionMatrix: Matrix;\r\n\r\n    /** Indicates that the update of particles is done in the animate function (and not in render) */\r\n    updateInAnimate: boolean;\r\n\r\n    /** @internal */\r\n    _wasDispatched: boolean;\r\n\r\n    /**\r\n     * Returns true if the particle system was generated by a node particle system set\r\n     */\r\n    isNodeGenerated: boolean;\r\n\r\n    /**\r\n     * Gets the maximum number of particles active at the same time.\r\n     * @returns The max number of active particles.\r\n     */\r\n    getCapacity(): number;\r\n\r\n    /**\r\n     * Gets the number of particles active at the same time.\r\n     * @returns The number of active particles.\r\n     */\r\n    getActiveCount(): number;\r\n\r\n    /**\r\n     * Gets if the system has been started. (Note: this will still be true after stop is called)\r\n     * @returns True if it has been started, otherwise false.\r\n     */\r\n    isStarted(): boolean;\r\n\r\n    /**\r\n     * Animates the particle system for this frame.\r\n     */\r\n    animate(): void;\r\n    /**\r\n     * Renders the particle system in its current state.\r\n     * @returns the current number of particles\r\n     */\r\n    render(): number;\r\n    /**\r\n     * Dispose the particle system and frees its associated resources.\r\n     * @param disposeTexture defines if the particle texture must be disposed as well (true by default)\r\n     * @param disposeAttachedSubEmitters defines if the attached sub-emitters must be disposed as well (false by default)\r\n     * @param disposeEndSubEmitters defines if the end type sub-emitters must be disposed as well (false by default)\r\n     */\r\n    dispose(disposeTexture?: boolean, disposeAttachedSubEmitters?: boolean, disposeEndSubEmitters?: boolean): void;\r\n    /**\r\n     * An event triggered when the system is disposed\r\n     */\r\n    onDisposeObservable: Observable<IParticleSystem>;\r\n    /**\r\n     * An event triggered when the system is stopped\r\n     */\r\n    onStoppedObservable: Observable<IParticleSystem>;\r\n    /**\r\n     * An event triggered when the system is started\r\n     */\r\n    onStartedObservable: Observable<IParticleSystem>;\r\n    /**\r\n     * Clones the particle system.\r\n     * @param name The name of the cloned object\r\n     * @param newEmitter The new emitter to use\r\n     * @returns the cloned particle system\r\n     */\r\n    clone(name: string, newEmitter: any): Nullable<IParticleSystem>;\r\n    /**\r\n     * Serializes the particle system to a JSON object\r\n     * @param serializeTexture defines if the texture must be serialized as well\r\n     * @returns the JSON object\r\n     */\r\n    serialize(serializeTexture: boolean): any;\r\n    /**\r\n     * Rebuild the particle system\r\n     */\r\n    rebuild(): void;\r\n\r\n    /** Force the system to rebuild all gradients that need to be resync */\r\n    forceRefreshGradients(): void;\r\n\r\n    /**\r\n     * Starts the particle system and begins to emit\r\n     * @param delay defines the delay in milliseconds before starting the system (0 by default)\r\n     */\r\n    start(delay?: number): void;\r\n\r\n    /**\r\n     * Stops the particle system.\r\n     */\r\n    stop(): void;\r\n\r\n    /**\r\n     * Remove all active particles\r\n     */\r\n    reset(): void;\r\n\r\n    /**\r\n     * Gets a boolean indicating that the system is stopping\r\n     * @returns true if the system is currently stopping\r\n     */\r\n    isStopping(): boolean;\r\n\r\n    /**\r\n     * Is this system ready to be used/rendered\r\n     * @returns true if the system is ready\r\n     */\r\n    isReady(): boolean;\r\n    /**\r\n     * Returns the string \"ParticleSystem\"\r\n     * @returns a string containing the class name\r\n     */\r\n    getClassName(): string;\r\n    /**\r\n     * Gets the custom effect used to render the particles\r\n     * @param blendMode Blend mode for which the effect should be retrieved\r\n     * @returns The effect\r\n     */\r\n    getCustomEffect(blendMode: number): Nullable<Effect>;\r\n    /**\r\n     * Sets the custom effect used to render the particles\r\n     * @param effect The effect to set\r\n     * @param blendMode Blend mode for which the effect should be set\r\n     */\r\n    setCustomEffect(effect: Nullable<Effect>, blendMode: number): void;\r\n\r\n    /**\r\n     * Fill the defines array according to the current settings of the particle system\r\n     * @param defines Array to be updated\r\n     * @param blendMode blend mode to take into account when updating the array\r\n     * @param fillImageProcessing fills the image processing defines\r\n     */\r\n    fillDefines(defines: Array<string>, blendMode: number, fillImageProcessing?: boolean): void;\r\n    /**\r\n     * Fill the uniforms, attributes and samplers arrays according to the current settings of the particle system\r\n     * @param uniforms Uniforms array to fill\r\n     * @param attributes Attributes array to fill\r\n     * @param samplers Samplers array to fill\r\n     */\r\n    fillUniformsAttributesAndSamplerNames(uniforms: Array<string>, attributes: Array<string>, samplers: Array<string>): void;\r\n    /**\r\n     * Observable that will be called just before the particles are drawn\r\n     */\r\n    onBeforeDrawParticlesObservable: Observable<Nullable<Effect>>;\r\n    /**\r\n     * Gets the name of the particle vertex shader\r\n     */\r\n    vertexShaderName: string;\r\n\r\n    /**\r\n     * Gets the vertex buffers used by the particle system\r\n     */\r\n    vertexBuffers: Immutable<{ [key: string]: VertexBuffer }>;\r\n    /**\r\n     * Gets the index buffer used by the particle system (or null if no index buffer is used)\r\n     */\r\n    indexBuffer: Nullable<DataBuffer>;\r\n\r\n    /**\r\n     * Adds a new color gradient\r\n     * @param gradient defines the gradient to use (between 0 and 1)\r\n     * @param color1 defines the color to affect to the specified gradient\r\n     * @param color2 defines an additional color used to define a range ([color, color2]) with main color to pick the final color from\r\n     * @returns the current particle system\r\n     */\r\n    addColorGradient(gradient: number, color1: Color4, color2?: Color4): IParticleSystem;\r\n    /**\r\n     * Remove a specific color gradient\r\n     * @param gradient defines the gradient to remove\r\n     * @returns the current particle system\r\n     */\r\n    removeColorGradient(gradient: number): IParticleSystem;\r\n    /**\r\n     * Adds a new size gradient\r\n     * @param gradient defines the gradient to use (between 0 and 1)\r\n     * @param factor defines the size factor to affect to the specified gradient\r\n     * @param factor2 defines an additional factor used to define a range ([factor, factor2]) with main value to pick the final value from\r\n     * @returns the current particle system\r\n     */\r\n    addSizeGradient(gradient: number, factor: number, factor2?: number): IParticleSystem;\r\n    /**\r\n     * Remove a specific size gradient\r\n     * @param gradient defines the gradient to remove\r\n     * @returns the current particle system\r\n     */\r\n    removeSizeGradient(gradient: number): IParticleSystem;\r\n    /**\r\n     * Gets the current list of color gradients.\r\n     * You must use addColorGradient and removeColorGradient to update this list\r\n     * @returns the list of color gradients\r\n     */\r\n    getColorGradients(): Nullable<Array<ColorGradient>>;\r\n    /**\r\n     * Gets the current list of size gradients.\r\n     * You must use addSizeGradient and removeSizeGradient to update this list\r\n     * @returns the list of size gradients\r\n     */\r\n    getSizeGradients(): Nullable<Array<FactorGradient>>;\r\n    /**\r\n     * Gets the current list of angular speed gradients.\r\n     * You must use addAngularSpeedGradient and removeAngularSpeedGradient to update this list\r\n     * @returns the list of angular speed gradients\r\n     */\r\n    getAngularSpeedGradients(): Nullable<Array<FactorGradient>>;\r\n    /**\r\n     * Adds a new angular speed gradient\r\n     * @param gradient defines the gradient to use (between 0 and 1)\r\n     * @param factor defines the angular speed to affect to the specified gradient\r\n     * @param factor2 defines an additional factor used to define a range ([factor, factor2]) with main value to pick the final value from\r\n     * @returns the current particle system\r\n     */\r\n    addAngularSpeedGradient(gradient: number, factor: number, factor2?: number): IParticleSystem;\r\n    /**\r\n     * Remove a specific angular speed gradient\r\n     * @param gradient defines the gradient to remove\r\n     * @returns the current particle system\r\n     */\r\n    removeAngularSpeedGradient(gradient: number): IParticleSystem;\r\n    /**\r\n     * Gets the current list of velocity gradients.\r\n     * You must use addVelocityGradient and removeVelocityGradient to update this list\r\n     * @returns the list of velocity gradients\r\n     */\r\n    getVelocityGradients(): Nullable<Array<FactorGradient>>;\r\n    /**\r\n     * Adds a new velocity gradient\r\n     * @param gradient defines the gradient to use (between 0 and 1)\r\n     * @param factor defines the velocity to affect to the specified gradient\r\n     * @param factor2 defines an additional factor used to define a range ([factor, factor2]) with main value to pick the final value from\r\n     * @returns the current particle system\r\n     */\r\n    addVelocityGradient(gradient: number, factor: number, factor2?: number): IParticleSystem;\r\n    /**\r\n     * Remove a specific velocity gradient\r\n     * @param gradient defines the gradient to remove\r\n     * @returns the current particle system\r\n     */\r\n    removeVelocityGradient(gradient: number): IParticleSystem;\r\n    /**\r\n     * Gets the current list of limit velocity gradients.\r\n     * You must use addLimitVelocityGradient and removeLimitVelocityGradient to update this list\r\n     * @returns the list of limit velocity gradients\r\n     */\r\n    getLimitVelocityGradients(): Nullable<Array<FactorGradient>>;\r\n    /**\r\n     * Adds a new limit velocity gradient\r\n     * @param gradient defines the gradient to use (between 0 and 1)\r\n     * @param factor defines the limit velocity to affect to the specified gradient\r\n     * @param factor2 defines an additional factor used to define a range ([factor, factor2]) with main value to pick the final value from\r\n     * @returns the current particle system\r\n     */\r\n    addLimitVelocityGradient(gradient: number, factor: number, factor2?: number): IParticleSystem;\r\n    /**\r\n     * Remove a specific limit velocity gradient\r\n     * @param gradient defines the gradient to remove\r\n     * @returns the current particle system\r\n     */\r\n    removeLimitVelocityGradient(gradient: number): IParticleSystem;\r\n    /**\r\n     * Adds a new drag gradient\r\n     * @param gradient defines the gradient to use (between 0 and 1)\r\n     * @param factor defines the drag to affect to the specified gradient\r\n     * @param factor2 defines an additional factor used to define a range ([factor, factor2]) with main value to pick the final value from\r\n     * @returns the current particle system\r\n     */\r\n    addDragGradient(gradient: number, factor: number, factor2?: number): IParticleSystem;\r\n    /**\r\n     * Remove a specific drag gradient\r\n     * @param gradient defines the gradient to remove\r\n     * @returns the current particle system\r\n     */\r\n    removeDragGradient(gradient: number): IParticleSystem;\r\n    /**\r\n     * Gets the current list of drag gradients.\r\n     * You must use addDragGradient and removeDragGradient to update this list\r\n     * @returns the list of drag gradients\r\n     */\r\n    getDragGradients(): Nullable<Array<FactorGradient>>;\r\n    /**\r\n     * Adds a new emit rate gradient (please note that this will only work if you set the targetStopDuration property)\r\n     * @param gradient defines the gradient to use (between 0 and 1)\r\n     * @param factor defines the emit rate to affect to the specified gradient\r\n     * @param factor2 defines an additional factor used to define a range ([factor, factor2]) with main value to pick the final value from\r\n     * @returns the current particle system\r\n     */\r\n    addEmitRateGradient(gradient: number, factor: number, factor2?: number): IParticleSystem;\r\n    /**\r\n     * Remove a specific emit rate gradient\r\n     * @param gradient defines the gradient to remove\r\n     * @returns the current particle system\r\n     */\r\n    removeEmitRateGradient(gradient: number): IParticleSystem;\r\n    /**\r\n     * Gets the current list of emit rate gradients.\r\n     * You must use addEmitRateGradient and removeEmitRateGradient to update this list\r\n     * @returns the list of emit rate gradients\r\n     */\r\n    getEmitRateGradients(): Nullable<Array<FactorGradient>>;\r\n\r\n    /**\r\n     * Adds a new start size gradient (please note that this will only work if you set the targetStopDuration property)\r\n     * @param gradient defines the gradient to use (between 0 and 1)\r\n     * @param factor defines the start size to affect to the specified gradient\r\n     * @param factor2 defines an additional factor used to define a range ([factor, factor2]) with main value to pick the final value from\r\n     * @returns the current particle system\r\n     */\r\n    addStartSizeGradient(gradient: number, factor: number, factor2?: number): IParticleSystem;\r\n    /**\r\n     * Remove a specific start size gradient\r\n     * @param gradient defines the gradient to remove\r\n     * @returns the current particle system\r\n     */\r\n    removeStartSizeGradient(gradient: number): IParticleSystem;\r\n    /**\r\n     * Gets the current list of start size gradients.\r\n     * You must use addStartSizeGradient and removeStartSizeGradient to update this list\r\n     * @returns the list of start size gradients\r\n     */\r\n    getStartSizeGradients(): Nullable<Array<FactorGradient>>;\r\n\r\n    /**\r\n     * Adds a new life time gradient\r\n     * @param gradient defines the gradient to use (between 0 and 1)\r\n     * @param factor defines the life time factor to affect to the specified gradient\r\n     * @param factor2 defines an additional factor used to define a range ([factor, factor2]) with main value to pick the final value from\r\n     * @returns the current particle system\r\n     */\r\n    addLifeTimeGradient(gradient: number, factor: number, factor2?: number): IParticleSystem;\r\n    /**\r\n     * Remove a specific life time gradient\r\n     * @param gradient defines the gradient to remove\r\n     * @returns the current particle system\r\n     */\r\n    removeLifeTimeGradient(gradient: number): IParticleSystem;\r\n    /**\r\n     * Gets the current list of life time gradients.\r\n     * You must use addLifeTimeGradient and removeLifeTimeGradient to update this list\r\n     * @returns the list of life time gradients\r\n     */\r\n    getLifeTimeGradients(): Nullable<Array<FactorGradient>>;\r\n\r\n    /**\r\n     * Gets the current list of color gradients.\r\n     * You must use addColorGradient and removeColorGradient to update this list\r\n     * @returns the list of color gradients\r\n     */\r\n    getColorGradients(): Nullable<Array<ColorGradient>>;\r\n\r\n    /**\r\n     * Adds a new ramp gradient used to remap particle colors\r\n     * @param gradient defines the gradient to use (between 0 and 1)\r\n     * @param color defines the color to affect to the specified gradient\r\n     * @returns the current particle system\r\n     */\r\n    addRampGradient(gradient: number, color: Color3): IParticleSystem;\r\n    /**\r\n     * Gets the current list of ramp gradients.\r\n     * You must use addRampGradient and removeRampGradient to update this list\r\n     * @returns the list of ramp gradients\r\n     */\r\n    getRampGradients(): Nullable<Array<Color3Gradient>>;\r\n\r\n    /** Gets or sets a boolean indicating that ramp gradients must be used\r\n     * @see https://doc.babylonjs.com/features/featuresDeepDive/particles/particle_system/ramps_and_blends\r\n     */\r\n    useRampGradients: boolean;\r\n\r\n    /**\r\n     * Adds a new color remap gradient\r\n     * @param gradient defines the gradient to use (between 0 and 1)\r\n     * @param min defines the color remap minimal range\r\n     * @param max defines the color remap maximal range\r\n     * @returns the current particle system\r\n     */\r\n    addColorRemapGradient(gradient: number, min: number, max: number): IParticleSystem;\r\n    /**\r\n     * Gets the current list of color remap gradients.\r\n     * You must use addColorRemapGradient and removeColorRemapGradient to update this list\r\n     * @returns the list of color remap gradients\r\n     */\r\n    getColorRemapGradients(): Nullable<Array<FactorGradient>>;\r\n\r\n    /**\r\n     * Adds a new alpha remap gradient\r\n     * @param gradient defines the gradient to use (between 0 and 1)\r\n     * @param min defines the alpha remap minimal range\r\n     * @param max defines the alpha remap maximal range\r\n     * @returns the current particle system\r\n     */\r\n    addAlphaRemapGradient(gradient: number, min: number, max: number): IParticleSystem;\r\n    /**\r\n     * Gets the current list of alpha remap gradients.\r\n     * You must use addAlphaRemapGradient and removeAlphaRemapGradient to update this list\r\n     * @returns the list of alpha remap gradients\r\n     */\r\n    getAlphaRemapGradients(): Nullable<Array<FactorGradient>>;\r\n\r\n    /**\r\n     * Creates a Point Emitter for the particle system (emits directly from the emitter position)\r\n     * @param direction1 Particles are emitted between the direction1 and direction2 from within the box\r\n     * @param direction2 Particles are emitted between the direction1 and direction2 from within the box\r\n     * @returns the emitter\r\n     */\r\n    createPointEmitter(direction1: Vector3, direction2: Vector3): PointParticleEmitter;\r\n\r\n    /**\r\n     * Creates a Hemisphere Emitter for the particle system (emits along the hemisphere radius)\r\n     * @param radius The radius of the hemisphere to emit from\r\n     * @param radiusRange The range of the hemisphere to emit from [0-1] 0 Surface Only, 1 Entire Radius\r\n     * @returns the emitter\r\n     */\r\n    createHemisphericEmitter(radius: number, radiusRange: number): HemisphericParticleEmitter;\r\n\r\n    /**\r\n     * Creates a Sphere Emitter for the particle system (emits along the sphere radius)\r\n     * @param radius The radius of the sphere to emit from\r\n     * @param radiusRange The range of the sphere to emit from [0-1] 0 Surface Only, 1 Entire Radius\r\n     * @returns the emitter\r\n     */\r\n    createSphereEmitter(radius: number, radiusRange: number): SphereParticleEmitter;\r\n\r\n    /**\r\n     * Creates a Directed Sphere Emitter for the particle system (emits between direction1 and direction2)\r\n     * @param radius The radius of the sphere to emit from\r\n     * @param direction1 Particles are emitted between the direction1 and direction2 from within the sphere\r\n     * @param direction2 Particles are emitted between the direction1 and direction2 from within the sphere\r\n     * @returns the emitter\r\n     */\r\n    createDirectedSphereEmitter(radius: number, direction1: Vector3, direction2: Vector3): SphereDirectedParticleEmitter;\r\n\r\n    /**\r\n     * Creates a Cylinder Emitter for the particle system (emits from the cylinder to the particle position)\r\n     * @param radius The radius of the emission cylinder\r\n     * @param height The height of the emission cylinder\r\n     * @param radiusRange The range of emission [0-1] 0 Surface only, 1 Entire Radius\r\n     * @param directionRandomizer How much to randomize the particle direction [0-1]\r\n     * @returns the emitter\r\n     */\r\n    createCylinderEmitter(radius: number, height: number, radiusRange: number, directionRandomizer: number): CylinderParticleEmitter;\r\n\r\n    /**\r\n     * Creates a Directed Cylinder Emitter for the particle system (emits between direction1 and direction2)\r\n     * @param radius The radius of the cylinder to emit from\r\n     * @param height The height of the emission cylinder\r\n     * @param radiusRange the range of the emission cylinder [0-1] 0 Surface only, 1 Entire Radius (1 by default)\r\n     * @param direction1 Particles are emitted between the direction1 and direction2 from within the cylinder\r\n     * @param direction2 Particles are emitted between the direction1 and direction2 from within the cylinder\r\n     * @returns the emitter\r\n     */\r\n    createDirectedCylinderEmitter(radius: number, height: number, radiusRange: number, direction1: Vector3, direction2: Vector3): CylinderDirectedParticleEmitter;\r\n\r\n    /**\r\n     * Creates a Cone Emitter for the particle system (emits from the cone to the particle position)\r\n     * @param radius The radius of the cone to emit from\r\n     * @param angle The base angle of the cone\r\n     * @returns the emitter\r\n     */\r\n    createConeEmitter(radius: number, angle: number): ConeParticleEmitter;\r\n\r\n    createDirectedConeEmitter(radius: number, angle: number, direction1: Vector3, direction2: Vector3): ConeDirectedParticleEmitter;\r\n\r\n    /**\r\n     * Creates a Box Emitter for the particle system. (emits between direction1 and direction2 from withing the box defined by minEmitBox and maxEmitBox)\r\n     * @param direction1 Particles are emitted between the direction1 and direction2 from within the box\r\n     * @param direction2 Particles are emitted between the direction1 and direction2 from within the box\r\n     * @param minEmitBox Particles are emitted from the box between minEmitBox and maxEmitBox\r\n     * @param maxEmitBox  Particles are emitted from the box between minEmitBox and maxEmitBox\r\n     * @returns the emitter\r\n     */\r\n    createBoxEmitter(direction1: Vector3, direction2: Vector3, minEmitBox: Vector3, maxEmitBox: Vector3): BoxParticleEmitter;\r\n\r\n    /**\r\n     * Get hosting scene\r\n     * @returns the scene\r\n     */\r\n    getScene(): Nullable<Scene>;\r\n}\r\n"]}

package/Particles/Node/Blocks/Emitters/index.d.ts

@@ -3,5 +3,6 @@ export * from "./sphereShapeBlock.js";
 export * from "./pointShapeBlock.js";
 export * from "./customShapeBlock.js";
 export * from "./cylinderShapeBlock.js";
+export * from "./meshShapeBlock.js";
 export * from "./setupSpriteSheetBlock.js";
 export * from "./createParticleBlock.js";

package/Particles/Node/Blocks/Emitters/index.js

@@ -3,6 +3,7 @@ export * from "./sphereShapeBlock.js";
 export * from "./pointShapeBlock.js";
 export * from "./customShapeBlock.js";
 export * from "./cylinderShapeBlock.js";
+export * from "./meshShapeBlock.js";
 export * from "./setupSpriteSheetBlock.js";
 export * from "./createParticleBlock.js";
 //# sourceMappingURL=index.js.map

package/Particles/Node/Blocks/Emitters/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../dev/core/src/Particles/Node/Blocks/Emitters/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC","sourcesContent":["export * from \"./boxShapeBlock\";\r\nexport * from \"./sphereShapeBlock\";\r\nexport * from \"./pointShapeBlock\";\r\nexport * from \"./customShapeBlock\";\r\nexport * from \"./cylinderShapeBlock\";\r\nexport * from \"./setupSpriteSheetBlock\";\r\nexport * from \"./createParticleBlock\";\r\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../dev/core/src/Particles/Node/Blocks/Emitters/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC","sourcesContent":["export * from \"./boxShapeBlock\";\r\nexport * from \"./sphereShapeBlock\";\r\nexport * from \"./pointShapeBlock\";\r\nexport * from \"./customShapeBlock\";\r\nexport * from \"./cylinderShapeBlock\";\r\nexport * from \"./meshShapeBlock\";\r\nexport * from \"./setupSpriteSheetBlock\";\r\nexport * from \"./createParticleBlock\";\r\n"]}

package/Particles/Node/Blocks/Emitters/meshShapeBlock.d.ts

@@ -0,0 +1,79 @@
+import type { Mesh } from "../../../../Meshes/mesh.js";
+import type { Nullable } from "../../../../types.js";
+import { NodeParticleBlock } from "../../nodeParticleBlock.js";
+import type { NodeParticleBuildState } from "../../nodeParticleBuildState.js";
+import type { NodeParticleConnectionPoint } from "../../nodeParticleBlockConnectionPoint.js";
+/**
+ * Defines a block used to generate particle shape from mesh geometry data
+ */
+export declare class MeshShapeBlock extends NodeParticleBlock {
+    private _mesh;
+    private _cachedVertexData;
+    private _indices;
+    private _positions;
+    private _normals;
+    private _colors;
+    private _storedNormal;
+    /**
+     * Gets or sets a boolean indicating that this block should serialize its cached data
+     */
+    serializedCachedData: boolean;
+    /**
+     * Gets or sets a boolean indicating if the mesh normals should be used for particle direction
+     */
+    useMeshNormalsForDirection: boolean;
+    /**
+     * Gets or sets a boolean indicating if the mesh colors should be used for particle color
+     */
+    useMeshColorForColor: boolean;
+    /**
+     * Gets or sets the mesh to use to get vertex data
+     */
+    get mesh(): Nullable<Mesh>;
+    set mesh(value: Nullable<Mesh>);
+    /**
+     * Create a new MeshShapeBlock
+     * @param name defines the block name
+     */
+    constructor(name: string);
+    /**
+     * Gets the current class name
+     * @returns the class name
+     */
+    getClassName(): string;
+    /**
+     * Gets a boolean indicating if the block is using cached data
+     */
+    get isUsingCachedData(): boolean;
+    /**
+     * Gets the particle component
+     */
+    get particle(): NodeParticleConnectionPoint;
+    /**
+     * Gets the direction1 input component
+     */
+    get direction1(): NodeParticleConnectionPoint;
+    /**
+     * Gets the direction2 input component
+     */
+    get direction2(): NodeParticleConnectionPoint;
+    /**
+     * Gets the output component
+     */
+    get output(): NodeParticleConnectionPoint;
+    /**
+     * Remove stored data
+     */
+    cleanData(): void;
+    /**
+     * Builds the block
+     * @param state defines the build state
+     */
+    _build(state: NodeParticleBuildState): void;
+    /**
+     * Serializes this block in a JSON representation
+     * @returns the serialized block object
+     */
+    serialize(): any;
+    _deserialize(serializationObject: any): void;
+}

package/Particles/Node/Blocks/Emitters/meshShapeBlock.js

@@ -0,0 +1,223 @@
+import { __decorate } from "../../../../tslib.es6.js";
+import { RegisterClass } from "../../../../Misc/typeStore.js";
+import { VertexData } from "../../../../Meshes/mesh.vertexData.js";
+import { editableInPropertyPage } from "../../../../Decorators/nodeDecorator.js";
+import { NodeParticleBlock } from "../../nodeParticleBlock.js";
+import { NodeParticleBlockConnectionPointTypes } from "../../Enums/nodeParticleBlockConnectionPointTypes.js";
+import { TmpVectors, Vector3, Vector4 } from "../../../../Maths/math.vector.js";
+import { RandomRange } from "../../../../Maths/math.scalar.functions.js";
+/**
+ * Defines a block used to generate particle shape from mesh geometry data
+ */
+export class MeshShapeBlock extends NodeParticleBlock {
+    /**
+     * Gets or sets the mesh to use to get vertex data
+     */
+    get mesh() {
+        return this._mesh;
+    }
+    set mesh(value) {
+        this._mesh = value;
+    }
+    /**
+     * Create a new MeshShapeBlock
+     * @param name defines the block name
+     */
+    constructor(name) {
+        super(name);
+        this._cachedVertexData = null;
+        this._indices = null;
+        this._positions = null;
+        this._normals = null;
+        this._colors = null;
+        this._storedNormal = Vector3.Zero();
+        /**
+         * Gets or sets a boolean indicating that this block should serialize its cached data
+         */
+        this.serializedCachedData = false;
+        /**
+         * Gets or sets a boolean indicating if the mesh normals should be used for particle direction
+         */
+        this.useMeshNormalsForDirection = false;
+        /**
+         * Gets or sets a boolean indicating if the mesh colors should be used for particle color
+         */
+        this.useMeshColorForColor = false;
+        this.registerInput("particle", NodeParticleBlockConnectionPointTypes.Particle);
+        this.registerInput("direction1", NodeParticleBlockConnectionPointTypes.Vector3, true, new Vector3(0, 1.0, 0));
+        this.registerInput("direction2", NodeParticleBlockConnectionPointTypes.Vector3, true, new Vector3(0, 1.0, 0));
+        this.registerOutput("output", NodeParticleBlockConnectionPointTypes.Particle);
+    }
+    /**
+     * Gets the current class name
+     * @returns the class name
+     */
+    getClassName() {
+        return "MeshShapeBlock";
+    }
+    /**
+     * Gets a boolean indicating if the block is using cached data
+     */
+    get isUsingCachedData() {
+        return !this.mesh && !!this._cachedVertexData;
+    }
+    /**
+     * Gets the particle component
+     */
+    get particle() {
+        return this._inputs[0];
+    }
+    /**
+     * Gets the direction1 input component
+     */
+    get direction1() {
+        return this._inputs[1];
+    }
+    /**
+     * Gets the direction2 input component
+     */
+    get direction2() {
+        return this._inputs[2];
+    }
+    /**
+     * Gets the output component
+     */
+    get output() {
+        return this._outputs[0];
+    }
+    /**
+     * Remove stored data
+     */
+    cleanData() {
+        this._mesh = null;
+        this._cachedVertexData = null;
+    }
+    /**
+     * Builds the block
+     * @param state defines the build state
+     */
+    _build(state) {
+        const system = this.particle.getConnectedValue(state);
+        if (!this._mesh && !this._cachedVertexData) {
+            this.output._storedValue = system;
+            return;
+        }
+        if (this._mesh) {
+            this._cachedVertexData = VertexData.ExtractFromMesh(this._mesh, false, true);
+        }
+        if (!this._cachedVertexData) {
+            this.output._storedValue = system;
+            return;
+        }
+        this._indices = this._cachedVertexData.indices;
+        this._positions = this._cachedVertexData.positions;
+        this._normals = this._cachedVertexData.normals;
+        this._colors = this._cachedVertexData.colors;
+        system._directionCreation.process = (particle) => {
+            state.particleContext = particle;
+            state.systemContext = system;
+            if (this.useMeshNormalsForDirection && this._normals) {
+                if (state.isEmitterTransformNode) {
+                    Vector3.TransformNormalToRef(this._storedNormal, state.emitterWorldMatrix, particle.direction);
+                }
+                else {
+                    particle.direction.copyFrom(this._storedNormal);
+                }
+                return;
+            }
+            const direction1 = this.direction1.getConnectedValue(state);
+            const direction2 = this.direction2.getConnectedValue(state);
+            const randX = RandomRange(direction1.x, direction2.x);
+            const randY = RandomRange(direction1.y, direction2.y);
+            const randZ = RandomRange(direction1.z, direction2.z);
+            if (state.isEmitterTransformNode) {
+                Vector3.TransformNormalFromFloatsToRef(randX, randY, randZ, state.emitterWorldMatrix, particle.direction);
+            }
+            else {
+                particle.direction.copyFromFloats(randX, randY, randZ);
+            }
+        };
+        system._positionCreation.process = (particle) => {
+            if (!this._indices || !this._positions) {
+                return;
+            }
+            const randomFaceIndex = 3 * ((Math.random() * (this._indices.length / 3)) | 0);
+            const bu = Math.random();
+            const bv = Math.random() * (1.0 - bu);
+            const bw = 1.0 - bu - bv;
+            const faceIndexA = this._indices[randomFaceIndex];
+            const faceIndexB = this._indices[randomFaceIndex + 1];
+            const faceIndexC = this._indices[randomFaceIndex + 2];
+            const vertexA = TmpVectors.Vector3[0];
+            const vertexB = TmpVectors.Vector3[1];
+            const vertexC = TmpVectors.Vector3[2];
+            const randomVertex = TmpVectors.Vector3[3];
+            Vector3.FromArrayToRef(this._positions, faceIndexA * 3, vertexA);
+            Vector3.FromArrayToRef(this._positions, faceIndexB * 3, vertexB);
+            Vector3.FromArrayToRef(this._positions, faceIndexC * 3, vertexC);
+            randomVertex.x = bu * vertexA.x + bv * vertexB.x + bw * vertexC.x;
+            randomVertex.y = bu * vertexA.y + bv * vertexB.y + bw * vertexC.y;
+            randomVertex.z = bu * vertexA.z + bv * vertexB.z + bw * vertexC.z;
+            if (state.isEmitterTransformNode) {
+                Vector3.TransformCoordinatesFromFloatsToRef(randomVertex.x, randomVertex.y, randomVertex.z, state.emitterWorldMatrix, particle.position);
+            }
+            else {
+                particle.position.copyFromFloats(randomVertex.x, randomVertex.y, randomVertex.z);
+            }
+            if (this.useMeshNormalsForDirection && this._normals) {
+                Vector3.FromArrayToRef(this._normals, faceIndexA * 3, vertexA);
+                Vector3.FromArrayToRef(this._normals, faceIndexB * 3, vertexB);
+                Vector3.FromArrayToRef(this._normals, faceIndexC * 3, vertexC);
+                this._storedNormal.x = bu * vertexA.x + bv * vertexB.x + bw * vertexC.x;
+                this._storedNormal.y = bu * vertexA.y + bv * vertexB.y + bw * vertexC.y;
+                this._storedNormal.z = bu * vertexA.z + bv * vertexB.z + bw * vertexC.z;
+            }
+            if (this.useMeshColorForColor && this._colors) {
+                Vector4.FromArrayToRef(this._colors, faceIndexA * 4, TmpVectors.Vector4[0]);
+                Vector4.FromArrayToRef(this._colors, faceIndexB * 4, TmpVectors.Vector4[1]);
+                Vector4.FromArrayToRef(this._colors, faceIndexC * 4, TmpVectors.Vector4[2]);
+                particle.color.copyFromFloats(bu * TmpVectors.Vector4[0].x + bv * TmpVectors.Vector4[1].x + bw * TmpVectors.Vector4[2].x, bu * TmpVectors.Vector4[0].y + bv * TmpVectors.Vector4[1].y + bw * TmpVectors.Vector4[2].y, bu * TmpVectors.Vector4[0].z + bv * TmpVectors.Vector4[1].z + bw * TmpVectors.Vector4[2].z, bu * TmpVectors.Vector4[0].w + bv * TmpVectors.Vector4[1].w + bw * TmpVectors.Vector4[2].w);
+            }
+        };
+        this.output._storedValue = system;
+    }
+    /**
+     * Serializes this block in a JSON representation
+     * @returns the serialized block object
+     */
+    serialize() {
+        const serializationObject = super.serialize();
+        serializationObject.serializedCachedData = this.serializedCachedData;
+        if (this.serializedCachedData) {
+            if (this._mesh) {
+                serializationObject.cachedVertexData = VertexData.ExtractFromMesh(this._mesh, false, true).serialize();
+            }
+            else if (this._cachedVertexData) {
+                serializationObject.cachedVertexData = this._cachedVertexData.serialize();
+            }
+        }
+        serializationObject.useMeshNormalsForDirection = this.useMeshNormalsForDirection;
+        serializationObject.useMeshColorForColor = this.useMeshColorForColor;
+        return serializationObject;
+    }
+    _deserialize(serializationObject) {
+        super._deserialize(serializationObject);
+        if (serializationObject.cachedVertexData) {
+            this._cachedVertexData = VertexData.Parse(serializationObject.cachedVertexData);
+        }
+        this.serializedCachedData = !!serializationObject.serializedCachedData;
+        this.useMeshNormalsForDirection = !!serializationObject.useMeshNormalsForDirection;
+        this.useMeshColorForColor = !!serializationObject.useMeshColorForColor;
+    }
+}
+__decorate([
+    editableInPropertyPage("Serialize cached data", 0 /* PropertyTypeForEdition.Boolean */, "ADVANCED", { embedded: true, notifiers: { rebuild: true } })
+], MeshShapeBlock.prototype, "serializedCachedData", void 0);
+__decorate([
+    editableInPropertyPage("Use normals for direction", 0 /* PropertyTypeForEdition.Boolean */, "ADVANCED", { embedded: true, notifiers: { rebuild: true } })
+], MeshShapeBlock.prototype, "useMeshNormalsForDirection", void 0);
+__decorate([
+    editableInPropertyPage("Use vertex color for color", 0 /* PropertyTypeForEdition.Boolean */, "ADVANCED", { embedded: true, notifiers: { rebuild: true } })
+], MeshShapeBlock.prototype, "useMeshColorForColor", void 0);
+RegisterClass("BABYLON.MeshShapeBlock", MeshShapeBlock);
+//# sourceMappingURL=meshShapeBlock.js.map

package/Particles/Node/Blocks/Emitters/meshShapeBlock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meshShapeBlock.js","sourceRoot":"","sources":["../../../../../../../dev/core/src/Particles/Node/Blocks/Emitters/meshShapeBlock.ts"],"names":[],"mappings":"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","sourcesContent":["import { RegisterClass } from \"../../../../Misc/typeStore\";\r\nimport type { Mesh } from \"../../../../Meshes/mesh\";\r\nimport { VertexData } from \"../../../../Meshes/mesh.vertexData\";\r\nimport type { FloatArray, IndicesArray, Nullable } from \"../../../../types\";\r\nimport { PropertyTypeForEdition, editableInPropertyPage } from \"core/Decorators/nodeDecorator\";\r\nimport { NodeParticleBlock } from \"../../nodeParticleBlock\";\r\nimport { NodeParticleBlockConnectionPointTypes } from \"../../Enums/nodeParticleBlockConnectionPointTypes\";\r\nimport type { NodeParticleBuildState } from \"../../nodeParticleBuildState\";\r\nimport type { NodeParticleConnectionPoint } from \"../../nodeParticleBlockConnectionPoint\";\r\nimport type { Particle } from \"core/Particles/particle\";\r\nimport { TmpVectors, Vector3, Vector4 } from \"core/Maths/math.vector\";\r\nimport { RandomRange } from \"core/Maths/math.scalar.functions\";\r\n\r\n/**\r\n * Defines a block used to generate particle shape from mesh geometry data\r\n */\r\nexport class MeshShapeBlock extends NodeParticleBlock {\r\n    private _mesh: Nullable<Mesh>;\r\n    private _cachedVertexData: Nullable<VertexData> = null;\r\n    private _indices: Nullable<IndicesArray> = null;\r\n    private _positions: Nullable<FloatArray> = null;\r\n    private _normals: Nullable<FloatArray> = null;\r\n    private _colors: Nullable<FloatArray> = null;\r\n    private _storedNormal = Vector3.Zero();\r\n\r\n    /**\r\n     * Gets or sets a boolean indicating that this block should serialize its cached data\r\n     */\r\n    @editableInPropertyPage(\"Serialize cached data\", PropertyTypeForEdition.Boolean, \"ADVANCED\", { embedded: true, notifiers: { rebuild: true } })\r\n    public serializedCachedData = false;\r\n\r\n    /**\r\n     * Gets or sets a boolean indicating if the mesh normals should be used for particle direction\r\n     */\r\n    @editableInPropertyPage(\"Use normals for direction\", PropertyTypeForEdition.Boolean, \"ADVANCED\", { embedded: true, notifiers: { rebuild: true } })\r\n    public useMeshNormalsForDirection = false;\r\n\r\n    /**\r\n     * Gets or sets a boolean indicating if the mesh colors should be used for particle color\r\n     */\r\n    @editableInPropertyPage(\"Use vertex color for color\", PropertyTypeForEdition.Boolean, \"ADVANCED\", { embedded: true, notifiers: { rebuild: true } })\r\n    public useMeshColorForColor = false;\r\n\r\n    /**\r\n     * Gets or sets the mesh to use to get vertex data\r\n     */\r\n    public get mesh() {\r\n        return this._mesh;\r\n    }\r\n\r\n    public set mesh(value: Nullable<Mesh>) {\r\n        this._mesh = value;\r\n    }\r\n\r\n    /**\r\n     * Create a new MeshShapeBlock\r\n     * @param name defines the block name\r\n     */\r\n    public constructor(name: string) {\r\n        super(name);\r\n\r\n        this.registerInput(\"particle\", NodeParticleBlockConnectionPointTypes.Particle);\r\n        this.registerInput(\"direction1\", NodeParticleBlockConnectionPointTypes.Vector3, true, new Vector3(0, 1.0, 0));\r\n        this.registerInput(\"direction2\", NodeParticleBlockConnectionPointTypes.Vector3, true, new Vector3(0, 1.0, 0));\r\n        this.registerOutput(\"output\", NodeParticleBlockConnectionPointTypes.Particle);\r\n    }\r\n\r\n    /**\r\n     * Gets the current class name\r\n     * @returns the class name\r\n     */\r\n    public override getClassName() {\r\n        return \"MeshShapeBlock\";\r\n    }\r\n\r\n    /**\r\n     * Gets a boolean indicating if the block is using cached data\r\n     */\r\n    public get isUsingCachedData() {\r\n        return !this.mesh && !!this._cachedVertexData;\r\n    }\r\n\r\n    /**\r\n     * Gets the particle component\r\n     */\r\n    public get particle(): NodeParticleConnectionPoint {\r\n        return this._inputs[0];\r\n    }\r\n\r\n    /**\r\n     * Gets the direction1 input component\r\n     */\r\n    public get direction1(): NodeParticleConnectionPoint {\r\n        return this._inputs[1];\r\n    }\r\n\r\n    /**\r\n     * Gets the direction2 input component\r\n     */\r\n    public get direction2(): NodeParticleConnectionPoint {\r\n        return this._inputs[2];\r\n    }\r\n\r\n    /**\r\n     * Gets the output component\r\n     */\r\n    public get output(): NodeParticleConnectionPoint {\r\n        return this._outputs[0];\r\n    }\r\n\r\n    /**\r\n     * Remove stored data\r\n     */\r\n    public cleanData() {\r\n        this._mesh = null;\r\n        this._cachedVertexData = null;\r\n    }\r\n\r\n    /**\r\n     * Builds the block\r\n     * @param state defines the build state\r\n     */\r\n    public override _build(state: NodeParticleBuildState) {\r\n        const system = this.particle.getConnectedValue(state);\r\n\r\n        if (!this._mesh && !this._cachedVertexData) {\r\n            this.output._storedValue = system;\r\n            return;\r\n        }\r\n\r\n        if (this._mesh) {\r\n            this._cachedVertexData = VertexData.ExtractFromMesh(this._mesh, false, true);\r\n        }\r\n\r\n        if (!this._cachedVertexData) {\r\n            this.output._storedValue = system;\r\n            return;\r\n        }\r\n\r\n        this._indices = this._cachedVertexData.indices;\r\n        this._positions = this._cachedVertexData.positions;\r\n        this._normals = this._cachedVertexData.normals;\r\n        this._colors = this._cachedVertexData.colors;\r\n\r\n        system._directionCreation.process = (particle: Particle) => {\r\n            state.particleContext = particle;\r\n            state.systemContext = system;\r\n\r\n            if (this.useMeshNormalsForDirection && this._normals) {\r\n                if (state.isEmitterTransformNode) {\r\n                    Vector3.TransformNormalToRef(this._storedNormal, state.emitterWorldMatrix!, particle.direction);\r\n                } else {\r\n                    particle.direction.copyFrom(this._storedNormal);\r\n                }\r\n                return;\r\n            }\r\n\r\n            const direction1 = this.direction1.getConnectedValue(state) as Vector3;\r\n            const direction2 = this.direction2.getConnectedValue(state) as Vector3;\r\n\r\n            const randX = RandomRange(direction1.x, direction2.x);\r\n            const randY = RandomRange(direction1.y, direction2.y);\r\n            const randZ = RandomRange(direction1.z, direction2.z);\r\n\r\n            if (state.isEmitterTransformNode) {\r\n                Vector3.TransformNormalFromFloatsToRef(randX, randY, randZ, state.emitterWorldMatrix!, particle.direction);\r\n            } else {\r\n                particle.direction.copyFromFloats(randX, randY, randZ);\r\n            }\r\n        };\r\n\r\n        system._positionCreation.process = (particle: Particle) => {\r\n            if (!this._indices || !this._positions) {\r\n                return;\r\n            }\r\n\r\n            const randomFaceIndex = 3 * ((Math.random() * (this._indices.length / 3)) | 0);\r\n            const bu = Math.random();\r\n            const bv = Math.random() * (1.0 - bu);\r\n            const bw = 1.0 - bu - bv;\r\n\r\n            const faceIndexA = this._indices[randomFaceIndex];\r\n            const faceIndexB = this._indices[randomFaceIndex + 1];\r\n            const faceIndexC = this._indices[randomFaceIndex + 2];\r\n            const vertexA = TmpVectors.Vector3[0];\r\n            const vertexB = TmpVectors.Vector3[1];\r\n            const vertexC = TmpVectors.Vector3[2];\r\n            const randomVertex = TmpVectors.Vector3[3];\r\n\r\n            Vector3.FromArrayToRef(this._positions, faceIndexA * 3, vertexA);\r\n            Vector3.FromArrayToRef(this._positions, faceIndexB * 3, vertexB);\r\n            Vector3.FromArrayToRef(this._positions, faceIndexC * 3, vertexC);\r\n\r\n            randomVertex.x = bu * vertexA.x + bv * vertexB.x + bw * vertexC.x;\r\n            randomVertex.y = bu * vertexA.y + bv * vertexB.y + bw * vertexC.y;\r\n            randomVertex.z = bu * vertexA.z + bv * vertexB.z + bw * vertexC.z;\r\n\r\n            if (state.isEmitterTransformNode) {\r\n                Vector3.TransformCoordinatesFromFloatsToRef(randomVertex.x, randomVertex.y, randomVertex.z, state.emitterWorldMatrix!, particle.position);\r\n            } else {\r\n                particle.position.copyFromFloats(randomVertex.x, randomVertex.y, randomVertex.z);\r\n            }\r\n\r\n            if (this.useMeshNormalsForDirection && this._normals) {\r\n                Vector3.FromArrayToRef(this._normals, faceIndexA * 3, vertexA);\r\n                Vector3.FromArrayToRef(this._normals, faceIndexB * 3, vertexB);\r\n                Vector3.FromArrayToRef(this._normals, faceIndexC * 3, vertexC);\r\n\r\n                this._storedNormal.x = bu * vertexA.x + bv * vertexB.x + bw * vertexC.x;\r\n                this._storedNormal.y = bu * vertexA.y + bv * vertexB.y + bw * vertexC.y;\r\n                this._storedNormal.z = bu * vertexA.z + bv * vertexB.z + bw * vertexC.z;\r\n            }\r\n\r\n            if (this.useMeshColorForColor && this._colors) {\r\n                Vector4.FromArrayToRef(this._colors, faceIndexA * 4, TmpVectors.Vector4[0]);\r\n                Vector4.FromArrayToRef(this._colors, faceIndexB * 4, TmpVectors.Vector4[1]);\r\n                Vector4.FromArrayToRef(this._colors, faceIndexC * 4, TmpVectors.Vector4[2]);\r\n\r\n                particle.color.copyFromFloats(\r\n                    bu * TmpVectors.Vector4[0].x + bv * TmpVectors.Vector4[1].x + bw * TmpVectors.Vector4[2].x,\r\n                    bu * TmpVectors.Vector4[0].y + bv * TmpVectors.Vector4[1].y + bw * TmpVectors.Vector4[2].y,\r\n                    bu * TmpVectors.Vector4[0].z + bv * TmpVectors.Vector4[1].z + bw * TmpVectors.Vector4[2].z,\r\n                    bu * TmpVectors.Vector4[0].w + bv * TmpVectors.Vector4[1].w + bw * TmpVectors.Vector4[2].w\r\n                );\r\n            }\r\n        };\r\n\r\n        this.output._storedValue = system;\r\n    }\r\n\r\n    /**\r\n     * Serializes this block in a JSON representation\r\n     * @returns the serialized block object\r\n     */\r\n    public override serialize(): any {\r\n        const serializationObject = super.serialize();\r\n        serializationObject.serializedCachedData = this.serializedCachedData;\r\n\r\n        if (this.serializedCachedData) {\r\n            if (this._mesh) {\r\n                serializationObject.cachedVertexData = VertexData.ExtractFromMesh(this._mesh, false, true).serialize();\r\n            } else if (this._cachedVertexData) {\r\n                serializationObject.cachedVertexData = this._cachedVertexData.serialize();\r\n            }\r\n        }\r\n\r\n        serializationObject.useMeshNormalsForDirection = this.useMeshNormalsForDirection;\r\n        serializationObject.useMeshColorForColor = this.useMeshColorForColor;\r\n\r\n        return serializationObject;\r\n    }\r\n\r\n    public override _deserialize(serializationObject: any) {\r\n        super._deserialize(serializationObject);\r\n\r\n        if (serializationObject.cachedVertexData) {\r\n            this._cachedVertexData = VertexData.Parse(serializationObject.cachedVertexData);\r\n        }\r\n\r\n        this.serializedCachedData = !!serializationObject.serializedCachedData;\r\n        this.useMeshNormalsForDirection = !!serializationObject.useMeshNormalsForDirection;\r\n        this.useMeshColorForColor = !!serializationObject.useMeshColorForColor;\r\n    }\r\n}\r\n\r\nRegisterClass(\"BABYLON.MeshShapeBlock\", MeshShapeBlock);\r\n"]}

package/Physics/v2/ragdoll.d.ts

@@ -73,6 +73,7 @@ export declare class Ragdoll {
     private _rootBoneIndex;
     private _mass;
     private _restitution;
+    private _beforeRenderObserver;
     /**
      * Pause synchronization between physics and bone position/orientation
      */

package/Physics/v2/ragdoll.js

@@ -36,6 +36,7 @@ export class Ragdoll {
         this._rootBoneIndex = -1;
         this._mass = 10;
         this._restitution = 0;
+        this._beforeRenderObserver = null;
         /**
          * Pause synchronization between physics and bone position/orientation
          */
@@ -255,7 +256,7 @@ export class Ragdoll {
             return;
         }
         this._initJoints();
-        this._scene.registerBeforeRender(() => {
+        this._beforeRenderObserver = this._scene.onBeforeRenderObservable.add(() => {
             this._syncBonesAndBoxes();
         });
         this._syncBonesToPhysics();
@@ -283,6 +284,19 @@ export class Ragdoll {
         for (const aggregate of this._aggregates) {
             aggregate.dispose();
         }
+        this._aggregates.length = 0;
+        for (const transform of this._transforms) {
+            transform.dispose();
+        }
+        this._transforms.length = 0;
+        for (const constraint of this._constraints) {
+            constraint.dispose();
+        }
+        this._constraints.length = 0;
+        if (this._beforeRenderObserver) {
+            this._scene.onBeforeRenderObservable.remove(this._beforeRenderObserver);
+            this._beforeRenderObserver = null;
+        }
     }
 }
 //# sourceMappingURL=ragdoll.js.map