91 lines
3.3 KiB
C#
91 lines
3.3 KiB
C#
|
using System.Collections.Generic;
|
|||
|
|
using TMPro;
|
|||
|
|
using UnityEngine;
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// TMP 图片资源优先渲染器
|
|||
|
|
///
|
|||
|
|
/// 功能：让 TextMeshPro 在渲染字符时，优先查找 SpriteAsset（图片/艺术字），
|
|||
|
|
/// 找不到再 fallback 到 FontAsset（普通字体）。
|
|||
|
|
///
|
|||
|
|
/// 用法：
|
|||
|
|
/// 1. 把此脚本挂到带有 TMP_Text (TextMeshProUGUI / TextMeshPro) 的 GameObject 上
|
|||
|
|
/// 2. 在 Inspector 中把需要优先的 SpriteAsset 拖进 PrioritySpriteAssets 列表
|
|||
|
|
/// （列表顺序即优先级顺序，排第一的最优先）
|
|||
|
|
/// 3. 运行时自动生效；也可手动调用 Apply() 强制刷新
|
|||
|
|
/// </summary>
|
|||
|
|
[AddComponentMenu("UI/TMP Sprite Priority")]
|
|||
|
|
[RequireComponent(typeof(TMP_Text))]
|
|||
|
|
public class TMP_SpritePriority : MonoBehaviour
|
|||
|
|
{
|
|||
|
|
[Header("优先渲染的 SpriteAsset 列表（顺序即优先级，第一个最高）")]
|
|||
|
|
[SerializeField]
|
|||
|
|
private List<TMP_SpriteAsset> prioritySpriteAssets = new List<TMP_SpriteAsset>();
|
|||
|
|
|
|||
|
|
[Header("是否在 Awake 时自动应用")]
|
|||
|
|
[SerializeField]
|
|||
|
|
private bool applyOnAwake = true;
|
|||
|
|
|
|||
|
|
private TMP_Text _tmpText;
|
|||
|
|
|
|||
|
|
private void Awake()
|
|||
|
|
{
|
|||
|
|
_tmpText = GetComponent<TMP_Text>();
|
|||
|
|
|
|||
|
|
if (applyOnAwake)
|
|||
|
|
Apply();
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 手动触发，将 SpriteAsset 插入 fallback 最前面，实现"Sprite 优先于 Font"渲染
|
|||
|
|
/// </summary>
|
|||
|
|
public void Apply()
|
|||
|
|
{
|
|||
|
|
if (_tmpText == null)
|
|||
|
|
_tmpText = GetComponent<TMP_Text>();
|
|||
|
|
|
|||
|
|
if (_tmpText == null || prioritySpriteAssets == null || prioritySpriteAssets.Count == 0)
|
|||
|
|
return;
|
|||
|
|
|
|||
|
|
// 取第一个作为 TMP_Text.spriteAsset（TMP 解析 <sprite> / unicode 时优先查此处）
|
|||
|
|
_tmpText.spriteAsset = prioritySpriteAssets[0];
|
|||
|
|
|
|||
|
|
// 将剩余 SpriteAsset 插入主 SpriteAsset 的 fallback 链最前端
|
|||
|
|
// TMP 查找 Sprite unicode 的顺序：spriteAsset → spriteAsset.fallbackSpriteAssets[0,1,...] → TMP Settings 默认
|
|||
|
|
if (_tmpText.spriteAsset != null)
|
|||
|
|
{
|
|||
|
|
var fallbacks = _tmpText.spriteAsset.fallbackSpriteAssets;
|
|||
|
|
if (fallbacks == null)
|
|||
|
|
fallbacks = new List<TMP_SpriteAsset>();
|
|||
|
|
|
|||
|
|
// 把列表[1]以后的 asset 依次插入到 fallback 前面（避免重复）
|
|||
|
|
for (int i = prioritySpriteAssets.Count - 1; i >= 1; i--)
|
|||
|
|
{
|
|||
|
|
var asset = prioritySpriteAssets[i];
|
|||
|
|
if (asset == null || fallbacks.Contains(asset)) continue;
|
|||
|
|
fallbacks.Insert(0, asset);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
_tmpText.spriteAsset.fallbackSpriteAssets = fallbacks;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 强制 TMP 重新解析文本，让新优先级立即生效
|
|||
|
|
_tmpText.SetAllDirty();
|
|||
|
|
_tmpText.ForceMeshUpdate();
|
|||
|
|
|
|||
|
|
Debug.Log($"[TMP_SpritePriority] {gameObject.name} → 首选 SpriteAsset: {_tmpText.spriteAsset?.name}，共 {prioritySpriteAssets.Count} 个图片资源已置为最高优先级");
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 恢复到系统默认（清除手动设置的 spriteAsset，交回 TMP Settings 管理）
|
|||
|
|
/// </summary>
|
|||
|
|
public void Reset()
|
|||
|
|
{
|
|||
|
|
if (_tmpText == null) return;
|
|||
|
|
|
|||
|
|
_tmpText.spriteAsset = null; // null = 使用 TMP Settings 中的默认 SpriteAsset
|
|||
|
|
_tmpText.SetAllDirty();
|
|||
|
|
_tmpText.ForceMeshUpdate();
|
|||
|
|
}
|
|||
|
|
}
|