Docsv3.8.0
Back to API Reference
Class

UniText

Inherits:UniTextBase
Implements:ILayoutController

Canvas-space text component. Renders into a Canvas via CanvasRenderer with full Unicode support — bidirectional scripts (Arabic, Hebrew), complex shaping (Devanagari, Thai), proper line breaking, color emoji, and a markup system via ParseRule.

Remarks

For world-space text (no Canvas), use UniTextWorld.

Nested Types

C
Glyph
public IEnumerable<CanvasRenderer> CanvasRenderers{ get }

Gets all canvas renderers used for sub-meshes.

protected bool RenderRootOffsetsGeometry{ get }
protected bool NeedsFrameTick{ get }
public RectTransform RenderRoot{ get }

Holds glyphs, inline media and range decorations in mesh space, below user-authored children; its position applies the document window offset. Main thread only; creates a hidden GameObject.

protected override void UpdateRendering()
protected override void ClearAllRenderers()
protected override void ApplyVisibility()
protected override float ProjectedEmPixels()

Screen-space canvases resolve the em size from the canvas scale and this transform's scale relative to the canvas; a world-space canvas relies on a camera adapter's projected scale.

protected override bool ApplyWindowScroll()

Re-places the window by moving the render root and the mask stamp root; built meshes stay untouched.

protected override void OnSetDirty()
protected override Nullable<Rect> ResolveAutomaticViewport()
protected override Nullable<Rect> ResolveDisplayBounds()

The root canvas is all a Canvas can show.

protected override void OnDeInit()
public override void SetMaterialDirty()

Translates Canvas masking notifications into a UniText appearance rebuild.

protected override void OnEnable()
protected override void OnDisable()
protected override void OnCanvasHierarchyChanged()
protected override void OnTransformParentChanged()
public override void CrossFadeColor()
public override void CrossFadeAlpha()
protected override void OnFrameTick()
public override void SetClipRect()

Sets the clipping rectangle for masking, applying to all sub-mesh renderers. Mask removal reaches a clippable only through this call (never Cull), so an invalid rect also resets VisibleWindow and the clip-cull state — otherwise the mesh would stay windowed and culled with no mask to excuse it.

public override void SetClipSoftness()

Sets soft clipping edges for smooth mask transitions on all sub-mesh renderers.

public override void Cull()

Culls against the actual rendered mesh bounds rather than the RectTransform (whose corners serve until a mesh exists). Glyphs can extend beyond the rect (long words, overflow, outline/glow, modifier transforms), so the default rect-corner test would hide still-visible meshes.

public override void OnCullingChanged()

Restores the effective cull — the union of clip-culling and render suppression — on every culling change, so a direct cull write from outside never lifts a Hide or scene-visibility state.

public static bool LanguageMatches()

Matches nonempty BCP 47 tags case-insensitively at subtag boundaries, such as zh and zh-Hans.

protected override Camera ResolveEventCamera()
Back to API Reference