Skip to main content

Class: MapSystemWaypointsRenderer

Defined in: src/sdk/components/mapsystem/MapSystemWaypointsRenderer.ts:15

A waypoint renderer for the MapSystem API. Supports addition of string-keyed render roles. Each render role is assigned a position in an ordered list that determines the priority of being chosen when roles are selected for rendering waypoints. For each waypoint, the renderer iterates through all render roles in the priority order list and selects the first role under which the waypoint is registered and is visible.

Extends

Constructors

Constructor

new MapSystemWaypointsRenderer(textManager): MapSystemWaypointsRenderer

Defined in: src/sdk/components/mapsystem/MapSystemWaypointsRenderer.ts:33

Constructor.

Parameters

ParameterTypeDescription
textManagerMapCullableTextLabelManagerThe text manager to use for waypoint labels.

Returns

MapSystemWaypointsRenderer

Overrides

MapWaypointRenderer.constructor

Properties

currentBit

protected currentBit: number = 1

Defined in: src/sdk/components/mapsystem/MapSystemWaypointsRenderer.ts:24


onRolesAdded

readonly onRolesAdded: SubEvent<MapSystemWaypointsRenderer, void>

Defined in: src/sdk/components/mapsystem/MapSystemWaypointsRenderer.ts:27

An event that fires when any roles are added.


onWaypointAdded

readonly onWaypointAdded: SubEvent<any, Waypoint>

Defined in: src/sdk/components/map/MapWaypointRenderer.ts:128

An event to subscribe to, fired when waypoints are added to the renderer.

Inherited from

MapWaypointRenderer.onWaypointAdded


onWaypointRemoved

readonly onWaypointRemoved: SubEvent<any, Waypoint>

Defined in: src/sdk/components/map/MapWaypointRenderer.ts:133

An event to subscribe to, fired when waypoints are removed from the render.

Inherited from

MapWaypointRenderer.onWaypointRemoved


registered

protected readonly registered: Map<string, MapWaypointRendererEntry<Waypoint>>

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

Inherited from

MapWaypointRenderer.registered


roleDefinitions

protected readonly roleDefinitions: Map<number, MapWaypointRenderRoleDef<Waypoint>>

Defined in: src/sdk/components/map/MapWaypointRenderer.ts:123

This renderer's render role definitions. Waypoints assigned to be rendered under a role or combination of roles with no definition will not be rendered.

Inherited from

MapWaypointRenderer.roleDefinitions


roleIdMap

protected readonly roleIdMap: Map<string, number>

Defined in: src/sdk/components/mapsystem/MapSystemWaypointsRenderer.ts:23


rolePriorityOrder

protected readonly rolePriorityOrder: number[] = []

Defined in: src/sdk/components/mapsystem/MapSystemWaypointsRenderer.ts:19


rolesByGroup

protected readonly rolesByGroup: Map<string, string[]>

Defined in: src/sdk/components/mapsystem/MapSystemWaypointsRenderer.ts:21


selectRoleToRender

protected readonly selectRoleToRender: MapWaypointRenderRoleSelector<Waypoint> = MapWaypointRenderer.DEFAULT_RENDER_ROLE_SELECTOR

Defined in: src/sdk/components/map/MapWaypointRenderer.ts:143

A function which selects roles under which to render waypoints. Defaults to MapWaypointRenderer.DEFAULT_RENDER_ROLE_SELECTOR.

Inherited from

MapWaypointRenderer.selectRoleToRender


textManager

protected readonly textManager: MapCullableTextLabelManager

Defined in: src/sdk/components/map/MapWaypointRenderer.ts:142

The text manager to use for waypoint labels.

Inherited from

MapWaypointRenderer.textManager


toCleanUp

protected readonly toCleanUp: Set<MapWaypointRendererEntry<Waypoint>>

Defined in: src/sdk/components/map/MapWaypointRenderer.ts:117

Inherited from

MapWaypointRenderer.toCleanUp


DefaultGroup

readonly static DefaultGroup: "DEFAULT_GROUP" = 'DEFAULT_GROUP'

Defined in: src/sdk/components/mapsystem/MapSystemWaypointsRenderer.ts:17

The default render role group.


NULL_ROLE_DEF

protected readonly static NULL_ROLE_DEF: object

Defined in: src/sdk/components/map/MapWaypointRenderer.ts:73

A null render role definition. Icons rendered under this role are never visible.

canvasContext

canvasContext: null = null

iconFactory

iconFactory: null = null

labelFactory

labelFactory: null = null

visibilityHandler()

visibilityHandler: () => boolean

Returns

boolean

Inherited from

MapWaypointRenderer.NULL_ROLE_DEF

Methods

addRenderRole()

Call Signature

addRenderRole(role, def?): false

Defined in: src/sdk/components/mapsystem/MapSystemWaypointsRenderer.ts:55

This method is disabled. Please use the addRenderRole(name: string, def: MapWaypointRenderRoleDef<Waypoint>, group?: string) overload to add render roles to this renderer.

Parameters
ParameterTypeDescription
rolenumberThe render role to add.
def?MapWaypointRenderRoleDef<Waypoint>The render role's definition.
Returns

false

false.

Overrides

MapWaypointRenderer.addRenderRole

Call Signature

addRenderRole(name, def?, group?): boolean

Defined in: src/sdk/components/mapsystem/MapSystemWaypointsRenderer.ts:67

Adds a new named render role to this renderer. The new render role will be placed at the end of this renderer's render role selection priority order. Roles positioned earlier in the order have a higher priority for being chosen when roles are selected for rendering waypoints.

Parameters
ParameterTypeDescription
namestringThe name of the render role to add.
def?MapWaypointRenderRoleDef<Waypoint>The render role's definition. If undefined, the new role will be assigned a default definition with no defined rendering context, icon, or label factories, and a visibility handler which always returns true.
group?stringThe group in which to include the new render role, if any. Defaults to MapSystemWaypointsRenderer.DefaultGroup.
Returns

boolean

Whether the role was successfully added.

Overrides

MapWaypointRenderer.addRenderRole


clearRenderRoles()

clearRenderRoles(): void

Defined in: src/sdk/components/map/MapWaypointRenderer.ts:205

Removes all render roles from this renderer.

Returns

void

Inherited from

MapWaypointRenderer.clearRenderRoles


deregister()

deregister(waypoint, role, sourceId): void

Defined in: src/sdk/components/map/MapWaypointRenderer.ts:334

Removes a registration for a waypoint for a specific role or roles. Once all of a waypoint's registrations for a role are removed, it will no longer be rendered in that role the next this renderer's update() method is called.

Parameters

ParameterTypeDescription
waypointWaypointThe waypoint to deregister.
rolenumberThe role(s) from which the waypoint should be deregistered.
sourceIdstringThe unique string ID for the source of the registration to remove.

Returns

void

Inherited from

MapWaypointRenderer.deregister


getNearestWaypoint()

getNearestWaypoint<T>(pos, first?): undefined | T

Defined in: src/sdk/components/map/MapWaypointRenderer.ts:405

Gets the nearest waypoint currently registered in the renderer.

Type Parameters

Type ParameterDefault type
T extends WaypointWaypoint

Parameters

ParameterTypeDescription
posLatLonInterfaceThe position to get the closest waypoint to.
first?(waypoint) => booleanA predicate that will search the list of closest waypoints for a match, and return the first one found.

Returns

undefined | T

The nearest waypoint, or undefined if none found.

Inherited from

MapWaypointRenderer.getNearestWaypoint


getRenderRoleDefinition()

getRenderRoleDefinition(role): undefined | Readonly<MapWaypointRenderRoleDef<Waypoint>>

Defined in: src/sdk/components/map/MapWaypointRenderer.ts:189

Gets the definition for a render role.

Parameters

ParameterTypeDescription
rolenumberA render role.

Returns

undefined | Readonly<MapWaypointRenderRoleDef<Waypoint>>

The definition for the specified render role, or undefined if no such role has been added to this renderer.

Inherited from

MapWaypointRenderer.getRenderRoleDefinition


getRoleFromName()

getRoleFromName(name): undefined | number

Defined in: src/sdk/components/mapsystem/MapSystemWaypointsRenderer.ts:126

Gets a render role associated with a name.

Parameters

ParameterTypeDescription
namestringThe name of the role.

Returns

undefined | number

The render role associated with the specified name, or undefined if there is no such role.


getRoleNamesByGroup()

getRoleNamesByGroup(group): readonly string[]

Defined in: src/sdk/components/mapsystem/MapSystemWaypointsRenderer.ts:135

Gets the names of roles in a specified group.

Parameters

ParameterTypeDescription
groupstringA render role group.

Returns

readonly string[]

An array of the names of all render roles belonging to the specified group.


hasRenderRole()

hasRenderRole(role): boolean

Defined in: src/sdk/components/map/MapWaypointRenderer.ts:152

Checks whether a render role has been added to this renderer.

Parameters

ParameterTypeDescription
rolenumberThe render role to check.

Returns

boolean

Whether the render role has been added to this renderer.

Inherited from

MapWaypointRenderer.hasRenderRole


insertRenderRole()

insertRenderRole(name, insertBefore, def?, group?): boolean

Defined in: src/sdk/components/mapsystem/MapSystemWaypointsRenderer.ts:105

Adds a new named render role to this renderer and inserts it before an existing render role in this renderer's render role selection priority order. Roles positioned earlier in the order have a higher priority for being chosen when roles are selected for rendering waypoints.

Parameters

ParameterTypeDefault valueDescription
namestringundefinedThe name of the render role to add.
insertBeforestringundefinedThe name of the role before which to insert the new role in this renderer's render role selection priority order. If the name does not match any of this renderer's existing render roles, the new role will be placed at the end of the priority order.
def?MapWaypointRenderRoleDef<Waypoint>undefinedThe render role's definition. If undefined, the new role will be assigned a default definition with no defined rendering context, icon, or label factories, and a visibility handler which always returns true.
group?stringMapSystemWaypointsRenderer.DefaultGroupThe group in which to include the new render role, if any. Defaults to MapSystemWaypointsRenderer.DefaultGroup.

Returns

boolean

Whether the role was successfully inserted.


isRegistered()

isRegistered(waypoint, role?): boolean

Defined in: src/sdk/components/map/MapWaypointRenderer.ts:288

Checks if a waypoint is registered with this renderer. A role or roles can be optionally specified such that the method will only return true if the waypoint is registered under those specific roles.

Parameters

ParameterTypeDescription
waypointWaypointA waypoint.
role?numberThe specific role(s) to check.

Returns

boolean

whether the waypoint is registered with this renderer.

Inherited from

MapWaypointRenderer.isRegistered


register()

register(waypoint, role, sourceId): void

Defined in: src/sdk/components/map/MapWaypointRenderer.ts:312

Registers a waypoint with this renderer under a specific role or roles. Registered waypoints will be drawn as appropriate the next time this renderer's update() method is called. Registering a waypoint under a role under which it is already registered has no effect unless the source of the registration is different.

Parameters

ParameterTypeDescription
waypointWaypointThe waypoint to register.
rolenumberThe role(s) under which the waypoint should be registered.
sourceIdstringA unique string ID for the source of the registration.

Returns

void

Inherited from

MapWaypointRenderer.register


removeRenderRole()

removeRenderRole(role): boolean

Defined in: src/sdk/components/map/MapWaypointRenderer.ts:179

Removes a render role from this renderer.

Parameters

ParameterTypeDescription
rolenumberThe render role to remove.

Returns

boolean

Whether the render role was successfully removed.

Inherited from

MapWaypointRenderer.removeRenderRole


renderRoles()

renderRoles(): IterableIterator<number>

Defined in: src/sdk/components/map/MapWaypointRenderer.ts:198

Gets an iterable of render roles added to this renderer. The iterable will return the roles in the order in which they were added.

Returns

IterableIterator<number>

An iterable of render roles added to this renderer.

Inherited from

MapWaypointRenderer.renderRoles


setCanvasContext()

setCanvasContext(role, context): boolean

Defined in: src/sdk/components/map/MapWaypointRenderer.ts:252

Sets the canvas rendering context for a render role. If the render role has not been added to this renderer, this method does nothing.

Parameters

ParameterTypeDescription
rolenumberA render role.
contextCanvasRenderingContext2DA canvas 2D rendering context.

Returns

boolean

Whether the context was set.

Inherited from

MapWaypointRenderer.setCanvasContext


setIconFactory()

setIconFactory(role, factory): boolean

Defined in: src/sdk/components/map/MapWaypointRenderer.ts:216

Sets the factory to use to create waypoint icons for a render role. If the render role has not been added to this renderer, this method does nothing.

Parameters

ParameterTypeDescription
rolenumberA render role.
factoryMapWaypointRendererIconFactory<Waypoint>A waypoint icon factory.

Returns

boolean

Whether the factory was set.

Inherited from

MapWaypointRenderer.setIconFactory


setLabelFactory()

setLabelFactory(role, factory): boolean

Defined in: src/sdk/components/map/MapWaypointRenderer.ts:234

Sets the factory to use to create waypoint labels for a render role. If the render role has not been added to this renderer, this method does nothing.

Parameters

ParameterTypeDescription
rolenumberA render role.
factoryMapWaypointRendererLabelFactory<Waypoint>A waypoint label factory.

Returns

boolean

Whether the factory was set.

Inherited from

MapWaypointRenderer.setLabelFactory


setVisibilityHandler()

setVisibilityHandler(role, handler): boolean

Defined in: src/sdk/components/map/MapWaypointRenderer.ts:270

Sets the handler that determines if a waypoint should visible for a render role. If the render role has not been added to this renderer, this method does nothing.

Parameters

ParameterTypeDescription
rolenumberA render role.
handler(waypoint) => booleanA function that determines if a waypoint should be visible.

Returns

boolean

Whether the handler was set.

Inherited from

MapWaypointRenderer.setVisibilityHandler


update()

update(mapProjection): void

Defined in: src/sdk/components/map/MapWaypointRenderer.ts:364

Redraws waypoints registered with this renderer.

Parameters

ParameterTypeDescription
mapProjectionMapProjectionThe map projection to use.

Returns

void

Inherited from

MapWaypointRenderer.update


DEFAULT_RENDER_ROLE_SELECTOR()

readonly static DEFAULT_RENDER_ROLE_SELECTOR<T>(entry, roleDefinitions): number

Defined in: src/sdk/components/map/MapWaypointRenderer.ts:102

The default render role selector. For each waypoint entry, iterates through all possible render roles in the order they were originally added to the renderer and selects the first role under which the entry is registered and is visible.

Type Parameters

Type Parameter
T extends MapWaypoint

Parameters

ParameterTypeDescription
entryMapWaypointRendererEntry<T>A waypoint entry.
roleDefinitionsReadonlyMap<number, Readonly<MapWaypointRenderRoleDef<T>>>A map from all possible render roles to their definitions.

Returns

number

The role under which the waypoint entry should be rendered, or 0 if the entry should not be rendered under any role.

Inherited from

MapWaypointRenderer.DEFAULT_RENDER_ROLE_SELECTOR


ENTRY_SORT_FUNC()

protected readonly static ENTRY_SORT_FUNC(a, b): number

Defined in: src/sdk/components/map/MapWaypointRenderer.ts:88

Sorts waypoint entries such that those with icons of higher priority are sorted after those with icons of lower priority.

Parameters

ParameterTypeDescription
aMapWaypointRendererEntry<any>The first waypoint entry to sort.
bMapWaypointRendererEntry<any>The second waypoint entry to sort.

Returns

number

A negative number if the first entry is to be sorted before the second, a positive number if the second entry is to be sorted before the first, and zero if the entries' relative sorting order does not matter.

Inherited from

MapWaypointRenderer.ENTRY_SORT_FUNC