EngineObject

LittleJS Object Base Object Class

  • Top level object class used by the engine
  • Automatically adds self to object list
  • Will be updated and rendered each frame
  • Renders as a sprite from a tilesheet by default
  • Can have color and additive color applied
  • 2D Physics and collision system
  • Sorted by renderOrder
  • Objects can have children attached
  • Parents are updated before children, and set child transform
  • Call destroy() to get rid of objects

The physics system used by objects is simple and fast with some caveats...

  • Collision uses the axis aligned size, the object's rotation angle is only for rendering
  • Objects are guaranteed to not intersect tile collision from physics
  • If an object starts or is moved inside tile collision, it will not collide with that tile
  • Collision for objects can be set to be solid to block other objects
  • Objects may get pushed into overlapping other solid objects, if so they will push away
  • Solid objects are more performance intensive and should be used sparingly

Constructor

new EngineObject(posopt, sizeopt, tileInfoopt, angleopt, coloropt, renderOrderopt)

Create an engine object and adds it to the list of objects

Parameters:
NameTypeAttributesDefaultDescription
posVector2<optional>
(0,0)

World space position of the object

sizeVector2<optional>
(1,1)

World space size of the object

tileInfoTileInfo<optional>

Tile info to render object (undefined is untextured)

angleNumber<optional>
0

Angle the object is rotated by

colorColor<optional>
(1,1,1,1)

Color to apply to tile when rendered

renderOrderNumber<optional>
0

Objects sorted by renderOrder before being rendered

Source
Example
// create an engine object, normally you would first extend the class with your own
const pos = vec2(2,3);
const object = new EngineObject(pos);

Members

additiveColor

Properties
TypeDescription
Color

Additive color to apply when rendered

Source

angle

Properties
TypeDescription
Number

Angle to rotate the object

Source

angleDamping

Properties
NameTypeAttributesDefaultDescription
angleDampingNumber<optional>
objectDefaultAngleDamping

How much to slow down rotation each frame (0-1)

Source

angleVelocity

Properties
TypeDescription
Number

Angular velocity of the object

Source

children

Properties
TypeDescription
Array

List of children of this object

Source

clampSpeedLinear

Properties
TypeDescription
Boolean

Limit object speed using linear or circular math

Source

collideRaycast

Properties
TypeDescription
Boolean

Object collides with raycasts

Source

collideSolidObjects

Properties
TypeDescription
Boolean

Object collides with solid objects

Source

collideTiles

Properties
TypeDescription
Boolean

Object collides with the tile collision

Source

color

Properties
TypeDescription
Color

Color to apply when rendered

Source

damping

Properties
NameTypeAttributesDefaultDescription
dampingNumber<optional>
objectDefaultDamping

How much to slow down velocity each frame (0-1)

Source

drawSize

Properties
TypeDescription
Vector2

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

Source

elasticity

Properties
NameTypeAttributesDefaultDescription
elasticityNumber<optional>
objectDefaultElasticity

How bouncy the object is when colliding (0-1)

Source

friction

Properties
NameTypeAttributesDefaultDescription
frictionNumber<optional>
objectDefaultFriction

How much friction to apply when sliding (0-1)

Source

gravityScale

Properties
TypeDescription
Number

How much to scale gravity by for this object

Source

isSolid

Properties
TypeDescription
Boolean

Object collides with and blocks other objects

Source

localAngle

Properties
TypeDescription
Number

Local angle if child

Source

localPos

Properties
TypeDescription
Vector2

Local position if child

Source

mass

Properties
NameTypeAttributesDefaultDescription
massNumber<optional>
objectDefaultMass

How heavy the object is, static if 0

Source

mirror

Properties
TypeDescription
Boolean

Should it flip along y axis when rendered

Source

parent

Properties
TypeDescription
EngineObject

Parent of object if in local space

Source

pos

Properties
TypeDescription
Vector2

World space position of the object

Source

renderOrder

Properties
TypeDescription
Number

Objects are sorted by render order

Source

size

Properties
TypeDescription
Vector2

World space width and height of the object

Source

spawnTime

Properties
TypeDescription
Number

Track when object was created

Source

tileInfo

Properties
TypeDescription
TileInfo

Tile info to render object (undefined is untextured)

Source

velocity

Properties
TypeDescription
Vector2

Velocity of the object

Source

Methods

addChild(child, localPosopt, localAngleopt)

Attaches a child to this with a given local transform

Parameters:
NameTypeAttributesDefaultDescription
childEngineObject
localPosVector2<optional>
(0,0)
localAngleNumber<optional>
0
Source

applyAcceleration(acceleration)

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

Parameters:
NameTypeDescription
accelerationVector2
Source

applyForce(force)

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

Parameters:
NameTypeDescription
forceVector2
Source

collideWithObject(object) → {Boolean}

Called to check if a object collision should be resolved

Parameters:
NameTypeDescription
objectEngineObject

the object to test against

Source
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:
NameTypeDescription
tileDataNumber

the value of the tile at the position

posVector2

tile where the collision occured

Source
Returns:
  • true if the collision should be resolved
Type: 
Boolean

destroy()

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

Source

getAliveTime() → {Number}

How long since the object was created

Source
Returns:
Type: 
Number

getMirrorSign() → {Number}

Get the direction of the mirror

Source
Returns:

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

Type: 
Number

localToWorld(pos)

Convert from local space to world space

Parameters:
NameTypeDescription
posVector2

local space point

Source

localToWorldVector(vec)

Convert from local space to world space for a vector (rotation only)

Parameters:
NameTypeDescription
vecVector2

local space vector

Source

removeChild(child)

Removes a child from this one

Parameters:
NameTypeDescription
childEngineObject
Source

render()

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

Source

renderDebugInfo()

Render debug info for this object

Source

setCollision(collideSolidObjectsopt, isSolidopt, collideTilesopt, collideRaycastopt)

Set how this object collides

Parameters:
NameTypeAttributesDefaultDescription
collideSolidObjectsBoolean<optional>
true

Does it collide with solid objects?

isSolidBoolean<optional>
true

Does it collide with and block other objects? (expensive in large numbers)

collideTilesBoolean<optional>
true

Does it collide with the tile collision?

collideRaycastBoolean<optional>
true

Does it collide with raycasts?

Source

toString() → {String}

Returns string containg info about this object for debugging

Source
Returns:
Type: 
String

update()

Update the object physics, called automatically by engine once each frame

Source

updateTransforms()

Update the object transform, called automatically by engine even when paused

Source

worldToLocal(pos)

Convert from world space to local space

Parameters:
NameTypeDescription
posVector2

world space point

Source

worldToLocalVector(vec)

Convert from world space to local space for a vector (rotation only)

Parameters:
NameTypeDescription
vecVector2

world space vector

Source