FontFile

public FontFile();

Создаёт пустой ресурс без загруженного шрифта. Загрузите данные и только затем настройте параметры и назначьте потребителю.

public bool AllowSystemFallback { get; set; }

Разрешает поиск отсутствующих символов в системных шрифтах; по умолчанию true. Результат зависит от ОС и установленных шрифтов. Изменение отправляет Changed.

public TextServer.FontAntialiasing Antialiasing { get; set; }

Сглаживание растровых глифов: None — однобитное, Gray — полутоновое, Lcd — субпиксели экрана. По умолчанию Gray. Lcd подходит для горизонтального немасштабированного текста 2D; это отдельная настройка от SubpixelPositioning. Изменение отправляет Changed; присваивание того же значения его не отправляет. Загрузка сбрасывает настройку.

public byte[] Data { get; set; }

Байты динамического шрифта. Getter возвращает managed-копию; назначьте изменённую копию обратно. Setter не проверяет формат и не отправляет Changed. Не полный пакет BMFont с изображениями.

public bool DisableEmbeddedBitmaps { get; set; }

Запрещает встроенные растровые варианты в динамическом шрифте; по умолчанию true. Не отключает загрузку отдельного BMFont. Для цветных и исключительно растровых шрифтов действуют ограничения формата и backend. Изменение отправляет Changed; присваивание того же значения его не отправляет. Загрузка сбрасывает настройку.

public int FixedSize { get; set; }

Фиксированный размер растеризации; 0 отключает принудительный размер. Это не размер текста Control. При изменении обновляет кэши и отправляет Changed; загрузка сбрасывает значение.

public TextServer.FixedSizeScaleMode FixedSizeScaleMode { get; set; }

Масштабирование при положительном FixedSize: Disable не масштабирует, IntegerOnly использует целый множитель, Enabled разрешает дробный. По умолчанию Disable. Для пиксельного растрового шрифта выбирайте IntegerOnly и проверяйте фактический масштаб интерфейса. Изменение отправляет Changed; присваивание того же значения его не отправляет. Загрузка сбрасывает настройку.

public string FontName { get; set; }

Имя семейства в метаданных первого кэша. Изменение не загружает другой файл и само не отправляет Changed.

public int FontStretch { get; set; }

Ширина в метаданных первого кэша, 50–200, обычная 100. Advanced backend ограничивает диапазон; это не масштаб Transform и не гарантированное растяжение глифов. Setter не отправляет Changed.

public TextServer.FontStyle FontStyle { get; set; }

Флаги метаданных начертания первого кэша. Не обещают синтез жирного или курсивного рисунка; setter не отправляет Changed.

public int FontWeight { get; set; }

Вес в метаданных первого кэша: диапазон 100–999, обычный 400, жирный 700. Advanced backend ограничивает диапазон. Не заменяет нужное начертание и не отправляет Changed.

public bool ForceAutohinter { get; set; }

Предпочитает автохинтинг встроенным инструкциям динамического шрифта; по умолчанию false. Не заменяет Hinting и не делает MSDF-шрифт хинтованным. Сравнивайте мелкий текст на целевом масштабе. Изменение отправляет Changed; присваивание того же значения его не отправляет. Загрузка сбрасывает настройку.

public bool GenerateMipmaps { get; set; }

Генерирует mip-уровни текстур шрифта; по умолчанию false. Может помочь при уменьшении текста, но требует памяти и подходящей фильтрации у потребителя. Само включение не гарантирует более чёткий текст. Изменение отправляет Changed; присваивание того же значения его не отправляет. Загрузка сбрасывает настройку.

public TextServer.Hinting Hinting { get; set; }

Подгонка динамического растрового шрифта к пиксельной сетке: None, Light или Normal; по умолчанию Light. Normal может менять метрики по обеим осям, в том числе ширины моноширинных символов. Для MSDF хинтинг не поддерживается. Изменение отправляет Changed; присваивание того же значения его не отправляет. Загрузка сбрасывает настройку.

public bool KeepRoundingRemainders { get; set; }

Сохраняет остатки округления при выравнивании глифов по пикселям, уменьшая накопление ошибки интервалов; по умолчанию true. При субпиксельном позиционировании соответствующее округление горизонтальных advances не применяется. Это не включение кернинга. Изменение отправляет Changed; присваивание того же значения его не отправляет. Загрузка сбрасывает настройку.

public bool ModulateColorGlyphs { get; set; }

Применяет RGB-модуляцию также к цветным глифам; по умолчанию false. При false цветные глифы сохраняют собственный RGB, но прозрачность отрисовки учитывается. Настройка не добавляет отсутствующие цветные символы. Изменение отправляет Changed; присваивание того же значения его не отправляет. Загрузка сбрасывает настройку.

public int MsdfPixelRange { get; set; }

Диапазон расстояний MSDF вокруг контура. У нового FontFile равен 16, после LoadDynamicFont — 14. Для обводки задавайте как минимум удвоенную максимальную толщину. Работает при включённом MSDF; большее значение само не повышает точность. Изменение отправляет Changed; присваивание того же значения его не отправляет. Загрузка сбрасывает настройку.

public int MsdfSize { get; set; }

Базовый размер генерации MSDF, не размер текста Control. У нового FontFile равен 48, после LoadDynamicFont — 128. Увеличивайте только при заметной нехватке точности: растут затраты генерации и памяти. Требует включённого MSDF. Изменение отправляет Changed; присваивание того же значения его не отправляет. Загрузка сбрасывает настройку.

public bool MultichannelSignedDistanceField { get; set; }

Использует многоканальное поле расстояний для масштабируемых глифов из векторных данных; по умолчанию false. Настраивайте MsdfSize и MsdfPixelRange после загрузки. Хинтинг недоступен, мелкий текст может выглядеть хуже; пересекающиеся контуры требуют проверки. Это не гарантия бесплатного масштабирования или качества любого файла. Изменение отправляет Changed; присваивание того же значения его не отправляет. Загрузка сбрасывает настройку.

public Reckfell.Collections.Dictionary OpentypeFeatureOverrides { get; set; }

Общие настройки функций OpenType: ключ-тег, например liga или kern, и целое значение. 0 выключает, положительное значение включает или выбирает вариант; отрицательные значения пропускаются при shaping. Это не оси variable font. Dictionary хранится совместно: для независимого снимка вызовите Duplicate. Setter и правка Dictionary не отправляют Changed; не рассчитывайте на автоматический перерасчёт уже подготовленного текста. Задавайте до использования, проверяйте поддержку функцией GetSupportedFeatureList. Загрузка файла сохраняет настройки.

public float Oversampling { get; set; }

Множитель растеризации динамического шрифта: положительное значение переопределяет настройку viewport, 0 оставляет её. Явный положительный аргумент метода рисования имеет приоритет. MSDF и положительный FixedSize обходят oversampling. Это не масштаб текста; учитывайте память и время генерации. Изменение отправляет Changed; присваивание того же значения его не отправляет. Загрузка сбрасывает настройку.

public string StyleName { get; set; }

Имя начертания в метаданных первого кэша, например Regular. Не выбирает автоматически другой файл шрифта и не отправляет Changed.

public TextServer.SubpixelPositioning SubpixelPositioning { get; set; }

Точность горизонтальной позиции глифа: Disabled, Auto, OneHalf или OneQuarter. У нового FontFile — Auto, после LoadDynamicFont — Disabled. Дополнительные позиции могут потребовать больше вариантов глифов в кэше. Не путайте с Lcd-сглаживанием. Изменение отправляет Changed; присваивание того же значения его не отправляет. Загрузка сбрасывает настройку.

public void ClearCache();

Очищает кэши и отправляет Changed, сохраняя Data и настройки ресурса. Это не выгрузка всех байтов шрифта.

public void ClearGlyphs(int cacheIndex, Vector2I size);

Удаляет записи глифов выбранного размера/обводки, сохраняя страницы и ручной кернинг. Динамические глифы могут создаваться снова по запросу; вручную заданные bitmap-записи нужно восстановить. Changed не отправляется.

public void ClearKerningMap(int cacheIndex, int size);

Очищает ручную таблицу пары для размера, не отключая встроенный кернинг исходного шрифта. Поэтому GetKerning после очистки не обязан вернуть ноль. Changed не отправляется.

public void ClearSizeCache(int cacheIndex);

Удаляет все кэши размеров выбранного RID вместе с их глифами, страницами и ручными метриками. Не удаляет исходные Data и сам слот FontFile. Changed не отправляется. Для ручного bitmap-кэша данные нужно построить заново.

public void ClearTextures(int cacheIndex, Vector2I size);

Очищает страницы, сохраняя записи глифов и их индексы. Последующее обращение может обнаружить недействительный атлас и попытаться пересоздать глифы; для ручного bitmap-кэша этого недостаточно. Пересоберите размер целиком или используйте новый FontFile. Changed не отправляется.

public TextServer.FontAntialiasing GetAntialiasing();

Читает Antialiasing без оценки качества отображения. Сглаживание растровых глифов: None — однобитное, Gray — полутоновое, Lcd — субпиксели экрана. По умолчанию Gray. Lcd подходит для горизонтального немасштабированного текста 2D; это отдельная настройка от SubpixelPositioning.

public float GetCacheAscent(int cacheIndex, int size);

Читает расстояние над базовой линией. Запрос может создать размерный кэш; для MSDF/масштабируемого FixedSize backend пересчитывает результат под запрошенный размер.

public int GetCacheCount();

Возвращает число слотов внутренних font RID. Не число глифов, файлов или проверенных начертаний; слот может создаваться лениво при обращении к метаданным.

public float GetCacheDescent(int cacheIndex, int size);

Читает расстояние под базовой линией. Запрос может создать размерный кэш; для MSDF/масштабируемого FixedSize backend пересчитывает результат под запрошенный размер.

public float GetCacheScale(int cacheIndex, int size);

Читает масштаб цветного bitmap-кэша. Запрос может создать размерный кэш; для MSDF/масштабируемого FixedSize backend пересчитывает результат под запрошенный размер.

public float GetCacheUnderlinePosition(int cacheIndex, int size);

Читает положение подчёркивания относительно базовой линии. Запрос может создать размерный кэш; для MSDF/масштабируемого FixedSize backend пересчитывает результат под запрошенный размер.

public float GetCacheUnderlineThickness(int cacheIndex, int size);

Читает толщину подчёркивания. Запрос может создать размерный кэш; для MSDF/масштабируемого FixedSize backend пересчитывает результат под запрошенный размер.

public long GetCharFromGlyphIndex(int size, int glyphIndex);

Ищет Unicode code point по индексу глифа первого кэша. Для динамического шрифта это поиск по cmap, не обратное преобразование сформированной строки: несколько символов могут делить глиф. Не используйте для восстановления лигатур, UTF-16 позиции или произвольного bitmap-кэша.

public byte[] GetData();

Возвращает копию исходных байтов в C#. Изменение результата само не меняет FontFile; используйте SetData. Для BMFont изображения страниц сюда не упаковываются.

public bool GetDisableEmbeddedBitmaps();

Читает DisableEmbeddedBitmaps без оценки качества отображения. Запрещает встроенные растровые варианты в динамическом шрифте; по умолчанию true. Не отключает загрузку отдельного BMFont. Для цветных и исключительно растровых шрифтов действуют ограничения формата и backend.

public float GetEmbolden(int cacheIndex);

Читает силу синтетического утолщения выбранного кэша; по умолчанию 0. Это не вес реального начертания.

public float GetExtraBaselineOffset(int cacheIndex);

Читает дополнительное смещение базовой линии как долю высоты шрифта; по умолчанию 0. Не пиксели.

public long GetExtraSpacing(int cacheIndex, TextServer.SpacingType spacing);

Читает дополнительный интервал выбранного типа в пикселях, не коэффициент размера. По умолчанию 0.

public long GetFaceIndex(int cacheIndex);

Читает сохранённый индекс начертания в коллекции, по умолчанию 0. Сам getter не подтверждает наличие такого начертания в файле.

public int GetFixedSize();

Читает настройку FixedSize, без измерения высоты текста или глифов.

public TextServer.FixedSizeScaleMode GetFixedSizeScaleMode();

Читает FixedSizeScaleMode без оценки качества отображения. Масштабирование при положительном FixedSize: Disable не масштабирует, IntegerOnly использует целый множитель, Enabled разрешает дробный. По умолчанию Disable. Для пиксельного растрового шрифта выбирайте IntegerOnly и проверяйте фактический масштаб интерфейса.

public bool GetGenerateMipmaps();

Читает GenerateMipmaps без оценки качества отображения. Генерирует mip-уровни текстур шрифта; по умолчанию false. Может помочь при уменьшении текста, но требует памяти и подходящей фильтрации у потребителя. Само включение не гарантирует более чёткий текст.

public Vector2 GetGlyphAdvance(int cacheIndex, int size, int glyph);

Читает перемещение пера, при необходимости создавая динамический глиф. MSDF/FixedSize, embolden и округление могут влиять на возвращённый результат. Не используйте как размер видимых пикселей или всего сформированного текста.

public int GetGlyphIndex(int size, long @char, long variationSelector);

Преобразует Unicode code point и необязательный variation selector в индекс глифа первого кэша. Это не индекс UTF-16 char в строке и не полноценный shaping: лигатуры/контекстные формы определяются TextServer. Для ручного bitmap-шрифта backend может использовать сам код символа как ключ.

public int[] GetGlyphList(int cacheIndex, Vector2I size);

Возвращает ключи уже имеющихся записей глифов выбранного кэша, не все символы файла. Ключи могут включать варианты субпиксельного/LCD-кэша; порядок не гарантирован. Результат C# — копия.

public Vector2 GetGlyphOffset(int cacheIndex, Vector2I size, int glyph);

Читает локальное смещение глифа с учётом поддерживаемого масштабирования MSDF/FixedSize. Это не позиция Entity или Control. Запрос может подготовить динамическую запись.

public Vector2 GetGlyphSize(int cacheIndex, Vector2I size, int glyph);

Возвращает размер рисуемого прямоугольника, возможно нулевой для невидимого символа. Масштабирование MSDF/FixedSize может влиять на результат. Это не шаг между символами.

public int GetGlyphTextureIdx(int cacheIndex, Vector2I size, int glyph);

Читает индекс страницы; Advanced backend возвращает -1, если нет отображаемой текстуры/глиф не подготовлен. Проверяйте индекс относительно GetTextureCount. После RemoveTexture даже допустимый индекс может ссылаться на другую страницу.

public Rect2 GetGlyphUVRect(int cacheIndex, Vector2I size, int glyph);

Читает прямоугольник источника в пикселях страницы атласа. Это не экранные координаты и не нормализованные UV. Запрос может создать динамический глиф.

public TextServer.Hinting GetHinting();

Читает Hinting без оценки качества отображения. Подгонка динамического растрового шрифта к пиксельной сетке: None, Light или Normal; по умолчанию Light. Normal может менять метрики по обеим осям, в том числе ширины моноширинных символов. Для MSDF хинтинг не поддерживается.

public bool GetKeepRoundingRemainders();

Читает KeepRoundingRemainders без оценки качества отображения. Сохраняет остатки округления при выравнивании глифов по пикселям, уменьшая накопление ошибки интервалов; по умолчанию true. При субпиксельном позиционировании соответствующее округление горизонтальных advances не применяется. Это не включение кернинга.

public Vector2 GetKerning(int cacheIndex, int size, Vector2I glyphPair);

Читает корректировку ручной пары; без неё backend может обратиться к данным исходного шрифта. Это не результат полного shaping строки и не список OpenType-правил.

public Reckfell.Collections.Array<Vector2I> GetKerningList(int cacheIndex, int size);

Возвращает пары глифов из ручной таблицы кернинга этого размера, не все пары исходного OpenType-файла. Порядок не гарантирован. Typed Array не является IDisposable.

public bool GetLanguageSupportOverride(string language);

Читает только явную запись языка. false означает и отсутствие записи, и явный запрет; различайте их через GetLanguageSupportOverrides. Запись «*» здесь не разрешается автоматически. Это не проверка наличия символов.

public string[] GetLanguageSupportOverrides();

Возвращает ключи явных языковых переопределений, включая записи со значением false и «*». Порядок не гарантирован; это не список всех языков, которые способен показать шрифт.

public int GetMsdfPixelRange();

Читает MsdfPixelRange без оценки качества отображения. Диапазон расстояний MSDF вокруг контура. У нового FontFile равен 16, после LoadDynamicFont — 14. Для обводки задавайте как минимум удвоенную максимальную толщину. Работает при включённом MSDF; большее значение само не повышает точность.

public int GetMsdfSize();

Читает MsdfSize без оценки качества отображения. Базовый размер генерации MSDF, не размер текста Control. У нового FontFile равен 48, после LoadDynamicFont — 128. Увеличивайте только при заметной нехватке точности: растут затраты генерации и памяти. Требует включённого MSDF.

public Reckfell.Collections.Dictionary GetOpentypeFeatureOverrides();

Возвращает Dictionary с общей таблицей функций OpenType. Изменения результата меняют данные ресурса без Changed; Duplicate даёт отдельную таблицу. Освобождайте managed wrapper после чтения. Наличие тега не доказывает поддержку файлом.

public float GetOversampling();

Читает Oversampling без оценки качества отображения. Множитель растеризации динамического шрифта: положительное значение переопределяет настройку viewport, 0 оставляет её. Явный положительный аргумент метода рисования имеет приоритет. MSDF и положительный FixedSize обходят oversampling. Это не масштаб текста; учитывайте память и время генерации.

public bool GetScriptSupportOverride(string script);

Читает явную запись письменности. false также возвращается без записи; наличие проверяйте по GetScriptSupportOverrides. Не разрешает «*», не анализирует глифы и не относится к C#-скриптам.

public string[] GetScriptSupportOverrides();

Возвращает ключи переопределений письменностей, включая false и «*», без гарантии порядка. Это не автоматически обнаруженный список письменностей файла.

public Reckfell.Collections.Array<Vector2I> GetSizeCacheList(int cacheIndex);

Список обычных кэшей размера выбранного font RID: Vector2I(размер, толщина обводки). Advanced backend исключает записи viewport oversampling; это не полный отчёт памяти. Сам запрос может лениво создать RID и базовый кэш размера.

public TextServer.SubpixelPositioning GetSubpixelPositioning();

Читает SubpixelPositioning без оценки качества отображения. Точность горизонтальной позиции глифа: Disabled, Auto, OneHalf или OneQuarter. У нового FontFile — Auto, после LoadDynamicFont — Disabled. Дополнительные позиции могут потребовать больше вариантов глифов в кэше. Не путайте с Lcd-сглаживанием.

public int GetTextureCount(int cacheIndex, Vector2I size);

Число страниц атласа для выбранного размера/обводки, не число глифов. Запрос может создать размерный кэш. Не доказывает, что все записи глифов ссылаются на правильные страницы.

public Image GetTextureImage(int cacheIndex, Vector2I size, int textureIndex);

Возвращает общую ссылку Image страницы, не копию пикселей и не снимок экрана. Изменение Image может затронуть других потребителей; для независимого редактирования создайте копию. Изменение Image само не гарантирует пересоздание текстуры атласа.

public int[] GetTextureOffsets(int cacheIndex, Vector2I size, int textureIndex);

Читает данные полок страницы группами x, y, ширина, высота. C# возвращает копию int[]; назначьте изменения через SetTextureOffsets. Это не прямоугольники глифов.

public Transform2D GetTransform(int cacheIndex);

Читает матрицу преобразования контура; по умолчанию Identity. Это не глобальное преобразование Control.

public Reckfell.Collections.Dictionary GetVariationCoordinates(int cacheIndex);

Возвращает общую таблицу координат осей выбранного кэша. В отличие от FontVariation, getter здесь не создаёт независимую копию. Правка alias обходит setter и сброс кэша; для изменений получите Duplicate и вызовите SetVariationCoordinates.

public bool IsAllowSystemFallback();

Читает разрешение системного fallback, а не наличие шрифта или нужного символа.

public bool IsForceAutohinter();

Читает ForceAutohinter без оценки качества отображения. Предпочитает автохинтинг встроенным инструкциям динамического шрифта; по умолчанию false. Не заменяет Hinting и не делает MSDF-шрифт хинтованным. Сравнивайте мелкий текст на целевом масштабе.

public bool IsModulateColorGlyphs();

Читает ModulateColorGlyphs без оценки качества отображения. Применяет RGB-модуляцию также к цветным глифам; по умолчанию false. При false цветные глифы сохраняют собственный RGB, но прозрачность отрисовки учитывается. Настройка не добавляет отсутствующие цветные символы.

public bool IsMultichannelSignedDistanceField();

Читает MultichannelSignedDistanceField без оценки качества отображения. Использует многоканальное поле расстояний для масштабируемых глифов из векторных данных; по умолчанию false. Настраивайте MsdfSize и MsdfPixelRange после загрузки. Хинтинг недоступен, мелкий текст может выглядеть хуже; пересекающиеся контуры требуют проверки. Это не гарантия бесплатного масштабирования или качества любого файла.

public Error LoadBitmapFont(string path);

Загружает текстовый BMFont или двоичный BMFont версии 3 и изображения страниц относительно его каталога. Сбрасывает прежнее состояние; ошибка может оставить частичные изменения. Проверяйте Error и журнал.

public Error LoadDynamicFont(string path);

Сбрасывает состояние и читает файл в Data. В 1.0.0 Error.Ok не подтверждает чтение или декодирование: проверяйте файл, данные, нужные глифы и отображение. Настройки задавайте после загрузки; отката нет.

public void RemoveCache(int cacheIndex);

Удаляет слот и освобождает его RID, сдвигает последующие индексы и отправляет Changed. Сохранённые индексы после удаления перепроверьте.

public void RemoveGlyph(int cacheIndex, Vector2I size, int glyph);

Удаляет одну запись кэша, сохраняя страницы, кернинг и данные шрифта. Не удаляет символ из исходного файла; динамическая запись может появиться снова при обращении. Changed не отправляется.

public void RemoveKerning(int cacheIndex, int size, Vector2I glyphPair);

Удаляет ручную корректировку упорядоченной пары, возвращая обычное поведение backend/файла. Не удаляет глифы; нет записи — нет изменений. Changed не отправляется.

public void RemoveLanguageSupportOverride(string language);

Удаляет точный ключ, если он есть, и передаёт удаление существующим кэшам. Это возврат к обычному выбору/общей записи «*», а не явный запрет. Отсутствующий ключ ничего не меняет; Changed не отправляется.

public void RemoveScriptSupportOverride(string script);

Удаляет явное решение письменности и восстанавливает выбор по файлу/записи «*». Не удаляет глифы. Отсутствующий ключ безопасно игнорируется; Changed не отправляется.

public void RemoveSizeCache(int cacheIndex, Vector2I size);

Удаляет один кэш размера/обводки, сохраняя RID и исходные данные. Берите ключ из GetSizeCacheList; MSDF, FixedSize и oversampling влияют на эффективные ключи. Нет записи — нет изменений. Changed не отправляется.

public void RemoveTexture(int cacheIndex, Vector2I size, int textureIndex);

Удаляет страницу и сдвигает следующие страницы. Дефект 1.0.0: индексы в глифах не переназначаются; допустимый старый индекс может уже указывать на чужое изображение, а вышедший за границы — вызвать диагностику/повторную растеризацию. Не удаляйте страницу используемого bitmap-атласа без пересборки всех зависимых записей. Changed не отправляется.

public void RenderGlyph(int cacheIndex, Vector2I size, int index);

Заранее подготавливает динамический глиф и необходимые варианты в кэше. Принимает индекс глифа, не Unicode code point. Не рисует текст на экране и не заполняет вручную отсутствующий bitmap-атлас. Настройте качество до подготовки.

public void RenderRange(int cacheIndex, Vector2I size, long start, long end);

Заранее подготавливает динамические глифы диапазона Unicode, включая обе границы. Это не диапазон индексов глифов или UTF-16. Ограничивайте набор нужными символами: широкий диапазон требует времени и памяти. Не заменяет shaping и не рисует текст.

public void SetAllowSystemFallback(bool allowSystemFallback);

Разрешает поиск отсутствующих символов в системных шрифтах; по умолчанию true. Результат зависит от ОС и установленных шрифтов. Изменение отправляет Changed.

public void SetAntialiasing(TextServer.FontAntialiasing antialiasing);

Сглаживание растровых глифов: None — однобитное, Gray — полутоновое, Lcd — субпиксели экрана. По умолчанию Gray. Lcd подходит для горизонтального немасштабированного текста 2D; это отдельная настройка от SubpixelPositioning. Изменение отправляет Changed; присваивание того же значения его не отправляет. Загрузка сбрасывает настройку.

public void SetCacheAscent(int cacheIndex, int size, float ascent);

Задаёт расстояние над базовой линией для кэша размера. Это ручная метрика, не изменение исходных контуров или размера Control. Changed не отправляется.

public void SetCacheDescent(int cacheIndex, int size, float descent);

Задаёт расстояние под базовой линией для кэша размера. Это ручная метрика, не изменение исходных контуров или размера Control. Changed не отправляется.

public void SetCacheScale(int cacheIndex, int size, float scale);

Задаёт масштаб цветного bitmap-кэша для кэша размера. Это ручная метрика, не изменение исходных контуров или размера Control. Changed не отправляется.

public void SetCacheUnderlinePosition(int cacheIndex, int size, float underlinePosition);

Задаёт положение подчёркивания относительно базовой линии для кэша размера. Это ручная метрика, не изменение исходных контуров или размера Control. Changed не отправляется.

public void SetCacheUnderlineThickness(int cacheIndex, int size, float underlineThickness);

Задаёт толщину подчёркивания для кэша размера. Это ручная метрика, не изменение исходных контуров или размера Control. Changed не отправляется.

public void SetData(byte[] data);

Заменяет байты шрифта и передаёт их существующим кэшам. Не выполняет полный reset и не отправляет Changed; пустые или повреждённые данные не превращаются в проверенный шрифт.

public void SetData(ReadOnlySpan<byte> data);

Заменяет байты шрифта и передаёт их существующим кэшам. Не выполняет полный reset и не отправляет Changed; пустые или повреждённые данные не превращаются в проверенный шрифт.

public void SetDisableEmbeddedBitmaps(bool disableEmbeddedBitmaps);

Запрещает встроенные растровые варианты в динамическом шрифте; по умолчанию true. Не отключает загрузку отдельного BMFont. Для цветных и исключительно растровых шрифтов действуют ограничения формата и backend. Изменение отправляет Changed; присваивание того же значения его не отправляет. Загрузка сбрасывает настройку.

public void SetEmbolden(int cacheIndex, float strength);

Задаёт синтетическое утолщение контура: 0 без изменения, положительное утолщает, отрицательное утоньшает. Не заменяет качественное начертание или ось weight. Смена значения может очистить кэш backend. Прямое изменение кэша не отправляет Changed; настраивайте до использования ресурса.

public void SetExtraBaselineOffset(int cacheIndex, float baselineOffset);

Задаёт дополнительное смещение базовой линии в долях высоты шрифта, не в пикселях. Отличается от SetGlyphOffset и Transform Control. Прямое изменение кэша не отправляет Changed; настраивайте до использования ресурса.

public void SetExtraSpacing(int cacheIndex, TextServer.SpacingType spacing, long value);

Задаёт дополнительные пиксели для Glyph, Space, Top или Bottom. Это не ручная таблица кернинга пары и не размер шрифта. Прямое изменение кэша не отправляет Changed; настраивайте до использования ресурса.

public void SetFaceIndex(int cacheIndex, long faceIndex);

Выбирает начертание внутри коллекции шрифтов; индекс неотрицательный, меньше 32767 и фактического числа начертаний. Это не индекс вариации или кэша. Наличие численно допустимого значения ещё не подтверждает декодирование файла. Прямое изменение кэша не отправляет Changed; настраивайте до использования ресурса.

public void SetFixedSize(int fixedSize);

Фиксированный размер растеризации; 0 отключает принудительный размер. Это не размер текста Control. При изменении обновляет кэши и отправляет Changed; загрузка сбрасывает значение.

public void SetFixedSizeScaleMode(TextServer.FixedSizeScaleMode fixedSizeScaleMode);

Масштабирование при положительном FixedSize: Disable не масштабирует, IntegerOnly использует целый множитель, Enabled разрешает дробный. По умолчанию Disable. Для пиксельного растрового шрифта выбирайте IntegerOnly и проверяйте фактический масштаб интерфейса. Изменение отправляет Changed; присваивание того же значения его не отправляет. Загрузка сбрасывает настройку.

public void SetFontName(string name);

Имя семейства в метаданных первого кэша. Изменение не загружает другой файл и само не отправляет Changed.

public void SetFontStretch(int stretch);

Ширина в метаданных первого кэша, 50–200, обычная 100. Advanced backend ограничивает диапазон; это не масштаб Transform и не гарантированное растяжение глифов. Setter не отправляет Changed.

public void SetFontStyle(TextServer.FontStyle style);

Флаги метаданных начертания первого кэша. Не обещают синтез жирного или курсивного рисунка; setter не отправляет Changed.

public void SetFontStyleName(string name);

Имя начертания в метаданных первого кэша, например Regular. Не выбирает автоматически другой файл шрифта и не отправляет Changed.

public void SetFontWeight(int weight);

Вес в метаданных первого кэша: диапазон 100–999, обычный 400, жирный 700. Advanced backend ограничивает диапазон. Не заменяет нужное начертание и не отправляет Changed.

public void SetForceAutohinter(bool forceAutohinter);

Предпочитает автохинтинг встроенным инструкциям динамического шрифта; по умолчанию false. Не заменяет Hinting и не делает MSDF-шрифт хинтованным. Сравнивайте мелкий текст на целевом масштабе. Изменение отправляет Changed; присваивание того же значения его не отправляет. Загрузка сбрасывает настройку.

public void SetGenerateMipmaps(bool generateMipmaps);

Генерирует mip-уровни текстур шрифта; по умолчанию false. Может помочь при уменьшении текста, но требует памяти и подходящей фильтрации у потребителя. Само включение не гарантирует более чёткий текст. Изменение отправляет Changed; присваивание того же значения его не отправляет. Загрузка сбрасывает настройку.

public void SetGlyphAdvance(int cacheIndex, int size, int glyph, Vector2 advance);

Задаёт перемещение пера после глифа в кэше без обводки. Это не ширина видимого прямоугольника: пробел может иметь advance без изображения. Создаёт/обновляет запись, но не страницу или контур. Changed не отправляется.

public void SetGlyphOffset(int cacheIndex, Vector2I size, int glyph, Vector2 offset);

Задаёт локальное смещение прямоугольника глифа относительно позиции рисования. Не меняет UV страницы или advance. Для bitmap-атласа согласуйте со всеми остальными полями записи. Changed не отправляется.

public void SetGlyphSize(int cacheIndex, Vector2I size, int glyph, Vector2 glSize);

Задаёт размер рисуемого прямоугольника глифа, не размер шрифта и не advance. Само по себе не создаёт изображение. Changed не отправляется.

public void SetGlyphTextureIdx(int cacheIndex, Vector2I size, int glyph, int textureIdx);

Задаёт индекс страницы записи глифа, не назначая Image и не проверяя полную согласованность атласа. Нужна существующая правильная страница; -1 обозначает отсутствие текстуры. Changed не отправляется.

public void SetGlyphUVRect(int cacheIndex, Vector2I size, int glyph, Rect2 uVRect);

Задаёт прямоугольник в пикселях изображения страницы атласа, не нормализованные UV 0–1. Должен соответствовать странице GlyphTextureIdx и её размерам. Не задаёт размер шрифта. Changed не отправляется.

public void SetHinting(TextServer.Hinting hinting);

Подгонка динамического растрового шрифта к пиксельной сетке: None, Light или Normal; по умолчанию Light. Normal может менять метрики по обеим осям, в том числе ширины моноширинных символов. Для MSDF хинтинг не поддерживается. Изменение отправляет Changed; присваивание того же значения его не отправляет. Загрузка сбрасывает настройку.

public void SetKeepRoundingRemainders(bool keepRoundingRemainders);

Сохраняет остатки округления при выравнивании глифов по пикселям, уменьшая накопление ошибки интервалов; по умолчанию true. При субпиксельном позиционировании соответствующее округление горизонтальных advances не применяется. Это не включение кернинга. Изменение отправляет Changed; присваивание того же значения его не отправляет. Загрузка сбрасывает настройку.

public void SetKerning(int cacheIndex, int size, Vector2I glyphPair, Vector2 kerning);

Задаёт ручную корректировку для упорядоченной пары индексов глифов. Не создаёт глифы и не включает функцию OpenType kern. MSDF/FixedSize влияют на эффективные значения. Changed не отправляется.

public void SetLanguageSupportOverride(string language, bool supported);

Задаёт явное решение для точного ключа языка и обновляет существующие font RID. «*» задаёт общий результат при отсутствии точного ключа. Не добавляет глифы или shaping; Changed не отправляется. Настраивайте до использования ресурса. Загрузка файла сохраняет эти записи.

public void SetModulateColorGlyphs(bool modulate);

Применяет RGB-модуляцию также к цветным глифам; по умолчанию false. При false цветные глифы сохраняют собственный RGB, но прозрачность отрисовки учитывается. Настройка не добавляет отсутствующие цветные символы. Изменение отправляет Changed; присваивание того же значения его не отправляет. Загрузка сбрасывает настройку.

public void SetMsdfPixelRange(int msdfPixelRange);

Диапазон расстояний MSDF вокруг контура. У нового FontFile равен 16, после LoadDynamicFont — 14. Для обводки задавайте как минимум удвоенную максимальную толщину. Работает при включённом MSDF; большее значение само не повышает точность. Изменение отправляет Changed; присваивание того же значения его не отправляет. Загрузка сбрасывает настройку.

public void SetMsdfSize(int msdfSize);

Базовый размер генерации MSDF, не размер текста Control. У нового FontFile равен 48, после LoadDynamicFont — 128. Увеличивайте только при заметной нехватке точности: растут затраты генерации и памяти. Требует включённого MSDF. Изменение отправляет Changed; присваивание того же значения его не отправляет. Загрузка сбрасывает настройку.

public void SetMultichannelSignedDistanceField(bool msdf);

Использует многоканальное поле расстояний для масштабируемых глифов из векторных данных; по умолчанию false. Настраивайте MsdfSize и MsdfPixelRange после загрузки. Хинтинг недоступен, мелкий текст может выглядеть хуже; пересекающиеся контуры требуют проверки. Это не гарантия бесплатного масштабирования или качества любого файла. Изменение отправляет Changed; присваивание того же значения его не отправляет. Загрузка сбрасывает настройку.

public void SetOpentypeFeatureOverrides(Reckfell.Collections.Dictionary overrides);

Общие настройки функций OpenType: ключ-тег, например liga или kern, и целое значение. 0 выключает, положительное значение включает или выбирает вариант; отрицательные значения пропускаются при shaping. Это не оси variable font. Dictionary хранится совместно: для независимого снимка вызовите Duplicate. Setter и правка Dictionary не отправляют Changed; не рассчитывайте на автоматический перерасчёт уже подготовленного текста. Задавайте до использования, проверяйте поддержку функцией GetSupportedFeatureList. Загрузка файла сохраняет настройки.

public void SetOversampling(float oversampling);

Множитель растеризации динамического шрифта: положительное значение переопределяет настройку viewport, 0 оставляет её. Явный положительный аргумент метода рисования имеет приоритет. MSDF и положительный FixedSize обходят oversampling. Это не масштаб текста; учитывайте память и время генерации. Изменение отправляет Changed; присваивание того же значения его не отправляет. Загрузка сбрасывает настройку.

public void SetScriptSupportOverride(string script, bool supported);

Задаёт решение для точного кода письменности, например Latn или Cyrl; «*» применяется при отсутствии точного ключа. Не меняет форму символов и не добавляет отсутствующие глифы. Обновляет существующие font RID без Changed; загрузка файла сохраняет записи.

public void SetSubpixelPositioning(TextServer.SubpixelPositioning subpixelPositioning);

Точность горизонтальной позиции глифа: Disabled, Auto, OneHalf или OneQuarter. У нового FontFile — Auto, после LoadDynamicFont — Disabled. Дополнительные позиции могут потребовать больше вариантов глифов в кэше. Не путайте с Lcd-сглаживанием. Изменение отправляет Changed; присваивание того же значения его не отправляет. Загрузка сбрасывает настройку.

public void SetTextureImage(int cacheIndex, Vector2I size, int textureIndex, Image image);

Назначает непустой Image странице атласа и создаёт её текстуру; больший индекс расширяет таблицу страниц. Image хранится как общий ресурс. Не задаёт прямоугольники/метрики глифов и не отправляет Changed. Настраивайте согласованный кэш до использования.

public void SetTextureOffsets(int cacheIndex, Vector2I size, int textureIndex, int[] offset);

Заменяет внутренние данные упаковки полок атласа: группы int по четыре — x, y, ширина, высота. Длина кратна 4. Это не смещение отдельного глифа и не UV-массив. C# копирует вход; перегрузки массива и span равнозначны. Changed не отправляется.

public void SetTextureOffsets(int cacheIndex, Vector2I size, int textureIndex, ReadOnlySpan<int> offset);

Заменяет внутренние данные упаковки полок атласа: группы int по четыре — x, y, ширина, высота. Длина кратна 4. Это не смещение отдельного глифа и не UV-массив. C# копирует вход; перегрузки массива и span равнозначны. Changed не отправляется.

public void SetTransform(int cacheIndex, Transform2D transform);

Задаёт преобразование контуров, например наклон или поворот. Это синтетическое изменение глифов, не перемещение элемента интерфейса; не рассчитывайте на перенос Origin как на позицию текста. Прямое изменение кэша не отправляет Changed; настраивайте до использования ресурса.

public void SetVariationCoordinates(int cacheIndex, Reckfell.Collections.Dictionary variationCoordinates);

Копирует плоскую таблицу ось → число в выбранный кэш; диапазоны/оси берите из GetSupportedVariationList. Предпочитайте числовые теги из TextServer.NameToTag. Это реальные оси variable font, не функции liga/kern. Backend сбрасывает кэш при изменении таблицы. Прямое изменение кэша не отправляет Changed; настраивайте до использования ресурса.