3.2.0-pre.4

[3.2.0-pre.4] - 2022-12-16

Changes

• Fixed italic horizontal displacement of punctuation. (TMPB-133)
• Updated Input Field to not restore the original text when the X in the HoloLens keyboard is pressed.
• Fixed MissingReferenceException when changing scenes. See case TMPB-120 and forum thread for more info.
• Fixed Undo operation not correctly undoing some newly created TMP objects. Case #1400391
• Fixed glyphs not being drawn in the various font asset inspector tables although present in the glyph table until unselecting and re-selecting the font asset.
• Fixed incorrect line breaking when using a mixture of Latin and CJK text.
• Fixed potential NullReferenceException when creating font asset with multiple atlas textures. See forum post for details.
• Fixed potential issue when using the <mark> tag in conjunction with Ellipsis.
• Added new "Get Font Features" option in the Generation Settings of Font Assets to provide control over fetching of font feature data.
• Fix potential duplication of Ligature data when using Dynamic Font Assets.
• Added new "duospace" attribute to the <mspace=value> markup tag where the spacing of the '.', ':' and ',' characters will be half of the value. This was added as an option when displaying numerical values using this markup tag.
• With the addition of support for new OpenType Layout features such as Ligatures, Mark-to-Base and Mark-to-Mark, we have made the following changes:
  • The "Kerning" option in the Extra Settings of the text component inspector has been replaced by a new popup menu to independently control these features which are "kern", "liga", "mark" and "mkmk"
  • The "enableKerning" property has been deprecated and replaced by the "fontFeatures" property which is a list that contains which features are enabled on the text component.
• Fixed two potential NullReferenceException related to missing material references or materials on SubMesh text objects. See forum post for details.
• Fixed for text alignment mode Justified and Flush blending not working correctly when using <NBSP> in the text.
• Fixed external keyboard on iOS/tvOS and Android when Hide Soft Keyboard is used

3.2.0-pre.3

[3.2.0-pre.3] - 2022-03-07

Changes

• Fixed a potential IndexOutOfRangeException when trying to select any portions of text in an Input Field whose child text component is using Overflow mode Truncate or Ellipsis where due to RectTransform width and / or height restrictions have results in the text being fully truncated. Case #1361032
• Fixed incorrect character sequencing in the Input Field when using Japanese IME in UWP builds. Case #1374755
• Fixed several potential IndexOutOfRangeException in the Input Field when text is fully truncated when using Text Overflow mode Ellipsis or Truncate.
• Fixed Input Field incorrect caretPosition and / or stringPosition properties when updating these via scripting. Case #1334622
• Fixed incorrect event handling on UWP and Hololens 2. Case #1357718 and Case #1351006
• Fixed Input Field OnSelect event potentially firing twice on some mobile devices including Microsoft Surfaces.
• Fixed Input Field incorrect caret insertion position when text contains a Carriage Return <CR> at the end of a line. Case #1362068
• Added support for <CR> markup tag.
• Added value range check for the text component margins located in the text component extra settings. Case #1365554
• Added new overload to the TMP_FontAsset.CreateFontAsset() to enable creating font asset instances using a file path.
• Added new TMP_ResourceManager.RemoveFontAsset() function to remove a font asset from the TMP Resource Manager. This new function would typically be used prior to unloading bundles and / or resources.
• Warnings about potentially missing character 0x5F used to display underline or strikethrough will only be displayed when using those features when Display Warning is enabled in the TMP Settings.
• Fixed incorrect handling of '-' at the end of a line when using Text Overflow Page mode. Case #1382173
• Fixed incorrect line breaking when a hyphen '-' is preceded by a space. Case #1391990
• When using Text Wrapping Mode - Preserve White Space or Preserve White Space No Wrap, the <ZWSP> character will now contribute to the preferred height when it is the first and only character on a new line.
• Added ClearFontAssetGlyphCache() function to the TMP_ResourcesManager to enable clearing the font asset fallback glyph cache.
• Added new <ZWJ> markup tag.
• Added ability to define a list of fallback text assets in the TMP Settings to be used for Emojis.
• Added new property "emojiFallbackSupport" to text components which is also exposed in the extra settings section of the text component inspector. When enabled, this will prioritize searching the Emoji Fallback Text Assets before the primary font asset for characters defined as Emoji in Unicode 14.0. See forum post for details.
• Fixed duplicated character when using custom validator in conjunction with soft keyboard. Case #1387772
• The <noparse> markup tag will now also affect inline markup tags like <br>, <shy>, etc.
• Fixed newly created StyleSheets having two Normal styles.
• Added new Double Pass SDF shader and example scene to the TMP Examples & Extras to showcase this new shader.
• Added new context menu option to manually "clear dynamic data" of a dynamic font asset. This performs the same clearing of data as the "Clear Dynamic Data on Build" option when manually triggered.
• Added new <a href="url"> markup tag which can be used as follows: "See <a href="http://url..."&gt;this link</a> for details.". This new markup tag is similar to the <link> tag but does not use an ID.
• Added new "A" style to the Default Style Sheet referenced in the TMP Settings. This "A" style defines the styling of the new <a> markup tag.
• The TMP_Text.parseCtrlCharacters property which controls the interpretation and parsing of escape characters in the text component's Text Input box in the inspector, will now apply to all methods of setting the text on the component. Case #1400008
• Fixed potential Null Reference Exception when editing the name of a sprite character. Case #1396591
• Fixed issue where TMP_FontAsset.HasCharacters would return false when called prior to font asset initialization. Case #1394817
• Minor TMP_InputField UI improvement where "Hide Mobile Input" property will be disabled when "Hide Soft Keyboard" property is disabled. Case #1388243

2.2.0-preview.3

[2.2.0-preview.3] - 2022-03-07

Changes

• Fixed a potential IndexOutOfRangeException when trying to select any portions of text in an Input Field whose child text component is using Overflow mode Truncate or Ellipsis where due to RectTransform width and / or height restrictions have results in the text being fully truncated. Case #1361032
• Fixed incorrect character sequencing in the Input Field when using Japanese IME in UWP builds. Case #1374755
• Fixed several potential IndexOutOfRangeException in the Input Field when text is fully truncated when using Text Overflow mode Ellipsis or Truncate.
• Fixed Input Field incorrect caretPosition and / or stringPosition properties when updating these via scripting. Case #1334622
• Fixed incorrect event handling on UWP and Hololens 2. Case #1357718 and Case #1351006
• Fixed Input Field OnSelect event potentially firing twice on some mobile devices including Microsoft Surfaces.
• Fixed Input Field incorrect caret insertion position when text contains a Carriage Return <CR> at the end of a line. Case #1362068
• Added support for <CR> markup tag.
• Added value range check for the text component margins located in the text component extra settings. Case #1365554
• Added new overload to the TMP_FontAsset.CreateFontAsset() to enable creating font asset instances using a file path.
• Added new TMP_ResourceManager.RemoveFontAsset() function to remove a font asset from the TMP Resource Manager. This new function would typically be used prior to unloading bundles and / or resources.
• Warnings about potentially missing character 0x5F used to display underline or strikethrough will only be displayed when using those features when Display Warning is enabled in the TMP Settings.
• Fixed incorrect handling of '-' at the end of a line when using Text Overflow Page mode. Case #1382173
• Fixed incorrect line breaking when a hyphen '-' is preceded by a space. Case #1391990
• When using Text Wrapping Mode - Preserve White Space or Preserve White Space No Wrap, the <ZWSP> character will now contribute to the preferred height when it is the first and only character on a new line.
• Added ClearFontAssetGlyphCache() function to the TMP_ResourcesManager to enable clearing the font asset fallback glyph cache.
• Added new <ZWJ> markup tag.
• Added ability to define a list of fallback text assets in the TMP Settings to be used for Emojis.
• Added new property "emojiFallbackSupport" to text components which is also exposed in the extra settings section of the text component inspector. When enabled, this will prioritize searching the Emoji Fallback Text Assets before the primary font asset for characters defined as Emoji in Unicode 14.0. See forum post for details.
• Fixed duplicated character when using custom validator in conjunction with soft keyboard. Case #1387772
• The <noparse> markup tag will now also affect inline markup tags like <br>, <shy>, etc.
• Fixed newly created StyleSheets having two Normal styles.
• Added new Double Pass SDF shader and example scene to the TMP Examples & Extras to showcase this new shader.
• Added new context menu option to manually "clear dynamic data" of a dynamic font asset. This performs the same clearing of data as the "Clear Dynamic Data on Build" option when manually triggered.
• Added new <a href="url"> markup tag which can be used as follows: "See <a href="http://url..."&gt;this link</a> for details.". This new markup tag is similar to the <link> tag but does not use an ID.
• Added new "A" style to the Default Style Sheet referenced in the TMP Settings. This "A" style defines the styling of the new <a> markup tag.
• The TMP_Text.parseCtrlCharacters property which controls the interpretation and parsing of escape characters in the text component's Text Input box in the inspector, will now apply to all methods of setting the text on the component. Case #1400008
• Fixed potential Null Reference Exception when editing the name of a sprite character. Case #1396591
• Fixed issue where TMP_FontAsset.HasCharacters would return false when called prior to font asset initialization. Case #1394817
• Minor TMP_InputField UI improvement where "Hide Mobile Input" property will be disabled when "Hide Soft Keyboard" property is disabled. Case #1388243

4.0.0-pre.2

[4.0.0-pre.2] - 2021-11-20

Changes

• Fixed italic horizontal displacement of punctuation. (TMPB-133)
• Updated Input Field to not restore the original text when the X in the HoloLens keyboard is pressed.
• Fixed MissingReferenceException when changing scenes. See case TMPB-120 and forum thread for more info.
• Fixed Undo operation not correctly undoing some newly created TMP objects. Case #1400391
• Fixed glyphs not being drawn in the various font asset inspector tables although present in the glyph table until unselecting and re-selecting the font asset.
• Fixed incorrect line breaking when using a mixture of Latin and CJK text.
• Fixed potential NullReferenceException when creating font asset with multiple atlas textures. See forum post for details.
• Fixed potential issue when using the <mark> tag in conjunction with Ellipsis.
• Added new "Get Font Features" option in the Generation Settings of Font Assets to provide control over fetching of font feature data.
• Fix potential duplication of Ligature data when using Dynamic Font Assets.
• Added new "duospace" attribute to the <mspace=value> markup tag where the spacing of the '.', ':' and ',' characters will be half of the value. This was added as an option when displaying numerical values using this markup tag.
• With the addition of support for new OpenType Layout features such as Ligatures, Mark-to-Base and Mark-to-Mark, we have made the following changes:
  • The "Kerning" option in the Extra Settings of the text component inspector has been replaced by a new popup menu to independently control these features which are "kern", "liga", "mark" and "mkmk"
  • The "enableKerning" property has been deprecated and replaced by the "fontFeatures" property which is a list that contains which features are enabled on the text component.
• Fixed two potential NullReferenceException related to missing material references or materials on SubMesh text objects. See forum post for details.
• Fixed for text alignment mode Justified and Flush blending not working correctly when using <NBSP> in the text.
• Fixed external keyboard on iOS/tvOS and Android when Hide Soft Keyboard is used
• • Fixed a potential IndexOutOfRangeException when trying to select any portions of text in an Input Field whose child text component is using Overflow mode Truncate or Ellipsis where due to RectTransform width and / or height restrictions have results in the text being fully truncated. Case #1361032
• Fixed incorrect character sequencing in the Input Field when using Japanese IME in UWP builds. Case #1374755
• Fixed several potential IndexOutOfRangeException in the Input Field when text is fully truncated when using Text Overflow mode Ellipsis or Truncate.
• Fixed Input Field incorrect caretPosition and / or stringPosition properties when updating these via scripting. Case #1334622
• Fixed incorrect event handling on UWP and Hololens 2. Case #1357718 and Case #1351006
• Fixed Input Field OnSelect event potentially firing twice on some mobile devices including Microsoft Surfaces.
• Fixed Input Field incorrect caret insertion position when text contains a Carriage Return <CR> at the end of a line. Case #1362068
• Added support for <CR> markup tag.
• Added value range check for the text component margins located in the text component extra settings. Case #1365554
• Added new overload to the TMP_FontAsset.CreateFontAsset() to enable creating font asset instances using a file path.
• Added new TMP_ResourceManager.RemoveFontAsset() function to remove a font asset from the TMP Resource Manager. This new function would typically be used prior to unloading bundles and / or resources.
• Warnings about potentially missing character 0x5F used to display underline or strikethrough will only be displayed when using those features when Display Warning is enabled in the TMP Settings.
• Fixed incorrect handling of '-' at the end of a line when using Text Overflow Page mode. Case #1382173
• Fixed incorrect line breaking when a hyphen '-' is preceded by a space. Case #1391990
• When using Text Wrapping Mode - Preserve White Space or Preserve White Space No Wrap, the <ZWSP> character will now contribute to the preferred height when it is the first and only character on a new line.
• Added ClearFontAssetGlyphCache() function to the TMP_ResourcesManager to enable clearing the font asset fallback glyph cache.
• Added new <ZWJ> markup tag.
• Added ability to define a list of fallback text assets in the TMP Settings to be used for Emojis.
• Added new property "emojiFallbackSupport" to text components which is also exposed in the extra settings section of the text component inspector. When enabled, this will prioritize searching the Emoji Fallback Text Assets before the primary font asset for characters defined as Emoji in Unicode 14.0. See forum post for details.
• Fixed duplicated character when using custom validator in conjunction with soft keyboard. Case #1387772
• The <noparse> markup tag will now also affect inline markup tags like <br>, <shy>, etc.
• Fixed newly created StyleSheets having two Normal styles.
• Added new Double Pass SDF shader and example scene to the TMP Examples & Extras to showcase this new shader.
• Added new context menu option to manually "clear dynamic data" of a dynamic font asset. This performs the same clearing of data as the "Clear Dynamic Data on Build" option when manually triggered.
• Added new <a href="url"> markup tag which can be used as follows: "See <a href="http://url..."&gt;this link</a> for details.". This new markup tag is similar to the <link> tag but does not use an ID.
• Added new "A" style to the Default Style Sheet referenced in the TMP Settings. This "A" style defines the styling of the new <a> markup tag.
• The TMP_Text.parseCtrlCharacters property which controls the interpretation and parsing of escape characters in the text component's Text Input box in the inspector, will now apply to all methods of setting the text on the component. Case #1400008
• Fixed potential Null Reference Exception when editing the name of a sprite character. Case #1396591
• Fixed issue where TMP_FontAsset.HasCharacters would return false when called prior to font asset initialization. Case #1394817
• Minor TMP_InputField UI improvement where "Hide Mobile Input" property will be disabled when "Hide Soft Keyboard" property is disabled. Case #1388243

3.2.0-pre.2

[3.2.0-pre.2] - 2021-10-31

Changes

• Fixed incorrect character spacing when using the <scale> tag. See forum post for details.
• Added Unicode code point range for Arabic Mark glyphs. See forum post for details.
• Added support for creating multiple Sprite Assets at once by selecting multiple sprite textures and using the "Create - TextMeshPro - Sprite Asset" context menu.
• Added new class definition type to the glyph class. This new property will only be visible when included in a new release of the Unity Editor.
• Fixed incorrect update of SDF Scale when text object scale is zero. The previous optimization where SDF Scale only gets updated when lossy scale change exceeds 20% of the previous value remains. See forum post for details.
• Fixed text objects not being visible when using a mixture of <TextMeshPro> objects with ≶TextMeshProUGUI> objects in Screenspace Overlay when these objects share the same material preset. See forum post for details.
• Updated TMP Essential Resources to include updated shaders to address texture mapping issue with one of the SDF shaders.
• Fixed a few inspector issues related to fallback glyph caching when adding, deleting and reordering fallback font asset lists.
• Minor change to the Font Asset Creator to prevent setting a face size of zero when using Auto Sizing mode. Case #1368638.
• Fixed incorrect selection of font face in the Font Asset Creator when using the "Update Atlas Texture" button in the Font Asset inspector. Case #1366468.
• Fixed incorrect Character Set selection being recalled when using the "Update Atlas Texture" button in the Font Asset inspector. Case #1368517.
• Fixed scene remaining dirty after undoing a change to a TMP text component which dirtied the scene. Case #1296400
• Improved Android / Chrome OS hardware keyboard support.
• Fixed incorrect parsing of invalid UTF16 and UTF32 character sequences. Case #1367695
• Added new example to the TMP Examples & Extras to showcase new HDRP shaders and inspector.
• Added support for GameCore platform support in the TMP Input Field.
• Added new Ligature Table to Font Assets allowing users to manually define Ligatures. This is a first pass at adding support for Ligatures.

2.2.0-preview.2

[2.2.0-preview.2] - 2021-10-31

Changes

• Fixed incorrect character spacing when using the <scale> tag. See forum post for details.
• Added Unicode code point range for Arabic Mark glyphs. See forum post for details.
• Added support for creating multiple Sprite Assets at once by selecting multiple sprite textures and using the "Create - TextMeshPro - Sprite Asset" context menu.
• Added new class definition type to the glyph class. This new property will only be visible when included in a new release of the Unity Editor.
• Fixed incorrect update of SDF Scale when text object scale is zero. The previous optimization where SDF Scale only gets updated when lossy scale change exceeds 20% of the previous value remains. See forum post for details.
• Fixed text objects not being visible when using a mixture of <TextMeshPro> objects with ≶TextMeshProUGUI> objects in Screenspace Overlay when these objects share the same material preset. See forum post for details.
• Fixed a few inspector issues related to fallback glyph caching when adding, deleting and reordering fallback font asset lists.
• Minor change to the Font Asset Creator to prevent setting a face size of zero when using Auto Sizing mode. Case #1368638.
• Fixed incorrect selection of font face in the Font Asset Creator when using the "Update Atlas Texture" button in the Font Asset inspector. Case #1366468.
• Fixed incorrect Character Set selection being recalled when using the "Update Atlas Texture" button in the Font Asset inspector. Case #1368517.
• Fixed scene remaining dirty after undoing a change to a TMP text component which dirtied the scene. Case #1296400
• Improved Android / Chrome OS hardware keyboard support.
• Fixed incorrect parsing of invalid UTF16 and UTF32 character sequences. Case #1367695
• Added support for GameCore platform support in the TMP Input Field.
• Added new Ligature Table to Font Assets allowing users to manually define Ligatures. This is a first pass at adding support for Ligatures.

4.0.0-pre.1

[4.0.0-pre.1] - 2021-10-27

Changes

• Fixed incorrect character spacing when using the <scale> tag. See forum post for details.
• Added Unicode code point range for Arabic Mark glyphs. See forum post for details.
• Added support for creating multiple Sprite Assets at once by selecting multiple sprite textures and using the "Create - TextMeshPro - Sprite Asset" context menu.
• Added new class definition type to the glyph class. This new property will only be visible when included in a new release of the Unity Editor.
• Fixed incorrect update of SDF Scale when text object scale is zero. The previous optimization where SDF Scale only gets updated when lossy scale change exceeds 20% of the previous value remains. See forum post for details.
• Fixed text objects not being visible when using a mixture of <TextMeshPro> objects with ≶TextMeshProUGUI> objects in Screenspace Overlay when these objects share the same material preset. See forum post for details.
• Updated TMP Essential Resources to include updated shaders to address texture mapping issue with one of the SDF shaders.
• Fixed a few inspector issues related to fallback glyph caching when adding, deleting and reordering fallback font asset lists.
• Minor change to the Font Asset Creator to prevent setting a face size of zero when using Auto Sizing mode. Case #1368638.
• Fixed incorrect selection of font face in the Font Asset Creator when using the "Update Atlas Texture" button in the Font Asset inspector. Case #1366468.
• Fixed incorrect Character Set selection being recalled when using the "Update Atlas Texture" button in the Font Asset inspector. Case #1368517.
• Fixed scene remaining dirty after undoing a change to a TMP text component which dirtied the scene. Case #1296400
• Improved Android / Chrome OS hardware keyboard support.
• Fixed incorrect parsing of invalid UTF16 and UTF32 character sequences. Case #1367695
• Added new example to the TMP Examples & Extras to showcase new HDRP shaders and inspector.
• Added support for GameCore platform support in the TMP Input Field.

3.2.0-pre.1

[3.2.0-pre.1] - 2021-08-06

2.2.0-preview.1

[2.2.0-preview.1] - 2021-08-06

1.6.0-preview.1

[1.6.0-preview.1] - 2021-08-06

[2.2.0-preview.1]

[3.2.0-pre.1]

Changes

• Added support for manually defining Diacritical Mark-to-Base and Mark-to-Mark glyph positional adjustments in font assets.
• Updated the font asset editor to include new Mark-to-Base and Mark-to-Mark adjustment tables along with new Preview window to make it easier to edit adjustment records.
• Added OnMissingCharacter event delegate called when the requested Unicode character is missing from the font asset.
• Fixed Argument Null Exception when attempting to create a font asset via the Create Context menu prior to importing the TMP Essential Resources. Case #1290444
• Changes to Sorting Layer ID and Sorting Order of <TextMeshPro> will now be reflected on any potential sub text objects.
• Replaced Word Wrapping in the text component inspector by Text Wrapping Mode to introduce new text wrapping options that control whether whitespaces are preserved or ignored at the end of a line.
• Input Field OnSubmit event will no longer be invoked on focus change or edit cancellation. OnEndEdit will continue to be invoked on submit, focus change or cancellation of edit.
• Added support for <SHY> tag which is replaced internally by a soft hyphen or \u00AD.
• Fixed potential text parsing issue when using markup tags without using quotes to encapsulate their values or attribute values. Case #1316658.
• Revised the textInfo property to return a new TMP_TextInfo instance instead of null when the text component has not yet been awaken. Case #1318194.
• Added new property to TMP Settings to control whether or not sub text objects will be visible in the scene hierarchy.
• Added new "Clear Dynamic Data On Build" property to TMP Settings which determines if the "clearDynamicDataOnBuild" font asset property will be set to true or false on newly created dynamic font assets.
• Added fallback character lookup caching to improve subsequent lookups of these characters coming from font assets assigned as local or global fallbacks.
• Added support for Dynamic OS Font Assets. This new dynamic font asset type will enable users to use fonts present on target platforms and devices. See the following video for more details.
• Fixed issue where the <mark> tag color may be incorrect based on line breaking location. See forum post for details.
• Fixed glyph positional adjustment (kerning) incorrectly being applied to some characters at the end of a line.
• Fixed incorrect text alignment when using <cspace> tag. Case 1333571
• Fixed potential NullReferenceException in TMP Input Field in SendTouchScreenKeyboardStatusChanged(). See forum post for details.
• Obsoleted the SetText(string, bool) function since the text in the Text Input Box is always synced now. Re-added the SetText(string) function. See forum post for details.
• Revised GetPreferredValues(string, float, float) where it will now return the width of the longest line of text given the width restrictions. See forum post for details.
• Fixed GetPreferredValues() potentially returning incorrect values. See forum post for details.
• Fixed potential sub text object shader mismatch when changing the shader of the text object.
• Added isAlert property to the TMP Input Field to control if the TouchScreenKeyboard is opened in alert mode. See forum post for details.
• Added new property "shouldActivateOnSelect" to the TMP Input Field which determines if the input field will be activated automatically when selected.
• Fixed potential text rendering issue due to incorrect "Additional Shader Channels" when using nested canvases. Case #1337742
• Newly created sprite assets will now be given a unique name to prevent potential AssetDatabase issue. Case #1345123
• Fixed potential IndexOutOfRangeException in the Input Field when the text height exceeds the height of the Text Area in conjunction with using text overflow mode Ellipsis or Truncate. Case #1341172
• Fixed <mark> tag not rendering correctly when using one of the SSD shaders. See forum post for details.
• Fixed potential culling issue that was resulting in the culling being delayed by one frame. Case #1335854
• Vertex colors of the <TextMeshPro> component will be converted to linear space when Project Settings are set to Linear color space. Case #1349920
• Fixed potential TouchScreenKeyboard handling issue in the TMP Input Field with UWP. Case #1337129
• Revised handling of <CR><LF> in the Input Field text where these characters will be treated as one when using Left, Right, Backspace and Del keys when "Allow Rich Text Editing" property is disabled. See forum post for details.
• Added new property "keepTextSelectionVisible" to the Input Field which maintains the text selection visible when selecting other Input Fields or UI Elements. See forum post for details.
• Fixed potential Input Field text area viewport vertical alignment issue when using a vertical scrollbar and when the child text object's vertical margins are not zero. Case #1353535
• Revised handling of SDF Scale updates where the SDF Scale will now only be updated when the lossy scale of the text object changes by more than 20%. Case #1352120