Font.RequestCharactersInTexture

Unity · Версия 2020.3 LTS · Scripting · Font

Font.RequestCharactersInTexture

Объявление

public void RequestCharactersInTexture(string characters, int size = 0, FontStyle style = FontStyle.Normal);

Параметры

characters Символы, которые должны быть в текстуре шрифта.
size Размер запрошенных символов (значение по умолчанию, равное нулю, будет использовать размер шрифта по умолчанию).
style Стиль запрошенных символов.

Описание

Запросить добавление символов в текстуру шрифта (только для динамических шрифтов).

Примечание: вам следует использовать это только тогда, когда вы хотите реализовать собственный рендеринг текста. Вызовите эту функцию, чтобы запросить Unity, чтобы убедиться, что все символы в строке characters доступны в текстуре шрифта (и это characterInfo собственность). Это полезно, когда вы хотите реализовать свой собственный код для отображения динамических шрифтов. Вы можете указать собственный размер и стиль шрифта для символов. Если size равен нулю (по умолчанию), для этого шрифта будет использоваться размер по умолчанию.

RequestCharactersInTexture может привести к повторной генерации текстуры шрифта, если в ней недостаточно места для добавления всех запрошенных символов. Если текстура шрифта регенерируется, она будет содержать только символы, которые использовались с помощью Font.RequestCharactersInTexture или с использованием функций рендеринга текста Unity во время последнего кадра. Поэтому рекомендуется всегда вызывать RequestCharactersInTexture для любого текста на экране, который вы хотите отобразить с помощью функций рендеринга пользовательских шрифтов, даже если символы в настоящее время присутствуют в текстуре, чтобы убедиться, что они не удаляются во время перестроения текстуры. р>

Смотрите так же: textureRebuilt, GetCharacterInfo.

using UnityEngine;
using System.Collections;

public class CustomFontMeshGenerator : MonoBehaviour
{
    Font font;
    string str = "Hello World";
    Mesh mesh;

    void OnFontTextureRebuilt(Font changedFont)
    {
        if (changedFont != font)
            return;

        RebuildMesh();
    }

    void RebuildMesh()
    {
        // Generate a mesh for the characters we want to print.
        var vertices = new Vector3[str.Length * 4];
        var triangles = new int[str.Length * 6];
        var uv = new Vector2[str.Length * 4];
        Vector3 pos = Vector3.zero;
        for (int i = 0; i < str.Length; i++)
        {
            // Get character rendering information from the font
            CharacterInfo ch;
            font.GetCharacterInfo(str[i], out ch);

            vertices[4 * i + 0] = pos + new Vector3(ch.minX, ch.maxY, 0);
            vertices[4 * i + 1] = pos + new Vector3(ch.maxX, ch.maxY, 0);
            vertices[4 * i + 2] = pos + new Vector3(ch.maxX, ch.minY, 0);
            vertices[4 * i + 3] = pos + new Vector3(ch.minX, ch.minY, 0);

            uv[4 * i + 0] = ch.uvTopLeft;
            uv[4 * i + 1] = ch.uvTopRight;
            uv[4 * i + 2] = ch.uvBottomRight;
            uv[4 * i + 3] = ch.uvBottomLeft;

            triangles[6 * i + 0] = 4 * i + 0;
            triangles[6 * i + 1] = 4 * i + 1;
            triangles[6 * i + 2] = 4 * i + 2;

            triangles[6 * i + 3] = 4 * i + 0;
            triangles[6 * i + 4] = 4 * i + 2;
            triangles[6 * i + 5] = 4 * i + 3;

            // Advance character position
            pos += new Vector3(ch.advance, 0, 0);
        }
        mesh.vertices = vertices;
        mesh.triangles = triangles;
        mesh.uv = uv;
    }

    void Start()
    {
        font = Font.CreateDynamicFontFromOSFont("Helvetica", 16);
        // Set the rebuild callback so that the mesh is regenerated on font changes.
        Font.textureRebuilt += OnFontTextureRebuilt;

        // Request characters.
        font.RequestCharactersInTexture(str);

        // Set up mesh.
        mesh = new Mesh();
        GetComponent<MeshFilter>().mesh = mesh;
        GetComponent<MeshRenderer>().material = font.material;

        // Generate font mesh.
        RebuildMesh();
    }

    void Update()
    {
        // Keep requesting our characters each frame, so Unity will make sure that they stay in the font when regenerating the font texture.
        font.RequestCharactersInTexture(str);
    }

    void OnDestroy()
    {
        Font.textureRebuilt -= OnFontTextureRebuilt;
    }
}

Обновлено 17 ноября 2026 г.