Site changes [skip-ci]

Author: defold-services

ru/manuals/font.md

@@ -12,6 +12,9 @@ toc:
 - Растровые шрифты BMFont
 - Артефакты и рекомендации
 - Кэш шрифта
+- Генерация во время выполнения
+- Предварительная генерация кэша глифов
+- Скриптование шрифтов
 ---
 
 # Ресурс Font
@@ -22,16 +25,11 @@ toc:
 - OpenType
 - BMFont
 
-
 Шрифты, добавленные в проект, автоматически конвертируются в текстуру, которую Defold может визуализировать. Доступны два метода визуализации шрифтов, каждый из которых имеет свои преимущества и недостатки:
 
 - Bitmap
 - Distance field
 
-<div class='sidenote' markdown='1'>
-Вместо генерации и включения текстуры шрифта в состав приложения можно [генерировать глифы шрифта во время выполнения](/extension-fontgen) из встроенного шрифта TrueType. Такой подход может значительно сократить размер загрузки и потребление оперативной памяти в игре на Defold.
-</div>
-
 ## Создание шрифта
 
 Чтобы создать шрифт для использования в Defold, создайте новый файл Font, выбрав в меню <kbd>File ▸ New...</kbd>, затем <kbd>Font</kbd>. Можно также <kbd>кликнуть ПКМ</kbd> в нужном расположении в браузере ассетов и выбрать <kbd>New... ▸ Font</kbd>.
@@ -177,4 +175,79 @@ space ! " # $ % & ' ( ) * + , - . / 0 1 2 3 4 5 6 7 8 9 : ; < = > ? @ A B C D E
 
 `float horizontal_gradient = fract(var_texcoord0.y / texture_size_recip.w);`
 
-Подробнее об унифицированных шейдерных переменных см. В [руководстве по шейдерам](/ru/manuals/shader).
+Подробнее об унифицированных шейдерных переменных см. В [руководстве по шейдерам](/ru/manuals/shader).
+
+## Генерация во время выполнения
+
+Возможно использовать генерацию шрифтов типа SDF (Distance Field) во время выполнения при использовании шрифтов TrueType (.ttf).  
+Этот подход позволяет значительно уменьшить размер загрузки и потребление памяти во время выполнения в игре на Defold.  
+Небольшой недостаток — небольшая задержка при генерации каждого глифа во время выполнения.
+
+Активируйте эту возможность, установив параметр `font.runtime_generation` в файле game.project.
+
+<div class='sidenote' markdown='1'>
+Эта функция на данный момент является экспериментальной, но планируется использовать её в качестве основного рабочего процесса в будущем.
+</div>
+
+<div class='important' markdown='1'>
+Этот параметр влияет на все .ttf шрифты в проекте.
+</div>
+
+### Предварительная генерация кэша глифов
+
+Чтобы упростить использование шрифтов, генерируемых во время выполнения, поддерживается предварительная генерация кэша глифов.  
+Это означает, что шрифт сгенерирует глифы, указанные в поле *Characters* ресурса шрифта.
+
+<div class='sidenote' markdown='1'>
+Если установлено свойство `All Chars`, предварительная генерация не будет выполняться, так как это противоречит цели — не генерировать все глифы сразу.
+</div>
+
+### Скриптование шрифтов
+
+Для шрифтов, генерируемых во время выполнения, можно добавлять и удалять подшрифты.  
+Это полезно, если один большой шрифт был разделён на несколько файлов по наборам символов (например, для CJK).
+
+<div class='important' markdown='1'>
+Добавление подшрифта не приводит к автоматической загрузке или отображению всех глифов.
+</div>
+
+```lua
+-- Добавить диапазон A-Z в .fontc
+local font_hash = hash("/assets/fonts/roboto.fontc")
+local ttf_hash = hash("/assets/fonts/Roboto/Roboto-Bold.ttf")
+local codepoint_min = 0x00000041 -- A
+local codepoint_max = 0x0000005A -- Z
+font.add_source(font_hash, ttf_hash, codepoint_min, codepoint_max)
+```
+
+```lua
+-- Удалить связанный ttf-ресурс
+local font_hash = hash("/assets/fonts/roboto.fontc")
+local ttf_hash = hash("/assets/fonts/Roboto/Roboto-Bold.ttf")
+font.remove_source(font_hash, ttf_hash)
+```
+
+Чтобы загрузить глифы в шрифт, необходимо вызвать `font.add_glyphs()`.
+Это асинхронная операция, и после её завершения можно безопасно отображать сообщения, содержащие эти глифы.
+
+```lua
+local function add_glyph_callback(self, id, result, errmsg)
+  if not result then
+    print("Запрос " .. id .. " завершился с ошибкой:", errmsg)
+  else
+    msg.post(some_url, "show_dialog")
+  end
+end
+
+-- Загрузить глифы в шрифт
+local font_hash = hash("/assets/fonts/roboto.fontc")
+local glyphs = "Some text to be shown!" -- для наилучшей производительности используйте список уникальных глифов
+local request_id = font.add_glyphs(font_hash, ttf_hash, add_glyph_callback)
+```
+
+И, когда символы больше не нужны, можно освободить память:
+```lua
+-- Удалить глифы из памяти
+local font_hash = hash("/assets/fonts/roboto.fontc")
+font.remove_glyphs(font_hash, "Все символы из набора")
+```