Class: MapCanvasLayer<P, C>

A layer which uses a canvas to draw graphics.

Type parameters

Name	Type
P	extends MapCanvasLayerProps<any> = MapCanvasLayerProps<any>
C	extends MapCanvasLayerCanvasInstance = MapCanvasLayerCanvasInstance

Hierarchy

• MapLayer<P>

  ↳ MapCanvasLayer

  ↳↳ MapCachedCanvasLayer

  ↳↳ MapSyncedCanvasLayer

Constructors

constructor

• new MapCanvasLayer<P, C>(props): MapCanvasLayer<P, C>

Creates an instance of a DisplayComponent.

Type parameters

Name	Type
P	extends MapCanvasLayerProps<any> = MapCanvasLayerProps<any>
C	extends MapCanvasLayerCanvasInstance = MapCanvasLayerCanvasInstance

Parameters

Name	Type	Description
props	P	The propertis of the component.

Returns

MapCanvasLayer<P, C>

Inherited from

MapLayer.constructor

Defined in

src/sdk/components/FSComponent.ts:73

Properties

context

• Optional context: [] = undefined

The context on this component, if any.

Inherited from

MapLayer.context

Defined in

src/sdk/components/FSComponent.ts:64

---

contextType

• Optional Readonly contextType: readonly [] = undefined

The type of context for this component, if any.

Inherited from

MapLayer.contextType

Defined in

src/sdk/components/FSComponent.ts:67

---

isInit

• Protected isInit: boolean = false

Defined in

src/sdk/components/map/layers/MapCanvasLayer.tsx:78

---

props

• props: P & ComponentProps

The properties of the component.

Inherited from

MapLayer.props

Defined in

src/sdk/components/FSComponent.ts:61

Accessors

buffer

• get buffer(): C

Gets this layer's buffer canvas instance.

Returns

C

This layer's buffer canvas instance.

Throws

Error if this layer's buffer canvas instance has not been initialized.

Defined in

src/sdk/components/map/layers/MapCanvasLayer.tsx:98

---

display

• get display(): C

Gets this layer's display canvas instance.

Returns

C

This layer's display canvas instance.

Throws

Error if this layer's display canvas instance has not been initialized.

Defined in

src/sdk/components/map/layers/MapCanvasLayer.tsx:85

Methods

copyBufferToDisplay

▸ copyBufferToDisplay(): void

Copies the contents of the buffer to the display. Has no effect if this layer does not have a buffer.

Returns

void

Defined in

src/sdk/components/map/layers/MapCanvasLayer.tsx:171

---

createCanvasInstance

▸ createCanvasInstance(canvas, context, isDisplayed): C

Creates a canvas instance.

Parameters

Name	Type	Description
canvas	HTMLCanvasElement	The canvas element.
context	CanvasRenderingContext2D	The canvas 2D rendering context.
isDisplayed	boolean	Whether the canvas is displayed.

Returns

C

a canvas instance.

Defined in

src/sdk/components/map/layers/MapCanvasLayer.tsx:227

---

destroy

▸ destroy(): void

Destroys this component.

Returns

void

Inherited from

MapLayer.destroy

Defined in

src/sdk/components/FSComponent.ts:98

---

getContext

▸ getContext(context): never

Gets a context data subscription from the context collection.

Parameters

Name	Type	Description
context	never	The context to get the subscription for.

Returns

never

The requested context.

Throws

An error if no data for the specified context type could be found.

Inherited from

MapLayer.getContext

Defined in

src/sdk/components/FSComponent.ts:106

---

getHeight

▸ getHeight(): number

Gets the height of the canvas element, in pixels.

Returns

number

the height of the canvas element.

Defined in

src/sdk/components/map/layers/MapCanvasLayer.tsx:134

---

getWidth

▸ getWidth(): number

Gets the width of the canvas element, in pixels.

Returns

number

the width of the canvas element.

Defined in

src/sdk/components/map/layers/MapCanvasLayer.tsx:126

---

isVisible

▸ isVisible(): boolean

Checks whether this layer is visible.

Returns

boolean

whether this layer is visible.

Inherited from

MapLayer.isVisible

Defined in

src/sdk/components/map/MapLayer.ts:38

---

onAfterRender

▸ onAfterRender(): void

A callback called after the component renders.

Returns

void

Overrides

MapLayer.onAfterRender

Defined in

src/sdk/components/map/layers/MapCanvasLayer.tsx:182

---

onAttached

▸ onAttached(): void

This method is called when this layer is attached to its parent map component.

Returns

void

Overrides

MapLayer.onAttached

Defined in

src/sdk/components/map/layers/MapCanvasLayer.tsx:201

---

onBeforeRender

▸ onBeforeRender(): void

A callback that is called before the component is rendered.

Returns

void

Inherited from

MapLayer.onBeforeRender

Defined in

src/sdk/components/FSComponent.ts:80

---

onDetached

▸ onDetached(): void

This method is called when this layer is detached from its parent map component.

Returns

void

Inherited from

MapLayer.onDetached

Defined in

src/sdk/components/map/MapLayer.ts:108

---

onMapProjectionChanged

▸ onMapProjectionChanged(mapProjection, changeFlags): void

This method is called when the map projection changes.

Parameters

Name	Type	Description
mapProjection	MapProjection	this layer's map projection.
changeFlags	number	The types of changes made to the projection.

Returns

void

Inherited from

MapLayer.onMapProjectionChanged

Defined in

src/sdk/components/map/MapLayer.ts:91

---

onSleep

▸ onSleep(): void

This method is called when this layer's parent map is put to sleep.

Returns

void

Inherited from

MapLayer.onSleep

Defined in

src/sdk/components/map/MapLayer.ts:81

---

onUpdated

▸ onUpdated(time, elapsed): void

This method is called once every map update cycle.

Parameters

Name	Type	Description
time	number	The current time as a UNIX timestamp.
elapsed	number	The elapsed time, in milliseconds, since the last update.

Returns

void

Inherited from

MapLayer.onUpdated

Defined in

src/sdk/components/map/MapLayer.ts:101

---

onVisibilityChanged

▸ onVisibilityChanged(isVisible): void

This method is called when this layer's visibility changes.

Parameters

Name	Type	Description
isVisible	boolean	Whether the layer is now visible.

Returns

void

Overrides

MapLayer.onVisibilityChanged

Defined in

src/sdk/components/map/layers/MapCanvasLayer.tsx:187

---

onWake

▸ onWake(): void

This method is called when this layer's parent map is woken.

Returns

void

Inherited from

MapLayer.onWake

Defined in

src/sdk/components/map/MapLayer.ts:74

---

render

▸ render(): null | VNode

Renders the component.

Returns

null | VNode

A JSX element to be rendered.

Overrides

MapLayer.render

Defined in

src/sdk/components/map/layers/MapCanvasLayer.tsx:256

---

setHeight

▸ setHeight(height): void

Sets the height of the canvas element, in pixels.

Parameters

Name	Type	Description
height	number	The new height.

Returns

void

Defined in

src/sdk/components/map/layers/MapCanvasLayer.tsx:157

---

setVisible

▸ setVisible(val): void

Sets this layer's visibility.

Parameters

Name	Type	Description
val	boolean	Whether this layer should be visible.

Returns

void

Inherited from

MapLayer.setVisible

Defined in

src/sdk/components/map/MapLayer.ts:46

---

setWidth

▸ setWidth(width): void

Sets the width of the canvas element, in pixels.

Parameters

Name	Type	Description
width	number	The new width.

Returns

void

Defined in

src/sdk/components/map/layers/MapCanvasLayer.tsx:142

---

tryGetBuffer

▸ tryGetBuffer(): undefined | C

Attempts to get this layer's buffer canvas instance.

Returns

undefined | C

This layer's buffer canvas instance, or undefined if it has not been initialized.

Defined in

src/sdk/components/map/layers/MapCanvasLayer.tsx:118

---

tryGetDisplay

▸ tryGetDisplay(): undefined | C

Attempts to get this layer's display canvas instance.

Returns

undefined | C

This layer's display canvas instance, or undefined if it has not been initialized.

Defined in

src/sdk/components/map/layers/MapCanvasLayer.tsx:110

---

updateCanvasSize

▸ updateCanvasSize(): void

Updates the canvas element's size.

Returns

void

Defined in

src/sdk/components/map/layers/MapCanvasLayer.tsx:234

---

updateFromVisibility

▸ updateFromVisibility(): void

Updates this layer according to its current visibility.

Returns

void

Defined in

src/sdk/components/map/layers/MapCanvasLayer.tsx:196