TMP参数说明

一、Main Settings

1. Font Asset (字体资源)

• Font Asset：选择要使用的TMP字体资源（SDF字体）。这是生成和使用矢量字体的关键资源，确保文字在任何缩放下都保持清晰。

2. Material Preset (材质预设)

• Material Preset：选择用于文本的材质预设。不同的材质可以控制文本的颜色、阴影、发光效果等。

3. Font Style (字体样式)

• Font Style：设置字体的样式，可以应用粗体 (Bold)、斜体 (Italic)、下划线 (Underline) 等效果。TMP支持多种样式组合。

4. Font Size (字体大小)

• Font Size：设置文本的字号大小。可以直接设置具体的字体大小数值。

5. Auto Size (自动调整大小)

• Auto Size：如果勾选，字体会自动调整大小以适应其容器，确保文本不会溢出边界。

6. Vertex Color (顶点颜色)

• Vertex Color：这是文本的基础颜色。你可以通过它设置整个文本的颜色。

7. Color Gradient (颜色渐变)

• Color Gradient：启用后，可以为文本应用颜色渐变效果。你可以为文本设置从上到下、从左到右的渐变颜色。

8. Override Tags (覆盖标签)

• Override Tags：如果启用，TMP会忽略文本中的HTML标签。HTML标签通常用于控制文本的样式（如 <b> 加粗或 <i> 斜体）。

9. Spacing Options (间距选项)

• Character Spacing (字符间距)：设置字符之间的空隙距离。
• Line Spacing (行间距)：设置每行文本之间的距离。
• Word Spacing (单词间距)：设置单词之间的空隙距离。
• Paragraph Spacing (段落间距)：设置段落之间的空隙距离。

10. Alignment (对齐方式)

• Alignment：设置文本的对齐方式，可以选择左对齐、右对齐、居中对齐、顶对齐、底对齐等。这可以根据文本所在的UI布局进行调整。

11. Wrapping (换行方式)

• Wrapping：控制文本是否在容器的边界处换行。通常，当文本超出容器宽度时，它会自动换行。

12. Overflow (溢出方式)

• Overflow：设置文本超出其容器时的处理方式。
  • Overflow：文本超出容器时，允许文本溢出。
  • Truncate：文本超出容器时，会截断超出的部分。
  • Ellipsis：文本超出容器时，显示省略号（…）以表示文本被截断。

13. Horizontal Mapping (水平映射) & Vertical Mapping (垂直映射)

• 这些参数通常用于控制渐变或其他材质效果如何在水平或垂直方向上应用于文本。例如，水平映射可以控制颜色从左到右的渐变，而垂直映射控制颜色从上到下的渐变。

二、Extra Settings

在 TextMesh Pro (TMP) 的 Extra Settings 中，各个参数的作用如下：

1. Margins (边距)

• 控制文本框的四个方向（左、上、右、下）的边距。
• 可以用于在 UI 中精确调整文本位置，使其与其他 UI 元素之间有一定的空间。

2. Geometry Sorting (几何排序)

• Normal：按照字符的自然顺序渲染文本。
• 其他选项可用于调整 TMP 文本的渲染顺序，通常与3D场景中的图形重叠排序有关。

3. Is Scale Static

• 启用后，TMP 组件将不再根据 Canvas 的缩放比例动态调整文本大小。这有助于保持文本在某些场景中的大小不变，避免被 Canvas 的 UI 缩放影响。

4. Rich Text (富文本)

• 是否启用富文本。富文本允许在文本中使用格式标签（如 <b>, <i>, <color>）来改变字体样式、颜色等。

5. Raycast Target

• 是否允许文本接收点击事件。如果勾选了这个选项，TMP 文本会拦截点击。如果取消勾选，点击事件将穿透文本传递给背后的 UI 元素。

6. Maskable

• 指定 TMP 文本是否受 UI Mask 的影响。勾选时，文本可以被遮罩（Mask）组件裁剪。

7. Parse Escape Characters

• 解析转义字符。如果启用，特殊字符（如 \n 表示换行，\t 表示制表符等）会被正确解析。

8. Visible Descender

• 如果启用，TMP 组件将计算并显示下降字符的空间（如字母“g”或“p”）。这有助于确保文本的基线和框架的一致性。

9. Sprite Asset

• 允许为 TMP 文本分配一个 Sprite 资源，用于显示文本中的图片或表情符号（通过 <sprite> 标签调用）。

10. Style Sheet Asset

• 允许为 TMP 文本分配一个样式表，样式表中可以定义预设的文本样式，用于快速应用统一的文本格式。

11. Kerning (字距调整)

• 控制是否启用字距调整。字距调整会根据字符的形状调整字符之间的间距，以便使文本看起来更平滑、更均匀。

12. Extra Padding (额外填充)

• 为文本增加额外的填充，可以避免在使用阴影、描边等效果时，文本被裁剪问题。