Class: TileLayer

Constructor

new TileLayer(positionopt, sizeopt, tileInfoopt, scaleopt, renderOrderopt)

Create a tile layer object

Parameters:

Name	Type	Attributes	Default	Description
`position`	Vector2	<optional>	Vector2()	World space position
`size`	Vector2	<optional>	tileCollisionSize	World space size
`tileInfo`	TileInfo	<optional>		Tile info for layer
`scale`	Vector2	<optional>	Vector2(1,1)	How much to scale this layer when rendered
`renderOrder`	Number	<optional>	0	Objects sorted by renderOrder before being rendered

Source: engineTileLayer.js, line 169

Example

// create tile collision and visible tile layer
initTileCollision(vec2(200,100));
const tileLayer = new TileLayer();

Extends

EngineObject

Members

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

Name	Type	Attributes	Default	Description
`angleDamping`	Number	<optional>	objectDefaultAngleDamping	How much to slow down rotation each frame (0-1)

Overrides: EngineObject#angleDamping
Source: engineObject.js, line 70

angleVelocity

Properties

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

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

canvas

Properties

Type	Description
HTMLCanvasElement	The canvas used by this tile layer

Source: engineTileLayer.js, line 183

color

Properties

Type	Description
Color	Color to apply when rendered

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

context

Properties

Type	Description
CanvasRenderingContext2D	The 2D canvas context used by this tile layer

Source: engineTileLayer.js, line 185

damping

Properties

Name	Type	Attributes	Default	Description
`damping`	Number	<optional>	objectDefaultDamping	How much to slow down velocity each frame (0-1)

Overrides: EngineObject#damping
Source: engineObject.js, line 68

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

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

Name	Type	Attributes	Default	Description
`gravityScale`	Number	<optional>	1	How much to scale gravity by for this object

Overrides: EngineObject#gravityScale
Source: engineObject.js, line 76

isOverlay

Properties

Name	Type	Attributes	Default	Description
`isOverlay`	Boolean	<optional>	0	If true this layer will render to overlay canvas and appear above all objects

Source: engineTileLayer.js, line 189

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

pos

Properties

Type	Description
Vector2	World space position of the object

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

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

scale

Properties

Type	Description
Vector2	How much to scale this layer when rendered

Source: engineTileLayer.js, line 187

size

Properties

Type	Description
Vector2	World space width and height of the object

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

tileInfo

Properties

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

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

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

drawAllTileData()

Draw all the tiles in this layer

Source: engineTileLayer.js, line 300

drawCanvas2D(pos, size, angleopt, mirroropt, drawFunction)

Draw directly to the 2D canvas in world space (bipass webgl)

Parameters:

Name	Type	Attributes	Default
`pos`	Vector2
`size`	Vector2
`angle`	Number	<optional>	0
`mirror`	Boolean	<optional>	0
`drawFunction`	function

Source: engineTileLayer.js, line 313

drawRect(pos, sizeopt, coloropt, angleopt)

Draw a rectangle directly onto the layer canvas

Parameters:

Name	Type	Attributes	Default
`pos`	Vector2
`size`	Vector2	<optional>	Vector2(1,1)
`color`	Color	<optional>	Color()
`angle`	Number	<optional>	0

Source: engineTileLayer.js, line 359

drawTile(pos, sizeopt, tileInfoopt, coloropt, angleopt, mirroropt)

Draw a tile directly onto the layer canvas

Parameters:

Name	Type	Attributes	Default
`pos`	Vector2
`size`	Vector2	<optional>	Vector2(1,1)
`tileInfo`	TileInfo	<optional>
`color`	Color	<optional>	Color()
`angle`	Number	<optional>	0
`mirror`	Boolean	<optional>	0

Source: engineTileLayer.js, line 333

drawTileData(layerPos)

Draw the tile at a given position

Parameters:

Name	Type	Description
`layerPos`	Vector2

Source: engineTileLayer.js, line 283

getAliveTime() → {Number}

How long since the object was created

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

Returns:

Type:: Number

getData(layerPos) → {TileLayerData}

Get data at a given position in the array

Parameters:

Name	Type	Description
`layerPos`	Vector2	Local position in array

Source: engineTileLayer.js, line 213

Returns:

Type:: TileLayerData

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

redraw()

Draw all the tile data to an offscreen canvas

This may be slow in some browsers

Source: engineTileLayer.js, line 239

redrawEnd()

Call to end the redraw process

Source: engineTileLayer.js, line 271

redrawStart(clearopt)

Call to start the redraw process

Parameters:

Name	Type	Attributes	Default	Description
`clear`	Boolean	<optional>	0	Should it clear the canvas before drawing

Source: engineTileLayer.js, line 248

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

setData(position, data, redrawopt)

Set data at a given position in the array

Parameters:

Name	Type	Attributes	Default	Description
`position`	Vector2			Local position in array
`data`	TileLayerData			Data to set
`redraw`	Boolean	<optional>	0	Force the tile to redraw if true

Source: engineTileLayer.js, line 201

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 object transform and physics, called automatically by engine once each frame

Overrides: EngineObject#update
Source: engineObject.js, line 94