Class Collision

Behaviour that causes particles to move away from other particles they collide with.

Hierarchy (View Summary)

Behaviour
- Collision

Index

Constructors

Properties

_life age dead delta easing emitter energy id isEnabled onCollide particles type useMass

Accessors

Methods

_getAverageMass applyBehaviour destroy energize fromJSON initialize mutate normalizeForce normalizeValue reset

Constructors

constructor

new Collision(
    emitter: Emitter,
    useMass: boolean,
    onCollide: OnCollide,
    life?: number,
    easing?: EasingFunction,
    isEnabled?: boolean,
): Collision
Constructs a Collision behaviour instance.
Parameters
- emitter: Emitter
  The emitter containing the particles to detect collisions against
- useMass: boolean
  Determiens whether to use mass or not
- onCollide: OnCollide
  Function to call when particles collide
- Optionallife: number
  The life of the particle
- Optionaleasing: EasingFunction
  The behaviour's decaying trend
- isEnabled: boolean = true
  Determines if the behaviour will be applied or not
Returns Collision
Overrides Behaviour.constructor
- Defined in src/behaviour/Collision.ts:30

Properties

_life

_life: number

age

age: number

dead

dead: boolean

delta

delta: Vector3D

easing

easing: EasingFunction

emitter

emitter: Emitter

energy

energy: number

id

id: string

isEnabled

isEnabled: boolean

onCollide

onCollide: OnCollide

particles

particles: Particle[]

type

type: string

useMass

useMass: boolean

Accessors

life

get life(): number
Gets the behaviour's life.

Returns number
Inherited from Behaviour.life
- Defined in src/behaviour/Behaviour.ts:65
set life(life: number): void
Ensures that life is infinity if an invalid value is supplied.
Parameters
- life: number
Returns void
Inherited from Behaviour.life
- Defined in src/behaviour/Behaviour.ts:58

Methods

_getAverageMass

_getAverageMass(particleA: Particle, particleB: Particle): number
Gets the average mass of both particles.
Parameters
- particleA: Particle
  The first particle
- particleB: Particle
  The second particle
Returns number
- Defined in src/behaviour/Collision.ts:126

applyBehaviour

applyBehaviour(target: Particle | Emitter, time: number, index?: number): void
Apply behaviour to the target as a factor of time.
Parameters
- target: Particle | Emitter
- time: number
- Optionalindex: number
Returns void
Inherited from Behaviour.applyBehaviour
- Defined in src/behaviour/Behaviour.ts:93

`Abstract`destroy

destroy(): void
Destroy this behaviour.

Returns void
Inherited from Behaviour.destroy
- Defined in src/behaviour/Behaviour.ts:140

energize

energize(particle: Particle, time: number, index?: number): void
Compares the age of the behaviour vs integration time and determines if the behaviour should be set to dead or not.
Parameters
- particle: Particle
- time: number
- Optionalindex: number
Returns void
Inherited from Behaviour.energize
- Defined in src/behaviour/Behaviour.ts:116

`Abstract`fromJSON

fromJSON(json: Record<string, unknown>): void
Returns a new instance of the behaviour from the JSON object passed.
Parameters
- json: Record<string, unknown>
Returns void
Overrides Behaviour.fromJSON
- Defined in src/behaviour/Collision.ts:133

`Abstract`initialize

initialize(particle: Particle): void
Set the behaviour's initial properties on the particle.
Parameters
- particle: Particle
Returns void
Inherited from Behaviour.initialize
- Defined in src/behaviour/Behaviour.ts:88

mutate

mutate(particle: Particle, time: number, index?: number): void
Detects collisions with other particles and calls the onCollide function on colliding particles.
Parameters
- particle: Particle
  the particle to apply the behaviour to
- time: number
  particle engine time
- Optionalindex: number
  the particle index
Returns void
Overrides Behaviour.mutate
- Defined in src/behaviour/Collision.ts:76

normalizeForce

normalizeForce(force: Vector3D): Vector3D
Normalize a force by 1:100.
Parameters
- force: Vector3D
Returns Vector3D
Inherited from Behaviour.normalizeForce
- Defined in src/behaviour/Behaviour.ts:72

normalizeValue

normalizeValue(value: number): number
Normalize a value by 1:100.
Parameters
- value: number
Returns number
Inherited from Behaviour.normalizeValue
- Defined in src/behaviour/Behaviour.ts:79

reset

reset(
    emitter: Emitter,
    useMass: boolean,
    onCollide: OnCollide,
    life?: number,
    easing?: EasingFunction,
): void
Resets the behaviour properties.
Parameters
- emitter: Emitter
  The emitter containing the particles to detect collisions against
- useMass: boolean
  Determiens whether to use mass or not
- onCollide: OnCollide
  Function to call when particles collide
- Optionallife: number
  The life of the particle
- Optionaleasing: EasingFunction
  The behaviour's decaying trend
Returns void
Overrides Behaviour.reset
- Defined in src/behaviour/Collision.ts:52