TextServer
Успадковує: RefCounted < Object
Успадковано від: TextServerExtension
Інтерфейс сервера для управління шрифтами та текстовим рендерингом.
Опис
TextServer — це серверний API для керування шрифтами та відтворення тексту.
Примітка. Це API низького рівня, замість нього можна використовувати класи TextLine, TextParagraph і Font.
Це абстрактний клас, тому, щоб отримати поточний активний екземпляр TextServer, використовуйте такий код:
var ts = TextServerManager.get_primary_interface()
var ts = TextServerManager.GetPrimaryInterface();
Методи
Переліки
enum FontAntialiasing: 🔗
FontAntialiasing FONT_ANTIALIASING_NONE = 0
Шрифт glyphs є растровими як 1-bit бітмапа.
FontAntialiasing FONT_ANTIALIASING_GRAY = 1
Шрифт glyphs є растровими як 8-бітні сіророзмірні антиалюзовані бітмапи.
FontAntialiasing FONT_ANTIALIASING_LCD = 2
Гліфи шрифтів растеризуються для РК-екранів.
Розташування субпікселів РК-дисплея визначається значенням параметра ProjectSettings.gui/theme/lcd_subpixel_layout.
Режим згладжування субпікселів РК-дисплея підходить лише для рендерингу горизонтального, немасштабованого тексту у 2D.
enum FontLCDSubpixelLayout: 🔗
FontLCDSubpixelLayout FONT_LCD_SUBPIXEL_LAYOUT_NONE = 0
Невідомий або не підтримується підпіксельний макет, LCD підпіксельний антиалії вимкнений.
FontLCDSubpixelLayout FONT_LCD_SUBPIXEL_LAYOUT_HRGB = 1
Горизонтальний RGB підпіксельний макет.
FontLCDSubpixelLayout FONT_LCD_SUBPIXEL_LAYOUT_HBGR = 2
Горизонтальний BGR підпіксельний макет.
FontLCDSubpixelLayout FONT_LCD_SUBPIXEL_LAYOUT_VRGB = 3
Вертикальний RGB підпіксельний макет.
FontLCDSubpixelLayout FONT_LCD_SUBPIXEL_LAYOUT_VBGR = 4
Вертикальний макет BGR.
FontLCDSubpixelLayout FONT_LCD_SUBPIXEL_LAYOUT_MAX = 5
Представляє розмір FontLCDSubpixelLayout enum.
enum Direction: 🔗
Direction DIRECTION_AUTO = 0
Текстовий напрямок визначається на основі вмісту та поточного локалізації.
Direction DIRECTION_LTR = 1
Текст написаний зліва направо.
Direction DIRECTION_RTL = 2
Текст письмовий з правого наліво.
Direction DIRECTION_INHERITED = 3
Текстовий напрямок написання є таким же, як базовий напрямок написання. Використовуються тільки для BiDi.
enum Orientation: 🔗
Orientation ORIENTATION_HORIZONTAL = 0
Текст письмовий горизонтально.
Orientation ORIENTATION_VERTICAL = 1
Залишається на правий текст письмово вертикально зверху донизу.
Право на лівий текст написано вертикально знизу до вершини.
flags JustificationFlag: 🔗
JustificationFlag JUSTIFICATION_NONE = 0
Повідомляти текст.
JustificationFlag JUSTIFICATION_KASHIDA = 1
За допомогою додавання і видалення kashidas.
JustificationFlag JUSTIFICATION_WORD_BOUND = 2
Визначте текст, змінивши ширину просторів між словами.
JustificationFlag JUSTIFICATION_TRIM_EDGE_SPACES = 4
Видаліть причепи і провідні пробіли з виправданого тексту.
JustificationFlag JUSTIFICATION_AFTER_LAST_TAB = 8
Тільки застосуйте обґрунтування частини тексту після останньої вкладки.
JustificationFlag JUSTIFICATION_CONSTRAIN_ELLIPSIS = 16
Застосувати виправдання на обрізну лінію еліпсом.
JustificationFlag JUSTIFICATION_SKIP_LAST_LINE = 32
Не застосуйте обґрунтування останньої лінії абзацу.
JustificationFlag JUSTIFICATION_SKIP_LAST_LINE_WITH_VISIBLE_CHARS = 64
Не застосовувати виправдання останнього рядка абзаців з видимими символами (докази, що передаються JUSTIFICATION_SKIP_LAST_LINE.
JustificationFlag JUSTIFICATION_DO_NOT_SKIP_SINGLE_LINE = 128
Завжди застосуйте обґрунтування абзаців одним рядком (JUSTIFICATION_SKIP_LAST_LINE і JUSTIFICATION_SKIP_LAST_LINE_WITH_VISIBLE_CHARS ігноруються).
enum AutowrapMode: 🔗
AutowrapMode AUTOWRAP_OFF = 0
Autowrap відключений.
AutowrapMode AUTOWRAP_ARBITRARY = 1
Обгортання тексту всередині прямокутника вузла, що дозволяє розірвати лінії на довільних позиціях, які корисно при наявності дуже обмеженого простору.
AutowrapMode AUTOWRAP_WORD = 2
Обгортання тексту всередині вузла, що межує прямокутник м'яким розривом між словами.
AutowrapMode AUTOWRAP_WORD_SMART = 3
Поведінка схожа на AUTOWRAP_WORD, але сила-розриває слово, якщо одне слово не вписується в одну лінію.
flags LineBreakFlag: 🔗
LineBreakFlag BREAK_NONE = 0
Не ламайте лінію.
LineBreakFlag BREAK_MANDATORY = 1
Переверніть рядок на лінії обов'язкові символи перерви (наприклад, "\n").
LineBreakFlag BREAK_WORD_BOUND = 2
Перервувати лінію між словами.
LineBreakFlag BREAK_GRAPHEME_BOUND = 4
Перервувати лінію будь-яких підключених графемів.
LineBreakFlag BREAK_ADAPTIVE = 8
Щоб використовуватися тільки в поєднанні з BREAK_WORD_BOUND, поламайте лінію між будь-якими незрівняними графеми, якщо неможливо розбити його між словами.
LineBreakFlag BREAK_TRIM_EDGE_SPACES = 16
Застаріло: Use BREAK_TRIM_START_EDGE_SPACES | BREAK_TRIM_END_EDGE_SPACES instead.
Зняти крайові місця від зламаних відрізків лінії.
LineBreakFlag BREAK_TRIM_INDENT = 32
Відшкодування першого рядка ширина від усіх ліній після першого.
LineBreakFlag BREAK_TRIM_START_EDGE_SPACES = 64
Видаліть пробіли та символи розриву рядка з початку розірваних сегментів.
Наприклад, після розриву рядка другий сегмент наступного тексту test \n next буде next, якщо прапорець встановлено, і `` next``, якщо ні.
LineBreakFlag BREAK_TRIM_END_EDGE_SPACES = 128
Видаліть пробіли та символи розриву рядка з кінця розірваних сегментів.
Наприклад, після розриву рядка перший сегмент наступного тексту test \n next буде test, якщо прапорець встановлено, і test \n, якщо ні.
enum VisibleCharactersBehavior: 🔗
VisibleCharactersBehavior VC_CHARS_BEFORE_SHAPING = 0
Обрізає текст перед формуванням. наприклад, збільшення значення Label.visible_characters або RichTextLabel.visible_characters візуально ідентично введенню тексту.
Примітка: у цьому режимі обрізаний текст взагалі не обробляється. Це не враховується під час розриву рядків і розрахунків розміру.
VisibleCharactersBehavior VC_CHARS_AFTER_SHAPING = 1
Відображає гліфи, що відповідають першим символам Label.visible_characters або RichTextLabel.visible_characters з початку тексту.
VisibleCharactersBehavior VC_GLYPHS_AUTO = 2
Відображає гліфи Label.visible_ratio або RichTextLabel.visible_ratio, починаючи зліва або справа, залежно від значення Control.layout_direction.
VisibleCharactersBehavior VC_GLYPHS_LTR = 3
Відображає гліфи Label.visible_ratio або RichTextLabel.visible_ratio, починаючи зліва.
VisibleCharactersBehavior VC_GLYPHS_RTL = 4
Відображає гліфи Label.visible_ratio або RichTextLabel.visible_ratio, починаючи справа.
enum OverrunBehavior: 🔗
OverrunBehavior OVERRUN_NO_TRIMMING = 0
Немає текстового обрізка виконується.
OverrunBehavior OVERRUN_TRIM_CHAR = 1
Перегляд тексту за характер.
OverrunBehavior OVERRUN_TRIM_WORD = 2
Перегляд тексту на слово.
OverrunBehavior OVERRUN_TRIM_ELLIPSIS = 3
Обрізає текст для кожного символу та додає трикрапку, щоб позначити, що частини приховані, якщо обрізаний текст містить 6 символів або більше.
OverrunBehavior OVERRUN_TRIM_WORD_ELLIPSIS = 4
Обрізає текст для кожного слова та додає трикрапку, щоб позначити приховані частини, якщо обрізаний текст містить 6 символів або більше.
OverrunBehavior OVERRUN_TRIM_ELLIPSIS_FORCE = 5
Обрізає текст для кожного символу та додає трикрапку, щоб позначити, що частини приховані незалежно від довжини обрізаного тексту.
OverrunBehavior OVERRUN_TRIM_WORD_ELLIPSIS_FORCE = 6
Обрізає текст по слову та додає трикрапку, щоб позначити, що частини приховані незалежно від довжини обрізаного тексту.
flags TextOverrunFlag: 🔗
TextOverrunFlag OVERRUN_NO_TRIM = 0
Не виконується обрізка.
TextOverrunFlag OVERRUN_TRIM = 1
Виконайте текст, коли він перевищує точну ширину.
TextOverrunFlag OVERRUN_TRIM_WORD_ONLY = 2
Перегляд тексту на слово замість графему.
TextOverrunFlag OVERRUN_ADD_ELLIPSIS = 4
Визначає, чи слід додати еліпсис в кінці тексту.
TextOverrunFlag OVERRUN_ENFORCE_ELLIPSIS = 8
Визначає, чи закріплюється еліпс на кінці тексту і не може бути прихованим.
TextOverrunFlag OVERRUN_JUSTIFICATION_AWARE = 16
Облікові записи для тексту, що обґрунтовується перед спробою його підірвати (див. RightificationFlag).
flags GraphemeFlag: 🔗
GraphemeFlag GRAPHEME_IS_VALID = 1
Графеме підтримується шрифтом і може бути намальований.
GraphemeFlag GRAPHEME_IS_RTL = 2
Grapheme є частиною прямо-лівої або нижньої стійки.
GraphemeFlag GRAPHEME_IS_VIRTUAL = 4
Графеме не входить до основного тексту, додана процесом вирівнювання.
GraphemeFlag GRAPHEME_IS_SPACE = 8
Grapheme - білий простір.
GraphemeFlag GRAPHEME_IS_BREAK_HARD = 16
Графеме - обов'язкова точка перерви (наприклад, "\n".
GraphemeFlag GRAPHEME_IS_BREAK_SOFT = 32
Grapheme є додатковим пунктом перерви (наприклад, простір).
GraphemeFlag GRAPHEME_IS_TAB = 64
Grapheme - характер таблички.
GraphemeFlag GRAPHEME_IS_ELONGATION = 128
Графеме - kashida.
GraphemeFlag GRAPHEME_IS_PUNCTUATION = 256
Графеме - проточний характер.
GraphemeFlag GRAPHEME_IS_UNDERSCORE = 512
Графеме - підкреслений характер.
GraphemeFlag GRAPHEME_IS_CONNECTED = 1024
Графеме підключено до попереднього графему. Перед тим як цей графем не є безпечним.
GraphemeFlag GRAPHEME_IS_SAFE_TO_INSERT_TATWEEL = 2048
Це безпечно вставляти U+0640 перед цим графемом для подовження.
GraphemeFlag GRAPHEME_IS_EMBEDDED_OBJECT = 4096
Графеме - символ заміни об'єкта для вбудованого об'єкта.
GraphemeFlag GRAPHEME_IS_SOFT_HYPHEN = 8192
Графеме - м'який фен.
enum Hinting: 🔗
Hinting HINTING_NONE = 0
Вимкнено натягування шрифту (смач, але менше хрустки).
Hinting HINTING_LIGHT = 1
Використовуйте режим натяка на блискавку.
Hinting HINTING_NORMAL = 2
Використовуйте режим натиснення за замовчуванням (криспер, але менш гладкий).
Примітка: Цей режим натягу змінює як горизонтальні, так і вертикальні гліфові метрики. Якщо застосовується до монокосмічної шрифту, деякі гліфи можуть мати різну ширину.
enum SubpixelPositioning: 🔗
SubpixelPositioning SUBPIXEL_POSITIONING_DISABLED = 0
Горизонтальна позиція Glyph закруглена на весь розмір пікселів, кожен гліф закріплюється один раз.
SubpixelPositioning SUBPIXEL_POSITIONING_AUTO = 1
Горизонтальна позиція Glyph закруглена на основі розміру шрифту.
до До одного чверті розміру пікселів, якщо розмір шрифту менший або дорівнює SUBPIXEL_SETTING_ONE_QUARTER_MAX_SIZE.
до До однієї половини розмір пікселів, якщо розмір шрифту менший або дорівнює SUBPIXEL_SETTING_ONE_HALF_MAX_SIZE.
до Для всіх розмірів пікселів для більших шрифтів.
SubpixelPositioning SUBPIXEL_POSITIONING_ONE_HALF = 2
Горизонтальна позиція Glyph округлюється на одну половину розмір пікселів, кожен гліф передається до двох разів.
SubpixelPositioning SUBPIXEL_POSITIONING_ONE_QUARTER = 3
Горизонтальна позиція Glyph закруглена до одного кварталу розміром пікселів, кожен глиф закріплюється до чотирьох разів.
SubpixelPositioning SUBPIXEL_POSITIONING_ONE_HALF_MAX_SIZE = 20
Максимальний розмір шрифту, який використовуватиме позиціонування субпікселів "половина пікселя" в режимі SUBPIXEL_POSITIONING_AUTO.
SubpixelPositioning SUBPIXEL_POSITIONING_ONE_QUARTER_MAX_SIZE = 16
Максимальний розмір шрифту, який використовуватиме позиціонування субпікселів «одна чверть пікселя» в режимі SUBPIXEL_POSITIONING_AUTO.
enum Feature: 🔗
Feature FEATURE_SIMPLE_LAYOUT = 1
TextServer підтримує прості текстові макети.
Feature FEATURE_BIDI_LAYOUT = 2
TextServer підтримує двосторонні текстові макети.
Feature FEATURE_VERTICAL_LAYOUT = 4
TextServer підтримує вертикальні макети.
Feature FEATURE_SHAPING = 8
TextServer підтримує комплексне формування тексту.
Feature FEATURE_KASHIDA_JUSTIFICATION = 16
TextServer підтримує вирівнювання за допомогою kashidas.
Feature FEATURE_BREAK_ITERATORS = 32
TextServer підтримує комплексні правила розбиття слів (наприклад, словник).
Feature FEATURE_FONT_BITMAP = 64
TextServer підтримує завантаження шрифтів бітмапа.
Feature FEATURE_FONT_DYNAMIC = 128
TextServer підтримує завантаження динамічних (TrueType, OpeType тощо) шрифтів.
Feature FEATURE_FONT_MSDF = 256
TextServer підтримує багатоканальний пульт дистанційного керування динамічним шрифтом.
Feature FEATURE_FONT_SYSTEM = 512
TextServer підтримує завантаження шрифтів системи.
Feature FEATURE_FONT_VARIABLE = 1024
TextServer підтримує змінні шрифти.
Feature FEATURE_CONTEXT_SENSITIVE_CASE_CONVERSION = 2048
TextServer підтримує локальну залежність та контекстну конфіденційну роботу.
Feature FEATURE_USE_SUPPORT_DATA = 4096
TextServer вимагає зовнішнього файлу даних для деяких функцій, див. load_support_data().
Feature FEATURE_UNICODE_IDENTIFIERS = 8192
TextServer підтримує перевірку ідентифікаторів UAX #31, див. is_valid_identifier().
Feature FEATURE_UNICODE_SECURITY = 16384
Підтримка TextServer Унікод Технічний звіт No36 та Unicode Технічний стандарт #39 на основі особливостей виявлення спофів.
enum ContourPointTag: 🔗
ContourPointTag CONTOUR_CURVE_TAG_ON = 1
Контурна точка знаходиться на криві.
ContourPointTag CONTOUR_CURVE_TAG_OFF_CONIC = 0
Контурна точка не знаходиться на криві, але служить контрольним пунктом для конічної (квадратної) Bézier arc.
ContourPointTag CONTOUR_CURVE_TAG_OFF_CUBIC = 2
Контурна точка не знаходиться на криві, але служить контрольним пунктом для кубічної дуги Bézier.
enum SpacingType: 🔗
SpacingType SPACING_GLYPH = 0
Розслаблення для кожного гліфа.
SpacingType SPACING_SPACE = 1
Просторий характер простору.
SpacingType SPACING_TOP = 2
Просування вгорі лінії.
SpacingType SPACING_BOTTOM = 3
Просування внизу лінії.
SpacingType SPACING_MAX = 4
Представляємо розмір SpacingType enum.
flags FontStyle: 🔗
FontStyle FONT_BOLD = 1
Шрифт сміливий.
FontStyle FONT_ITALIC = 2
Шрифт - це італійка або коса.
FontStyle FONT_FIXED_WIDTH = 4
Шрифт має символи фіксованої ширини (також відомі як моноширинні).
enum StructuredTextParser: 🔗
StructuredTextParser STRUCTURED_TEXT_DEFAULT = 0
Використовуйте алгоритм Unicode.
StructuredTextParser STRUCTURED_TEXT_URI = 1
БіД перенаречений на URI.
StructuredTextParser STRUCTURED_TEXT_FILE = 2
BiDi override для шляху до файлів.
StructuredTextParser STRUCTURED_TEXT_EMAIL = 3
БіД перенаречений на електронну пошту.
StructuredTextParser STRUCTURED_TEXT_LIST = 4
БіД перенаречений на списки. Конструктивні параметри тексту: роздільник списку String.
StructuredTextParser STRUCTURED_TEXT_GDSCRIPT = 5
БіД перенаречений на GDScript.
StructuredTextParser STRUCTURED_TEXT_CUSTOM = 6
Визначений користувачем текст БіDi функції перевизначення.
enum FixedSizeScaleMode: 🔗
FixedSizeScaleMode FIXED_SIZE_SCALE_DISABLE = 0
Не масштабовано шрифт Bitmap.
FixedSizeScaleMode FIXED_SIZE_SCALE_INTEGER_ONLY = 1
Bitmap шрифт масштабований до найближчого цілого декількох фіксованого розміру шрифту. Рекомендований варіант для шрифтів піксельного мистецтва.
FixedSizeScaleMode FIXED_SIZE_SCALE_ENABLED = 2
Bitmap шрифт масштабований довільним (фракційним) розміром. Рекомендований варіант для непіксельних шрифтів мистецтва.
Описи методів
Створює новий, порожній вхідний ресурс кешу. Щоб звільнити отриманий ресурс, скористайтеся методом free_rid().
RID create_font_linked_variation(font_rid: RID) 🔗
Створює нову варіацію існуючого шрифту, який перетворює той самий кеш-пам'яті і дані шрифту. Щоб звільнити отриманий ресурс, скористайтеся методом free_rid().
RID create_shaped_text(direction: Direction = 0, orientation: Orientation = 0) 🔗
Створює новий буфер для складного текстового макета із заданими параметрами direction та orientation. Щоб звільнити результуючий буфер, використовуйте метод free_rid().
Примітка: Напрямок ігнорується, якщо сервер не підтримує функцію FEATURE_BIDI_LAYOUT (підтримується TextServerAdvanced).
Примітка: Орієнтація ігнорується, якщо сервер не підтримує функцію FEATURE_VERTICAL_LAYOUT (підтримується TextServerAdvanced).
void draw_hex_code_box(canvas: RID, size: int, pos: Vector2, index: int, color: Color) const 🔗
Накладні ящики відображають характер шістнадцяткового коду. Використовується для заміни відсутніх символів.
void font_clear_glyphs(font_rid: RID, size: Vector2i) 🔗
Видаліть всю інформацію про гліф з вхідного кешу.
Примітка: Ця функція не видаляє текстури, пов'язані з гліфами, використовувати font_remove_texture() для видалення їх вручну.
void font_clear_kerning_map(font_rid: RID, size: int) 🔗
Видаліть всі накладки керма.
void font_clear_size_cache(font_rid: RID) 🔗
Видаліть всі розміри шрифтів з вхідного кешу.
void font_clear_system_fallback_cache() 🔗
Звільняє всі автоматично завантажені системні шрифти.
void font_clear_textures(font_rid: RID, size: Vector2i) 🔗
Видаліть всі текстури з запису кешу шрифту.
Примітка: Ця функція не видаляє гліфи, пов'язані з текстурою, використовувати font_remove_glyph() для видалення їх вручну.
void font_draw_glyph(font_rid: RID, canvas: RID, size: int, pos: Vector2, index: int, color: Color = Color(1, 1, 1, 1), oversampling: float = 0.0) const 🔗
Малює один гліф на елементі полотна в позиції, використовуючи font_rid розміром size. Якщо oversampling більше за нуль, він використовується як коефіцієнт передискретизації шрифту, інакше використовуються налаштування передискретизації області перегляду.
Примітка: Індекс гліфа є специфічним для шрифту, використовуйте індекси гліфів, повернуті shaped_text_get_glyphs() або font_get_glyph_index().
Примітка: Якщо є гліфи, які очікують рендерингу, виклик цієї функції може ініціювати оновлення кешу текстур.
void font_draw_glyph_outline(font_rid: RID, canvas: RID, size: int, outline_size: int, pos: Vector2, index: int, color: Color = Color(1, 1, 1, 1), oversampling: float = 0.0) const 🔗
Малює контур одного гліфа розміром outline_size в елементі полотна в позиції, використовуючи font_rid розміром size. Якщо oversampling більше за нуль, він використовується як коефіцієнт передискретизації шрифту, інакше використовуються налаштування передискретизації області перегляду.
Примітка: Індекс гліфа є специфічним для шрифту, використовуйте індекси гліфів, повернуті shaped_text_get_glyphs() або font_get_glyph_index().
Примітка: Якщо є гліфи, які очікують рендерингу, виклик цієї функції може ініціювати оновлення кешу текстур.
FontAntialiasing font_get_antialiasing(font_rid: RID) const 🔗
Повертає режим антиалюзії шрифту.
float font_get_ascent(font_rid: RID, size: int) const 🔗
Повертає розмір шрифту (номер пікселів вище базової лінії).
float font_get_baseline_offset(font_rid: RID) const 🔗
Повертає додатковий базовий зсув (як дроб висоти шрифту).
int font_get_char_from_glyph_index(font_rid: RID, size: int, glyph_index: int) const 🔗
Повертає код символу, пов'язаний з glyph_index, або 0, якщо glyph_index недійсний. Див. font_get_glyph_index().
float font_get_descent(font_rid: RID, size: int) const 🔗
Повертає піксельний спуск (номер пікселів нижче базової лінії).
bool font_get_disable_embedded_bitmaps(font_rid: RID) const 🔗
Повертає, чи вимкнено вбудовану бітмаму шрифту.
float font_get_embolden(font_rid: RID) const 🔗
Повертає міцність емболдену шрифту.
int font_get_face_count(font_rid: RID) const 🔗
Повертає кількість обличчя в колекції TrueType / OpenType.
int font_get_face_index(font_rid: RID) const 🔗
Повертає індекс активного обличчя в колекції TrueType / OpenType.
int font_get_fixed_size(font_rid: RID) const 🔗
Повернення растрових шрифтів фіксованого розміру.
FixedSizeScaleMode font_get_fixed_size_scale_mode(font_rid: RID) const 🔗
Повертає режим масштабування шрифтів бітмапа.
bool font_get_generate_mipmaps(font_rid: RID) const 🔗
Повертаємо true, якщо ввімкнено фактуру mipmap.
float font_get_global_oversampling() const 🔗
Застаріло: Use Viewport oversampling, or the oversampling argument of the draw_* methods instead.
Застаріло. Цей метод завжди повертає 1.0.
Vector2 font_get_glyph_advance(font_rid: RID, size: int, glyph: int) const 🔗
Повернення glyph заздалегідь (зміщення наступного glyph).
Примітка: Перевага для контурів glyph є таким же, як основа glyph заздалегідь і не збережена.
Dictionary font_get_glyph_contours(font: RID, size: int, index: int) const 🔗
Повертає контурні контури гліфа як Словник із таким вмістом:
точки - PackedVector3Array, що містить контурні точки. x і y – координати точки. z – це тип точки з використанням значень ContourPointTag.
контури - PackedInt32Array, що містить індекси кінцевих точок кожного контуру.
orientation - bool, контурна орієнтація. Якщо true, необхідно заповнити контури за годинниковою стрілкою.
Дві послідовні CONTOUR_CURVE_TAG_ON точки позначають сегмент лінії.
Одна CONTOUR_CURVE_TAG_OFF_CONIC точка між двома CONTOUR_CURVE_TAG_ON точками вказує на одну конічну (квадратичну) дугу Безьє.
Дві CONTOUR_CURVE_TAG_OFF_CUBIC точки між двома CONTOUR_CURVE_TAG_ON точками вказують на одну кубічну дугу Безьє.
Дві послідовні CONTOUR_CURVE_TAG_OFF_CONIC точки позначають дві послідовні конічні (квадратичні) дуги Безьє з віртуальною CONTOUR_CURVE_TAG_ON точкою в їх середині.
Кожен контур замкнутий. Остання точка контуру використовує першу точку контуру як наступну точку, і навпаки. Першою точкою може бути CONTOUR_CURVE_TAG_OFF_CONIC точка.
int font_get_glyph_index(font_rid: RID, size: int, char: int, variation_selector: int) const 🔗
Повертає індекс гліфів char, додатково модифікований version_selector. font_get_char_from_glyph_index().
PackedInt32Array font_get_glyph_list(font_rid: RID, size: Vector2i) const 🔗
Повертає список рендерованих гліфів в записі кешу.
Vector2 font_get_glyph_offset(font_rid: RID, size: Vector2i, glyph: int) const 🔗
Повернення гліфів з базової лінії.
Vector2 font_get_glyph_size(font_rid: RID, size: Vector2i, glyph: int) const 🔗
Повертає розмір гліфи.
int font_get_glyph_texture_idx(font_rid: RID, size: Vector2i, glyph: int) const 🔗
Повертає індекс кеш-фактури, що містить гліф.
RID font_get_glyph_texture_rid(font_rid: RID, size: Vector2i, glyph: int) const 🔗
Повернення ресурсу ID кеш-фактури, що містить гліф.
Примітка: Якщо ви замовляєте glyphs для рендерингу, за допомогою цієї функції можна запустити оновлення кешу текстури.
Vector2 font_get_glyph_texture_size(font_rid: RID, size: Vector2i, glyph: int) const 🔗
Повертає розмір кеш-фактури, що містить гліф.
Примітка: Якщо ви замовляєте glyphs для рендерингу, за допомогою цієї функції можна запустити оновлення кешу текстури.
Rect2 font_get_glyph_uv_rect(font_rid: RID, size: Vector2i, glyph: int) const 🔗
Повертає прямокутник в текстурі кешу, що містить гліф.
Hinting font_get_hinting(font_rid: RID) const 🔗
Повертає режим підказки шрифту. Використовується тільки динамічними шрифтами.
bool font_get_keep_rounding_remainders(font_rid: RID) const 🔗
Повертає поведінку округлення позиції гліфа. Якщо встановлено значення true, під час вирівнювання гліфів до меж пікселів залишки округлення накопичуються для забезпечення більш рівномірного розподілу гліфів. Цей параметр не діє, якщо ввімкнено субпіксельне позиціонування.
Vector2 font_get_kerning(font_rid: RID, size: int, glyph_pair: Vector2i) const 🔗
Повертає кермо для пари гліфів.
Array[Vector2i] font_get_kerning_list(font_rid: RID, size: int) const 🔗
Повертає список кермових накладів.
bool font_get_language_support_override(font_rid: RID, language: String) 🔗
Повертає true, якщо для language увімкнено заміну підтримки.
PackedStringArray font_get_language_support_overrides(font_rid: RID) 🔗
Повернути список мовної підтримки.
int font_get_msdf_pixel_range(font_rid: RID) const 🔗
Повертає ширину діапазону навколо форми між мінімальною і максимальною відкритою дистанцією.
int font_get_msdf_size(font_rid: RID) const 🔗
Повертає розмір шрифту джерела, що використовується для створення текстур MSDF.
String font_get_name(font_rid: RID) const 🔗
Повернення імені шрифту.
Dictionary font_get_opentype_feature_overrides(font_rid: RID) const 🔗
Відкриває шрифт OpenType.
Dictionary font_get_ot_name_strings(font_rid: RID) const 🔗
Повернення Dictionary з рядками імен верхнього шрифту OpenType (розмірні імена шрифтів, версія, опис, інформація про ліцензію, текст зразка тощо).
float font_get_oversampling(font_rid: RID) const 🔗
Повертає перевизначення коефіцієнта передискретизації. Якщо встановлено додатне значення, замінює коефіцієнт передискретизації області перегляду, в якій використовується цей шрифт. Див. Viewport.oversampling. Це значення не замінює параметр oversampling методів draw_*. Використовується лише динамічними шрифтами.
float font_get_scale(font_rid: RID, size: int) const 🔗
Повертає фактор масштабування кольорового бітмапа шрифту.
bool font_get_script_support_override(font_rid: RID, script: String) 🔗
Повертає true, якщо для сценарію script увімкнено перевизначення підтримки.
PackedStringArray font_get_script_support_overrides(font_rid: RID) 🔗
Повертає список сценаріїв, що підтримує перевизначення.
Array[Dictionary] font_get_size_cache_info(font_rid: RID) const 🔗
Повертає інформацію про кеш шрифтів, кожен запис містить такі поля: Vector2i size_px - розмір шрифту в пікселях, float viewport_oversampling - коефіцієнт передискретизації viewport, int glyphs - кількість відрендерених гліфів, int textures - кількість використаних текстур, int textures_size - розмір даних текстури в байтах.
Array[Vector2i] font_get_size_cache_list(font_rid: RID) const 🔗
Повертає список розмірів шрифтів у кеші. Кожен розмір Vector2i з розмірами шрифту та розміром контурів.
int font_get_spacing(font_rid: RID, spacing: SpacingType) const 🔗
Повертає інтервал для spacing у пікселях (не відносно розміру шрифту).
int font_get_stretch(font_rid: RID) const 🔗
Повертає розмір шрифту, у порівнянні з нормальною шириною. Відсоткова вартість між 50% і 200%.
BitField[FontStyle] font_get_style(font_rid: RID) const 🔗
Повертає прапорці стилю шрифту.
String font_get_style_name(font_rid: RID) const 🔗
Повертає назву стилю шрифту.
SubpixelPositioning font_get_subpixel_positioning(font_rid: RID) const 🔗
Повертає режим позиціонування шрифту Glyph.
String font_get_supported_chars(font_rid: RID) const 🔗
Повертає рядок, що містить всі символи, доступні в шрифті.
PackedInt32Array font_get_supported_glyphs(font_rid: RID) const 🔗
Повертає масив, що містить усі індекси гліфів у шрифті.
int font_get_texture_count(font_rid: RID, size: Vector2i) const 🔗
Повертає кількість текстур, що використовуються записом кешу шрифту.
Image font_get_texture_image(font_rid: RID, size: Vector2i, texture_index: int) const 🔗
Повертає дані текстури шрифту кешу.
PackedInt32Array font_get_texture_offsets(font_rid: RID, size: Vector2i, texture_index: int) const 🔗
Повертає масив, що містить дані про упаковку glyph.
Transform2D font_get_transform(font_rid: RID) const 🔗
Повертає 2D трансформацію, що наноситься на параметри шрифту.
float font_get_underline_position(font_rid: RID, size: int) const 🔗
Повертає піксельний зсув нижньої лінії нижче базової лінії.
float font_get_underline_thickness(font_rid: RID, size: int) const 🔗
Повертає товщину нижньої лінії в пікселях.
Dictionary font_get_variation_coordinates(font_rid: RID) const 🔗
Повертає варіаційні координати за вказаний запис кешу шрифту. Детальніше font_supported_variation_list().
int font_get_weight(font_rid: RID) const 🔗
Повертає вагу (похильність) шрифту. Значення в діапазоні 100...999, нормальна вага шрифту 400, смілива вага шрифту 700.
bool font_has_char(font_rid: RID, char: int) const 🔗
Повертає true, якщо Unicode char доступний у шрифті.
bool font_is_allow_system_fallback(font_rid: RID) const 🔗
Повертаємо true, якщо шрифти системи можуть бути автоматично використані як резервні копії.
bool font_is_force_autohinter(font_rid: RID) const 🔗
Повертаємо true, якщо автозбереження підтримується і віддаємо перевагу над шрифтом вбудованим натяком. Використовується тільки динамічними шрифтами.
bool font_is_language_supported(font_rid: RID, language: String) const 🔗
true, якщо шрифт підтримує дану мову (ISO 639 код.
bool font_is_modulate_color_glyphs(font_rid: RID) const 🔗
Повертає true, якщо під час малювання кольорових гліфів застосовується колірна модуляція.
bool font_is_multichannel_signed_distance_field(font_rid: RID) const 🔗
Повертаємо true, якщо гліфи всіх розмірів подаються за допомогою одного багатоканального підписаного джерела відстані, створеного з динамічних даних вектора шрифту.
bool font_is_script_supported(font_rid: RID, script: String) const 🔗
Повертає true, якщо шрифт підтримує даний скрипт (ISO 15924 код).
void font_remove_glyph(font_rid: RID, size: Vector2i, glyph: int) 🔗
Видаліть зазначену інформацію про гліф з запису кешу.
Примітка: Ця функція не видаляє текстури, пов'язані з гліфами, використовувати font_remove_texture() для видалення їх вручну.
void font_remove_kerning(font_rid: RID, size: int, glyph_pair: Vector2i) 🔗
Знімає кермовий наклад для пари гліфів.
void font_remove_language_support_override(font_rid: RID, language: String) 🔗
Видалення мовної підтримки наречених.
void font_remove_script_support_override(font_rid: RID, script: String) 🔗
Вилучає підтримку сценаріїв наднаряддя.
void font_remove_size_cache(font_rid: RID, size: Vector2i) 🔗
Вилучає вказаний розмір шрифту з запису кешу.
void font_remove_texture(font_rid: RID, size: Vector2i, texture_index: int) 🔗
Видаліть зазначену текстуру з вхідного кешу.
Примітка: Ця функція не видаляє гліфи, пов'язані з текстурою, видаліть їх вручну, використовуючи font_remove_glyph().
void font_render_glyph(font_rid: RID, size: Vector2i, index: int) 🔗
Рендери вказані гліф до текстури кешу шрифту.
void font_render_range(font_rid: RID, size: Vector2i, start: int, end: int) 🔗
Рендери діапазону символів до текстури кешу шрифту.
void font_set_allow_system_fallback(font_rid: RID, allow_system_fallback: bool) 🔗
Якщо встановити на true, можна автоматично використовувати шрифти системи.
void font_set_antialiasing(font_rid: RID, antialiasing: FontAntialiasing) 🔗
Налаштовує режим дії шрифту.
void font_set_ascent(font_rid: RID, size: int, ascent: float) 🔗
Встановлює сходження шрифту (номер пікселів над базовою лінією).
void font_set_baseline_offset(font_rid: RID, baseline_offset: float) 🔗
Набори додаткового базового офсету (як дроб висоти шрифту).
void font_set_data(font_rid: RID, data: PackedByteArray) 🔗
Налаштовує дані джерела шрифтів, наприклад, вміст динамічного файлу джерела шрифтів.
void font_set_descent(font_rid: RID, size: int, descent: float) 🔗
Налаштовує піксельний спуск (номер пікселів нижче базової лінії).
void font_set_disable_embedded_bitmaps(font_rid: RID, disable_embedded_bitmaps: bool) 🔗
Якщо встановити на true, вбудоване завантаження бітма в шрифті вимкнено (розрядні та кольорові шрифти ігнорують цю властивість).
void font_set_embolden(font_rid: RID, strength: float) 🔗
Комплектує міцність емболдену шрифту. Якщо strength не дорівнює нулю, змішує шрифтові контури. Негативні значення зменшують товщину контуру.
void font_set_face_index(font_rid: RID, face_index: int) 🔗
Встановіть активний індекс обличчя в колекції TrueType / OpenType.
void font_set_fixed_size(font_rid: RID, fixed_size: int) 🔗
Набори растрових шрифтів фіксованого розміру. Для всіх розмірів шрифту буде використовуватися набір для значення більше нуля.
void font_set_fixed_size_scale_mode(font_rid: RID, fixed_size_scale_mode: FixedSizeScaleMode) 🔗
Встановлює режим масштабування шрифтів бітмапа. Ця властивість використовується тільки в тому випадку, якщо fixed_size перевищує нуль.
void font_set_force_autohinter(font_rid: RID, force_autohinter: bool) 🔗
Якщо встановити до true auto-hinting краще над шрифтом вбудованим натяком.
void font_set_generate_mipmaps(font_rid: RID, generate_mipmaps: bool) 🔗
У комплекті до true ввімкнено фактуру mipmap.
void font_set_global_oversampling(oversampling: float) 🔗
Застаріло: Use Viewport oversampling, or the oversampling argument of the draw_* methods instead.
Застаріло. Цей метод нічого не робить.
void font_set_glyph_advance(font_rid: RID, size: int, glyph: int, advance: Vector2) 🔗
Набори glyph заздалегідь (зміщення наступного glyph).
Примітка: Перевага для контурів glyph є таким же, як основа glyph заздалегідь і не збережена.
void font_set_glyph_offset(font_rid: RID, size: Vector2i, glyph: int, offset: Vector2) 🔗
Комплекти гліфового офсету з базової лінії.
void font_set_glyph_size(font_rid: RID, size: Vector2i, glyph: int, gl_size: Vector2) 🔗
Набори розмір гліфи.
void font_set_glyph_texture_idx(font_rid: RID, size: Vector2i, glyph: int, texture_idx: int) 🔗
Встановлює індекс кеш-фактури, що містить гліф.
void font_set_glyph_uv_rect(font_rid: RID, size: Vector2i, glyph: int, uv_rect: Rect2) 🔗
Встановлює прямокутник в текстурі кешу, що містить гліф.
void font_set_hinting(font_rid: RID, hinting: Hinting) 🔗
Встановлює режим підказки шрифту. Використовується тільки динамічними шрифтами.
void font_set_keep_rounding_remainders(font_rid: RID, keep_rounding_remainders: bool) 🔗
Встановлює поведінку округлення позиції гліфа. Якщо встановлено значення true, під час вирівнювання гліфів до меж пікселів залишки округлення накопичуються для забезпечення більш рівномірного розподілу гліфів. Цей параметр не діє, якщо ввімкнено субпіксельне позиціонування.
void font_set_kerning(font_rid: RID, size: int, glyph_pair: Vector2i, kerning: Vector2) 🔗
Набори керма для пари гліфів.
void font_set_language_support_override(font_rid: RID, language: String, supported: bool) 🔗
Додає перевантаження для font_is_language_supported().
void font_set_modulate_color_glyphs(font_rid: RID, force_autohinter: bool) 🔗
Якщо встановлено значення true, колірна модуляція застосовується під час малювання кольорових гліфів, інакше вона застосовується лише до монохромних гліфів.
void font_set_msdf_pixel_range(font_rid: RID, msdf_pixel_range: int) 🔗
Встановлює ширину діапазону навколо форми між мінімальною і максимальною відкритою дистанцією.
void font_set_msdf_size(font_rid: RID, msdf_size: int) 🔗
Встановлює розмір початкового шрифту, що використовується для створення текстур MSDF.
void font_set_multichannel_signed_distance_field(font_rid: RID, msdf: bool) 🔗
Якщо встановити до true, glyphs всіх розмірів подаються за допомогою одного багатоканального підписаного поля відстані, створеного з динамічних вхідних даних шрифту. MSDF рендеринг дозволяє відображати шрифт на будь-якому факторі масштабування без розмитості, а також без втрати вартості процесора при зміні розміру шрифтів (з тих пір, як шрифт більше не потрібно буде оцінювати на процесорі). Як знизу, підказка шрифту не доступна з MSDF. Недолік шрифту може призвести до меншої кількості хрустких і менш читаних шрифтів у невеликих розмірах.
Примітка: MSDF шрифт рендеринг не рендерує гліфи з заповненням форм правильно. Передавання форм не діє за стандартом OpenType, але все ще зустрічається в багатьох файлах шрифту, особливо тих, які перетворюються на Google Fonts. Щоб уникнути проблем з перекриттям гліфів, розгляньте завантаження файлу шрифту безпосередньо з вибраного типу замість перекриття на Google Fonts.
void font_set_name(font_rid: RID, name: String) 🔗
Встановлює назву родини шрифтів.
void font_set_opentype_feature_overrides(font_rid: RID, overrides: Dictionary) 🔗
Набори шрифтів OpenType встановлюють надряддя.
void font_set_oversampling(font_rid: RID, oversampling: float) 🔗
Якщо встановлено додатне значення, перевизначає коефіцієнт передискретизації області перегляду, в якій використовується цей шрифт. Див. Viewport.oversampling. Це значення не перевизначає параметр oversampling методів draw_*. Використовується лише динамічними шрифтами.
void font_set_scale(font_rid: RID, size: int, scale: float) 🔗
Встановлює фактор масштабування шрифту кольорової бітмапи.
void font_set_script_support_override(font_rid: RID, script: String, supported: bool) 🔗
Додає перевантаження для font_is_script_supported().
void font_set_spacing(font_rid: RID, spacing: SpacingType, value: int) 🔗
Встановлює інтервал для spacing на value у пікселях (не відносно розміру шрифту).
void font_set_stretch(font_rid: RID, weight: int) 🔗
Встановлює ступінь розтягування шрифту порівняно зі звичайною шириною. Відсоткове значення між 50% та 200%.
Примітка: Це значення використовується лише для зіставлення шрифтів і не впливатиме на рендеринг шрифтів. Використовуйте замість цього font_set_face_index(), font_set_variation_coordinates() або font_set_transform().
void font_set_style(font_rid: RID, style: BitField[FontStyle]) 🔗
Встановлює прапорці стилю шрифту.
Примітка: Це значення використовується лише для зіставлення шрифтів і не впливатиме на відображення шрифтів. Використовуйте замість цього font_set_face_index(), font_set_variation_coordinates(), font_set_embolden() або font_set_transform().
void font_set_style_name(font_rid: RID, name: String) 🔗
Встановлює назву стилю шрифту.
void font_set_subpixel_positioning(font_rid: RID, subpixel_positioning: SubpixelPositioning) 🔗
Налаштовує режим позиціонування шрифту.
void font_set_texture_image(font_rid: RID, size: Vector2i, texture_index: int, image: Image) 🔗
Налаштовує дані текстури шрифту кешу.
void font_set_texture_offsets(font_rid: RID, size: Vector2i, texture_index: int, offset: PackedInt32Array) 🔗
Встановлює масив, що містить дані про упаковку glyph.
void font_set_transform(font_rid: RID, transform: Transform2D) 🔗
Набори 2D трансформуються, нанесені на шрифтові контури, можуть використовуватися для сланцевих, флипсових і поворотних гліфів.
Наприклад, для імітації italic typeface від slanting, застосувати наступний трансформатор Transform2D(1.0, slant, 0.0, 1.0, 0.0).
void font_set_underline_position(font_rid: RID, size: int, underline_position: float) 🔗
Налаштовує піксельний зсув нижньої лінії нижче базової лінії.
void font_set_underline_thickness(font_rid: RID, size: int, underline_thickness: float) 🔗
Встановлює товщину нижньої лінії в пікселях.
void font_set_variation_coordinates(font_rid: RID, variation_coordinates: Dictionary) 🔗
Налаштовує координати варіації для вказаного запису кешу шрифту. Детальніше font_supported_variation_list().
void font_set_weight(font_rid: RID, weight: int) 🔗
Встановлює товщину (жирність) шрифту. Значення в діапазоні 100...999, звичайна товщина шрифту — 400, товщина жирного шрифту — 700.
Примітка: Це значення використовується лише для зіставлення шрифтів і не впливатиме на рендеринг шрифту. Використовуйте замість цього font_set_face_index(), font_set_variation_coordinates() або font_set_embolden().
Dictionary font_supported_feature_list(font_rid: RID) const 🔗
Повертає словник підтримуваних функцій OpenType.
Dictionary font_supported_variation_list(font_rid: RID) const 🔗
Повертає словник підтримуваних кодів варіації OpenType.
String format_number(number: String, language: String = "") const 🔗
Перетворює число із західної арабської (0..9) системи числення, що використовується в language.
Якщо language пропущено, буде використано активну локаль.
Безкоштовний об'єкт, створений цим TextServer.
Повертає функції текстового сервера, див. Feature.
Vector2 get_hex_code_box_size(size: int, index: int) const 🔗
Повертає розмір замінного символу (коробка з символом шістнадцяткового коду, що намальовується в місці недійсних символів).
Повертає назву інтерфейсу сервера.
PackedByteArray get_support_data() const 🔗
Повертає базу даних TextServer за замовчуванням (наприклад, ітератори розриву ICU та словники).
String get_support_data_filename() const 🔗
Повертає базу даних за замовчуванням TextServer (наприклад, ітератори та словники ICU).
String get_support_data_info() const 🔗
Повертає базу даних текстовихсерверів (наприклад, ітератори та словники ICU).
Повертає true, якщо rid є дійсним ресурсом, що належить цьому текстовому серверу.
bool has_feature(feature: Feature) const 🔗
Повертає true, якщо сервер підтримує функцію.
int is_confusable(string: String, dict: PackedStringArray) const 🔗
Повертає індекс першого рядка в дикт який візуально плутається з string, або -1, якщо ніхто не знайдений.
Примітка: Цей метод не виявляє невидимих персонажів, для виявлення спофів його використання в поєднанні з spoof_check().
Примітка: Завжди повертає -1, якщо сервер не підтримує функцію FEATURE_UNICODE_SECURITY.
bool is_locale_right_to_left(locale: String) const 🔗
Повертаємо true, якщо локальне право вліво.
bool is_valid_identifier(string: String) const 🔗
Повертає true, якщо string є дійсним ідентифікатором.
Якщо текстовий сервер підтримує функцію FEATURE_UNICODE_IDENTIFIERS, необхідний ідентифікатор:
Форма нормалізації С.
Починайте з символом Unicode XID_Start або
..Може містити символи Unicode класу XID_Continue в інших позиціях.
Використовуйте UAX #31 рекомендовані скрипти тільки (Дозволені скрипти).
Якщо функція FEATURE_UNICODE_IDENTIFIERS не підтримується, необхідний ідентифікатор:
Починайте з символом Unicode XID_Start або
..Може містити символи Unicode класу XID_Continue в інших позиціях.
bool is_valid_letter(unicode: int) const 🔗
Повернення true, якщо вказаний пункт коду є дійсним листом, тобто він належить до категорії Unicode "L".
bool load_support_data(filename: String) 🔗
Навантаження необов'язкової бази даних ТексServer (наприклад, ітератори та словники ICU).
Примітка: Ця функція повинна бути викликана до будь-яких інших функцій TextServer, інакше вона не матиме ніякого ефекту.
int name_to_tag(name: String) const 🔗
Перетворює читабельну функцію, варіацію, скрипт або назву мови на тег OpenType.
String parse_number(number: String, language: String = "") const 🔗
Перетворює number із систем числення, що використовуються в language, на західну арабську (0..9).
Array[Vector3i] parse_structured_text(parser_type: StructuredTextParser, args: Array, text: String) const 🔗
Реалізація функції перевизначення алгоритму BiDi за замовчуванням.
String percent_sign(language: String = "") const 🔗
Повертає знак відсотка, який використовується в language.
bool save_support_data(filename: String) const 🔗
Заощаджує додаткову базу даних текстовихсерверів (наприклад, ітератори та словники ICU) до файлу.
Примітка: Ця функція використовується під час експорту проекту, щоб включити базу даних TextServer.
int shaped_get_run_count(shaped: RID) const 🔗
Повертає кількість повторень однорідного тексту в буфері.
Direction shaped_get_run_direction(shaped: RID, index: int) const 🔗
Повертає напрямок виконання тексту index (у візуальному порядку).
RID shaped_get_run_font_rid(shaped: RID, index: int) const 🔗
Повертає RID шрифту для рядка тексту index (у візуальному порядку).
int shaped_get_run_font_size(shaped: RID, index: int) const 🔗
Повертає розмір шрифту рядка тексту index (у візуальному порядку).
String shaped_get_run_language(shaped: RID, index: int) const 🔗
Повертає мову текстового рядка index (у візуальному порядку).
Variant shaped_get_run_object(shaped: RID, index: int) const 🔗
Повертає вбудований об'єкт текстового рядка index (у візуальному порядку).
Vector2i shaped_get_run_range(shaped: RID, index: int) const 🔗
Повертає діапазон вихідного тексту для рядка тексту index (у візуальному порядку).
String shaped_get_run_text(shaped: RID, index: int) const 🔗
Повертає вихідний текст рядка тексту index (у візуальному порядку).
int shaped_get_span_count(shaped: RID) const 🔗
Повертає кількість текстових проміжків, доданих за допомогою методу shaped_text_add_string або shaped_text_add_object().
Variant shaped_get_span_embedded_object(shaped: RID, index: int) const 🔗
Повертає текстовий ключ вбудованого об’єкта.
Variant shaped_get_span_meta(shaped: RID, index: int) const 🔗
Повертає метадані тексту.
Variant shaped_get_span_object(shaped: RID, index: int) const 🔗
Повертає ключ вбудованого об'єкта text span.
String shaped_get_span_text(shaped: RID, index: int) const 🔗
Повертає вихідний текст діапазону тексту.
String shaped_get_text(shaped: RID) const 🔗
Повертає вихідний текст текстового буфера, включаючи символи заміни об'єкта.
void shaped_set_span_update_font(shaped: RID, index: int, fonts: Array[RID], size: int, opentype_features: Dictionary = {}) 🔗
Змінити шрифт, розмір шрифту та функції OpenType, не змінюючи текст.
bool shaped_text_add_object(shaped: RID, key: Variant, size: Vector2, inline_align: InlineAlignment = 5, length: int = 1, baseline: float = 0.0) 🔗
Додає вбудований об'єкт до текстового буфера, key повинен бути унікальним. У тексті об'єкт представлений як символ заміни об'єкта length.
bool shaped_text_add_string(shaped: RID, text: String, fonts: Array[RID], size: int, opentype_features: Dictionary = {}, language: String = "", meta: Variant = null) 🔗
Додає текстовий проміжок і шрифт, щоб намалювати його на текстовий буфер.
void shaped_text_clear(rid: RID) 🔗
Очищає текстовий буфер (відправляє текст та інлайн об’єкти).
int shaped_text_closest_character_pos(shaped: RID, pos: int) const 🔗
Повертає положення композитного символу в найближчому порядку pos.
void shaped_text_draw(shaped: RID, canvas: RID, pos: Vector2, clip_l: float = -1, clip_r: float = -1, color: Color = Color(1, 1, 1, 1), oversampling: float = 0.0) const 🔗
Намалюйте фігурний текст на елементі полотна в заданій позиції за допомогою параметра color. pos визначає крайню ліву точку базової лінії (для горизонтального розташування) або крайню верхню точку базової лінії (для вертикального розташування). Якщо oversampling більше за нуль, він використовується як коефіцієнт передискретизації шрифту, інакше використовуються налаштування передискретизації області перегляду.
clip_l та clip_r – це зміщення відносно pos, що йдуть праворуч у горизонтальному розміщенні та вниз у вертикальному розміщенні. Якщо clip_l не є від’ємним, гліфи, що починаються перед зміщенням, обрізаються. Якщо clip_r не є від’ємним, гліфи, що закінчуються після зміщення, обрізаються.
void shaped_text_draw_outline(shaped: RID, canvas: RID, pos: Vector2, clip_l: float = -1, clip_r: float = -1, outline_size: int = 1, color: Color = Color(1, 1, 1, 1), oversampling: float = 0.0) const 🔗
Намалюйте контур фігурного тексту на елементі полотна в заданій позиції за допомогою параметра color. Параметр pos визначає крайню ліву точку базової лінії (для горизонтального розташування) або крайню верхню точку базової лінії (для вертикального розташування). Якщо параметр oversampling більше за нуль, він використовується як коефіцієнт передискретизації шрифту, інакше використовуються налаштування передискретизації області перегляду.
clip_l та clip_r – це зміщення відносно pos, що йдуть праворуч у горизонтальному розміщенні та вниз у вертикальному розміщенні. Якщо параметр clip_l не є від’ємним, гліфи, що починаються перед зміщенням, обрізаються. Якщо параметр clip_r не є від’ємним, гліфи, що закінчуються після зміщення, обрізаються.
float shaped_text_fit_to_width(shaped: RID, width: float, justification_flags: BitField[JustificationFlag] = 3) 🔗
Налаштовує ширину тексту, щоб відповідати задану ширину, повертає нову ширину тексту.
float shaped_text_get_ascent(shaped: RID) const 🔗
Повернення текстового сходження (номер пікселів над базовою основою для горизонтального планування або зліва від базової лінії для вертикальної).
Примітка: В цілому сходження може бути вище, ніж сходження шрифту, якщо деякі гліфи переміщуються з базової лінії.
Dictionary shaped_text_get_carets(shaped: RID, position: int) const 🔗
Повертає форми каретки, що відповідають символу зсуву position в тексті. Повернута форма догляду - 1 піксельний широкий прямокутник.
PackedInt32Array shaped_text_get_character_breaks(shaped: RID) const 🔗
Повертає масив ліній композитного характеру.
int shaped_text_get_custom_ellipsis(shaped: RID) const 🔗
Повертає характер ellipsis, який використовується для текстового затиску.
String shaped_text_get_custom_punctuation(shaped: RID) const 🔗
Повертає користувацький список символів пунктуації, що використовується для розбиття слів. Якщо встановити порожній рядок, використовувані за замовчуванням сервера.
float shaped_text_get_descent(shaped: RID) const 🔗
Повертає текстовий спуск (номер пікселів нижче базової лінії для горизонтального планування або праворуч від базової лінії для вертикальної).
Примітка: В цілому спуск може бути вище, ніж спуск шрифту, якщо деякі гліфи переміщуються з базової лінії.
Direction shaped_text_get_direction(shaped: RID) const 🔗
Повертає напрямок тексту.
Direction shaped_text_get_dominant_direction_in_range(shaped: RID, start: int, end: int) const 🔗
Повертає домінантний напрямок в діапазоні тексту.
int shaped_text_get_ellipsis_glyph_count(shaped: RID) const 🔗
Повертає кількість гліфів у еліпсі.
Array[Dictionary] shaped_text_get_ellipsis_glyphs(shaped: RID) const 🔗
Повертає масив гліфів в ellipsis.
int shaped_text_get_ellipsis_pos(shaped: RID) const 🔗
Повертає позицію ellipsis.
int shaped_text_get_glyph_count(shaped: RID) const 🔗
Повертає кількість гліфів в буфері.
Array[Dictionary] shaped_text_get_glyphs(shaped: RID) const 🔗
Повертає масив гліфів у візуальному порядку.
Vector2 shaped_text_get_grapheme_bounds(shaped: RID, pos: int) const 🔗
Повертає композитні риси характеру як офсети від початку лінії.
Direction shaped_text_get_inferred_direction(shaped: RID) const 🔗
Повертає напрямок тексту, вказаний алгоритмом BiDi.
PackedInt32Array shaped_text_get_line_breaks(shaped: RID, width: float, start: int = 0, break_flags: BitField[LineBreakFlag] = 3) const 🔗
Перериває текст на лінії і повертає діапазони символів для кожної лінії.
PackedInt32Array shaped_text_get_line_breaks_adv(shaped: RID, width: PackedFloat32Array, start: int = 0, once: bool = true, break_flags: BitField[LineBreakFlag] = 3) const 🔗
Перервує текст на лінії і стовпчики. Повертає характерні діапазони для кожного сегмента.
int shaped_text_get_object_glyph(shaped: RID, key: Variant) const 🔗
Повертає індекс гліфів внутр.
Vector2i shaped_text_get_object_range(shaped: RID, key: Variant) const 🔗
Повертає характерний діапазон об'єкта inline.
Rect2 shaped_text_get_object_rect(shaped: RID, key: Variant) const 🔗
Повертає межу прямокутника об'єкта inline.
Array shaped_text_get_objects(shaped: RID) const 🔗
Повертає масив вбудованих об'єктів.
Orientation shaped_text_get_orientation(shaped: RID) const 🔗
Повертає текстову спрямованість.
RID shaped_text_get_parent(shaped: RID) const 🔗
Повертає батьківський буфер, з якого береться підрядка.
bool shaped_text_get_preserve_control(shaped: RID) const 🔗
Повертає true, якщо текстовий буфер налаштований для відображення символів керування.
bool shaped_text_get_preserve_invalid(shaped: RID) const 🔗
Повертає true, якщо текстовий буфер налаштований для відображення шестигранних кодів на місці недійсних символів.
Примітка: Якщо встановити до false, нічого не відображається на місці недійсних символів.
Vector2i shaped_text_get_range(shaped: RID) const 🔗
Повертає підрядний буферний діапазон символів у буфері батьків.
PackedVector2Array shaped_text_get_selection(shaped: RID, start: int, end: int) const 🔗
Повертає вибір прямокутників для вказаного діапазону символів.
Vector2 shaped_text_get_size(shaped: RID) const 🔗
Повертає розмір тексту.
int shaped_text_get_spacing(shaped: RID, spacing: SpacingType) const 🔗
Повертає додаткову запору, додану між гліфами або лініями в пікселях.
int shaped_text_get_trim_pos(shaped: RID) const 🔗
Повертає позицію перерізу.
float shaped_text_get_underline_position(shaped: RID) const 🔗
Повертає піксельний зсув нижньої лінії нижче базової лінії.
float shaped_text_get_underline_thickness(shaped: RID) const 🔗
Повертає товщину нижньої лінії.
float shaped_text_get_width(shaped: RID) const 🔗
Повертає ширину (для горизонтального планування) або висоти (для вертикального) тексту.
PackedInt32Array shaped_text_get_word_breaks(shaped: RID, grapheme_flags: BitField[GraphemeFlag] = 264, skip_grapheme_flags: BitField[GraphemeFlag] = 4) const 🔗
Розбиває текст на слова та повертає масив діапазонів символів. Використовуйте grapheme_flags, щоб встановити, які символи використовуються для розбиття.
bool shaped_text_has_visible_chars(shaped: RID) const 🔗
Повертає true, якщо текстовий буфер містить будь-які видимі символи.
int shaped_text_hit_test_grapheme(shaped: RID, coords: float) const 🔗
Повертає індекс графему на вказаному піксельному офсеті на базовій лінії, або -1, якщо ніхто не знайдений.
int shaped_text_hit_test_position(shaped: RID, coords: float) const 🔗
Повертає увагу, що вихід символів у зазначеному офсеті пікселя на базовій лінії. Ця функція завжди повертає дійсну позицію.
bool shaped_text_is_ready(shaped: RID) const 🔗
Повертаємо true, якщо буфер успішно сформований.
int shaped_text_next_character_pos(shaped: RID, pos: int) const 🔗
Повертає положення композитного символу, що знаходиться в безпосередній близькості до pos.
int shaped_text_next_grapheme_pos(shaped: RID, pos: int) const 🔗
Повертає позицію, що закінчується графеме до pos.
void shaped_text_overrun_trim_to_width(shaped: RID, width: float = 0, overrun_trim_flags: BitField[TextOverrunFlag] = 0) 🔗
Текст обрізки, якщо він перевищує задану ширину.
int shaped_text_prev_character_pos(shaped: RID, pos: int) const 🔗
Повертає початкову позицію складеного символу, найближчу до pos.
int shaped_text_prev_grapheme_pos(shaped: RID, pos: int) const 🔗
Повертає позицію початку графему в найближчий до pos.
bool shaped_text_resize_object(shaped: RID, key: Variant, size: Vector2, inline_align: InlineAlignment = 5, baseline: float = 0.0) 🔗
Налаштовує новий розмір і вирівнювання вбудованого об'єкта.
void shaped_text_set_bidi_override(shaped: RID, override: Array) 🔗
Надійшла BiDi для структурованого тексту.
Визначні діапазони повинні закривати текст повного джерела без перекриття. Для кожного діапазону використовуйте алгоритм BiDi.
void shaped_text_set_custom_ellipsis(shaped: RID, char: int) 🔗
Набір символів ellipsis, що використовується для текстового затиску.
void shaped_text_set_custom_punctuation(shaped: RID, punct: String) 🔗
Встановлює користувацький список символів пунктуації, який використовується для розбиття слів. Якщо встановити порожній рядок, використовувані за замовчуванням сервера.
void shaped_text_set_direction(shaped: RID, direction: Direction = 0) 🔗
Встановлює бажаний текстовий напрямок. Якщо встановити до DIRECTION_AUTO, напрямок буде виявлений на основі вмісту буфера та поточного локалізації.
Примітка: Дирекція ігнорується, якщо сервер не підтримує функцію FEATURE_BIDI_LAYOUT (за підтримки TextServerAdvanced).
void shaped_text_set_orientation(shaped: RID, orientation: Orientation = 0) 🔗
Налаштовує бажаний напрям тексту.
Примітка: Орієнтація ігнорується, якщо сервер не підтримує функцію FEATURE_VERTICAL_LAYOUT (підтримується TextServerAdvanced).
void shaped_text_set_preserve_control(shaped: RID, enabled: bool) 🔗
Якщо встановити на true текстовий буфер буде відображати символи керування.
void shaped_text_set_preserve_invalid(shaped: RID, enabled: bool) 🔗
Якщо встановити до true текстовий буфер буде відображати недійсні символи, як шістнадцяткові коди, інакше нічого не відображається.
void shaped_text_set_spacing(shaped: RID, spacing: SpacingType, value: int) 🔗
Налаштовує додатковий інтервал між гліфами або лініями в пікселях.
bool shaped_text_shape(shaped: RID) 🔗
Шапки буфер, якщо він не подібний. Повертає true, якщо рядок добре сформований.
Примітка: Не обов'язково викликати цю функцію вручну, буфер буде сформований автоматично, як тільки будь-який з його вихідних даних запитується.
Array[Dictionary] shaped_text_sort_logical(shaped: RID) 🔗
Повертає текстові гліфи в логічному порядку.
RID shaped_text_substr(shaped: RID, start: int, length: int) const 🔗
Повертає текстовий буфер для підрядки тексту в тексті shaped.
float shaped_text_tab_align(shaped: RID, tab_stops: PackedFloat32Array) 🔗
Вирівнює форму тексту на задану вкладку.
bool spoof_check(string: String) const 🔗
Повертає true, якщо string, ймовірно, є спробою заплутати читача.
Примітка: Завжди повертає false, якщо сервер не підтримує функцію FEATURE_UNICODE_SECURITY.
PackedInt32Array string_get_character_breaks(string: String, language: String = "") const 🔗
Повертає масив меж складених символів.
var ts = TextServerManager.get_primary_interface()
print(ts.string_get_character_breaks("Тест ❤️🔥 Тест")) # Виводить [1, 2, 3, 4, 5, 9, 10, 11, 12, 13, 14]
PackedInt32Array string_get_word_breaks(string: String, language: String = "", chars_per_line: int = 0) const 🔗
Повертає масив меж розриву слів. Елементи у поверненому масиві є зсувами початку та кінця слів. Тому довжина масиву завжди парна.
Якщо chars_per_line більше нуля, натомість повертаються межі розриву рядка.
var ts = TextServerManager.get_primary_interface()
# Відповідає підрядкам "The", "Godot", "Engine" і "4".
print(ts.string_get_word_breaks("The Godot Engine, 4")) # Вивести [0, 3, 4, 9, 10, 16, 18, 19]
# Відповідає підрядкам "The", "Godot", "Engin" і "e, 4".
print(ts.string_get_word_breaks("The Godot Engine, 4", "en", 5)) # Виводить [0, 3, 4, 9, 10, 15, 15, 19]
# Відповідає підрядкам «The Godot» і «Engine, 4».
print(ts.string_get_word_breaks("The Godot Engine, 4", "en", 10)) # Виводить [0, 9, 10, 19]
String string_to_lower(string: String, language: String = "") const 🔗
Повертає рядок, що перетворюється в нижній регістр.
Примітка: Кастинг є локальним залежним і контекстним чутливим, якщо серверна підтримка FEATURE_CONTEXT_SENSITIVE_CASE_CONVERSION (підтримується TextServerAdvanced).
Примітка: В результаті може бути довше або коротше, ніж оригінальний.
String string_to_title(string: String, language: String = "") const 🔗
Повертає рядок, що перетворюється на назву справи.
Примітка: Обчислення локального та контекстного чутливого, якщо серверна підтримка FEATURE_CONTEXT_SENSITIVE_CASE_CONVERSION (підтримується TextServerAdvanced).
Примітка: Результат може бути більшим або коротшим, ніж оригінальний.
String string_to_upper(string: String, language: String = "") const 🔗
Повертає рядок, що перетворюється на верхній край.
Примітка: Кастинг є локальним залежним і контекстним чутливим, якщо серверна підтримка FEATURE_CONTEXT_SENSITIVE_CASE_CONVERSION (підтримується TextServerAdvanced).
Примітка: В результаті може бути довше або коротше, ніж оригінальний.
String strip_diacritics(string: String) const 🔗
Смуги діакрітики з рядка.
Примітка: Результат може бути більшим або коротшим, ніж оригінальний.
String tag_to_name(tag: int) const 🔗
Перетворення Відкрито Тип тегу для читання функцій, варіації, скрипт або назва мови.