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
Un componente Label renderiza una porción de texto en pantalla, en el espacio del juego. Por defecto se ordena y dibuja junto con todos los gráficos de sprites y tiles. El componente tiene un conjunto de propiedades que controla cómo se renderiza el texto. La GUI de Defold permite usar texto, pero puede ser complicado colocar elementos GUI en el mundo del juego. Los componentes Label facilitan esto.
Para crear un componente Label, haz click derecho en el objeto de juego y selecciona Add Component ▸ Label.

(Si quieres instanciar varios labels desde la misma plantilla, también puedes crear un nuevo archivo de componente Label: haz click derecho en una carpeta en el navegador Assets y selecciona New... ▸ Label, luego añade el archivo como componente a cualquier objeto de juego)

Define la propiedad Font con la fuente que quieres usar y asegúrate de definir la propiedad Material con un material que coincida con el tipo de fuente:

Para usar una fuente Vector, sigue la configuración de fuentes vectoriales, asigna el recurso .font a la propiedad Font del Label y establece su Material en /builtins/fonts/label-vector.material. Usa Font Size para controlar el tamaño mostrado.
Para emoji a color, completa también la configuración de la fuente alternativa COLRv1 y su inclusión en el bundle. El ejemplo siguiente supone que hay un Label con id label y un script en el mismo objeto de juego. Deja el Text del Label vacío para mostrar el saludo solo cuando sus glifos estén listos:
function init(self)
local text = "Hello 😀 🍎 🚀"
local font_resource = go.get("#label", "font")
-- Agrega la fuente alternativa una sola vez para este recurso de fuente compartido.
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
Las letras normales usan la fuente original y los emoji usan la fuente a color agregada. Si otros Label o nodos de texto GUI comparten este recurso de fuente, inicializa la alternativa en un solo lugar y reutilízala.
Además de las propiedades Id, Position, Rotation y Scale, existen las siguientes propiedades específicas del componente:
Ten en cuenta que el material predeterminado tiene desactivado el renderizado de sombras por razones de rendimiento.
La propiedad Blend Mode define cómo deben mezclarse los gráficos del componente con los gráficos que hay detrás. Estos son los modos de mezcla disponibles y cómo se calculan:
src.a * src.rgb + (1 - src.a) * dst.rgbsrc.rgb + dst.rgbsrc.rgb * dst.rgbsrc.rgb - dst.rgb * dst.rgbAl definir la propiedad Pivot, puedes cambiar el modo de alineación del texto.
Center, North o South, el texto queda alineado al centro.West, el texto queda alineado a la izquierda.East, el texto queda alineado a la derecha.
Puedes manipular labels en runtime obteniendo y definiendo el texto del label, así como sus distintas propiedades.
textstring). Disponible mediante go.get() y go.set().colorvector4)outlinevector4)shadowvector4)scalenumber para escalado uniforme o un vector3 para escalado individual a lo largo de cada eje.sizevector3)function init(self)
-- Establece el texto del componente "my_label" del mismo objeto de juego
-- que este script.
go.set("#my_label", "text", "New text")
local text = go.get("#my_label", "text")
print(text) -- New text
end
label.set_text() y label.get_text() están obsoletas en favor de la propiedad text. Las funciones antiguas siguen disponibles por compatibilidad. El setter antiguo encola un mensaje, mientras que go.set() actualiza el texto inmediatamente.
function init(self)
-- Define el color del componente "my_label" en el mismo objeto de juego
-- que este script. El color es un valor RGBA almacenado en un vector4.
local grey = vmath.vector4(0.5, 0.5, 0.5, 1.0)
go.set("#my_label", "color", grey)
-- ...y elimina el contorno definiendo su alfa como 0...
go.set("#my_label", "outline.w", 0)
-- ...y escálalo x2 a lo largo del eje x.
local scale_x = go.get("#my_label", "scale.x")
go.set("#my_label", "scale.x", scale_x * 2)
end
El archivo game.project tiene algunas configuraciones del proyecto relacionadas con labels.