From 9737d20b82e2c0a09b6588bca5b251a0f59b2018 Mon Sep 17 00:00:00 2001
From: Unity Technologies <@unity>
Date: Fri, 6 Aug 2021 00:00:00 +0000
Subject: [PATCH] com.unity.textmeshpro@3.2.0-pre.1 ## [3.2.0-pre.1] -
2021-08-06
---
CHANGELOG.md | 115 ++-
Editor Resources/Shaders/TMP_SDF_SSD.cginc | 4 +-
.../TMP Essential Resources.unitypackage | Bin 1323954 -> 1446837 bytes
.../TMP Examples & Extras.unitypackage | Bin 1939376 -> 1939312 bytes
Package Resources/TMP Shaders.unitypackage | Bin 0 -> 143468 bytes
.../TMP Shaders.unitypackage.meta | 4 +-
Scripts/Editor/DropdownOptionListDrawer.cs | 7 +-
Scripts/Editor/GlyphMetricsPropertyDrawer.cs | 2 +-
Scripts/Editor/HDRP.meta | 8 +
Scripts/Editor/HDRP/HDRP_LitShaderGUI.cs | 83 ++
.../HDRP_LitShaderGUI.cs.meta} | 3 +-
Scripts/Editor/HDRP/HDRP_UnlitShaderGUI.cs | 57 ++
.../Editor/HDRP/HDRP_UnlitShaderGUI.cs.meta | 11 +
.../Editor/HDRP/TMP_BaseHDRPLitShaderGUI.cs | 677 +++++++++++++
.../HDRP/TMP_BaseHDRPLitShaderGUI.cs.meta | 12 +
.../Editor/HDRP/TMP_BaseHDRPUnlitShaderGUI.cs | 677 +++++++++++++
.../HDRP/TMP_BaseHDRPUnlitShaderGUI.cs.meta | 12 +
.../Editor/HDRP/TMP_SDF_HDRPLitShaderGUI.cs | 638 ++++++++++++
.../HDRP/TMP_SDF_HDRPLitShaderGUI.cs.meta | 12 +
.../Editor/HDRP/TMP_SDF_HDRPUnlitShaderGUI.cs | 638 ++++++++++++
.../HDRP/TMP_SDF_HDRPUnlitShaderGUI.cs.meta | 12 +
Scripts/Editor/TMP_BaseEditorPanel.cs | 11 +-
Scripts/Editor/TMP_BaseShaderGUI.cs | 93 +-
Scripts/Editor/TMP_DropdownEditor.cs | 3 +
.../TMP_EditorResourceManager.cs | 113 ++-
.../TMP_EditorResourceManager.cs.meta | 0
Scripts/Editor/TMP_FontAssetEditor.cs | 916 +++++++++++++++++-
Scripts/Editor/TMP_FontAsset_CreationMenu.cs | 23 +-
...GlyphPairAdjustmentRecordPropertyDrawer.cs | 2 +-
Scripts/Editor/TMP_InputFieldEditor.cs | 23 +-
...arkToBaseAdjustmentRecordPropertyDrawer.cs | 271 ++++++
...BaseAdjustmentRecordPropertyDrawer.cs.meta | 11 +
...arkToMarkAdjustmentRecordPropertyDrawer.cs | 270 ++++++
...MarkAdjustmentRecordPropertyDrawer.cs.meta | 11 +
Scripts/Editor/TMP_MarkupTagUpdateUtility.cs | 282 ++++++
.../Editor/TMP_MarkupTagUpdateUtility.cs.meta | 11 +
Scripts/Editor/TMP_PostBuildProcessHandler.cs | 2 +-
Scripts/Editor/TMP_PreBuildProcessor.cs | 2 +-
Scripts/Editor/TMP_PreBuildProcessor.cs.meta | 2 +-
Scripts/Editor/TMP_ResourcesLoader.cs | 50 +-
Scripts/Editor/TMP_SDFShaderGUI.cs | 395 ++++++--
Scripts/Editor/TMP_SettingsEditor.cs | 38 +-
Scripts/Editor/TMP_SpriteAssetEditor.cs | 5 +-
Scripts/Editor/TMP_SpriteAssetMenu.cs | 4 +-
Scripts/Editor/TMPro_ContextMenus.cs | 33 +-
Scripts/Editor/TMPro_CreateObjectMenu.cs | 27 +-
.../Editor/TMPro_FontAssetCreatorWindow.cs | 150 ++-
Scripts/Editor/TMPro_FontPlugin.cs | 115 ---
Scripts/Editor/TMPro_TexturePostProcessor.cs | 27 +-
.../Editor/Unity.TextMeshPro.Editor.asmdef | 11 +-
Scripts/Runtime/FontFeatureCommonGPOS.cs | 151 +++
Scripts/Runtime/FontFeatureCommonGPOS.cs.meta | 11 +
Scripts/Runtime/FontFeatureCommonGSUB.cs | 76 ++
Scripts/Runtime/FontFeatureCommonGSUB.cs.meta | 11 +
Scripts/Runtime/MaterialReferenceManager.cs | 10 +-
Scripts/Runtime/TMP_Asset.cs | 63 +-
Scripts/Runtime/TMP_CharacterInfo.cs | 5 +-
Scripts/Runtime/TMP_DefaultControls.cs | 7 +-
Scripts/Runtime/TMP_Dropdown.cs | 192 +++-
.../Runtime/TMP_DynamicFontAssetUtilities.cs | 188 ++++
.../TMP_DynamicFontAssetUtilities.cs.meta | 11 +
Scripts/Runtime/TMP_FontAsset.cs | 573 +++++++----
Scripts/Runtime/TMP_FontAssetCommon.cs | 8 +-
Scripts/Runtime/TMP_FontAssetUtilities.cs | 9 +-
Scripts/Runtime/TMP_FontFeatureTable.cs | 96 +-
Scripts/Runtime/TMP_InputField.cs | 226 +++--
Scripts/Runtime/TMP_LineInfo.cs | 1 +
Scripts/Runtime/TMP_MaterialManager.cs | 3 +
Scripts/Runtime/TMP_MeshInfo.cs | 17 +-
.../Runtime/TMP_PackageResourceImporter.cs | 146 ++-
Scripts/Runtime/TMP_ResourcesManager.cs | 177 +++-
Scripts/Runtime/TMP_RichTextTagsCommon.cs | 15 +-
Scripts/Runtime/TMP_Settings.cs | 29 +-
Scripts/Runtime/TMP_ShaderUtilities.cs | 115 ++-
Scripts/Runtime/TMP_SpriteAnimator.cs | 4 +-
Scripts/Runtime/TMP_SpriteAsset.cs | 14 +-
Scripts/Runtime/TMP_SpriteCharacter.cs | 12 -
Scripts/Runtime/TMP_SubMesh.cs | 4 +-
Scripts/Runtime/TMP_SubMeshUI.cs | 4 +-
Scripts/Runtime/TMP_Text.cs | 815 +++++++++-------
Scripts/Runtime/TMP_TextInfo.cs | 20 +-
Scripts/Runtime/TMP_TextParsingUtilities.cs | 21 +
Scripts/Runtime/TMP_TextProcessingStack.cs | 3 +
Scripts/Runtime/TMP_TextUtilities.cs | 113 +++
Scripts/Runtime/TMPro_ExtensionMethods.cs | 21 +
Scripts/Runtime/TMPro_MeshUtilities.cs | 16 +-
Scripts/Runtime/TMPro_Private.cs | 248 +++--
Scripts/Runtime/TMPro_UGUI_Private.cs | 248 +++--
Scripts/Runtime/TextMeshPro.cs | 6 +-
Scripts/Runtime/TextMeshProUGUI.cs | 21 +-
Scripts/Runtime/Unity.TextMeshPro.asmdef | 8 +-
Tests/Editor/TMP_EditorTests.cs | 14 +-
Tests/Runtime/TMP_RuntimeTests.cs | 15 +-
ValidationExceptions.json | 9 -
package.json | 11 +-
95 files changed, 8254 insertions(+), 1386 deletions(-)
create mode 100644 Package Resources/TMP Shaders.unitypackage
rename ValidationExceptions.json.meta => Package Resources/TMP Shaders.unitypackage.meta (62%)
create mode 100644 Scripts/Editor/HDRP.meta
create mode 100644 Scripts/Editor/HDRP/HDRP_LitShaderGUI.cs
rename Scripts/Editor/{TMPro_FontPlugin.cs.meta => HDRP/HDRP_LitShaderGUI.cs.meta} (74%)
create mode 100644 Scripts/Editor/HDRP/HDRP_UnlitShaderGUI.cs
create mode 100644 Scripts/Editor/HDRP/HDRP_UnlitShaderGUI.cs.meta
create mode 100644 Scripts/Editor/HDRP/TMP_BaseHDRPLitShaderGUI.cs
create mode 100644 Scripts/Editor/HDRP/TMP_BaseHDRPLitShaderGUI.cs.meta
create mode 100644 Scripts/Editor/HDRP/TMP_BaseHDRPUnlitShaderGUI.cs
create mode 100644 Scripts/Editor/HDRP/TMP_BaseHDRPUnlitShaderGUI.cs.meta
create mode 100644 Scripts/Editor/HDRP/TMP_SDF_HDRPLitShaderGUI.cs
create mode 100644 Scripts/Editor/HDRP/TMP_SDF_HDRPLitShaderGUI.cs.meta
create mode 100644 Scripts/Editor/HDRP/TMP_SDF_HDRPUnlitShaderGUI.cs
create mode 100644 Scripts/Editor/HDRP/TMP_SDF_HDRPUnlitShaderGUI.cs.meta
rename Scripts/{Runtime => Editor}/TMP_EditorResourceManager.cs (53%)
rename Scripts/{Runtime => Editor}/TMP_EditorResourceManager.cs.meta (100%)
create mode 100644 Scripts/Editor/TMP_MarkToBaseAdjustmentRecordPropertyDrawer.cs
create mode 100644 Scripts/Editor/TMP_MarkToBaseAdjustmentRecordPropertyDrawer.cs.meta
create mode 100644 Scripts/Editor/TMP_MarkToMarkAdjustmentRecordPropertyDrawer.cs
create mode 100644 Scripts/Editor/TMP_MarkToMarkAdjustmentRecordPropertyDrawer.cs.meta
create mode 100644 Scripts/Editor/TMP_MarkupTagUpdateUtility.cs
create mode 100644 Scripts/Editor/TMP_MarkupTagUpdateUtility.cs.meta
delete mode 100644 Scripts/Editor/TMPro_FontPlugin.cs
create mode 100644 Scripts/Runtime/FontFeatureCommonGPOS.cs
create mode 100644 Scripts/Runtime/FontFeatureCommonGPOS.cs.meta
create mode 100644 Scripts/Runtime/FontFeatureCommonGSUB.cs
create mode 100644 Scripts/Runtime/FontFeatureCommonGSUB.cs.meta
create mode 100644 Scripts/Runtime/TMP_DynamicFontAssetUtilities.cs
create mode 100644 Scripts/Runtime/TMP_DynamicFontAssetUtilities.cs.meta
delete mode 100644 ValidationExceptions.json
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 16effc9..777fbad 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,15 +1,60 @@
# Changelog
These are the release notes for the TextMesh Pro UPM package which was first introduced with Unity 2018.1. Please see the following link for the Release Notes for prior versions of TextMesh Pro. http://digitalnativestudios.com/forum/index.php?topic=1363.0
+## [3.2.0-pre.1] - 2021-08-06
+## [2.2.0-preview.1] - 2021-08-06
+## [1.6.0-preview.1] - 2021-08-06
+### 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.
+- Changed text geometry UV layout which was necessary to support SRP. This change may require updating any code dealing with text geometry modifications such as the VertexColorCycler.cs script included in the TMP Examples & Extras.
+
The new UV layout is as follows:
+ - UV0 has changed from a Vector2 to Vector4. The "x" and "y" properties continue to contain the UV coordinates of the glyph in the font asset atlas texture. The "z" property is reserved for future use and "w" contains the SDF Scale.
+ - UV2 contains the UV coordinates for the font face and outline texture. Previously, the UV coordinates for the face and outline texture was encoded in UV2.x.
+- Added Multi Select support to TMP Dropdown.
+- Fixed issue where the <mark> tag color may be incorrect based on line breaking location. See [forum post](https://forum.unity.com/threads/rich-text-tags-dont-apply-to-space-characters-is-there-a-way.1103887/) 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](https://forum.unity.com/threads/nullreferenceexception-at-tmpro-tmp_inputfield-sendtouchscreenkeyboardstatuschanged.1109678/) 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](https://forum.unity.com/threads/updating-unity-broke-tmpro.1110794/#post-7183375) 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](https://forum.unity.com/threads/question-on-getpreferredvalues-and-text-wrapping.564970/#post-7189120) for details.
+- Fixed GetPreferredValues() potentially returning incorrect values. See [forum post](https://forum.unity.com/threads/question-on-getpreferredvalues-and-text-wrapping.564970/#post-7189120) 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](https://forum.unity.com/threads/tmp_inputfield-dark-keyboard-option.698900/#post-7126367) 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](https://forum.unity.com/threads/mobile-tmpro-support-for-mark-mark.1132414/#post-7335727) 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](https://forum.unity.com/threads/pasted-r-n-arent-removed-and-break-input-fields.1139056/#post-7397879) 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](https://forum.unity.com/threads/input-field-selection-disappear-when-another-ui-item-is-activated.1145375/) 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
+
## [3.0.6] - 2021-04-23
-## [2.1.6]
-## [1.5.6]
+## [2.1.6] - 2021-04-23
+## [1.5.6] - 2021-04-23
### Changes
-- Added compiler conditional to exclude reference to PS5 in Unity 2019.4.22f1 or older and similar for Unity 2020.2.2f1 or older.
+- Removed the use of Out Variable Declarations since it is not support in C# 6.0 and causing internal testing issue on UWP.
## [3.0.5] - 2021-04-09
-## [2.1.5]
-## [1.5.5]
+## [2.1.5] - 2021-04-09
+## [1.5.5] - 2021-04-09
### Changes
- Added compiler conditional to address error related to missing RectMask2D padding property which was added in Unity 2019.4.12f1. See [forum post](https://forum.unity.com/threads/update-textmesh-pro-to-latest-in-2019-4.945332/#post-6906851) for details.
- Fixed GetPreferredValues(string text) and GetPreferredValues(string text, float width, float height) incorrectly changing the text. See [forum post](https://forum.unity.com/threads/preferred-width-height-sometimes-0.980022/#post-6991058) for details.
@@ -22,8 +67,8 @@ These are the release notes for the TextMesh Pro UPM package which was first int
- Added support for PS4 and PS5 to TMP Input Field.
## [3.0.4] - 2021-02-19
-## [2.1.4]
-## [1.5.4]
+## [2.1.4] - 2021-02-19
+## [1.5.4] - 2021-02-19
### Changes
- Improved sprite tag anim functionality to take into consideration the sprite character and glyph scale. Case #1309707
- Improved Ellipsis character insertion handling to prevent potential issues when the Ellipsis glyph ascender and descender exceed those of the primary font asset. See [forum post](https://forum.unity.com/threads/ellipsis-exception.995680/#post-6472790) for details.
@@ -54,8 +99,8 @@ These are the release notes for the TextMesh Pro UPM package which was first int
- Fixed an issue with Text Overflow Linked mode where text would not flow correctly from one component to the other when the last character present at the break point was a linefeed "\n" or vertical tab "\v". See [forum post](https://forum.unity.com/threads/odd-line-break-behavior-in-text-with-overflow-linked.1056821/) for details.
## [3.0.3] - 2020-10-27
-## [2.1.3]
-## [1.5.3]
+## [2.1.3] - 2020-10-27
+## [1.5.3] - 2020-10-27
### Changes
- Fixed potential null reference exception in the Input Field that can occur as a result of using a workflow that involves enabling and disabling Canvases. See [forum post](https://forum.unity.com/threads/tmp_inputfield-generatecaret-m_textcomponent-canvas-exception.940659/) for details.
- Fixed potential Invalid AssetDatabase path warning that can be issued when assets are imported from outside the project. See [forum post](https://forum.unity.com/threads/textmesh-pro-invalid-assetdatabase-path-use-path-relative-to-the-project-folder.955731/) for details.
@@ -86,8 +131,8 @@ These are the release notes for the TextMesh Pro UPM package which was first int
- Fixed minor UI cosmetic issue in the Sprite Asset Sprite Glyph Table inspector. Case #1285022
## [3.0.1] - 2020-07-26
-## [2.1.1]
-## [1.5.1]
+## [2.1.1] - 2020-07-26
+## [1.5.1] - 2020-07-26
### Changes
- Addressed compiler warning related to the new virtual event OnPreRenderText.
- Added one additional layer of missing character search where in the even the missing glyph character \u0000 or space character \u0020 is not available in any font asset or potential fallbacks, the End of Text (ETX) \u0003 will be used instead.
@@ -97,8 +142,8 @@ These are the release notes for the TextMesh Pro UPM package which was first int
- Fixed potential issue when using multiple <font> tag in the same text object where these referencing several font assets derived from the same font file. Since their Default Material all have the same name, this was causing an issue in the Material Reference Manager. See [forum post](https://forum.unity.com/threads/argumentexception-on-v2-1-0-unity-2019-4-4f1-identified-bug.934789/) for details. Case #1264596.
## [3.0.0] - 2020-06-30
-## [2.1.0]
-## [1.5.0]
+## [2.1.0] - 2020-06-30
+## [1.5.0] - 2020-06-30
### Changes
- Added support to control if a text object is Maskable and affected by UI Mask components. The new setting is found in the Extra Settings section of the <TextMeshProUGUI> component inspector.
- Fixed potential Null Reference Exception when trying to add characters and / or glyphs to a font asset via scripting and before it has been initialized or ReadFontAssetDefinition() has been called.
@@ -114,8 +159,8 @@ These are the release notes for the TextMesh Pro UPM package which was first int
- It will no longer be possible to create Editor Presets for the TMP_FontAsset, TMP_SpriteAsset, TMP_StyleSheet, TMP_ColorGradient and TMP_Settings as these are persistent and runtime assets. Case #1251229
## [3.0.0-preview.14] - 2020-06-08
-## [2.1.0-preview.14]
-## [1.5.0-preview.14]
+## [2.1.0-preview.14] - 2020-06-08
+## [1.5.0-preview.14] - 2020-06-08
### Changes
- Fixed sprite character and sprite glyph scale not being reflected in the text layout. See [forum post](https://forum.unity.com/threads/glyph-scale-dont-change-line-height.898817/) for details.
- Fixed potential null reference exception in the CrossFadeColor or CrossFadeAlpha functions. See [forum post](https://forum.unity.com/threads/version-1-5-0-2-1-0-3-0-0-preview-13-now-available-for-testing.753587/page-4#post-5885075) for details.
@@ -125,8 +170,8 @@ These are the release notes for the TextMesh Pro UPM package which was first int
- Fixed InvalidOperationException that could occur when changing text Overflow linked components via code. Case #1251283
## [3.0.0-preview.13] - 2020-05-22
-## [2.1.0-preview.13]
-## [1.5.0-preview.13]
+## [2.1.0-preview.13] - 2020-05-22
+## [1.5.0-preview.13] - 2020-05-22
### Changes
- Fixed potential issue where the Font Asset Creator could get stuck in the packing phase of the atlas generation process. See [forum post](https://forum.unity.com/threads/font-asset-creator-stuck-at-packing-glyphs-pass-8.811863/) for details.
- Fixed issue potentially affecting text layout as a result of the width of the RectTransform being incorrectly reported. See [forum post](https://forum.unity.com/threads/textmesh-pro-forcemeshupdate-true-not-working-when-object-inactive.524507/#post-5798515) for details.
@@ -134,8 +179,8 @@ These are the release notes for the TextMesh Pro UPM package which was first int
- Fixed culling issue where lossy scale was not considered in the determination of the bounds of the text geometry.
## [3.0.0-preview.12] - 2020-05-09
-## [2.1.0-preview.12]
-## [1.5.0-preview.12]
+## [2.1.0-preview.12] - 2020-05-09
+## [1.5.0-preview.12] - 2020-05-09
### Changes
- Added synchronization of the RaycastTarget property of the parent <TextMeshProUGUI> with potential child sub text objects. Case #1240784
- Fixed Font Asset Bold Spacing adjustment scaling based on the text object point size instead of current point size. Case #1241132
@@ -149,15 +194,15 @@ These are the release notes for the TextMesh Pro UPM package which was first int
- Fixed NullReferenceException when setting the Atlas Texture to None in the Debug Settings of the Material Inspector of a text object. Case #1245104
## [3.0.0-preview.11] - 2020-04-22
-## [2.1.0-preview.11]
-## [1.5.0-preview.11]
+## [2.1.0-preview.11] - 2020-04-22
+## [1.5.0-preview.11] - 2020-04-22
### Changes
- Fixed incorrect culling of text object by RectMask2D component when the parent Canvas Render Mode is set to Screen Space - Camera or World Space. Case #1240595
- Added special handling to ForceMeshUpdate() when the parent Canvas is disabled.
## [3.0.0-preview.10] - 2020-04-21
-## [2.1.0-preview.10]
-## [1.5.0-preview.10]
+## [2.1.0-preview.10] - 2020-04-21
+## [1.5.0-preview.10] - 2020-04-21
### Changes
- Revised caching of Preferred Width and Height to further reduce the amount of time it has to be recomputed when using a complex structure of Layout components.
- Fixed potential issue when using Text Overflow Ellipsis and Truncate modes when the text contains characters using superscript, subscript or using the <voffset> tag.
@@ -184,8 +229,8 @@ These are the release notes for the TextMesh Pro UPM package which was first int
- Fixed mouse cursor flickering when hovering the Text Input Box of a text prefab with RTL enabled. Case #1206395
## [3.0.0-preview.8] - 2020-03-14
-## [2.1.0-preview.8]
-## [1.5.0-preview.8]
+## [2.1.0-preview.8] - 2020-03-14
+## [1.5.0-preview.8] - 2020-03-14
### Changes
- Fixed a minor issue where the preferred width of a text object can be incorrect when using multiple font assets, fallbacks and sprites in the same line of text.
- Added Alpha Fade Speed property to the TMP_DropDown inspector.
@@ -201,8 +246,8 @@ These are the release notes for the TextMesh Pro UPM package which was first int
- Fix incorrect material reference when current font asset is not the primary or a fallback that is missing a character which is present in the primary font asset.
## [3.0.0-preview.7] - 2020-03-07
-## [2.1.0-preview.7]
-## [1.5.0-preview.7]
+## [2.1.0-preview.7] - 2020-03-07
+## [1.5.0-preview.7] - 2020-03-07
### Changes
- Reverted recent change to the TMP_SubMeshUI OnDisable() function that could result in a Missing Reference Exception in the GraphicRaycaster.cs script. See the following [forum post](https://forum.unity.com/threads/version-1-5-0-2-1-0-preview-5-now-available-for-testing.753587/page-2#post-5523412).
- Fixed glyph drawing issue in the Font Asset Inspector Glyph Adjustment Table when Multi Atlas Texture is enabled and the glyph is not located in the main atlas texture or at atlasTextures[0].
@@ -218,8 +263,8 @@ These are the release notes for the TextMesh Pro UPM package which was first int
- As requested by a few users, TMP_FontAsset.faceInfo setter is now public instead of internal.
## [3.0.0-preview.5] - 2020-02-25
-## [2.1.0-preview.5]
-## [1.5.0-preview.5]
+## [2.1.0-preview.5] - 2020-02-25
+## [1.5.0-preview.5] - 2020-02-25
### Changes
- Revised SetText function formatting options to including ability to specify padding for integral part of the value. Revised format is as follows: {Arg Index:Integral Padding.Decimal Precision} Example: TMP_Text.SetText("Value = {0:000.00}", 10.375f); result in "Value = 010.38".
- Fixed issue where text objects isTextObjectScaleStatic property would be ignored when OnCanvasHierarchyChanged() is called.
@@ -232,8 +277,8 @@ These are the release notes for the TextMesh Pro UPM package which was first int
- Text object InternalUpdate() used to handle potential scale changes of text objects now uses willRenderCanvases event instead of onPreCull. This avoids a potential one frame delay in updating of objects and no impact on objects. Case #1216007
## [3.0.0-preview.4] - 2020-01-31
-## [2.1.0-preview.4]
-## [1.5.0-preview.4]
+## [2.1.0-preview.4] - 2020-01-31
+## [1.5.0-preview.4] - 2020-01-31
### Changes
- Fixed Input Field issue where scrolling events could prevent OnEndEdit event from firing. See [forum post](https://forum.unity.com/threads/mouse-wheel-on-multiline-input-field-with-no-scrollbar-hangs-input-field-stops-event-firing.794607/) for details.
- Improved Input Field handling of Vertical Scrollbar in conjunction with the ResetOnDeActivation property. Using the Vertical Scrollbar no longer triggers OnEndEdit event.
@@ -249,8 +294,8 @@ These are the release notes for the TextMesh Pro UPM package which was first int
- Added public ITextPreprocessor textPreprocessor; property to allow setting the text preprocessor for a given text component.
## [3.0.0-preview.3] - 2019-12-16
-## [2.1.0-preview.3]
-## [1.5.0-preview.3]
+## [2.1.0-preview.3] - 2019-12-16
+## [1.5.0-preview.3] - 2019-12-16
### Changes
- Fixed potential issue with TMP Dropdown where calling Show() and Hide() in very short interval could result in additional Blockers. Case #1194114
- Fixed potential issues that could occur when upgrading to version 1.5.0-preview.2 or newer of the TMP package without also updating the TMP Essential Resources in the project.
@@ -274,7 +319,7 @@ These are the release notes for the TextMesh Pro UPM package which was first int
- Optimization to ensure the TMP Update Manager only rebuilds text objects once per frame regardless of the number of cameras in the scene.
## [2.1.0-preview.2] - 2019-10-30
-## [1.5.0-preview.2]
+## [1.5.0-preview.2] - 2019-10-30
### Changes
- Fixed Input Field issue when Read Only flag is set preventing the initial setting of the text. Also fixed Read Only flag not being respected when using IME input.
- Fixed potential infinite loop when using text overflow mode ScrollRect. See Case #1188867
@@ -299,7 +344,7 @@ These are the release notes for the TextMesh Pro UPM package which was first int
- Fixed potential Null Reference Exception in the Editor when assigning new font asset to disabled game object when no previous font asset was assigned.
## [2.1.0-preview.1] - 2019-09-30
-## [1.5.0-preview.1]
+## [1.5.0-preview.1] - 2019-09-30
### Changes
- Fixed an issue when using Overflow Ellipsis mode where the Ellipsis character would not be displayed correctly when the preceding character is a sprite.
- Added the ability to define the Resource path for Style Sheets in the TMP Settings.
diff --git a/Editor Resources/Shaders/TMP_SDF_SSD.cginc b/Editor Resources/Shaders/TMP_SDF_SSD.cginc
index 0f587bd..b16f269 100644
--- a/Editor Resources/Shaders/TMP_SDF_SSD.cginc
+++ b/Editor Resources/Shaders/TMP_SDF_SSD.cginc
@@ -3,7 +3,7 @@
float4 position : POSITION;
float3 normal : NORMAL;
float4 color : COLOR;
- float2 texcoord0 : TEXCOORD0;
+ float4 texcoord0 : TEXCOORD0;
float2 texcoord1 : TEXCOORD1;
};
@@ -34,7 +34,7 @@ pixel_t VertShader(vertex_t input)
{
pixel_t output;
- float bold = step(input.texcoord1.y, 0);
+ float bold = step(input.texcoord0.w, 0);
float4 vert = input.position;
vert.x += _VertexOffsetX;
diff --git a/Package Resources/TMP Essential Resources.unitypackage b/Package Resources/TMP Essential Resources.unitypackage
index df07702cdf3bc4fd32ac911754b73bc8b1466ef7..6fa68f5b1037605133fba55dcf32e7761e3e92bf 100644
GIT binary patch
delta 1440741
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