Class TextMeshPro
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(MeshRenderer))]
[AddComponentMenu("Mesh/TextMeshPro - Text")]
[ExecuteAlways]
[HelpURL("https://docs.unity3d.com/Packages/com.unity.textmeshpro@4.0")]
public class TextMeshPro : TMP_Text, ICanvasElement, IClippable, IMaskable, IMaterialModifier, ILayoutElement
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
Overrides
maskType
Declaration
public MaskingTypes maskType { get; set; }
Property Value
mesh
Returns the mesh assigned to the text object.
Declaration
public override Mesh mesh { get; }
Property Value
Overrides
meshFilter
Returns the Mesh Filter of the text object.
Declaration
public MeshFilter meshFilter { get; }
Property Value
renderer
Returns the rendered assigned to the text object.
Declaration
public Renderer renderer { get; }
Property Value
sortingLayerID
Sets the Renderer's sorting Layer ID
Declaration
public int sortingLayerID { get; set; }
Property Value
sortingOrder
Sets the Renderer's sorting order within the assigned layer.
Declaration
public int sortingOrder { get; set; }
Property Value
transform
Returns a reference to the Transform
Declaration
public Transform transform { get; }
Property Value
Methods
Awake()
Declaration
protected override void Awake()
Overrides
CalculateLayoutInputHorizontal()
Declaration
public void CalculateLayoutInputHorizontal()
Implements
CalculateLayoutInputVertical()
Declaration
public void CalculateLayoutInputVertical()
Implements
ClearMesh(Boolean)
Function to clear the geometry of the Primary and Sub Text objects.
Declaration
public override void ClearMesh(bool updateMesh)
Parameters
| Type |
Name |
Description |
| Boolean |
updateMesh |
|
Overrides
ComputeMarginSize()
Update the margin width and height
Declaration
public override void ComputeMarginSize()
Overrides
DestroySubMeshObjects()
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
Overrides
GetMaterial(Material)
Declaration
protected override Material GetMaterial(Material mat)
Parameters
Returns
Overrides
GetMaterials(Material[])
Method returning instances of the materials used by the text object.
Declaration
protected override Material[] GetMaterials(Material[] mats)
Parameters
Returns
Overrides
GetSharedMaterials()
Method returning an array containing the materials used by the text object.
Declaration
protected override Material[] GetSharedMaterials()
Returns
Overrides
GetTextContainerLocalCorners()
Method to return the local corners of the Text Container or RectTransform.
Declaration
protected override Vector3[] GetTextContainerLocalCorners()
Returns
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
Overrides
LoadFontAsset()
Declaration
protected override void LoadFontAsset()
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
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
SetActiveSubTextObjectRenderers(Boolean)
Declaration
protected void SetActiveSubTextObjectRenderers(bool state)
Parameters
| Type |
Name |
Description |
| Boolean |
state |
|
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
SetMask(MaskingTypes, Vector4)
Function used to set the mask type and coordinates in World Space
Declaration
public void SetMask(MaskingTypes type, Vector4 maskCoords)
Parameters
SetMask(MaskingTypes, Vector4, Single, Single)
Function used to set the mask type, coordinates and softness
Declaration
public void SetMask(MaskingTypes type, Vector4 maskCoords, float softnessX, float softnessY)
Parameters
SetMaterialDirty()
Schedule updating of the material used by the text object.
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
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()
Schedule rebuilding of the text geometry.
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
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
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
Overrides