Class: ToldUserSettings

Defined in: src/workingtitle-instruments-g3000/html_ui/Shared/Settings/ToldUserSettings.ts:199

Utility class for retrieving and working with TOLD (takeoff/landing) performance calculation user settings managers.

Extends

• DefaultUserSettingManager<ToldUserSettingTypes>

Constructors

Constructor

new ToldUserSettings(bus, settingDefs, keepLocal): ToldUserSettings

Defined in: src/sdk/settings/UserSetting.ts:238

Creates a new instance of DefaultUserSettingManager.

Parameters

Parameter	Type	Default value	Description
bus	EventBus	undefined	The bus used by this manager to publish setting change events.
settingDefs	readonly UserSettingDefinition<string | number | boolean>[]	undefined	The setting definitions used to initialize this manager's settings.
keepLocal	boolean	false	Whether the manager should only sync the values of its settings within its local instrument. If true, then the manager will not sync setting values to or from the same settings on other instruments. If false, then the manager will sync setting values to and from the same settings on other instruments. Defaults to false.

Returns

ToldUserSettings

Inherited from

DefaultUserSettingManager.constructor

Properties

bus

protected readonly bus: EventBus

Defined in: src/sdk/settings/UserSetting.ts:239

The bus used by this manager to publish setting change events.

Inherited from

DefaultUserSettingManager.bus

---

publisher

protected readonly publisher: Publisher<ToldUserSettingTypes>

Defined in: src/sdk/settings/UserSetting.ts:222

Inherited from

DefaultUserSettingManager.publisher

---

settings

protected readonly settings: Map<string, UserSettingManagerEntry<string | number | boolean>>

Defined in: src/sdk/settings/UserSetting.ts:220

Inherited from

DefaultUserSettingManager.settings

---

subscriber

protected readonly subscriber: EventSubscriber<ToldUserSettingTypes>

Defined in: src/sdk/settings/UserSetting.ts:223

Inherited from

DefaultUserSettingManager.subscriber

---

syncPublisher

protected readonly syncPublisher: Publisher<UserSettingManagerSyncEvents>

Defined in: src/sdk/settings/UserSetting.ts:225

Inherited from

DefaultUserSettingManager.syncPublisher

---

syncSubscriber

protected readonly syncSubscriber: EventSubscriber<UserSettingManagerSyncEvents>

Defined in: src/sdk/settings/UserSetting.ts:226

Inherited from

DefaultUserSettingManager.syncSubscriber

Methods

getAllSettings()

getAllSettings(): UserSetting<UserSettingValue>[]

Defined in: src/sdk/settings/UserSetting.ts:330

Gets an array of all settings of this manager.

Returns

UserSetting<UserSettingValue>[]

an array of all settings of this manager.

Inherited from

DefaultUserSettingManager.getAllSettings

---

getSetting()

getSetting<K>(name): UserSetting<ToNonNullable<PropertyTypeOf<ToldUserSettingTypes, K>>>

Defined in: src/sdk/settings/UserSetting.ts:320

Gets a setting from this manager.

Type Parameters

Type Parameter

K extends "toldDatabaseVersion" | "toldEnabled" | "toldOriginIcao" | "toldTakeoffDistanceRequired" | "toldTakeoffWeight" | "toldTakeoffRunwaySurface" | "toldTakeoffWindDirection" | "toldTakeoffWindSpeed" | "toldTakeoffTemperature" | "toldTakeoffCanUseRat" | "toldTakeoffUseRat" | "toldTakeoffPressure" | "toldTakeoffRunwayLength" | "toldTakeoffRunwayElevation" | "toldTakeoffRunwayHeading" | "toldTakeoffRunwayGradient" | "toldTakeoffPressureAltitude" | "toldTakeoffFlapsIndex" | "toldTakeoffFlapsIndexDefault" | "toldTakeoffAntiIceOn" | "toldTakeoffThrustReversers" | "toldTakeoffFactor" | "toldTakeoffRolling" | "toldTakeoffRollingDefault" | "toldTakeoffCalcResult" | "toldTakeoffVSpeedsAccepted" | "toldDestinationDefaultApplied" | "toldDestinationIcao" | "toldLandingDistanceRequired" | "toldLandingCanUsePredictedWeight" | "toldLandingUsePredictedWeight" | "toldLandingWeight" | "toldLandingRunwaySurface" | "toldLandingWindDirection" | "toldLandingWindSpeed" | "toldLandingTemperature" | "toldLandingPressure" | "toldLandingRunwayLength" | "toldLandingRunwayElevation" | "toldLandingRunwayHeading" | "toldLandingRunwayGradient" | "toldLandingPressureAltitude" | "toldLandingFlapsIndex" | "toldLandingFlapsIndexDefault" | "toldLandingAntiIceOn" | "toldLandingThrustReversers" | "toldLandingFactor" | "toldLandingFactorDefault" | "toldLandingAutothrottleOn" | "toldLandingCalcResult" | "toldLandingVSpeedsAccepted"

Parameters

Parameter	Type	Description
name	K	The name of the setting to get.

Returns

UserSetting<ToNonNullable<PropertyTypeOf<ToldUserSettingTypes, K>>>

The requested setting.

Throws

Error if no setting with the specified name exists.

Inherited from

DefaultUserSettingManager.getSetting

---

mapTo()

mapTo<M>(map): UserSettingManager<M & ToldUserSettingTypes>

Defined in: src/sdk/settings/UserSetting.ts:345

Maps a subset of this manager's settings to ones with aliased names, and creates a new setting manager which supports accessing the settings using their aliases.

Type Parameters

Type Parameter
M extends UserSettingRecord

Parameters

Parameter	Type	Description
map	UserSettingMap<M, T>	A map defining the aliases of a subset of this manager's settings, with aliased setting names as keys and original setting names as values.

Returns

UserSettingManager<M & ToldUserSettingTypes>

A new setting manager which supports accessing a subset of this manager's settings using aliased names.

Inherited from

DefaultUserSettingManager.mapTo

---

onSettingValueChanged()

protected onSettingValueChanged<K>(entry, value): void

Defined in: src/sdk/settings/UserSetting.ts:354

A callback which is called when one of this manager's settings has its value changed locally.

Type Parameters

Type Parameter
K extends keyof ToldUserSettingTypes

Parameters

Parameter	Type	Description
entry	UserSettingManagerEntry<ToldUserSettingTypes[K]>	The entry for the setting that was changed.
value	ToldUserSettingTypes[K]	The new value of the setting.

Returns

void

Inherited from

DefaultUserSettingManager.onSettingValueChanged

---

onSettingValueSynced()

protected onSettingValueSynced<K>(entry, data): void

Defined in: src/sdk/settings/UserSetting.ts:367

A callback which is called when a setting changed event is received over the event bus.

Type Parameters

Type Parameter
K extends keyof ToldUserSettingTypes

Parameters

Parameter	Type	Description
entry	UserSettingManagerEntry<ToldUserSettingTypes[K]>	The entry for the setting that was changed.
data	UserSettingManagerSyncData<ToldUserSettingTypes[K]>	The sync data.

Returns

void

Inherited from

DefaultUserSettingManager.onSettingValueSynced

---

syncSettingFromEvent()

protected syncSettingFromEvent<K>(entry, data): void

Defined in: src/sdk/settings/UserSetting.ts:386

Syncs a setting using data received from a sync event.

Type Parameters

Type Parameter
K extends keyof ToldUserSettingTypes

Parameters

Parameter	Type	Description
entry	UserSettingManagerEntry<ToldUserSettingTypes[K]>	The entry for the setting to sync.
data	UserSettingManagerSyncData<ToldUserSettingTypes[K]>	The sync event data.

Returns

void

Inherited from

DefaultUserSettingManager.syncSettingFromEvent

---

tryGetSetting()

tryGetSetting<K>(name): OptionalUserSettingFromManager<ToldUserSettingTypes, K>

Defined in: src/sdk/settings/UserSetting.ts:315

Attempts to get a setting from this manager.

Type Parameters

Type Parameter
K extends string

Parameters

Parameter	Type	Description
name	K	The name of the setting to get.

Returns

OptionalUserSettingFromManager<ToldUserSettingTypes, K>

The requested setting, or undefined if no such setting exists.

Inherited from

DefaultUserSettingManager.tryGetSetting

---

whenSettingChanged()

whenSettingChanged<K>(name): UserSettingConsumerFromManager<ToldUserSettingTypes, K>

Defined in: src/sdk/settings/UserSetting.ts:335

Gets a consumer which notifies handlers when the value of a setting changes.

Type Parameters

Type Parameter

K extends "toldDatabaseVersion" | "toldEnabled" | "toldOriginIcao" | "toldTakeoffDistanceRequired" | "toldTakeoffWeight" | "toldTakeoffRunwaySurface" | "toldTakeoffWindDirection" | "toldTakeoffWindSpeed" | "toldTakeoffTemperature" | "toldTakeoffCanUseRat" | "toldTakeoffUseRat" | "toldTakeoffPressure" | "toldTakeoffRunwayLength" | "toldTakeoffRunwayElevation" | "toldTakeoffRunwayHeading" | "toldTakeoffRunwayGradient" | "toldTakeoffPressureAltitude" | "toldTakeoffFlapsIndex" | "toldTakeoffFlapsIndexDefault" | "toldTakeoffAntiIceOn" | "toldTakeoffThrustReversers" | "toldTakeoffFactor" | "toldTakeoffRolling" | "toldTakeoffRollingDefault" | "toldTakeoffCalcResult" | "toldTakeoffVSpeedsAccepted" | "toldDestinationDefaultApplied" | "toldDestinationIcao" | "toldLandingDistanceRequired" | "toldLandingCanUsePredictedWeight" | "toldLandingUsePredictedWeight" | "toldLandingWeight" | "toldLandingRunwaySurface" | "toldLandingWindDirection" | "toldLandingWindSpeed" | "toldLandingTemperature" | "toldLandingPressure" | "toldLandingRunwayLength" | "toldLandingRunwayElevation" | "toldLandingRunwayHeading" | "toldLandingRunwayGradient" | "toldLandingPressureAltitude" | "toldLandingFlapsIndex" | "toldLandingFlapsIndexDefault" | "toldLandingAntiIceOn" | "toldLandingThrustReversers" | "toldLandingFactor" | "toldLandingFactorDefault" | "toldLandingAutothrottleOn" | "toldLandingCalcResult" | "toldLandingVSpeedsAccepted"

Parameters

Parameter	Type	Description
name	K	The name of a setting.

Returns

UserSettingConsumerFromManager<ToldUserSettingTypes, K>

a consumer which notifies handlers when the value of the setting changes.

Throws

Error if no setting with the specified name exists.

Deprecated

Please use getSetting(name).sub() instead.

Inherited from

DefaultUserSettingManager.whenSettingChanged

---

getManager()

static getManager(bus): DefaultUserSettingManager<ToldUserSettingTypes>

Defined in: src/workingtitle-instruments-g3000/html_ui/Shared/Settings/ToldUserSettings.ts:207

Gets an instance of the TOLD (takeoff/landing) performance calculation user settings manager.

Parameters

Parameter	Type	Description
bus	EventBus	The event bus.

Returns

DefaultUserSettingManager<ToldUserSettingTypes>

An instance of the TOLD (takeoff/landing) performance calculation user settings manager.

---

parseLandingResultString()

static parseLandingResultString(resultString): undefined | ToldLandingPerformanceResult

Defined in: src/workingtitle-instruments-g3000/html_ui/Shared/Settings/ToldUserSettings.ts:464

Parses a landing performance result object from a string.

Parameters

Parameter	Type	Description
resultString	string	The stringified result object.

Returns

undefined | ToldLandingPerformanceResult

The landing performance result object parsed from the specified string, or undefined if the string does not define such an object.

---

parseTakeoffResultString()

static parseTakeoffResultString(resultString): undefined | ToldTakeoffPerformanceResult

Defined in: src/workingtitle-instruments-g3000/html_ui/Shared/Settings/ToldUserSettings.ts:428

Parses a takeoff performance result object from a string.

Parameters

Parameter	Type	Description
resultString	string	The stringified result object.

Returns

undefined | ToldTakeoffPerformanceResult

The takeoff performance result object parsed from the specified string, or undefined if the string does not define such an object.