uninstallBitmapFont

uninstallBitmapFont(name): void

Defined in: packages/renderer/src/assets.ts:442

Tear down a font installed by installBitmapFont: drop its source face and free the baked atlas (and every emphasis variant) plus its registry entries. The symmetric counterpart of installBitmapFont — without it an install-once font’s atlas lives until the page unloads.

Safe to interleave with a webFont({ bitmap }) sharing the same family: the atlas is reference-counted, so it’s only destroyed once the last owner (this install and any web-font load) has released it. A no-op for a name that was never installed.

const font = await installBitmapFont("fonts/PressStart2P.ttf", { name: "PressStart" });
// …later, when nothing renders with it anymore:
uninstallBitmapFont(font);

Parameters

name

string

Returns

void