Docsv3.3.0
Back to API Reference
Class

SystemFont

static

Resolves complete Unicode sequences through the platform font cascade and caches the exact source face plus variable-axis coordinates selected by the operating system. Returned runtimes are cache-owned and must not be disposed by callers.

public static int InactiveSourceCapacity{ get; set }

Maximum number of resolved source faces retained after their last text provider releases them. Active faces are never evicted. Set to zero to keep no inactive source faces.

public static long InactiveByteBudget{ get; set }

Maximum owned bytes retained by inactive memory-backed source faces and warm entries. Mapped files are released with their last native consumer and do not consume this budget.

public static SystemFontMemoryStats MemoryStats{ get }

Returns a consistent snapshot of SystemFont ownership and memory-backed retained bytes.

public static bool Disabled{ get; set }

Turns off the automatically appended OS fallback and the OS-default primary used when no font is assigned. Explicitly assigned UniTextSystemFont assets remain active. Changing the value invalidates resolution caches and raises DisableChanged.

public static Core Default{ get }

The configured project system font, or the platform default sans-serif runtime used as the final family and as the primary when no font is assigned. Null when implicit fallback is disabled or unavailable.

public static Core TryResolve()

Returns the platform cascade face covering a codepoint, optionally carrying another system font's render settings.

public static Core TryResolveStyled()

Returns the closest platform cascade face for the requested CSS weight and slant. The returned face may be regular when the family has no real styled cut.

public static Core TryResolveStyledFamily()

Returns a covering cut of the named installed family, or null when the platform substitutes another family or no cut covers the codepoint.

public static void Trim()

Evicts least-recently-used source faces beyond InactiveSourceCapacity and trims unreferenced font-file bytes to InactiveByteBudget. Faces leased by live providers are preserved.

public static void TrimUnused()

Releases every inactive source face and unreferenced font-file byte immediately. Active text providers remain valid.

public static void Reset()

Discards all request/source matches, styled companions and platform byte caches so subsequent resolution observes the current installed fonts.

public static Action Changed

Raised whenever implicit system-font availability or resolved platform font sources change.

public static Action DisableChanged

Raised when Disabled changes.

Back to API Reference