Class TextMeshProUGUI

Inheritance
Object
UIBehaviour
Graphic
MaskableGraphic
TMP_Text
TextMeshProUGUI
Inherited Members
UnityEngine.UI.MaskableGraphic.OnValidate()
UnityEngine.UI.MaskableGraphic.UnityEngine.UI.IClippable.get_gameObject()
UnityEngine.UI.Graphic.SetRaycastDirty()
UnityEngine.UI.Graphic.OnRebuildRequested()
UnityEngine.UI.Graphic.Reset()
UnityEngine.UI.Graphic.UnityEngine.UI.ICanvasElement.get_transform()
Namespace: TMPro
Syntax
[DisallowMultipleComponent]
[RequireComponent(typeof(RectTransform))]
[RequireComponent(typeof(CanvasRenderer))]
[AddComponentMenu("UI/TextMeshPro - Text (UI)", 11)]
[ExecuteAlways]
[HelpURL("https://docs.unity3d.com/Packages/com.unity.textmeshpro@4.0")]
public class TextMeshProUGUI : TMP_Text, ICanvasElement, IClippable, IMaskable, IMaterialModifier, ILayoutElement

Fields

m_subTextObjects

Declaration
protected TMP_SubMeshUI[] m_subTextObjects
Field Value
Type Description
TMP_SubMeshUI[]

Properties

autoSizeTextContainer

Determines if the size of the text container will be adjusted to fit the text object when it is first created.

Declaration
public override bool autoSizeTextContainer { get; set; }
Property Value
Type Description
Boolean
Overrides

canvasRenderer

Reference to the CanvasRenderer used by the text object.

Declaration
public CanvasRenderer canvasRenderer { get; }
Property Value
Type Description
CanvasRenderer

maskOffset

Sets the masking offset from the bounds of the object

Declaration
public Vector4 maskOffset { get; set; }
Property Value
Type Description
Vector4

materialForRendering

Get the material that will be used for rendering.

Declaration
public override Material materialForRendering { get; }
Property Value
Type Description
Material
Overrides

mesh

Reference to the Mesh used by the text object.

Declaration
public override Mesh mesh { get; }
Property Value
Type Description
Mesh
Overrides

Methods

Awake()

Declaration
protected override void Awake()
Overrides

CalculateLayoutInputHorizontal()

Function called by Unity when the horizontal layout needs to be recalculated.

Declaration
public void CalculateLayoutInputHorizontal()
Implements

CalculateLayoutInputVertical()

Function called by Unity when the vertical layout needs to be recalculated.

Declaration
public void CalculateLayoutInputVertical()
Implements

ClearMesh()

Function to clear the geometry of the Primary and Sub Text objects.

Declaration
public override void ClearMesh()
Overrides

ComputeMarginSize()

Update the margin width and height

Declaration
public override void ComputeMarginSize()
Overrides

Cull(Rect, Boolean)

Override of the Cull function to provide for the ability to override the culling of the text object.

Declaration
public override void Cull(Rect clipRect, bool validRect)
Parameters
Type Name Description
Rect clipRect
Boolean validRect

DestroySubMeshObjects()

Destroy Sub Mesh Objects

Declaration
protected override void DestroySubMeshObjects()
Overrides

ForceMeshUpdate(Boolean, Boolean)

Function to force regeneration of the text object before its normal process time. This is useful when changes to the text object properties need to be applied immediately.

Declaration
public override void ForceMeshUpdate(bool ignoreActiveState = false, bool forceTextReparsing = false)
Parameters
Type Name Description
Boolean ignoreActiveState

Ignore Active State of text objects. Inactive objects are ignored by default.
Boolean forceTextReparsing

Force re-parsing of the text.
Overrides

GenerateTextMesh()

This is the main function that is responsible for creating / displaying the text.

Declaration
protected virtual void GenerateTextMesh()

GetCompoundBounds()

Method returning the compound bounds of the text object and child sub objects.

Declaration
protected override Bounds GetCompoundBounds()
Returns
Type Description
Bounds
Overrides

GetMaterial(Material)

Declaration
protected override Material GetMaterial(Material mat)
Parameters
Type Name Description
Material mat
Returns
Type Description
Material
Overrides

GetMaterials(Material[])

Method returning instances of the materials used by the text object.

Declaration
protected override Material[] GetMaterials(Material[] mats)
Parameters
Type Name Description
Material[] mats
Returns
Type Description
Material[]
Overrides

GetModifiedMaterial(Material)

Declaration
public override Material GetModifiedMaterial(Material baseMaterial)
Parameters
Type Name Description
Material baseMaterial
Returns
Type Description
Material

GetSharedMaterials()

Method returning an array containing the materials used by the text object.

Declaration
protected override Material[] GetSharedMaterials()
Returns
Type Description
Material[]
Overrides

GetTextContainerLocalCorners()

Method to return the local corners of the Text Container or RectTransform.

Declaration
protected override Vector3[] GetTextContainerLocalCorners()
Returns
Type Description
Vector3[]
Overrides

GetTextInfo(String)

Function used to evaluate the length of a text string.

Declaration
public override TMP_TextInfo GetTextInfo(string text)
Parameters
Type Name Description
String text
Returns
Type Description
TMP_TextInfo
Overrides

InternalCrossFadeAlpha(Single, Single, Boolean)

Tweens the alpha of the CanvasRenderer color associated with this Graphic.

Declaration
protected override void InternalCrossFadeAlpha(float alpha, float duration, bool ignoreTimeScale)
Parameters
Type Name Description
Single alpha

Target alpha.
Single duration

Duration of the tween in seconds.
Boolean ignoreTimeScale

Should ignore Time.scale?
Overrides

InternalCrossFadeColor(Color, Single, Boolean, Boolean)

Tweens the CanvasRenderer color associated with this Graphic.

Declaration
protected override void InternalCrossFadeColor(Color targetColor, float duration, bool ignoreTimeScale, bool useAlpha)
Parameters
Type Name Description
Color targetColor

Target color.
Single duration

Tween duration.
Boolean ignoreTimeScale

Should ignore Time.scale?
Boolean useAlpha

Should also Tween the alpha channel?
Overrides

LoadFontAsset()

Declaration
protected override void LoadFontAsset()
Overrides

OnCanvasHierarchyChanged()

Declaration
protected override void OnCanvasHierarchyChanged()
Overrides

OnDestroy()

Declaration
protected override void OnDestroy()
Overrides

OnDidApplyAnimationProperties()

Declaration
protected override void OnDidApplyAnimationProperties()
Overrides

OnDisable()

Declaration
protected override void OnDisable()
Overrides

OnEnable()

Declaration
protected override void OnEnable()
Overrides

OnRectTransformDimensionsChange()

Declaration
protected override void OnRectTransformDimensionsChange()
Overrides

OnTransformParentChanged()

Declaration
protected override void OnTransformParentChanged()
Overrides

Rebuild(CanvasUpdate)

Declaration
public override void Rebuild(CanvasUpdate update)
Parameters
Type Name Description
CanvasUpdate update
Overrides

RecalculateClipping()

Method called when the state of a parent changes.

Declaration
public override void RecalculateClipping()
Overrides

SetActiveSubMeshes(Boolean)

Method to Enable or Disable child SubMesh objects.

Declaration
protected override void SetActiveSubMeshes(bool state)
Parameters
Type Name Description
Boolean state
Overrides

SetAllDirty()

Declaration
public override void SetAllDirty()
Overrides

SetCulling()

Declaration
protected override void SetCulling()
Overrides

SetFaceColor(Color32)

Declaration
protected override void SetFaceColor(Color32 color)
Parameters
Type Name Description
Color32 color
Overrides

SetLayoutDirty()

Declaration
public override void SetLayoutDirty()
Overrides

SetMaterialDirty()

Declaration
public override void SetMaterialDirty()
Overrides

SetOutlineColor(Color32)

Declaration
protected override void SetOutlineColor(Color32 color)
Parameters
Type Name Description
Color32 color
Overrides

SetOutlineThickness(Single)

Declaration
protected override void SetOutlineThickness(float thickness)
Parameters
Type Name Description
Single thickness
Overrides

SetShaderDepth()

Declaration
protected override void SetShaderDepth()
Overrides

SetSharedMaterial(Material)

Declaration
protected override void SetSharedMaterial(Material mat)
Parameters
Type Name Description
Material mat
Overrides

SetSharedMaterials(Material[])

Method used to assign new materials to the text and sub text objects.

Declaration
protected override void SetSharedMaterials(Material[] materials)
Parameters
Type Name Description
Material[] materials
Overrides

SetVerticesDirty()

Declaration
public override void SetVerticesDirty()
Overrides

UpdateFontAsset()

Declaration
public void UpdateFontAsset()

UpdateGeometry(Mesh, Int32)

Function to update the geometry of the main and sub text objects.

Declaration
public override void UpdateGeometry(Mesh mesh, int index)
Parameters
Type Name Description
Mesh mesh
Int32 index
Overrides

UpdateMaterial()

Declaration
protected override void UpdateMaterial()
Overrides

UpdateMeshPadding()

Function to be used to force recomputing of character padding when Shader / Material properties have been changed via script.

Declaration
public override void UpdateMeshPadding()
Overrides

UpdateVertexData()

Function to upload the updated vertex data and renderer.

Declaration
public override void UpdateVertexData()
Overrides

UpdateVertexData(TMP_VertexDataUpdateFlags)

Function to upload the updated vertex data and renderer.

Declaration
public override void UpdateVertexData(TMP_VertexDataUpdateFlags flags)
Parameters
Type Name Description
TMP_VertexDataUpdateFlags flags
Overrides

Events

OnPreRenderText

Event to allow users to modify the content of the text info before the text is rendered.

Declaration
public override event Action<TMP_TextInfo> OnPreRenderText
Event Type
Type Description
Action<TMP_TextInfo>
Overrides