Skip to main content

Class: MapCullableLocationTextLabel

Defined in: src/sdk/components/map/MapCullableTextLabel.ts:32

A cullable (hides labels that collide with other labels) text label associated with a specific geographic location.

Extends​

Implements​

Constructors​

Constructor​

new MapCullableLocationTextLabel(text, priority, location, alwaysShow, options?): MapCullableLocationTextLabel

Defined in: src/sdk/components/map/MapCullableTextLabel.ts:52

Constructor.

Parameters​

ParameterTypeDescription
textstring | Subscribable<string>The text of this label, or a subscribable which provides it.
prioritynumber | Subscribable<number>The priority of this label, or a subscribable which provides it.
locationGeoPointInterface | Subscribable<GeoPointInterface>The geographic location of this label, or a subscribable which provides it.
alwaysShowboolean | Subscribable<boolean>Whether this label is immune to culling, or a subscribable which provides it.
options?MapLocationTextLabelOptionsOptions with which to initialize this label.

Returns​

MapCullableLocationTextLabel

Overrides​

MapLocationTextLabel.constructor

Properties​

alwaysShow​

readonly alwaysShow: Subscribable<boolean>

Defined in: src/sdk/components/map/MapCullableTextLabel.ts:34

Whether this label is immune to culling.

Implementation of​

MapCullableTextLabel.alwaysShow


anchor​

readonly anchor: Subscribable<Readonly<Omit<Float64Array, "set" | "sort" | "copyWithin">>>

Defined in: src/sdk/components/map/MapTextLabel.ts:89

The anchor point of this label, expressed relative to this label's width/height. [0, 0] is the top-left corner, and [1, 1] is the bottom-right corner.

Inherited from​

MapLocationTextLabel.anchor


bgBorderRadius​

readonly bgBorderRadius: Subscribable<number>

Defined in: src/sdk/components/map/MapTextLabel.ts:116

The border radius of this label's background.

Inherited from​

MapLocationTextLabel.bgBorderRadius


bgColor​

readonly bgColor: Subscribable<string>

Defined in: src/sdk/components/map/MapTextLabel.ts:110

This label's background color.

Inherited from​

MapLocationTextLabel.bgColor


bgOutlineColor​

readonly bgOutlineColor: Subscribable<string>

Defined in: src/sdk/components/map/MapTextLabel.ts:122

The outline color of this label's background.

Inherited from​

MapLocationTextLabel.bgOutlineColor


bgOutlineWidth​

readonly bgOutlineWidth: Subscribable<number>

Defined in: src/sdk/components/map/MapTextLabel.ts:119

The outline width of this label's background.

Inherited from​

MapLocationTextLabel.bgOutlineWidth


bgPadding​

readonly bgPadding: Subscribable<Readonly<Omit<Float64Array, "set" | "sort" | "copyWithin">>>

Defined in: src/sdk/components/map/MapTextLabel.ts:113

The padding of this label's background, in pixels. Expressed as [top, right, bottom, left].

Inherited from​

MapLocationTextLabel.bgPadding


bounds​

readonly bounds: Float64Array

Defined in: src/sdk/components/map/MapCullableTextLabel.ts:37

The bounding box of this label.

Implementation of​

MapCullableTextLabel.bounds


font​

readonly font: Subscribable<string>

Defined in: src/sdk/components/map/MapTextLabel.ts:92

The font type of this label.

Inherited from​

MapLocationTextLabel.font


fontColor​

readonly fontColor: Subscribable<string>

Defined in: src/sdk/components/map/MapTextLabel.ts:98

The font color of this label.

Inherited from​

MapLocationTextLabel.fontColor


fontOutlineColor​

readonly fontOutlineColor: Subscribable<string>

Defined in: src/sdk/components/map/MapTextLabel.ts:104

The font outline color of this label.

Inherited from​

MapLocationTextLabel.fontOutlineColor


fontOutlineWidth​

readonly fontOutlineWidth: Subscribable<number>

Defined in: src/sdk/components/map/MapTextLabel.ts:101

The font outline width of this label, in pixels.

Inherited from​

MapLocationTextLabel.fontOutlineWidth


fontSize​

readonly fontSize: Subscribable<number>

Defined in: src/sdk/components/map/MapTextLabel.ts:95

The font size of this label, in pixels.

Inherited from​

MapLocationTextLabel.fontSize


invalidation​

readonly invalidation: SubEventInterface<MapCullableLocationTextLabel, void>

Defined in: src/sdk/components/map/MapCullableTextLabel.ts:40

An invalidation event.

Implementation of​

MapCullableTextLabel.invalidation


location​

readonly location: Subscribable<GeoPointInterface>

Defined in: src/sdk/components/map/MapTextLabel.ts:314

Inherited from​

MapLocationTextLabel.location


offset​

readonly offset: Subscribable<Readonly<Omit<Float64Array, "set" | "sort" | "copyWithin">>>

Defined in: src/sdk/components/map/MapTextLabel.ts:316

Inherited from​

MapLocationTextLabel.offset


priority​

readonly priority: Subscribable<number>

Defined in: src/sdk/components/map/MapTextLabel.ts:83

The render priority of this label. Higher numbers will render on top of labels with lower numbers when used with a MapCullableTextLabelManager.

Implementation of​

MapCullableTextLabel.priority

Inherited from​

MapLocationTextLabel.priority


showBg​

readonly showBg: Subscribable<boolean>

Defined in: src/sdk/components/map/MapTextLabel.ts:107

Whether to show the background for this label.

Inherited from​

MapLocationTextLabel.showBg


text​

readonly text: Subscribable<string>

Defined in: src/sdk/components/map/MapTextLabel.ts:80

The text of this label.

Implementation of​

MapCullableTextLabel.text

Inherited from​

MapLocationTextLabel.text


tempVec2​

protected readonly static tempVec2: Float64Array

Defined in: src/sdk/components/map/MapTextLabel.ts:77

Inherited from​

MapLocationTextLabel.tempVec2

Methods​

destroy()​

destroy(): void

Defined in: src/sdk/components/map/MapCullableTextLabel.ts:107

Destroys this label.

Returns​

void


draw()​

draw(context, mapProjection): void

Defined in: src/sdk/components/map/MapTextLabel.ts:157

Draws this label to a canvas.

Parameters​

ParameterTypeDescription
contextCanvasRenderingContext2DThe canvas rendering context to use to draw.
mapProjectionMapProjectionThe projection to use to project the location of the label.

Returns​

void

Implementation of​

MapCullableTextLabel.draw

Inherited from​

MapLocationTextLabel.draw


drawBackground()​

protected drawBackground(context, centerX, centerY, width, height): void

Defined in: src/sdk/components/map/MapTextLabel.ts:230

Draws this label's background to a canvas.

Parameters​

ParameterTypeDescription
contextCanvasRenderingContext2DThe canvas rendering context.
centerXnumberThe x-coordinate of the center of the label, in pixels.
centerYnumberthe y-coordinate of the center of the label, in pixels.
widthnumberThe width of the background, in pixels.
heightnumberThe height of the background, in pixels.

Returns​

void

Inherited from​

MapLocationTextLabel.drawBackground


drawText()​

protected drawText(context, centerX, centerY): void

Defined in: src/sdk/components/map/MapTextLabel.ts:209

Draws this label's text to a canvas.

Parameters​

ParameterTypeDescription
contextCanvasRenderingContext2DThe canvas rendering context.
centerXnumberThe x-coordinate of the center of the label, in pixels.
centerYnumberthe y-coordinate of the center of the label, in pixels.

Returns​

void

Inherited from​

MapLocationTextLabel.drawText


getPosition()​

protected getPosition(mapProjection, out): Float64Array

Defined in: src/sdk/components/map/MapTextLabel.ts:338

Gets the projected position of the label, in pixels.

Parameters​

ParameterTypeDescription
mapProjectionMapProjectionThe map projection to use.
outFloat64ArrayThe vector to which to write the result.

Returns​

Float64Array

The projected position of the label.

Inherited from​

MapLocationTextLabel.getPosition


loadBackgroundPath()​

protected loadBackgroundPath(context, left, top, width, height, radius): void

Defined in: src/sdk/components/map/MapTextLabel.ts:278

Loads the path of this label's background to a canvas rendering context.

Parameters​

ParameterTypeDescription
contextCanvasRenderingContext2DThe canvas rendering context to use.
leftnumberThe x-coordinate of the left edge of the background, in pixels.
topnumberThe y-coordinate of the top edge of the background, in pixels.
widthnumberThe width of the background, in pixels.
heightnumberThe height of the background, in pixels.
radiusnumberThe border radius of the background, in pixels.

Returns​

void

Inherited from​

MapLocationTextLabel.loadBackgroundPath


setTextStyle()​

protected setTextStyle(context): void

Defined in: src/sdk/components/map/MapTextLabel.ts:197

Loads this label's text style to a canvas rendering context.

Parameters​

ParameterTypeDescription
contextCanvasRenderingContext2DThe canvas rendering context to use.

Returns​

void

Inherited from​

MapLocationTextLabel.setTextStyle


updateBounds()​

updateBounds(mapProjection): void

Defined in: src/sdk/components/map/MapCullableTextLabel.ts:75

Updates this label's bounding box.

Parameters​

ParameterTypeDescription
mapProjectionMapProjectionThe map projection to use.

Returns​

void

Implementation of​

MapCullableTextLabel.updateBounds