load
Loads all font definitions and referenced assets in increasing pack priority order. Resource filters and selected overlays apply before font-provider stacks are merged. Invalid source metadata is diagnosed and excluded according to the selected compatibility contract; sources without metadata remain supported. Malformed font documents are diagnosed and skipped; an asset or reference failure invalidates its containing font bundle. Default MinecraftFontLoadLimits bound source enumeration, input, decompression, and later image allocation.
Return
a thread-safe detached font snapshot.
Parameters
source list from lowest to highest priority, never retained.
typed target capabilities.
immutable provider-filter and language-direction options.
Throws
when pack enumeration or a fatal loading failure prevents snapshot creation.
Loads a detached resource stack under caller-selected inclusive input and allocation ceilings. A source enumeration limit excludes that source with a diagnostic; malformed or oversized documents are skipped. Provider and graph limits invalidate the containing bundle while other inputs may use remaining capacity. Custom sources and decoders must bound their own allocations; their returned payloads are also checked before loader copying or retention.
Return
thread-safe snapshot without streams, sources, native faces, or mutable budget counters.
Parameters
stable source list in increasing priority order, never retained.
typed target capabilities.
immutable provider-filter and language-direction options.
immutable ceilings shared across this load and retained only for later image checks.
Throws
when the source list itself exceeds its ceiling.
when ordinary source enumeration or a fatal loading failure prevents creation.