Class TMP_Settings
Scaling options for the sprites
Inherited Members
Namespace: TMPro
Assembly: Unity.TextMeshPro.dll
Syntax
[Serializable]
[ExcludeFromPreset]
public class TMP_Settings : ScriptableObject
Properties
autoSizeTextContainer
Set the size of the text container of newly created text objects to match the size of the text.
Declaration
public static bool autoSizeTextContainer { get; }
Property Value
Type | Description |
---|---|
bool |
defaultColorGradientPresetsPath
The relative path to a Resources folder in the project that contains Color Gradient Presets.
Declaration
public static string defaultColorGradientPresetsPath { get; }
Property Value
Type | Description |
---|---|
string |
defaultFontAsset
Returns the Default Font Asset to be used by newly created text objects.
Declaration
public static TMP_FontAsset defaultFontAsset { get; }
Property Value
Type | Description |
---|---|
TMP_FontAsset |
defaultFontAssetPath
The relative path to a Resources folder in the project.
Declaration
public static string defaultFontAssetPath { get; }
Property Value
Type | Description |
---|---|
string |
defaultFontSize
The Default Point Size of newly created text objects.
Declaration
public static float defaultFontSize { get; }
Property Value
Type | Description |
---|---|
float |
defaultSpriteAsset
The Default Sprite Asset to be used by default.
Declaration
public static TMP_SpriteAsset defaultSpriteAsset { get; }
Property Value
Type | Description |
---|---|
TMP_SpriteAsset |
defaultSpriteAssetPath
The relative path to a Resources folder in the project.
Declaration
public static string defaultSpriteAssetPath { get; }
Property Value
Type | Description |
---|---|
string |
defaultStyleSheet
The Default Style Sheet used by the text objects.
Declaration
public static TMP_StyleSheet defaultStyleSheet { get; }
Property Value
Type | Description |
---|---|
TMP_StyleSheet |
defaultTextAutoSizingMaxRatio
The multiplier used to computer the default Max point size when Text Auto Sizing is used.
Declaration
public static float defaultTextAutoSizingMaxRatio { get; }
Property Value
Type | Description |
---|---|
float |
defaultTextAutoSizingMinRatio
The multiplier used to computer the default Min point size when Text Auto Sizing is used.
Declaration
public static float defaultTextAutoSizingMinRatio { get; }
Property Value
Type | Description |
---|---|
float |
defaultTextMeshProTextContainerSize
The Default Size of the Text Container of a TextMeshPro object.
Declaration
public static Vector2 defaultTextMeshProTextContainerSize { get; }
Property Value
Type | Description |
---|---|
Vector2 |
defaultTextMeshProUITextContainerSize
The Default Width of the Text Container of a TextMeshProUI object.
Declaration
public static Vector2 defaultTextMeshProUITextContainerSize { get; }
Property Value
Type | Description |
---|---|
Vector2 |
enableEmojiSupport
Determines if Emoji support is enabled in the Input Field TouchScreenKeyboard.
Declaration
public static bool enableEmojiSupport { get; set; }
Property Value
Type | Description |
---|---|
bool |
enableExtraPadding
Controls if Extra Padding is enabled on newly created text objects by default.
Declaration
public static bool enableExtraPadding { get; }
Property Value
Type | Description |
---|---|
bool |
enableKerning
Controls if Kerning is enabled on newly created text objects by default.
Declaration
public static bool enableKerning { get; }
Property Value
Type | Description |
---|---|
bool |
enableParseEscapeCharacters
Controls if Escape Characters will be parsed in the Text Input Box on newly created text objects.
Declaration
public static bool enableParseEscapeCharacters { get; }
Property Value
Type | Description |
---|---|
bool |
enableRaycastTarget
Controls if Raycast Target is enabled by default on newly created text objects.
Declaration
public static bool enableRaycastTarget { get; }
Property Value
Type | Description |
---|---|
bool |
enableTintAllSprites
Controls if TintAllSprites is enabled on newly created text objects by default.
Declaration
public static bool enableTintAllSprites { get; }
Property Value
Type | Description |
---|---|
bool |
enableWordWrapping
Controls if Word Wrapping will be enabled on newly created text objects by default.
Declaration
public static bool enableWordWrapping { get; }
Property Value
Type | Description |
---|---|
bool |
fallbackFontAssets
Returns the list of Fallback Fonts defined in the TMP Settings file.
Declaration
public static List<TMP_FontAsset> fallbackFontAssets { get; }
Property Value
Type | Description |
---|---|
List<TMP_FontAsset> |
followingCharacters
Text file that contains the following characters used for line breaking for Asian languages.
Declaration
public static TextAsset followingCharacters { get; }
Property Value
Type | Description |
---|---|
TextAsset |
getFontFeaturesAtRuntime
Determines if OpenType Font Features should be retrieved at runtime from the source font file.
Declaration
public static bool getFontFeaturesAtRuntime { get; }
Property Value
Type | Description |
---|---|
bool |
instance
Get a singleton instance of the settings class.
Declaration
public static TMP_Settings instance { get; }
Property Value
Type | Description |
---|---|
TMP_Settings |
isTextObjectScaleStatic
Disables InternalUpdate() calls when true. This can improve performance when the scale of the text object is static.
Declaration
public static bool isTextObjectScaleStatic { get; set; }
Property Value
Type | Description |
---|---|
bool |
leadingCharacters
Text file that contains the leading characters used for line breaking for Asian languages.
Declaration
public static TextAsset leadingCharacters { get; }
Property Value
Type | Description |
---|---|
TextAsset |
linebreakingRules
Declaration
public static TMP_Settings.LineBreakingTable linebreakingRules { get; }
Property Value
Type | Description |
---|---|
TMP_Settings.LineBreakingTable |
matchMaterialPreset
Controls whether or not TMP will create a matching material preset or use the default material of the fallback font asset.
Declaration
public static bool matchMaterialPreset { get; }
Property Value
Type | Description |
---|---|
bool |
missingCharacterSpriteUnicode
The unicode value of the sprite that will be used when the requested sprite is missing from the sprite asset and potential fallbacks.
Declaration
public static uint missingCharacterSpriteUnicode { get; set; }
Property Value
Type | Description |
---|---|
uint |
missingGlyphCharacter
The character that will be used as a replacement for missing glyphs in a font asset.
Declaration
public static int missingGlyphCharacter { get; set; }
Property Value
Type | Description |
---|---|
int |
styleSheetsResourcePath
The relative path to a Resources folder in the project that contains the TMP Style Sheets.
Declaration
public static string styleSheetsResourcePath { get; }
Property Value
Type | Description |
---|---|
string |
useModernHangulLineBreakingRules
Determines if Modern or Traditional line breaking rules should be used for Korean text.
Declaration
public static bool useModernHangulLineBreakingRules { get; set; }
Property Value
Type | Description |
---|---|
bool |
version
Returns the release version of the product.
Declaration
public static string version { get; }
Property Value
Type | Description |
---|---|
string |
warningsDisabled
Controls the display of warning message in the console.
Declaration
public static bool warningsDisabled { get; }
Property Value
Type | Description |
---|---|
bool |
Methods
GetFontAsset()
Returns the Font Asset defined in the TMP Settings file.
Declaration
public static TMP_FontAsset GetFontAsset()
Returns
Type | Description |
---|---|
TMP_FontAsset |
GetSettings()
Returns the Sprite Asset defined in the TMP Settings file.
Declaration
public static TMP_Settings GetSettings()
Returns
Type | Description |
---|---|
TMP_Settings |
GetSpriteAsset()
Returns the Sprite Asset defined in the TMP Settings file.
Declaration
public static TMP_SpriteAsset GetSpriteAsset()
Returns
Type | Description |
---|---|
TMP_SpriteAsset |
GetStyleSheet()
Returns the Style Sheet defined in the TMP Settings file.
Declaration
public static TMP_StyleSheet GetStyleSheet()
Returns
Type | Description |
---|---|
TMP_StyleSheet |
LoadDefaultSettings()
Static Function to load the TMP Settings file.
Declaration
public static TMP_Settings LoadDefaultSettings()
Returns
Type | Description |
---|---|
TMP_Settings |
LoadLinebreakingRules()
Declaration
public static void LoadLinebreakingRules()