This translation is community contributed and may not be up to date. We only maintain the English version of the documentation. Read this manual in English
Компонент Label визуализирует фрагмент текста на экране в игровом пространстве. По умолчанию он упорядочивается и отрисовывается вместе со всей графикой спрайтов и тайлов. Компонент имеет набор свойств, определяющих способ визуализации текста. В Defold GUI поддерживает текст, но размещение элементов GUI в пространстве игры может оказаться сложной задачей. Текстовые метки эту задачу облегчают.
Чтобы создать компонент Label, кликните ПКМ на игровом объекте и выберите Add Component ▸ Label.

(Если необходимо создать несколько текстовых меток из одного шаблона, лучше создать новый файл компонента Label: кликните ПКМ в папке в браузере Assets и выберите New... ▸ Label, затем добавьте этот файл в качестве компонента к любым игровым объектам.)

В свойстве Font укажите необходимый шрифт и убедитесь, что в свойстве Material установлен материал, соответствующий типу шрифта:

Для использования векторного шрифта выполните настройку векторного шрифта, назначьте ресурс .font в Font компонента Label и установите Material компонента в /builtins/fonts/label-vector.material. Управляйте отображаемым размером через Font Size.
Для цветных эмодзи также выполните настройку резервного COLRv1-шрифта и его включения в бандл. Пример ниже предполагает Label с id label и скрипт на том же игровом объекте. Оставьте Text метки пустым, чтобы приветствие появилось только после подготовки глифов:
function init(self)
local text = "Hello 😀 🍎 🚀"
local font_resource = go.get("#label", "font")
-- Добавить резервный шрифт один раз для этого общего ресурса шрифта.
font.add_font(font_resource, "/fonts/NotoColorEmoji-Regular.ttf")
font.prewarm_text(font_resource, text, function(self, request_id, result, err)
if result then
go.set("#label", "text", text)
else
print("Could not prepare label text:", err)
end
end)
end
Обычные буквы используют исходный шрифт, а эмодзи — добавленный цветной шрифт. Если этот ресурс шрифта используют другие Label или GUI-ноды Text, инициализируйте резервный шрифт в одном месте и используйте его совместно.
Помимо свойств Id, Position, Rotation и Scale существуют следующие специфичные для компонента свойства:
Следует отметить, что в материале по умолчанию рендеринг теней отключен по соображениям производительности.
Свойство Blend Mode определяет, как графика компонента должна смешиваться с графикой, расположенной позади. Ниже представлены доступные режимы наложения и способы их вычисления:
src.a * src.rgb + (1 - src.a) * dst.rgbsrc.rgb + dst.rgbsrc.rgb * dst.rgbsrc.rgb - dst.rgb * dst.rgbНастроив свойство Pivot, можно изменять режим выравнивания текста.
Center, North или South, текст выравнивается по центру.West, текст выравнивается по левому краю.East, текст выравнивается по правому краю.
Текстовыми метками можно манипулировать во время выполнения, получая и устанавливая текст метки, а также изменяя другие свойства.
textstring). Доступно через go.get() и go.set().colorvector4)outlinevector4)shadowvector4)scalenumber для равномерного масштабирования, либо vector3 для масштабирования индивидуально по каждой из осей.sizevector3)function init(self)
-- Задать текст компоненту "my_label" в том же игровом объекте,
-- что и этот скрипт.
go.set("#my_label", "text", "New text")
local text = go.get("#my_label", "text")
print(text) -- New text
end
Функции label.set_text() и label.get_text() считаются устаревшими; вместо них используется свойство text. Старые функции остаются доступными для совместимости. Прежняя функция установки текста ставит сообщение в очередь, тогда как go.set() обновляет текст немедленно.
function init(self)
-- Задать цвет компоненту "my_label" в том же игровом объекте,
-- что и этот скрипт. Цвет представляется значением RGBA, хранящимся как тип vector4.
local grey = vmath.vector4(0.5, 0.5, 0.5, 1.0)
go.set("#my_label", "color", grey)
-- ...и убрать обводку, установив ее альфу в 0...
go.set("#my_label", "outline.w", 0)
-- ...и увеличить масштаб в два раза по оси X.
local scale_x = go.get("#my_label", "scale.x")
go.set("#my_label", "scale.x", scale_x * 2)
end
В файле game.project имеются несколько проектных настроек, относящихся к текстовым меткам.