Read this manual in English

GUI-нода Text

Defold поддерживает особый тип GUI-ноды, позволяющий отображать текст в GUI-сцене. Любой ресурс Font, добавленный в проект, может быть использован для рендеринга ноды Text.

Добавление ноды Text

Шрифты, которые планируется использовать в GUI-нодах Text, должны быть добавлены в компонент GUI. Кликните ПКМ на папке Fonts, используйте контекстное меню GUI или нажмите соответствующее клавиатурное сокращение.

Fonts

Нода Text обладает набором специфических свойств:

Font
Любая созданная нода Text должна иметь настроенное свойство Font.
Text
Отображаемый текст.
Line Break
Выравнивание текста следует за настройкой пивота, и настройка этого свойства позволяет тексту располагаться на нескольких строках. Ширина ноды определяет, в каком месте текст будет перенесен.

Выравнивание

Настроив пивот ноды, можно изменить режим выравнивания текста.

Center
Если пивот установлен в Center, North или South, текст выравнивается по центру.
Left
Если пивот установлен в какой-либо из режимов West, текст выравнивается по левому краю.
Right
Если пивот установлен в один из режимов East, текст выравнивается по правому краю.

Text alignment

Воздействие на ноду Text в рантайме

Нода Text реагирует на любые общие функции манипуляции нодами по настройке размера, пивота, цвета и так далее. Существует несколько функций, предназначенных только для ноды Text:

  • Чтобы изменить шрифт ноды Text, используйте функцию gui.set_font().
  • Чтобы изменить поведение переноса строки ноды Text, используйте функцию gui.set_line_break().
  • Чтобы изменить содержимое ноды Text, используйте функцию gui.set_text().
function on_message(self, message_id, message, sender)
    if message_id == hash("set_score") then
        local s = gui.get_node("score")
        gui.set_text(s, message.score)
    end
end