Skip to main content

Trigger

Triggers are a method of firing arbitrary code on collision. These are useful as 'buttons', 'switches', or to trigger effects in a game. By default triggers are invisible, and can only be seen when Trigger.visible is set to true.

Hierarchy

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Properties

publicinherited_componentsToRemove

_componentsToRemove: ComponentCtor[] = []

publicaction

action: (entity: Entity) => void

Action to fire when triggered by collision

Type declaration

publicinheritedactions

actions: ActionsComponent

Useful for quickly scripting actor behavior, like moving to a place, patrolling back and forth, blinking, etc.

Access to the Actor's built in ActionsComponent which forwards to the Action context of the actor.

publicinheritedbody

body: BodyComponent

The physics body the is associated with this actor. The body is the container for all physical properties, like position, velocity, acceleration, mass, inertia, etc.

publicinheritedchildrenAdded$

childrenAdded$: Observable<Entity<any>> = ...

publicinheritedchildrenRemoved$

childrenRemoved$: Observable<Entity<any>> = ...

publicinheritedcollider

collider: ColliderComponent

Access to the Actor's built in ColliderComponent

publicinheritedcomponentAdded$

componentAdded$: Observable<Component> = ...

publicinheritedcomponentRemoved$

componentRemoved$: Observable<Component> = ...

publicreadonlyinheritedcomponents

components: Map<Function, Component> = ...

Current components on the entity

Do not modify

Use addComponent/removeComponent otherwise the ECS will not be notified of changes.

publicinheritedcomponentValues

componentValues: Component[] = []

publicevents

events: EventEmitter<TriggerEvents & ActorEvents> = ...

Listen to or emit events for an entity

publicfilter

filter: (entity: Entity) => boolean

Filter to add additional granularity to action dispatch, if a filter is specified the action will only fire when filter return true for the collided entity.

Type declaration

    • Parameters

      Returns boolean

publicinheritedgraphics

graphics: GraphicsComponent

Access to the Actor's built in GraphicsComponent

publicinheritedid

id: number = ...

The unique identifier for the entity

publicinheritedisActive

isActive: boolean = true

Whether this entity is active, if set to false it will be reclaimed

publicinheritedlogger

logger: Logger = ...

Convenience reference to the global logger

publicinheritedmotion

motion: MotionComponent

Access the Actor's built in MotionComponent

publicinheritedname

name: string = ...

publicinheritedpaused

paused: PauseComponent

The physics body the is associated with this actor. The body is the container for all physical properties, like position, velocity, acceleration, mass, inertia, etc.

publicinheritedpointer

pointer: PointerComponent

Access to the Actor's built in PointerComponent config

publicrepeat

repeat: number

Number of times to repeat before killing the trigger,

publicinheritedscene

scene: Scene<unknown> | null = null

The current scene that the entity is in, if any

publicinheritedtagAdded$

tagAdded$: Observable<string> = ...

publicinheritedtagRemoved$

tagRemoved$: Observable<string> = ...

publicoptionaltarget

target?: Entity<any>

publicinheritedtransform

transform: TransformComponent

Access the Actor's built in TransformComponent

publicstaticinheriteddefaults

defaults: { anchor: Vector } = ...

Set defaults for all Actors

Type declaration

Accessors

publicinheritedacc

  • Gets the acceleration vector of the actor in pixels/second/second. An acceleration pointing down such as (0, 100) may be useful to simulate a gravitational effect.

    Returns Vector

  • Sets the acceleration vector of teh actor in pixels/second/second

    Parameters

    Returns void

publicinheritedactive

  • get active(): boolean
  • set active(val: boolean): void

  • Whether this entity is active, if set to false it will be reclaimed

    @deprecated

    use isActive

    Returns boolean

  • Whether this entity is active, if set to false it will be reclaimed

    @deprecated

    use isActive

    Parameters

    • val: boolean

    Returns void

publicinheritedanchor

  • The anchor to apply all actor related transformations like rotation, translation, and scaling. By default the anchor is in the center of the actor. By default it is set to the center of the actor (.5, .5)

    An anchor of (.5, .5) will ensure that drawings are centered.

    Use anchor.setTo to set the anchor to a different point using values between 0 and 1. For example, anchoring to the top-left would be Actor.anchor.setTo(0, 0) and top-right would be Actor.anchor.setTo(0, 1).

    Returns Vector

  • Parameters

    Returns void

publicinheritedangularVelocity

  • get angularVelocity(): number
  • set angularVelocity(angularVelocity: number): void

  • Gets the rotational velocity of the actor in radians/second

    Returns number

  • Sets the rotational velocity of the actor in radians/sec

    Parameters

    • angularVelocity: number

    Returns void

publicinheritedcanPause

  • get canPause(): boolean
  • set canPause(canPause: boolean): void

  • Returns boolean

  • Parameters

    • canPause: boolean

    Returns void

publicinheritedcenter

  • Get the center point of an actor (global position)

    Returns Vector

publicinheritedchildren

  • get children(): readonly Entity<any>[]

  • Get the direct children of this entity

    Returns readonly Entity<any>[]

publicinheritedcolor

  • Sets the color of the actor's current graphic

    Returns Color

  • Parameters

    Returns void

publicinheriteddraggable

  • get draggable(): boolean
  • set draggable(isDraggable: boolean): void

  • Returns boolean

  • Parameters

    • isDraggable: boolean

    Returns void

publicinheritedglobalPos

  • The actor's world position taking into account parent relationships, scaling, rotation, and translation

    Returns Vector

publicinheritedglobalRotation

  • get globalRotation(): number

  • The actor's rotation (in radians) taking into account any parent relationships

    Returns number

publicinheritedglobalScale

  • The global scale of the Actor

    Returns Vector

publicinheritedglobalZ

  • get globalZ(): number

  • The global z-index of the actor

    Returns number

publicinheritedheight

  • get height(): number

  • Returns number

publicinheritedisAdded

  • get isAdded(): boolean

  • Returns boolean

publicinheritedisInitialized

  • get isInitialized(): boolean

  • Gets whether the actor is Initialized

    Returns boolean

publicinheritedisOffScreen

  • get isOffScreen(): boolean

  • Indicates whether the actor is physically in the viewport

    Returns boolean

publicinheritedisPaused

  • get isPaused(): boolean

  • Returns boolean

publicinheritedlocalCenter

  • Get the local center point of an actor

    Returns Vector

publicinheritedoffset

  • The offset in pixels to apply to all actor graphics

    Default offset of (0, 0)

    Returns Vector

  • Parameters

    Returns void

publicinheritedoldAcc

  • Gets the acceleration of the actor from the last frame. This does not include the global acc Physics.acc.

    Returns Vector

  • Sets the acceleration of the actor from the last frame. This does not include the global acc Physics.acc.

    Parameters

    Returns void

publicinheritedoldGlobalPos

  • Gets the global position vector of the actor from the last frame

    Returns Vector

publicinheritedoldPos

  • Gets the position vector of the actor from the last frame

    Returns Vector

  • Sets the position vector of the actor in the last frame

    Parameters

    Returns void

publicinheritedoldVel

  • Gets the velocity vector of the actor from the last frame

    Returns Vector

  • Sets the velocity vector of the actor from the last frame

    Parameters

    Returns void

publicinheritedparent

  • get parent(): Entity<any> | null

  • Returns Entity<any> | null

publicinheritedpos

  • Gets the position vector of the actor in pixels

    Returns Vector

  • Sets the position vector of the actor in pixels

    Parameters

    Returns void

publicinheritedrotation

  • get rotation(): number
  • set rotation(theAngle: number): void

  • Gets the rotation of the actor in radians. 1 radian = 180/PI Degrees.

    Returns number

  • Sets the rotation of the actor in radians. 1 radian = 180/PI Degrees.

    Parameters

    • theAngle: number

    Returns void

publicinheritedscale

  • Returns Vector

  • Parameters

    Returns void

publicinheritedtags

  • get tags(): Set<string>

  • Specifically get the tags on the entity from TagsComponent

    Returns Set<string>

publicinheritedtypes

  • The types of the components on the Entity

    Returns ComponentCtor[]

publicinheritedvel

  • Gets the velocity vector of the actor in pixels/sec

    Returns Vector

  • Sets the velocity vector of the actor in pixels/sec

    Parameters

    Returns void

publicinheritedwidth

  • get width(): number

  • Returns number

publicinheritedz

  • get z(): number
  • set z(newZ: number): void

  • Gets the z-index of an actor. The z-index determines the relative order an actor is drawn in. Actors with a higher z-index are drawn on top of actors with a lower z-index

    Returns number

  • Sets the z-index of an actor and updates it in the drawing list for the scene. The z-index determines the relative order an actor is drawn in. Actors with a higher z-index are drawn on top of actors with a lower z-index

    Parameters

    • newZ: number

      new z-index to assign

    Returns void

Methods

publicinheritedaddChild

  • Adds an entity to be a child of this entity

    Parameters

    Returns Entity

publicinheritedaddComponent

  • addComponent<TComponent>(component: TComponent, force?: boolean): Entity<any>

  • Adds a component to the entity

    Type parameters

    Parameters

    • component: TComponent

      Component or Entity to add copy of components from

    • force: boolean = false

      Optionally overwrite any existing components of the same type

    Returns Entity<any>

publicinheritedaddTag

  • addTag(tag: string): Entity<any>

  • Adds a tag to an entity

    Parameters

    • tag: string

    Returns Entity<any>

publicinheritedaddTemplate

  • addTemplate(templateEntity: Entity, force?: boolean): Entity

  • Adds a copy of all the components from another template entity as a "prefab"

    Parameters

    • templateEntity: Entity

      Entity to use as a template

    • force: boolean = false

      Force component replacement if it already exists on the target entity

    Returns Entity

publicinheritedclearComponents

  • clearComponents(): void

  • Returns void

publicinheritedclone

  • Creates a deep copy of the entity and a copy of all its components

    Returns Actor

publicinheritedcontains

  • contains(x: number, y: number, recurse?: boolean): boolean

  • Tests whether the x/y specified are contained in the actor

    Parameters

    • x: number

      X coordinate to test (in world coordinates)

    • y: number

      Y coordinate to test (in world coordinates)

    • recurse: boolean = false

      checks whether the x/y are contained in any child actors (if they exist).

    Returns boolean

publicinheritedemit

  • emit<TEventName>(eventName: TEventName, event: ActorEvents[TEventName]): void
  • emit(eventName: string, event?: any): void

  • Emits an event for target

    Type parameters

    Parameters

    • eventName: TEventName

      The name of the event to publish

    • event: ActorEvents[TEventName]

      Optionally pass an event data object to the handler

    Returns void

inheritedget

publicinheritedgetAncestors

  • Returns a list of parent entities starting with the topmost parent. Includes the current entity.

    Returns Entity<any>[]

publicinheritedgetComponents

  • Returns all component instances on entity

    Returns Component[]

publicinheritedgetDescendants

  • getDescendants(): Entity<any>[]

  • Returns a list of all the entities that descend from this entity. Includes the current entity.

    Returns Entity<any>[]

publicinheritedgetGlobalPos

  • Gets an actor's world position taking into account parent relationships, scaling, rotation, and translation

    @deprecated

    Use globalPos instead

    Returns Vector

    Position in world coordinates

publicinheritedgetGlobalRotation

  • getGlobalRotation(): number

  • Gets this actor's rotation taking into account any parent relationships

    @deprecated

    Use globalRotation instead

    Returns number

    Rotation angle in radians

publicinheritedgetGlobalScale

  • Gets the global scale of the Actor

    @deprecated

    Use globalScale instead

    Returns Vector

publicinheritedhas

  • Check if a component type exists

    Type parameters

    Parameters

    Returns boolean

inheritedhasAll

  • hasAll<TComponent>(requiredTypes: ComponentCtor<TComponent>[]): boolean

  • Verifies that an entity has all the required types

    Type parameters

    Parameters

    Returns boolean

inheritedhasAllTags

  • hasAllTags(requiredTags: string[]): boolean

  • Verifies that an entity has all the required tags

    Parameters

    • requiredTags: string[]

    Returns boolean

publicinheritedhasChild

  • hasChild(child: Entity, recursive?: boolean): boolean

  • Check if a child entity exists on the parent entity

    Parameters

    • child: Entity

      entity to check for

    • recursive: boolean = false

      whether to check recursively

    Returns boolean

publicinheritedhasTag

  • hasTag(tag: string): boolean

  • Check if a tag exists on the entity

    Parameters

    • tag: string

      name to check for

    Returns boolean

publicinheritedisKilled

  • isKilled(): boolean

  • Indicates whether the actor has been killed.

    Returns boolean

publicinheritedkill

  • kill(): void

  • If the current actor is a member of the scene, this will remove it from the scene graph. It will no longer be drawn or updated.

    Returns void

publicinheritedoff

  • off<TEventName>(eventName: TEventName, handler: Handler<ActorEvents[TEventName]>): void
  • off(eventName: string, handler: Handler<unknown>): void
  • off(eventName: string): void

  • Unsubscribe an event handler(s) from an event. If a specific handler is specified for an event, only that handler will be unsubscribed. Otherwise all handlers will be unsubscribed for that event.

    Type parameters

    Parameters

    • eventName: TEventName

      The name of the event to unsubscribe

    • handler: Handler<ActorEvents[TEventName]>

      Optionally the specific handler to unsubscribe

    Returns void

publicinheritedon

  • Subscribe an event handler to a particular event name, multiple handlers per event name are allowed.

    Type parameters

    Parameters

    • eventName: TEventName

      The name of the event to subscribe to

    • handler: Handler<ActorEvents[TEventName]>

      The handler callback to fire on this event

    Returns Subscription

publicinheritedonAdd

  • onAdd is called when Actor is added to scene. This method is meant to be overridden.

    Synonymous with the event handler .on('add', (evt) => {...})

    Parameters

    Returns void

publicinheritedonce

  • Once listens to an event once then auto unsubscribes from that event

    Type parameters

    Parameters

    • eventName: TEventName

      The name of the event to subscribe to once

    • handler: Handler<ActorEvents[TEventName]>

      The handler of the event that will be auto unsubscribed

    Returns Subscription

publicinheritedonCollisionEnd

  • Fires once when 2 entities with a ColliderComponent separate after having been in contact.

    Parameters

    Returns void

publicinheritedonCollisionStart

  • Fires once when 2 entities with a ColliderComponent first start colliding or touching, if the Colliders stay in contact this does not continue firing until they separate and re-collide.

    Parameters

    Returns void

publicinheritedonInitialize

  • onInitialize(engine: Engine): void

  • onInitialize is called before the first update of the actor. This method is meant to be overridden. This is where initialization of child actors should take place.

    Synonymous with the event handler .on('initialize', (evt) => {...})

    Parameters

    Returns void

publicinheritedonPostCollisionResolve

  • Fires after every resolution for a confirmed contact.

    Parameters

    Returns void

publicinheritedonPostKill

  • onPostKill(scene: Scene): void

  • Safe to override onPostKill lifecycle event handler. Synonymous with .on('postkill', (evt) => {...})

    onPostKill is called directly after an actor is killed and remove from its current Scene.

    Parameters

    Returns void

publicinheritedonPostUpdate

  • onPostUpdate(engine: Engine, elapsed: number): void

  • Safe to override onPostUpdate lifecycle event handler. Synonymous with .on('postupdate', (evt) =>{...})

    onPostUpdate is called directly after an actor is updated.

    Parameters

    • engine: Engine

      The reference to the current game engine

    • elapsed: number

      The time elapsed since the last update in milliseconds

    Returns void

publicinheritedonPreCollisionResolve

  • Fires before every collision resolution for a confirmed contact

    Parameters

    Returns void

publicinheritedonPreKill

  • onPreKill(scene: Scene): void

  • Safe to override onPreKill lifecycle event handler. Synonymous with .on('prekill', (evt) =>{...})

    onPreKill is called directly before an actor is killed and removed from its current Scene.

    Parameters

    Returns void

publicinheritedonPreUpdate

  • onPreUpdate(engine: Engine, elapsed: number): void

  • Safe to override onPreUpdate lifecycle event handler. Synonymous with .on('preupdate', (evt) =>{...})

    onPreUpdate is called directly before an actor is updated.

    Parameters

    • engine: Engine

      The reference to the current game engine

    • elapsed: number

      The time elapsed since the last update in milliseconds

    Returns void

publicinheritedonRemove

  • onRemove(engine: Engine): void

  • onRemove is called when Actor is removed from a scene. This method is meant to be overridden.

    Synonymous with the event handler .on('remove', (evt) => {...})

    Parameters

    Returns void

publicinheritedremoveAllChildren

  • Removes all children from this entity

    Returns Entity

publicinheritedremoveChild

  • Remove an entity from children if it exists

    Parameters

    Returns Entity

publicinheritedremoveComponent

  • removeComponent<TComponent>(typeOrInstance: TComponent | ComponentCtor<TComponent>, force?: boolean): Entity<Exclude<any, TComponent>>

  • Removes a component from the entity, by default removals are deferred to the end of entity update to avoid consistency issues

    Components can be force removed with the force flag, the removal is not deferred and happens immediately

    Type parameters

    Parameters

    • typeOrInstance: TComponent | ComponentCtor<TComponent>
    • force: boolean = false

    Returns Entity<Exclude<any, TComponent>>

publicinheritedremoveTag

  • removeTag(tag: string): Entity<any>

  • Removes a tag on the entity

    Removals are deferred until the end of update

    Parameters

    • tag: string

    Returns Entity<any>

publicinheritedunkill

  • unkill(): void

  • If the current actor is killed, it will now not be killed.

    Returns void

publicinheritedunparent

  • unparent(): void

  • Unparents this entity, if there is a parent. Otherwise it does nothing.

    Returns void

publicinheritedwithin

  • within(actor: Actor, distance: number): boolean

  • Returns true if the two actor.collider's surfaces are less than or equal to the distance specified from each other

    Parameters

    • actor: Actor

      Actor to test

    • distance: number

      Distance in pixels to test

    Returns boolean

Page Options