Skip to main content

Interface: CameraEcsComponent

Defined in: rendering/components/camera-component.ts:84

Fields of CameraEcsComponent with a sensible default; callers may omit these.

Extends​

Properties​

clearColor​

clearColor: Color

Defined in: rendering/components/camera-component.ts:72

The clear color

Inherited from​

CameraDefaultedOptions.clearColor


cullingMask​

cullingMask: number

Defined in: rendering/components/camera-component.ts:57

A bitmask matched against each sprite's Renderable.category (matchesMask) to decide whether this camera draws it. Defaults to 0xffffffff (every category) in addCameraComponent.

Inherited from​

CameraDefaultedOptions.cullingMask


isStatic​

isStatic: boolean

Defined in: rendering/components/camera-component.ts:50

When true, this camera ignores zoomInput and panInput entirely (createCameraEcsSystem returns early for it). Use for cameras whose position and zoom are driven by other means, or that should never move.

Inherited from​

CameraDefaultedOptions.isStatic


layer​

layer: number

Defined in: rendering/components/camera-component.ts:67

The draw-order layer for this camera's renderTarget, relative to other cameras presented in the same frame: lower layers are presented (and thus drawn onto the canvas) first, so higher layers appear on top. Only meaningful between cameras with different render targets; has no effect on cameras that share one (they're already composited together before presenting) or that render straight to the canvas.

Inherited from​

CameraDefaultedOptions.layer


maxZoom​

maxZoom: number

Defined in: rendering/components/camera-component.ts:43

The upper bound zoom is clamped to.

Inherited from​

CameraDefaultedOptions.maxZoom


minZoom​

minZoom: number

Defined in: rendering/components/camera-component.ts:38

The lower bound zoom is clamped to.

Inherited from​

CameraDefaultedOptions.minZoom


panInput?​

optional panInput?: Axis2dAction

Defined in: rendering/components/camera-component.ts:101

The 2D input action that drives panning (the camera's local position), if any. Ignored while isStatic is true.


panSensitivity​

panSensitivity: number

Defined in: rendering/components/camera-component.ts:33

How strongly panInput moves the camera's position. Scaled by the inverse of the current zoom, so panning covers the same apparent distance on screen at any zoom level.

Inherited from​

CameraDefaultedOptions.panSensitivity


renderTarget?​

optional renderTarget?: RenderTarget

Defined in: rendering/components/camera-component.ts:108

When set, this camera renders into the given off-screen render target instead of directly onto the canvas. A present pass is then responsible for drawing the target's color texture onto the canvas.


scissorRect?​

optional scissorRect?: Rect

Defined in: rendering/components/camera-component.ts:89

When set, restricts this camera's draw output to the given rectangular region instead of its full destination.


verticalWorldUnits​

verticalWorldUnits: number

Defined in: rendering/components/camera-component.ts:81

The total height, in world units, this camera's view spans vertically. Horizontal extent follows automatically from the destination's aspect ratio, so the same verticalWorldUnits shows the same amount of the world vertically regardless of window size/shape (see calculatePixelsPerUnit). Defaults to 10.

Inherited from​

CameraDefaultedOptions.verticalWorldUnits


zoom​

zoom: number

Defined in: rendering/components/camera-component.ts:19

The current zoom level. Higher values zoom in (the view covers less of the world); lower values zoom out. Adjusted by zoomInput (via zoomSensitivity) when the camera isn't isStatic, and clamped to [minZoom, maxZoom].

Inherited from​

CameraDefaultedOptions.zoom


zoomInput?​

optional zoomInput?: Axis1dAction

Defined in: rendering/components/camera-component.ts:95

The 1D input action that drives zoom changes, if any. Ignored while isStatic is true.


zoomSensitivity​

zoomSensitivity: number

Defined in: rendering/components/camera-component.ts:26

How strongly zoomInput changes zoom. Applied exponentially (see createCameraEcsSystem) so scrolling has a consistent relative effect regardless of the current zoom level.

Inherited from​

CameraDefaultedOptions.zoomSensitivity