Unity TextMeshPro - Professional Text Rendering

Overview

TextMeshPro (TMPro) is Unity's advanced text rendering solution using Signed Distance Field (SDF) technology for resolution-independent, high-quality text with minimal performance overhead.

Foundation Required: unity-csharp-fundamentals (TryGetComponent, FindAnyObjectByType), unity-ui (UI systems, Canvas, UGUI)

Core Topics:

• SDF font asset creation and configuration

• Dynamic vs static font assets

• Rich text formatting and styling

• Material presets and text effects

• Performance optimization patterns

• Localization and dynamic text handling

Quick Start

Basic Text Setup

using TMPro; using UnityEngine;

public class TextController : MonoBehaviour { [SerializeField] private TMP_Text mDisplayText;

void Start()
{
    mDisplayText.text = "Hello, World!";
    mDisplayText.fontSize = 36;
    mDisplayText.color = Color.white;
}

}

TMP_Text vs TextMeshProUGUI vs TextMeshPro

// TMP_Text - Base class, use for serialization (works with both) [SerializeField] private TMP_Text mText;

// TextMeshProUGUI - Canvas UI text (most common) [SerializeField] private TextMeshProUGUI mUiText;

// TextMeshPro - 3D world space text (MeshRenderer) [SerializeField] private TextMeshPro mWorldText;

Rich Text Formatting

// Basic formatting text.text = "<b>Bold</b> and <i>Italic</i>"; text.text = "<size=48>Large</size> and <size=24>Small</size>"; text.text = "<color=#FF0000>Red</color> text";

// Advanced formatting text.text = "<mark=#FFFF00AA>Highlighted</mark>"; text.text = "H₂O and E=mc²"; text.text = "<s>Strikethrough</s> and <u>Underline</u>";

// Sprite embedding text.text = "Score: 100 <sprite=0>";

Component Selection Guide

Scenario Component Reason

UI Canvas text TextMeshProUGUI Canvas integration, auto-batching

3D world labels TextMeshPro MeshRenderer, world-space

Serialized reference TMP_Text Works with both types

Input field TMP_InputField Built-in input handling

Dropdown TMP_Dropdown Built-in dropdown UI

Font Asset Best Practices

Font Asset Types

Static Font Asset:

• Pre-generated character set
• Best performance (no runtime generation)
• Use for: Known character sets, optimized builds

Dynamic Font Asset:

• Runtime character generation
• Flexible but slower initial render
• Use for: Localization, user input, unknown characters

Creating Optimal Font Assets

Font Asset Creator (Window > TextMeshPro > Font Asset Creator)

• Set appropriate Atlas Resolution (1024x1024 for basic, 2048x2048 for CJK)

• Use "Custom Character List" for known character sets

• Enable Multi Atlas Textures for large character sets

Sampling Point Size: Use highest size that fits atlas (better quality)

Padding: 5-9 for normal use, higher for effects (outline, glow)

Performance Guidelines

Text Update Optimization

// BAD: Frequent text changes trigger mesh rebuild void Update() { scoreText.text = $"Score: {score}"; // Rebuilds every frame }

// GOOD: Update only when value changes private int mLastScore = -1;

void Update() { if (score != mLastScore) { mLastScore = score; scoreText.text = $"Score: {score}"; } }

// BETTER: Use SetText for formatted updates (less allocation) void UpdateScore(int score) { scoreText.SetText("Score: {0}", score); }

Memory-Efficient Patterns

// Use StringBuilder for complex text construction private readonly StringBuilder mSb = new StringBuilder(256);

void BuildComplexText() { mSb.Clear(); mSb.Append("Player: "); mSb.Append(playerName); mSb.Append(" | Score: "); mSb.Append(score); displayText.SetText(mSb); }

// Prefer SetText with parameters over string interpolation text.SetText("{0}/{1}", currentHP, maxHP); // Less GC // Instead of text.text = $"{currentHP}/{maxHP}"; // More GC

Material Presets

// Apply material preset at runtime [SerializeField] private Material mHighlightMaterial; [SerializeField] private Material mNormalMaterial;

void Highlight(bool active) { mText.fontMaterial = active ? mHighlightMaterial : mNormalMaterial; }

// Modify material properties mText.fontMaterial.SetFloat(ShaderUtilities.ID_OutlineWidth, 0.2f); mText.fontMaterial.SetColor(ShaderUtilities.ID_OutlineColor, Color.black);

Reference Documentation

Fundamentals

Core TextMeshPro concepts:

• SDF technology explanation

• Font asset creation workflow

• Character sets and fallback fonts

• Sprite assets integration

• Style sheets usage

Performance Optimization

Optimization techniques:

• Mesh geometry optimization

• Dynamic batching strategies

• Font atlas memory management

• Text update minimization patterns

• Profiling text rendering

Advanced Patterns

Advanced usage patterns:

• Custom shaders and effects

• Text animation techniques

• Localization integration

• Typewriter effects

• Link and event handling

Key Principles

• Use TMP_Text for References: Base class works with both UI and 3D text

• Prefer SetText() over .text: Reduces GC allocations for dynamic values

• Update Only When Changed: Avoid unnecessary mesh rebuilds

• Choose Appropriate Font Assets: Static for performance, Dynamic for flexibility

• Batch Similar Text: Group text with same material for draw call reduction

Common Anti-Patterns

// AVOID: Creating new materials per text instance text.fontMaterial = new Material(text.fontMaterial); // Memory leak risk

// AVOID: Updating text in Update() without change check void Update() { text.text = score.ToString(); } // Constant rebuild

// AVOID: Excessive rich text nesting text.text = "<b><i><color=#FF0000><size=48>...</size></color></i></b>";

// AVOID: Dynamic fonts for static content // Use pre-generated static font assets instead

Platform Considerations

• Mobile: Use static font assets, minimize atlas size, avoid complex effects

• WebGL: Pre-load font assets, avoid dynamic font generation

• VR/AR: Consider text readability, use larger fonts, avoid thin outlines

Integration with Other Skills

• unity-ui: TextMeshPro integrates with Canvas and UI Toolkit

• unity-performance: Text rendering impacts draw calls and memory

• unity-mobile: Font asset optimization critical for mobile

• unity-async: Async font loading with Addressables