minecraft/dev.s7a.strata.runtime.minecraft.font/MinecraftFontBackend

MinecraftFontBackend

interface MinecraftFontBackend : AutoCloseable(source)

Owner-thread CPU image-decoding and TrueType services owned by one font engine. Implementations must not require Minecraft, a display, or a graphics context. Returned images and glyphs are detached, and close is idempotent. Custom decoders must bound their own allocations; MinecraftBoundedFontBackend receives each snapshot's explicit image ceilings.

Inheritors

MinecraftBoundedFontBackend

Functions

abstract override fun close()

Releases backend-owned native resources on the owner thread.

decodePng

abstract fun decodePng(bytes: ByteArray): DrawImage

Decodes PNG bytes into a detached straight-ARGB image.

openTrueType

abstract fun openTrueType(bytes: ByteArray, settings: MinecraftTrueTypeSettings): MinecraftTrueTypeFace

Opens one owner-thread TrueType face for the supplied settings. A failed open must release every partially allocated face resource before propagating the failure.

visualGlyphs

open fun visualGlyphs(text: String, rightToLeft: Boolean): List<MinecraftVisualGlyph>

Orders and shapes a complete logical line while preserving original UTF-16 scalar positions for font lookup. Shaping spans the whole line, including font boundaries, and contractions belong to their first contributing scalar. Original positions deliberately correct the native style lookup drift after Arabic contractions without changing the shaped glyphs. The default supplies identity order and replaces unmatched UTF-16 surrogates with the replacement scalar. Backends providing native bidirectional processing must override this operation alongside visualOrder.

visualOrder

open fun visualOrder(text: String, rightToLeft: Boolean): String

Applies the selected release's native-compatible bidirectional ordering and shaping. The default preserves text for backends whose caller supplies visual-order text.