Class Camera

Cameras

Camera is the base class for all Excalibur cameras. Cameras are used to move around your game and set focus. They are used to determine what is "off screen" and can be used to scale the game.

Hierarchy

Camera

Implements

Index

Constructors

constructor

new Camera(): Camera
Returns Camera

Properties

`Protected` _follow

_follow: Actor

`Protected` _isShaking

_isShaking: boolean = false

`Protected` _isZooming

_isZooming: boolean = false

acc

acc: Vector = Vector.Zero

Get or set the camera's acceleration

az

az: number = 0

Get or set zoom acceleration

dz

dz: number = 0

Get or set rate of change in zoom, defaults to 0

events

events: EventEmitter<CameraEvents> = ...

inverse

inverse: AffineMatrix = ...

rotation

rotation: number = 0

Current rotation of the camera

strategy

strategy: StrategyContainer = ...

transform

transform: AffineMatrix = ...

vel

vel: Vector = Vector.Zero

Get or set the camera's velocity

Accessors

angularVelocity

get angularVelocity(): number
Get or set the camera's angular velocity

Returns number
- Defined in Camera.ts:300
set angularVelocity(value: number): void
Parameters
- value: number
Returns void
- Defined in Camera.ts:304

ax

get ax(): number
Get or set the camera's x acceleration

Returns number
- Defined in Camera.ts:419
set ax(value: number): void
Parameters
- value: number
Returns void
- Defined in Camera.ts:423

ay

get ay(): number
Get or set the camera's y acceleration

Returns number
- Defined in Camera.ts:430
set ay(value: number): void
Parameters
- value: number
Returns void
- Defined in Camera.ts:434

dx

get dx(): number
Get or set the camera's x velocity

Returns number
- Defined in Camera.ts:397
set dx(value: number): void
Parameters
- value: number
Returns void
- Defined in Camera.ts:401

dy

get dy(): number
Get or set the camera's y velocity

Returns number
- Defined in Camera.ts:408
set dy(value: number): void
Parameters
- value: number
Returns void
- Defined in Camera.ts:412

isInitialized

get isInitialized(): boolean
Returns boolean
- Defined in Camera.ts:600

pos

get pos(): Vector
Returns Vector
- Defined in Camera.ts:313
set pos(vec: Vector): void
Parameters
- vec: Vector
Returns void
- Defined in Camera.ts:316

viewport

get viewport(): BoundingBox
Gets the bounding box of the viewport of this camera in world coordinates

Returns BoundingBox
- Defined in Camera.ts:526

x

get x(): number
Get the camera's x position

Returns number
- Defined in Camera.ts:365
set x(value: number): void
Set the camera's x position (cannot be set when following an Actor or when moving)
Parameters
- value: number
Returns void
- Defined in Camera.ts:372

y

get y(): number
Get the camera's y position

Returns number
- Defined in Camera.ts:381
set y(value: number): void
Set the camera's y position (cannot be set when following an Actor or when moving)
Parameters
- value: number
Returns void
- Defined in Camera.ts:388

zoom

get zoom(): number
Returns number
- Defined in Camera.ts:270
set zoom(val: number): void
Parameters
- val: number
Returns void
- Defined in Camera.ts:274

Methods

_initialize

_initialize(_engine: Engine): void
Parameters
- _engine: Engine
Returns void
- Defined in Camera.ts:604

_postupdate

_postupdate(engine: Engine, delta: number): void
Internal
It is not recommended that internal excalibur methods be overridden, do so at your own risk.

Internal _preupdate handler for onPostUpdate lifecycle event
Parameters
- engine: Engine
- delta: number
Returns void
- Defined in Camera.ts:583

_preupdate

_preupdate(engine: Engine, delta: number): void
Internal
It is not recommended that internal excalibur methods be overridden, do so at your own risk.

Internal _preupdate handler for onPreUpdate lifecycle event
Parameters
- engine: Engine
- delta: number
Returns void
- Defined in Camera.ts:563

addStrategy

addStrategy<T>(cameraStrategy: CameraStrategy<T>): void
Adds a new camera strategy to this camera
Type Parameters
- T
Parameters
- cameraStrategy: CameraStrategy<T>
  
  Instance of an CameraStrategy
Returns void
- Defined in Camera.ts:538

clearAllStrategies

clearAllStrategies(): void
Clears all camera strategies from the camera

Returns void
- Defined in Camera.ts:553

draw

draw(ctx: ExcaliburGraphicsContext): void
Applies the relevant transformations to the game canvas to "move" or apply effects to the Camera
Parameters
- ctx: ExcaliburGraphicsContext
  
  Canvas context to apply transformations
Returns void
- Defined in Camera.ts:776

emit

emit<TEventName>(eventName: TEventName, event: CameraEvents[TEventName]): void
Type Parameters
- TEventName extends EventKey<CameraEvents>
Parameters
- eventName: TEventName
- event: CameraEvents[TEventName]
Returns void
- Defined in Camera.ts:656
emit(eventName: string, event?: any): void
Parameters
- eventName: string
- Optional event: any
Returns void
- Defined in Camera.ts:657

getFocus

getFocus(): Vector
Returns the focal point of the camera, a new point giving the x and y position of the camera

Returns Vector
- Defined in Camera.ts:441

move

move(pos: Vector, duration: number, easingFn??: Util.EasingFunction): Promise<Vector>
This moves the camera focal point to the specified position using specified easing function. Cannot move when following an Actor.

Returns
A Promise that resolves when movement is finished, including if it's interrupted. The Promise value is the Vector of the target position. It will be rejected if a move cannot be made.
Parameters
- pos: Vector
  
  The target position to move to
- duration: number
  
  The duration in milliseconds the move should last
- Optional easingFn: Util.EasingFunction = EasingFunctions.EaseInOutCubic
  
  An optional easing function (ex.EasingFunctions.EaseInOutCubic by default)
Returns Promise<Vector>
- Defined in Camera.ts:454

off

off<TEventName>(eventName: TEventName, handler: Handler<CameraEvents[TEventName]>): void
Type Parameters
- TEventName extends EventKey<CameraEvents>
Parameters
- eventName: TEventName
- handler: Handler<CameraEvents[TEventName]>
Returns void
Implementation of CanInitialize.off
- Defined in Camera.ts:674
off(eventName: string, handler: Handler<unknown>): void
Parameters
- eventName: string
- handler: Handler<unknown>
Returns void
Implementation of CanUpdate.off
- Defined in Camera.ts:675
off(eventName: string): void
Parameters
- eventName: string
Returns void
Implementation of CanUpdate.off
- Defined in Camera.ts:676

on

on<TEventName>(eventName: TEventName, handler: Handler<CameraEvents[TEventName]>): Subscription
Event signature
Type Parameters
- TEventName extends EventKey<CameraEvents>
Parameters
- eventName: TEventName
- handler: Handler<CameraEvents[TEventName]>
Returns Subscription
Implementation of CanInitialize.on
- Defined in Camera.ts:662
on(eventName: string, handler: Handler<unknown>): Subscription
Event signatures
Parameters
- eventName: string
- handler: Handler<unknown>
Returns Subscription
Implementation of CanUpdate.on
- Defined in Camera.ts:663

onInitialize

onInitialize(_engine: Engine): void
Safe to override onPostUpdate lifecycle event handler. Synonymous with .on('preupdate', (evt) =>{...})

onPostUpdate is called directly after a scene is updated.
Parameters
- _engine: Engine
Returns void
Implementation of CanInitialize.onInitialize
- Defined in Camera.ts:652

onPostUpdate

onPostUpdate(_engine: Engine, _delta: number): void
Safe to override onPostUpdate lifecycle event handler. Synonymous with .on('preupdate', (evt) =>{...})

onPostUpdate is called directly after a scene is updated.
Parameters
- _engine: Engine
- _delta: number
Returns void
Implementation of CanUpdate.onPostUpdate
- Defined in Camera.ts:593

onPreUpdate

onPreUpdate(_engine: Engine, _delta: number): void
Safe to override onPreUpdate lifecycle event handler. Synonymous with .on('preupdate', (evt) =>{...})

onPreUpdate is called directly before a scene is updated.
Parameters
- _engine: Engine
- _delta: number
Returns void
Implementation of CanUpdate.onPreUpdate
- Defined in Camera.ts:573

once

once<TEventName>(eventName: TEventName, handler: Handler<CameraEvents[TEventName]>): Subscription
Type Parameters
- TEventName extends EventKey<CameraEvents>
Parameters
- eventName: TEventName
- handler: Handler<CameraEvents[TEventName]>
Returns Subscription
Implementation of CanInitialize.once
- Defined in Camera.ts:668
once(eventName: string, handler: Handler<unknown>): Subscription
Parameters
- eventName: string
- handler: Handler<unknown>
Returns Subscription
Implementation of CanUpdate.once
- Defined in Camera.ts:669

removeStrategy

removeStrategy<T>(cameraStrategy: CameraStrategy<T>): void
Removes a camera strategy by reference
Type Parameters
- T
Parameters
- cameraStrategy: CameraStrategy<T>
  
  Instance of an CameraStrategy
Returns void
- Defined in Camera.ts:546

runStrategies

runStrategies(engine: Engine, delta: number): void
Parameters
- engine: Engine
- delta: number
Returns void
- Defined in Camera.ts:681

shake

shake(magnitudeX: number, magnitudeY: number, duration: number): void
Sets the camera to shake at the specified magnitudes for the specified duration
Parameters
- magnitudeX: number
  
  The x magnitude of the shake
- magnitudeY: number
  
  The y magnitude of the shake
- duration: number
  
  The duration of the shake in milliseconds
Returns void
- Defined in Camera.ts:488

update

update(_engine: Engine, delta: number): void
Parameters
- _engine: Engine
- delta: number
Returns void
- Defined in Camera.ts:697

updateTransform

updateTransform(): void
Returns void
- Defined in Camera.ts:780

updateViewport

updateViewport(): void
Returns void
- Defined in Camera.ts:687

zoomOverTime

zoomOverTime(scale: number, duration?: number, easingFn?: Util.EasingFunction): Promise<boolean>
Zooms the camera in or out by the specified scale over the specified duration. If no duration is specified, it take effect immediately.
Parameters
- scale: number
  
  The scale of the zoom
- duration: number = 0
  
  The duration of the zoom in milliseconds
- easingFn: Util.EasingFunction = EasingFunctions.EaseInOutCubic
Returns Promise<boolean>
- Defined in Camera.ts:501

Class Camera

Hierarchy

Implements

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Returns Camera

Properties

Protected _follow

Protected _isShaking

Protected _isZooming

acc

az

dz

events

inverse

rotation

strategy

transform

vel

Accessors

angularVelocity

Returns number

Parameters

value: number

Returns void

ax

Returns number

Parameters

value: number

Returns void

ay

Returns number

Parameters

value: number

Returns void

dx

Returns number

Parameters

value: number

Returns void

dy

Returns number

Parameters

value: number

Returns void

isInitialized

Returns boolean

pos

Returns Vector

Parameters

vec: Vector

Returns void

viewport

Returns BoundingBox

x

Returns number

Parameters

value: number

Returns void

y

Returns number

Parameters

value: number

Returns void

zoom

Returns number

Parameters

val: number

Returns void

Methods

_initialize

Parameters

_engine: Engine

Returns void

_postupdate

`Protected` _follow

`Protected` _isShaking

`Protected` _isZooming

`Optional` event: any

`Optional` easingFn: Util.EasingFunction = EasingFunctions.EaseInOutCubic