Skip to main content

Class: BingComponent

Defined in: src/sdk/components/bing/BingComponent.tsx:111

A FSComponent that displays the MSFS Bing Map, weather radar, and 3D terrain.

Extends​

Constructors​

Constructor​

new BingComponent(props): BingComponent

Defined in: src/sdk/components/FSComponent.ts:73

Creates an instance of a DisplayComponent.

Parameters​

ParameterTypeDescription
propsBingComponentPropsThe propertis of the component.

Returns​

BingComponent

Inherited from​

DisplayComponent.constructor

Properties​

context?​

optional context: [] = undefined

Defined in: src/sdk/components/FSComponent.ts:64

The context on this component, if any.

Inherited from​

DisplayComponent.context

contextType?​

readonly optional contextType: readonly [] = undefined

Defined in: src/sdk/components/FSComponent.ts:67

The type of context for this component, if any.

Inherited from​

DisplayComponent.contextType

props​

props: BingComponentProps & ComponentProps

Defined in: src/sdk/components/FSComponent.ts:61

The properties of the component.

Inherited from​

DisplayComponent.props

DEFAULT_RESOLUTION​

readonly static DEFAULT_RESOLUTION: 1024 = 1024

Defined in: src/sdk/components/bing/BingComponent.tsx:113

The default resolution of the Bing Map along both horizontal and vertical axes, in pixels.

DEFAULT_WEATHER_COLORS​

readonly static DEFAULT_WEATHER_COLORS: readonly readonly [number, number][]

Defined in: src/sdk/components/bing/BingComponent.tsx:115

MAX_RADIUS​

readonly static MAX_RADIUS: 5000000 = 5e6

Defined in: src/sdk/components/bing/BingComponent.tsx:123

The maximum supported radius, in meters.

Methods​

destroy()​

destroy(): void

Defined in: src/sdk/components/bing/BingComponent.tsx:519

Destroys this component.

Returns​

void

Overrides​

DisplayComponent.destroy

getContext()​

protected getContext(context): never

Defined in: src/sdk/components/FSComponent.ts:106

Gets a context data subscription from the context collection.

Parameters​

ParameterTypeDescription
contextneverThe 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​

DisplayComponent.getContext

isAwake()​

isAwake(): boolean

Defined in: src/sdk/components/bing/BingComponent.tsx:272

Checks whether this Bing component is awake.

Returns​

boolean

whether this Bing component is awake.

isBound()​

isBound(): boolean

Defined in: src/sdk/components/bing/BingComponent.tsx:264

Checks whether this Bing component has been bound.

Returns​

boolean

whether this Bing component has been bound.

onAfterRender()​

onAfterRender(): void

Defined in: src/sdk/components/bing/BingComponent.tsx:277

A callback that is called after the component is rendered.

Returns​

void

Overrides​

DisplayComponent.onAfterRender

onBeforeRender()​

onBeforeRender(): void

Defined in: src/sdk/components/FSComponent.ts:80

A callback that is called before the component is rendered.

Returns​

void

Inherited from​

DisplayComponent.onBeforeRender

render()​

render(): VNode

Defined in: src/sdk/components/bing/BingComponent.tsx:512

Renders the component.

Returns​

VNode

A JSX element to be rendered.

Overrides​

DisplayComponent.render

resetImgSrc()​

resetImgSrc(): void

Defined in: src/sdk/components/bing/BingComponent.tsx:554

Resets the img element's src attribute.

Returns​

void

setPositionRadius()​

setPositionRadius(pos, radius): void

Defined in: src/sdk/components/bing/BingComponent.tsx:483

Sets the center position and radius of this Bing component.

Parameters​

ParameterTypeDescription
posLatLongThe center position.
radiusnumberThe radius, in meters.

Returns​

void

sleep()​

sleep(): void

Defined in: src/sdk/components/bing/BingComponent.tsx:457

Puts this Bing component to sleep. While asleep, this component cannot make changes to the Bing instance to which it is bound.

Returns​

void

wake()​

wake(): void

Defined in: src/sdk/components/bing/BingComponent.tsx:428

Wakes this Bing component. Upon awakening, this component will synchronize its state to the Bing instance to which it is bound.

Returns​

void

createEarthColorsArray()​

static createEarthColorsArray(waterColor, terrainColors, minElevation, maxElevation, stepCount): number[]

Defined in: src/sdk/components/bing/BingComponent.tsx:669

Creates a full Bing component earth colors array. The earth colors array will contain the specified water color and terrain colors (including interpolated values between the explicitly defined ones, as necessary).

Parameters​

ParameterTypeDefault valueDescription
waterColorstringundefinedThe desired water color, as a hex string with the format #hhhhhh.
terrainColorsobject[]undefinedAn array of desired terrain colors at specific elevations. Elevations should be specified in feet and colors as hex strings with the format #hhhhhh.
minElevationnumber0The minimum elevation to which to assign a color, in feet. Defaults to 0.
maxElevationnumber30000The maximum elevation to which to assign a color, in feet. Defaults to 30000.
stepCountnumber61The number of terrain color steps. Defaults to 61.

Returns​

number[]

a full Bing component earth colors array.

hexaToRGBAColor()​

static hexaToRGBAColor(hexColor): number

Defined in: src/sdk/components/bing/BingComponent.tsx:614

Converts an HTML hex color string to a numerical RGBA value, as R + G * 256 + B * 256^2 + A * 256^3.

Parameters​

ParameterTypeDescription
hexColorstringThe hex color string to convert.

Returns​

number

The numerical RGBA value equivalent of the specified hex color string, as R + G * 256 + B * 256^2 + A * 256^3.

hexaToRGBColor()​

static hexaToRGBColor(hexColor): number

Defined in: src/sdk/components/bing/BingComponent.tsx:568

Converts an HTML hex color string to a numerical RGB value, as R + G * 256 + B * 256^2.

Parameters​

ParameterTypeDescription
hexColorstringThe hex color string to convert.

Returns​

number

The numerical RGB value equivalent of the specified hex color string, as R + G * 256 + B * 256^2.

rgbaColor()​

static rgbaColor(r, g, b, a): number

Defined in: src/sdk/components/bing/BingComponent.tsx:653

Converts RGBA color components to a numerical RGBA value, as R + G * 256 + B * 256^2 + A * 256^3.

Parameters​

ParameterTypeDescription
rnumberThe red component, from 0 to 255.
gnumberThe green component, from 0 to 255.
bnumberThe blue component, from 0 to 255.
anumberThe alpha component, from 0 to 255.

Returns​

number

The numerical RGBA value of the specified components, as R + G * 256 + B * 256^2 + A * 256^3.

rgbaToHexaColor()​

static rgbaToHexaColor(rgba, poundPrefix): string

Defined in: src/sdk/components/bing/BingComponent.tsx:636

Converts a numerical RGBA value to an HTML hex color string.

Parameters​

ParameterTypeDefault valueDescription
rgbanumberundefinedThe numerical RGBA value to convert, as R + G * 256 + B * 256^2 + A * 256^3.
poundPrefixbooleantrueWhether to include the pound (#) prefix in the converted string. Defaults to true.

Returns​

string

The HTML hex color string equivalent of the specified numerical RGBA value.

rgbColor()​

static rgbColor(r, g, b): number

Defined in: src/sdk/components/bing/BingComponent.tsx:604

Converts RGB color components to a numerical RGB value, as R + G * 256 + B * 256^2.

Parameters​

ParameterTypeDescription
rnumberThe red component, from 0 to 255.
gnumberThe green component, from 0 to 255.
bnumberThe blue component, from 0 to 255.

Returns​

number

The numerical RGB value of the specified components, as R + G * 256 + B * 256^2.

rgbToHexaColor()​

static rgbToHexaColor(rgb, poundPrefix): string

Defined in: src/sdk/components/bing/BingComponent.tsx:589

Converts a numerical RGB value to an HTML hex color string.

Parameters​

ParameterTypeDefault valueDescription
rgbnumberundefinedThe numerical RGB value to convert, as R + G * 256 + B * 256^2.
poundPrefixbooleantrueWhether to include the pound (#) prefix in the converted string. Defaults to true.

Returns​

string

The HTML hex color string equivalent of the specified numerical RGB value.