Class

UniTextFontProvider

sealed

Owns Unicode-sequence font resolution for a text object: composes the family chain from the assigned font and font stack, walks it (plus emoji and the always-on SystemFont fallback) to pick a covering runtime and exact variation instance when available, and otherwise returns the primary runtime as the intentional.notdef endpoint. Asset-backed faces are captured as worker-safe lazy slots; bare runtime companions and the emoji singleton flow through the same resolution path. The owner must dispose the provider after all processing and raster work finishes.

public static int InactiveVariationCapacity{ get; set }

Maximum number of exact variation registrations retained after their last provider releases them. Active registrations are never evicted.

public static FontVariationMemoryStats VariationMemoryStats{ get }

Returns a consistent snapshot of exact variation registrations and their ownership.

public float FontSize{ get; set }

Gets or sets the current font size in points.

public UniTextFont.Core PrimaryFont{ get }

Resolved primary font runtime. Provides strut metrics and serves as the head of codepoint resolution.

public int PrimaryFontId{ get }

Stable id of PrimaryFont.

public bool HasFaces{ get }

True if the resolved family chain carries variant faces (Bold/Italic) or a variable font.

public void SetFontSize(float size)

Equivalent to setting FontSize.

[ctor]public UniTextFontProvider(UniTextFont primary, UniTextFontStack fontStack, float fontSize = 36f, FontNormalizeMetric normalizeMetric = FontNormalizeMetric.None, float normalizeTarget = 0f)

Initializes the provider. The resolution chain is primary (if set), then fontStack's families, then SystemFont.Default (the configured UniTextSettings.SystemFont or the OS default) as the always-on final fallback. With nothing assigned, SystemFont.Default becomes the primary. Main-thread only.

public float GetNormalizationScale(UniTextFont.Core font)

Per-font multiplier matching a fallback/secondary font to the primary font's reference metric (CSS font-size-adjust). Derived from the runtime alone, so every id addressing one runtime — base or variation instance — yields the same multiplier. Returns 1 when normalization is off, the font is the primary, the font opts out, or a metric is unavailable.

public float GetNormalizationScale(int fontId)

Convenience overload resolving the runtime from a font id issued by this provider. Returns 1 for an id it never issued.

public float MetricScale(int fontId, float fontSize)

Design-units → pixels for fontId at fontSize: folds in the font's UniTextFont.FontScale and the active normalization (CSS font-size-adjust). Multiply any design-unit metric (advance, bearing, line height) by the result. Returns 0 when the font is unavailable.

public float MetricScale(UniTextFont.Core font, float fontSize)

public void SetNormalization(FontNormalizeMetric metric, float target)

Sets the active normalization metric and target, recomputing the primary reference ratio. Called by a font-size-match modifier so the provider stays modifier-agnostic.

public static int GetFontId(UniTextFont.Core font)

Process-lifetime font identity. The primary system emoji face uses EmojiFont.FontId; null uses 0.

public static int GetFontId(UniTextFont font)

Process-lifetime font identity from a UniTextFont asset.

public void RegisterFont(int fontId, UniTextFont.Core font)

Registers a runtime under its process identity. Writes are serialized; reads stay lock-free.

public void Dispose()

Releases all SystemFont source leases and variation registrations owned by this provider. Call only after its processing and raster work has finished.

public UniTextFont.Core GetFont(int fontId)

Resolves a font id to its registered runtime, or null when the id has no owner in this provider.

public void GetLineMetrics(float size, out float ascender, out float descender, out float lineHeight)

Strut metrics from the primary font, scaled to size points. descender is negative; lineHeight falls back to 1.2 × extent when the font omits it.

public float GetCapHeight(float size)

Cap height (top of capital letters) of the primary font, scaled to size points. Returns 0 when unavailable.

public float GetXHeight(float size)

x-height (top of lowercase letters) of the primary font, scaled to size points. Returns 0 when unavailable.

public void GetTypoMetrics(float size, out float ascent, out float descent)

Typographic ascent/descent (OS/2 sTypo) of the primary font, scaled to size points — the designer's tight content box. Falls back to the selected ascent/descent line when the font omits typo metrics. descent is negative.

public int TryGetFontIdByFamilyName(string name)

Resolves a FontFamily.name to its primary font id, registering the runtime with this provider if needed. Returns 0 when the name is empty or unknown. Case-sensitive, first-wins across the family chain.

public int FindFontForCodepoint(int codepoint)

Finds the best font id to render codepoint via the fallback chain; result is cached in SharedFontCache.

public int FindFontForCodepoint(int codepoint, byte language)

Same as FindFontForCodepoint but prefers families whose FontFamily.preferredLanguage matches the given language registry index.

public static void TrimUnusedVariations()

Releases every exact variation registration not leased by a live provider. Active shaping and raster data is preserved.

public ushort GetFamilyIndex(int fontId)

Family index for a font id, or MaxValue when the runtime has no family owner.

public byte[] GetFontData(int fontId)

Creates a managed snapshot of the complete font file for a font id, allocating and copying its full source, or returns null when unavailable.

Back to API Reference

UniTextFontProvider

Properties

Methods