Docsv3.3.2
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.
public IEnumerable<CanvasRenderer> CanvasRenderers{ get }

Gets all canvas renderers used for sub-meshes.

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

Single hidden child holding every visible render object this component spawns — glyph sub-meshes and inline media. Kept before user-authored children, after the optional internal mask stamp, so the text composites below nested graphics. Highlights still self-order around it ("Behind" before, "Above" after). One node is positioned instead of each renderer. Main thread only — creates a GameObject.

protected override void UpdateRendering()
protected override void ClearAllRenderers()
protected override void ApplyVisibility()
protected override void OnSetDirty()
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.

protected override Camera ResolveEventCamera()
Back to API Reference