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
O Defold oferece suporte a um tipo específico de node GUI que permite renderizar texto em uma cena GUI. Qualquer recurso de fonte adicionado a um projeto pode ser usado para renderização de nodes de texto.
A prévia do editor oferece suporte à modelagem de texto e ao layout da direita para a esquerda usando o renderizador de fontes da engine. Consulte suporte a layout de texto para conhecer as configurações de fonte e App Manifest necessárias.
As fontes que você deseja usar em nodes GUI de texto devem ser adicionadas ao componente GUI. Clique com o botão direito na pasta Fonts, use o menu superior GUI ou pressione o atalho de teclado correspondente.

Nodes de texto têm um conjunto de propriedades especiais:
Siga a configuração de fontes vetoriais, adicione o recurso .font a Fonts da cena de GUI e selecione-o no nó de texto. Defina o Material do recurso de fonte como /builtins/fonts/font-vector.material. Use Font Size do nó para controlar o tamanho exibido.
Para emojis coloridos, conclua também a configuração do fallback COLRv1 e de inclusão no bundle. Crie um nó de texto com o id text, deixe seu Text vazio e adicione o seguinte ao .gui_script da cena de GUI:
function init(self)
local node = gui.get_node("text")
local text = "Hello 😀 🍎 🚀"
local font_resource = gui.get_font_resource(gui.get_font(node))
-- Adicione o fallback uma única vez para este recurso de fonte compartilhado.
font.add_font(font_resource, "/fonts/NotoColorEmoji-Regular.ttf")
font.prewarm_text(font_resource, text, function(self, request_id, result, err)
if result then
gui.set_text(node, text)
else
print("Could not prepare GUI text:", err)
end
end)
end
gui.get_font() retorna o nome da fonte na cena de GUI; gui.get_font_resource() resolve esse nome para o recurso de fonte usado por font.add_font(). Outros nós e Labels que compartilham esse recurso também recebem o fallback, portanto inicialize-o apenas uma vez. O texto é definido depois que a preparação é concluída com sucesso.
Ao definir o pivô do node, você pode alterar o modo de alinhamento do texto.
Center, North ou South, o texto será alinhado ao centro.West, o texto será alinhado à esquerda.East, o texto será alinhado à direita.
Nodes de texto respondem a qualquer função genérica de manipulação de nodes para definir tamanho, pivô, cor e assim por diante. Existem algumas funções exclusivas de nodes de texto:
gui.set_font().gui.set_line_break().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