Docsv2.12.12
Back to API Reference
Class

UniTextSystemFont

Inherits:UniTextFont

UniTextFont that resolves its font bytes from the host OS at runtime from a per-platform pick (Common / Windows / macOS / Linux / iOS / Android). WebGL is unsupported.

Remarks

A regular font: it participates only when added to a font stack. Automatic gap-filling for codepoints no font covers is a separate, always-on mechanism — SystemFont — independent of this asset. FaceInfo, SDF detail multiplier and tile-size offset can be overridden per platform. Each field defaults to an "unset" sentinel; unset fields use values extracted from the loaded font. Glyph overrides are not supported — they reference indices specific to a particular font file, which a system font does not pin.

Nested Types

S
FaceInfoOverride
Optional FaceInfo override. Every field defaults to the unset sentinel.
E
FontPlatform
S
PlatformConfig
public string ResolvedPath{ get }

Path of the file the bytes were read from (or descriptor on iOS). Null if unresolved.

public string ResolvedFontName{ get }

Catalog display name actually used at runtime. Null if unresolved.

public FontPlatform ResolvedPlatform{ get }

Platform tab whose configuration drove the resolution.

public bool ResolveFailed{ get }

True if resolution ran and produced no bytes.

public byte[] FontData{ get }
public bool HasFontData{ get }
public PlatformConfig GetConfig()

Returns a mutable reference to the platform tab's config (Common/Windows/macOS/Linux/iOS/Android).

protected override void OnEnable()
protected override Core CreateRuntime()
public void Invalidate()

Forces re-resolution on the next access. Call after changing config at runtime.

public static const int UnsetInt
public static const float UnsetFloat
Back to API Reference