Skip to main content

Class: Collider

physics/collider/collider.Collider

Represents a collider (bounding box) in 2D space.

Collider's should always be positioned in world space so that collisions can be calculated correctly.

Hierarchy

Implemented by

Constructors

constructor

โ€ข new Collider()

Inherited from

Shape.constructor

Defined in

src/shapes/shape.ts:30

Properties

listeners

โ€ข Protected listeners: Object = {}

Index signature

โ–ช [index: string]: Listener[]

Inherited from

Shape.listeners

Defined in

src/object2d.ts:32


opacity

โ€ข opacity: number = 1

Opacity of the shape.

This is an opacity of the whole shape which is applied to the shape's entire texture equally.

Range is 0 (completely transparent) to 1 (completely opaque)

Inherited from

Shape.opacity

Defined in

src/shapes/shape.ts:28


texture

โ€ข texture: Texture = defaultTexture

Inherited from

Shape.texture

Defined in

src/shapes/shape.ts:19

Methods

addEventListener

โ–ธ addEventListener(event, listener): boolean

Executes a function when an event is fired.

Parameters

NameTypeDescription
eventstringThe event to listen for
listenerListenerThe function to execute when the event fired

Returns

boolean

Wether or not the listener was added

Inherited from

Shape.addEventListener

Defined in

src/object2d.ts:209


findFurthestNeighbours

โ–ธ Abstract findFurthestNeighbours(direction): Object

Calculates the furthest point on the collider in a direction and it's neighbouring vertices on the collider.

Parameters

NameTypeDescription
directionvec2The direction in which to calculate the furthest point

Returns

Object

The furthest point on the collider in the given direction and its left and right neighbours

NameType
furthestvec2
leftvec2
leftIndex?number
rightvec2
rightIndex?number

Defined in

src/physics/collider/collider.ts:56


findFurthestPoint

โ–ธ Abstract findFurthestPoint(direction): vec2

Calculates the furthest point on the collider in a direction.

Parameters

NameTypeDescription
directionvec2The direction in which to calculate the furthest point

Returns

vec2

The furthest point on the collider in the given direction

Defined in

src/physics/collider/collider.ts:48


fireEvent

โ–ธ fireEvent(event, ...e): void

Executes all listeners attached to a given event.

Parameters

NameTypeDescription
eventstringThe event to fire
...eanyThe data to pass to each event listener

Returns

void

Inherited from

Shape.fireEvent

Defined in

src/object2d.ts:185


getBaseVertices

โ–ธ Abstract getBaseVertices(): vec2[]

Calculates the base vertices of the shape.

These are the vertices for the type of shape at unit size, scaled to the shape's dimensions.

Returns

vec2[]

The shape's vertices

Inherited from

Shape.getBaseVertices

Defined in

src/shapes/shape.ts:109


getEventListeners

โ–ธ getEventListeners(event): Listener[]

Gets the listeners attached to an event.

Parameters

NameType
eventstring

Returns

Listener[]

An array of listeners attached to the given event

Inherited from

Shape.getEventListeners

Defined in

src/object2d.ts:198


getEvents

โ–ธ getEvents(): string[]

Gets the events that can be listened to on the object.

Returns

string[]

The events the object supports

Inherited from

Shape.getEvents

Defined in

src/object2d.ts:175


getIndices

โ–ธ Abstract getIndices(offset?): Uint16Array

Gets the shape's vertex indices for drawing using element arrays.

Parameters

NameTypeDescription
offset?numberAn offset to apply to each index

Returns

Uint16Array

The shape's vertex indices with the given offset added to each index

Inherited from

Shape.getIndices

Defined in

src/shapes/shape.ts:117


getPoints

โ–ธ getPoints(): vec2[]

Calculates the bounding points of the Shape instance.

NOTE: The shape's vertices are recalculated every time this function is called.

Returns

vec2[]

The bounding points of the box

Inherited from

Shape.getPoints

Defined in

src/shapes/shape.ts:136


getPosition

โ–ธ getPosition(): vec2

Gets the object's position.

Returns

vec2

The object's position as a vec2

Inherited from

Shape.getPosition

Defined in

src/object2d.ts:82


getRotation

โ–ธ getRotation(): number

Gets the object's rotation as a number in radians relative to y+.

Returns

number

The object's rotation

Inherited from

Shape.getRotation

Defined in

src/object2d.ts:139


getUVCoords

โ–ธ Abstract getUVCoords(): Float32Array

Calculates the shape's UV coords to be used for texture rendering.

Returns

Float32Array

the shape's UV coords

Inherited from

Shape.getUVCoords

Defined in

src/shapes/shape.ts:50


getVertices

โ–ธ getVertices(): number[]

Calculates the shape's vertices in local space.

Returns

number[]

The shape's vertices

Inherited from

Shape.getVertices

Defined in

src/shapes/shape.ts:57


getVerticesClipSpace

โ–ธ getVerticesClipSpace(origin, scale, rotation?, camera?): number[]

Calculates the shape's vertices relative to the provided origin in world space.

Parameters

NameTypeDescription
originvec2The origin to calculate the vertices relative to, should be a world position
scalevec2The vector to scale the world space vertices by to obtain clip space values
rotation?numberAn optional rotation to apply to the vertices
camera?CameraAn optional camera to get vertices relative to

Returns

number[]

The shape's vertices relative to the provided origin in clip space

Inherited from

Shape.getVerticesClipSpace

Defined in

src/shapes/shape.ts:87


getVerticesWorld

โ–ธ Abstract getVerticesWorld(origin, rotation?, returnVecs?): number[] | vec2[]

Calculates the shape's vertices relative to the provided origin in world space.

Parameters

NameTypeDescription
originvec2The origin to calculate the vertices relative to, should be a world position
rotation?numberAn optional world space rotation to apply to the vertices
returnVecs?booleanWether or not to return the vertices as vec2s or raw numbers

Returns

number[] | vec2[]

The shape's vertices relative to the provided origin in world space

Inherited from

Shape.getVerticesWorld

Defined in

src/shapes/shape.ts:76


moveRight

โ–ธ moveRight(dist): void

Moves the object's position right (x+) relative to it's rotation.

Parameters

NameTypeDescription
distnumberThe distance to move right, can be + or -

Returns

void

Inherited from

Shape.moveRight

Defined in

src/object2d.ts:100


moveUp

โ–ธ moveUp(dist): void

Moves the object's position up (y+) relative to it's rotation.

Parameters

NameTypeDescription
distnumberThe distance to move up, can be + or -

Returns

void

Inherited from

Shape.moveUp

Defined in

src/object2d.ts:114


removeEventListener

โ–ธ removeEventListener(event, listener): boolean

Removes a listener from an event.

Parameters

NameTypeDescription
eventstringThe event the listener is attached to
listenerListenerThe listener to remove

Returns

boolean

Wether or not the listener was removed

Inherited from

Shape.removeEventListener

Defined in

src/object2d.ts:223


render

โ–ธ render(position?, rotation?, zIndex?): void

Renders the shape using the Renderer.

Parameters

NameTypeDescription
position?vec2The x and y position to render the shape at
rotation?numberThe rotation to apply to the rendered shape
zIndex?numberThe z position of the rendered shape

Returns

void

Inherited from

Shape.render

Defined in

src/shapes/shape.ts:41


rotate

โ–ธ rotate(angle): void

Increments the object's rotation by an angle in radians.

Parameters

NameTypeDescription
anglenumberThe angle to rotate by in radians

Returns

void

Inherited from

Shape.rotate

Defined in

src/object2d.ts:148


setPosition

โ–ธ setPosition(pos): void

Sets the object's position.

Parameters

NameTypeDescription
posvec2The object's new position

Returns

void

Inherited from

Shape.setPosition

Defined in

src/object2d.ts:43


setPositionX

โ–ธ setPositionX(x): void

Sets the x component of the object's position.

Parameters

NameTypeDescription
xnumberThe object's new x coordinate

Returns

void

Inherited from

Shape.setPositionX

Defined in

src/object2d.ts:56


setPositionY

โ–ธ setPositionY(y): void

Sets the y component of the object's position.

Parameters

NameTypeDescription
ynumberThe object's new y coordinate

Returns

void

Inherited from

Shape.setPositionY

Defined in

src/object2d.ts:69


setRotation

โ–ธ setRotation(angle): void

Sets the object's rotation.

Parameters

NameTypeDescription
anglenumberThe object's new rotation

Returns

void

Inherited from

Shape.setRotation

Defined in

src/object2d.ts:128


setupEvents

โ–ธ Protected setupEvents(): void

Sets all the events that can be used in listeners.

Listeners can be added for an event using:

   this.listeners.eventName = [];

example Setup listeners for "position" and "rotate" events. this.listeners.position = []; this.listeners.rotate = [];

Returns

void

Inherited from

Shape.setupEvents

Defined in

src/object2d.ts:165


supportPoint

โ–ธ Abstract supportPoint(c, direction): vec2

Calculates a support point on the minkowski difference in a given direction.

Parameters

NameTypeDescription
cColliderThe collider to test against
directionvec2The direction to use when calculating furthest points

Returns

vec2

The support point in the given direction for the Minkowski difference

Defined in

src/physics/collider/collider.ts:40


testCollision

โ–ธ Abstract testCollision(c): CollisionResult

Checks if this collider is colliding with another collider.

Parameters

NameTypeDescription
cColliderCollider to test collisions against

Returns

CollisionResult

CollisionResult with the results of the test

Defined in

src/physics/collider/collider.ts:31


translate

โ–ธ translate(v): void

Translates the object by the provided vector.

Parameters

NameTypeDescription
vvec2The vector to translate by

Returns

void

Inherited from

Shape.translate

Defined in

src/object2d.ts:91