Skip to main content

MotionComponent

Components are containers for state in Excalibur, the are meant to convey capabilities that an Entity possesses

Implementations of Component must have a zero-arg constructor to support dependencies

class MyComponent extends ex.Component {
  // zero arg support required if you want to use component dependencies
  constructor(public optionalPos?: ex.Vector) {}
}

Hierarchy

Index

Constructors

Properties

Methods

Constructors

constructor

Properties

publicacc

acc: Vector = Vector.Zero

The acceleration of entity in pixels per second^2

publicangularVelocity

angularVelocity: number = 0

The angular velocity which is how quickly the entity is rotating in radians per second

optionalreadonlydependencies

dependencies?: ComponentCtor<Component>[]

Optionally list any component types this component depends on If the owner entity does not have these components, new components will be added to the entity

Only components with zero-arg constructors are supported as automatic component dependencies

publicinertia

inertia: number = 1

Inertia can be thought of as the resistance to motion

optionalowner

owner?: Entity<any> = undefined

Current owning [[Entity]], if any, of this component. Null if not added to any [[Entity]]

publicscaleFactor

scaleFactor: Vector = Vector.Zero

The scale rate of change in scale units per second

publictorque

torque: number = 0

The amount of torque applied to the entity, angular acceleration is torque * inertia

publicvel

vel: Vector = Vector.Zero

The velocity of an entity in pixels per second

Methods

clone

  • Clones any properties on this component, if that property value has a clone() method it will be called

    Returns Component

optionalonAdd

  • onAdd(owner: Entity<any>): void

  • Optional callback called when a component is added to an entity

    Parameters

    Returns void

optionalonRemove

  • onRemove(previousOwner: Entity<any>): void

  • Optional callback called when a component is removed from an entity

    Parameters

    Returns void