Skip to main content

System

class System(val typeface: Typeface) : Face() /** The bundled Lato family - the "no custom font configured" state. */ object Lato : Face() } private val _faces: MutableMap<FontRole, Face> = mutableMapOf( FontRole.HEADING to Face.Lato, FontRole.BODY to Face.Lato ) /** * The [FontResolution] each role was last given, so a repeat [apply] / [applyRole] with the * same resolution - the resolver's memo answering a role that was never actually cleared, for * instance - can skip [_faceFor] entirely rather than re-opening the font file only to find * [_sameFace] discards the result (#20290 review). */ private val _lastResolution: MutableMap<FontRole, FontResolution> = mutableMapOf() /** role x style -> Typeface. Every `createFromFile` / `create` allocates, so memoise. */ private val _typefaces: MutableMap<String, Typeface> = mutableMapOf() private val _listeners: MutableList<() -> Unit> = mutableListOf() /** * The specs the owner last asked for, per role. Kept here so the runtime-playout delta * ([FontPlayoutDelta]) has a "current" to compare an incoming payload against - an absent key * means "leave this role alone", which is only expressible against a remembered state. */ var currentSpecs: Map<FontRole, FontSpec> = mapOf( FontRole.HEADING to FontSpec.None, FontRole.BODY to FontSpec.None ) /** * Roles whose last applied [FontResolution] was [FontResolution.Unavailable] - a transient * failure (network hiccup, or the shared module's resolution timeout) rather than a final * answer. The download for these keeps running in the background and lands in the cache, but * nobody asks again unless prompted (#20290: `BBNativePlayerView` retries once on a timer, and * re-resolves a re-sent playout even when its specs did not change). [FontResolution.Unusable] * is a permanent, contractual answer and must never show up here. */ val unavailableRoles: Set<FontRole> get() = _lastResolution.filterValues

A font that was already on the device, found by family name.

Properties​

currentSpecs​

var currentSpecs: Map<FontRole, FontSpec>

The specs the owner last asked for, per role. Kept here so the runtime-playout delta ([FontPlayoutDelta]) has a "current" to compare an incoming payload against - an absent key means "leave this role alone", which is only expressible against a remembered state.

unavailableRoles​

val unavailableRoles: Set<FontRole>

Roles whose last applied [FontResolution] was [FontResolution.Unavailable] - a transient failure (network hiccup, or the shared module's resolution timeout) rather than a final answer. The download for these keeps running in the background and lands in the cache, but nobody asks again unless prompted (#20290: BBNativePlayerView retries once on a timer, and re-resolves a re-sent playout even when its specs did not change). [FontResolution.Unusable] is a permanent, contractual answer and must never show up here.

Functions​

hasUnavailableRole​

fun hasUnavailableRole() : Boolean

True while at least one role is stuck on [FontResolution.Unavailable] (see [unavailableRoles]).

typeface​

fun typeface(role: FontRole, style: BBFontStyle) : Typeface

The Typeface for [role] at [style]. Never null: it falls all the way back to the platform default if even Lato fails to load.

apply​

fun apply(heading: FontResolution, body: FontResolution)

Both roles at once, one listener fire. This is what a [FontResolution] pair lands in.

applyRole​

fun applyRole(role: FontRole, resolution: FontResolution)

One role. The other keeps whatever it had - the roles never cover for each other.

addListener​

fun addListener(listener: () -> Unit)

Called exactly once after every [apply] / [applyRole], so owners can re-sweep their view trees. Fired even when nothing changed: a re-apply is also how a freshly inflated subtree gets its fonts, and a redundant sweep is cheaper than a missed one. Listeners run on whatever thread called apply - in practice the resolver's callbackDispatcher, i.e. Main.

latoFallback​

fun latoFallback(context: Context) : BBFontProvider

A shared, frozen, Lato-only provider for views that have not been handed their owner's provider yet (a screen's init block runs before BBNativePlayerView can inject one). It refuses [apply], so it can never pick up another player's font, and its loader holds the application context, so it leaks nothing.