Class: ParticleEmitter

Constructor

new ParticleEmitter(position, angleopt, emitSizeopt, emitTimeopt, emitRateopt, emitConeAngleopt, tileInfoopt, colorStartAopt, colorStartBopt, colorEndAopt, colorEndBopt, particleTimeopt, sizeStartopt, sizeEndopt, speedopt, angleSpeedopt, dampingopt, angleDampingopt, gravityScaleopt, particleConeAngleopt, fadeRateopt, randomnessopt, collideTilesopt, additiveopt, randomColorLinearopt, renderOrderopt, localSpaceopt)

Create a particle system with the given settings

Parameters:

Name	Type	Attributes	Default	Description
`position`	Vector2			World space position of the emitter
`angle`	Number	<optional>	0	Angle to emit the particles
`emitSize`	Number	<optional>	0	World space size of the emitter (float for circle diameter, vec2 for rect)
`emitTime`	Number	<optional>	0	How long to stay alive (0 is forever)
`emitRate`	Number	<optional>	100	How many particles per second to spawn, does not emit if 0
`emitConeAngle`	Number	<optional>	PI	Local angle to apply velocity to particles from emitter
`tileInfo`	TileInfo	<optional>		Tile info to render particles (undefined is untextured)
`colorStartA`	Color	<optional>	Color()	Color at start of life 1, randomized between start colors
`colorStartB`	Color	<optional>	Color()	Color at start of life 2, randomized between start colors
`colorEndA`	Color	<optional>	Color(1,1,1,0)	Color at end of life 1, randomized between end colors
`colorEndB`	Color	<optional>	Color(1,1,1,0)	Color at end of life 2, randomized between end colors
`particleTime`	Number	<optional>	.5	How long particles live
`sizeStart`	Number	<optional>	.1	How big are particles at start
`sizeEnd`	Number	<optional>	1	How big are particles at end
`speed`	Number	<optional>	.1	How fast are particles when spawned
`angleSpeed`	Number	<optional>	.05	How fast are particles rotating
`damping`	Number	<optional>	1	How much to dampen particle speed
`angleDamping`	Number	<optional>	1	How much to dampen particle angular speed
`gravityScale`	Number	<optional>	0	How much does gravity effect particles
`particleConeAngle`	Number	<optional>	PI	Cone for start particle angle
`fadeRate`	Number	<optional>	.1	How quick to fade in particles at start/end in percent of life
`randomness`	Number	<optional>	.2	Apply extra randomness percent
`collideTiles`	Boolean	<optional>	0	Do particles collide against tiles
`additive`	Boolean	<optional>	0	Should particles use addtive blend
`randomColorLinear`	Boolean	<optional>	1	Should color be randomized linearly or across each component
`renderOrder`	Number	<optional>	0	Render order for particles (additive is above other stuff by default)
`localSpace`	Boolean	<optional>	0	Should it be in local space of emitter (world space is default)

Source: engineParticles.js, line 24

Example

// create a particle emitter
let pos = vec2(2,3);
let particleEmiter = new ParticleEmitter
(
    pos, 0, 1, 0, 500, PI,  // pos, angle, emitSize, emitTime, emitRate, emiteCone
    tile(0, 16),            // tileInfo
    new Color(1,1,1),   new Color(0,0,0),   // colorStartA, colorStartB
    new Color(1,1,1,0), new Color(0,0,0,0), // colorEndA, colorEndB
    2, .2, .2, .1, .05,  // particleTime, sizeStart, sizeEnd, particleSpeed, particleAngleSpeed
    .99, 1, 1, PI, .05,  // damping, angleDamping, gravityScale, particleCone, fadeRate, 
    .5, 1                // randomness, collide, additive, randomColorLinear, renderOrder
);

Extends

EngineObject

Members

additive

Properties

Type	Description
Number	Should particles use addtive blend

Source: engineParticles.js, line 136

additiveColor

Properties

Type	Description
Color	Additive color to apply when rendered

Overrides: EngineObject#additiveColor
Source: engineObject.js, line 62

angle

Properties

Type	Description
Number	Angle to rotate the object

Overrides: EngineObject#angle
Source: engineObject.js, line 58

angleDamping

Properties

Type	Description
Number	How much to dampen particle angular speed

Overrides: EngineObject#angleDamping
Source: engineParticles.js, line 124

angleSpeed

Properties

Type	Description
Number	How fast are particles rotating

Source: engineParticles.js, line 120

angleVelocity

Properties

Name	Type	Attributes	Default	Description
`angleVelocity`	Number	<optional>	0	Angular velocity of the object

Overrides: EngineObject#angleVelocity
Source: engineObject.js, line 82

collideTiles

Properties

Type	Description
Number	Do particles collide against tiles

Source: engineParticles.js, line 134

color

Properties

Type	Description
Color	Color to apply when rendered

Overrides: EngineObject#color
Source: engineObject.js, line 60

colorEndA

Properties

Type	Description
Color	Color at end of life 1, randomized between end colors

Source: engineParticles.js, line 104

colorEndB

Properties

Type	Description
Color	Color at end of life 2, randomized between end colors

Source: engineParticles.js, line 106

colorStartA

Properties

Type	Description
Color	Color at start of life 1, randomized between start colors

Source: engineParticles.js, line 100

colorStartB

Properties

Type	Description
Color	Color at start of life 2, randomized between start colors

Source: engineParticles.js, line 102

damping

Properties

Type	Description
Number	How much to dampen particle speed

Overrides: EngineObject#damping
Source: engineParticles.js, line 122

drawSize

Properties

Type	Description
Vector2	Size of object used for drawing, uses size if not set

Overrides: EngineObject#drawSize
Source: engineObject.js, line 54

elasticity

Properties

Name	Type	Attributes	Default	Description
`elasticity`	Number	<optional>	objectDefaultElasticity	How bouncy the object is when colliding (0-1)

Overrides: EngineObject#elasticity
Source: engineObject.js, line 72

emitConeAngle

Properties

Type	Description
Number	Local angle to apply velocity to particles from emitter

Source: engineParticles.js, line 96

emitRate

Properties

Type	Description
Number	How many particles per second to spawn, does not emit if 0

Source: engineParticles.js, line 94

emitSize

Properties

Type	Description
Number	World space size of the emitter (float for circle diameter, vec2 for rect)

Source: engineParticles.js, line 90

emitTime

Properties

Type	Description
Number	How long to stay alive (0 is forever)

Source: engineParticles.js, line 92

fadeRate

Properties

Type	Description
Number	How quick to fade in particles at start/end in percent of life

Source: engineParticles.js, line 130

friction

Properties

Name	Type	Attributes	Default	Description
`friction`	Number	<optional>	objectDefaultFriction	How much friction to apply when sliding (0-1)

Overrides: EngineObject#friction
Source: engineObject.js, line 74

gravityScale

Properties

Type	Description
Number	How much does gravity effect particles

Overrides: EngineObject#gravityScale
Source: engineParticles.js, line 126

localSpace

Properties

Type	Description
Boolean	Should it be in local space of emitter

Source: engineParticles.js, line 138

mass

Properties

Name	Type	Attributes	Default	Description
`mass`	Number	<optional>	objectDefaultMass	How heavy the object is, static if 0

Overrides: EngineObject#mass
Source: engineObject.js, line 66

particleConeAngle

Properties

Type	Description
Number	Cone for start particle angle

Source: engineParticles.js, line 128

particleTime

Properties

Type	Description
Number	How long particles live

Source: engineParticles.js, line 112

pos

Properties

Type	Description
Vector2	World space position of the object

Overrides: EngineObject#pos
Source: engineObject.js, line 50

randomColorLinear

Properties

Type	Description
Boolean	Should color be randomized linearly or across each component

Source: engineParticles.js, line 108

randomness

Properties

Type	Description
Number	Apply extra randomness percent

Source: engineParticles.js, line 132

renderOrder

Properties

Name	Type	Attributes	Default	Description
`renderOrder`	Number	<optional>	0	Objects are sorted by render order

Overrides: EngineObject#renderOrder
Source: engineObject.js, line 78

size

Properties

Type	Description
Vector2	World space width and height of the object

Overrides: EngineObject#size
Source: engineObject.js, line 52

sizeEnd

Properties

Type	Description
Number	How big are particles at end

Source: engineParticles.js, line 116

sizeStart

Properties

Type	Description
Number	How big are particles at start

Source: engineParticles.js, line 114

speed

Properties

Type	Description
Number	How fast are particles when spawned

Source: engineParticles.js, line 118

tileInfo

Properties

Type	Description
TileInfo	Tile info to render object (undefined is untextured)

Overrides: EngineObject#tileInfo
Source: engineObject.js, line 56

trailScale

Properties

Type	Description
Number	If set the partile is drawn as a trail, stretched in the drection of velocity

Source: engineParticles.js, line 140

velocity

Properties

Name	Type	Attributes	Default	Description
`velocity`	Vector2	<optional>	Vector2()	Velocity of the object

Overrides: EngineObject#velocity
Source: engineObject.js, line 80

Methods

addChild(child, localPosopt, localAngleopt)

Attaches a child to this with a given local transform

Parameters:

Name	Type	Attributes	Default
`child`	EngineObject
`localPos`	Vector2	<optional>	Vector2()
`localAngle`	Number	<optional>	0

Overrides: EngineObject#addChild
Source: engineObject.js, line 326

applyAcceleration(acceleration)

Apply acceleration to this object (adjust velocity, not affected by mass)

Parameters:

Name	Type	Description
`acceleration`	Vector2

Overrides: EngineObject#applyAcceleration
Source: engineObject.js, line 312

applyForce(force)

Apply force to this object (adjust velocity, affected by mass)

Parameters:

Name	Type	Description
`force`	Vector2

Overrides: EngineObject#applyForce
Source: engineObject.js, line 316

collideWithObject(object) → {Boolean}

Called to check if a object collision should be resolved

Parameters:

Name	Type	Description
`object`	EngineObject	the object to test against

Overrides: EngineObject#collideWithObject
Source: engineObject.js, line 304

Returns:

true if the collision should be resolved

Type:: Boolean

collideWithTile(tileData, pos) → {Boolean}

Called to check if a tile collision should be resolved

Parameters:

Name	Type	Description
`tileData`	Number	the value of the tile at the position
`pos`	Vector2	tile where the collision occured

Overrides: EngineObject#collideWithTile
Source: engineObject.js, line 292

Returns:

true if the collision should be resolved

Type:: Boolean

collideWithTileRaycast(tileData, pos) → {Boolean}

Called to check if a tile raycast hit

Parameters:

Name	Type	Description
`tileData`	Number	the value of the tile at the position
`pos`	Vector2	tile where the raycast is

Overrides: EngineObject#collideWithTileRaycast
Source: engineObject.js, line 298

Returns:

true if the raycast should hit

Type:: Boolean

destroy()

Destroy this object, destroy it's children, detach it's parent, and mark it for removal

Overrides: EngineObject#destroy
Source: engineObject.js, line 276

emitParticle() → {Particle}

Spawn one particle

Source: engineParticles.js, line 171

Returns:

Type:: Particle

getAliveTime() → {Number}

How long since the object was created

Overrides: EngineObject#getAliveTime
Source: engineObject.js, line 308

Returns:

Type:: Number

getMirrorSign() → {Number}

Get the direction of the mirror

Overrides: EngineObject#getMirrorSign
Source: engineObject.js, line 320

Returns:

-1 if this.mirror is true, or 1 if not mirrored

Type:: Number

removeChild(child)

Removes a child from this one

Parameters:

Name	Type	Description
`child`	EngineObject

Overrides: EngineObject#removeChild
Source: engineObject.js, line 337

render()

Render the object, draws a tile by default, automatically called each frame, sorted by renderOrder

Overrides: EngineObject#render
Source: engineObject.js, line 269

setCollision(collideSolidObjectsopt, isSolidopt, collideTilesopt)

Set how this object collides

Parameters:

Name	Type	Attributes	Default	Description
`collideSolidObjects`	Boolean	<optional>	1	Does it collide with solid objects
`isSolid`	Boolean	<optional>	1	Does it collide with and block other objects (expensive in large numbers)
`collideTiles`	Boolean	<optional>	1	Does it collide with the tile collision

Overrides: EngineObject#setCollision
Source: engineObject.js, line 348

toString() → {String}

Returns string containg info about this object for debugging

Overrides: EngineObject#toString
Source: engineObject.js, line 359

Returns:

Type:: String

update()

Update the emitter to spawn particles, called automatically by engine once each frame

Overrides: EngineObject#update
Source: engineParticles.js, line 147