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
Komponent Label renderuje fragment tekstu na ekranie, w przestrzeni gry. Domyślnie jest sortowany i rysowany razem ze wszystkimi grafikami sprite i tile. Komponent ma zestaw właściwości, które określają sposób renderowania tekstu. GUI w Defold obsługuje tekst, ale umieszczanie elementów GUI w świecie gry może być trudne. Label ułatwia to zadanie.
Aby utworzyć komponent Label, kliknij prawym przyciskiem myszy obiekt gry i wybierz Add Component ▸ Label.

(Jeśli chcesz utworzyć kilka Label z tego samego szablonu, możesz też utworzyć nowy plik komponentu Label: kliknij prawym przyciskiem myszy folder w przeglądarce Assets i wybierz New... ▸ Label, a następnie dodaj ten plik jako komponent do dowolnych obiektów gry.)

Ustaw właściwość Font na font, którego chcesz użyć, i upewnij się, że właściwość Material wskazuje materiał zgodny z typem fontu:

Aby używać fontu Vector, wykonaj kroki konfiguracji fontów wektorowych, przypisz zasób .font do właściwości Font etykiety i ustaw jej Material na /builtins/fonts/label-vector.material. Rozmiar wyświetlanego tekstu określa Font Size.
Aby wyświetlać kolorowe emoji, wykonaj też konfigurację fontu zapasowego COLRv1 i zasobów paczki. Poniższy przykład zakłada etykietę o identyfikatorze label i skrypt na tym samym obiekcie gry. Pozostaw Text etykiety puste, aby powitanie pojawiło się dopiero po przygotowaniu jego glifów:
function init(self)
local text = "Hello 😀 🍎 🚀"
local font_resource = go.get("#label", "font")
-- Dodaj font zastępczy raz dla tego współdzielonego zasobu fontu.
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
Zwykłe litery korzystają z oryginalnego fontu, a emoji z dodanego fontu kolorowego. Jeśli inne etykiety lub węzły tekstowe GUI współdzielą ten zasób fontu, zainicjalizuj font zapasowy w jednym miejscu i używaj go ponownie.
Oprócz właściwości Id, Position, Rotation i Scale istnieją też następujące właściwości specyficzne dla komponentu:
Należy pamiętać, że domyślny materiał ma renderowanie cienia wyłączone ze względów wydajnościowych.
Właściwość Blend Mode określa, w jaki sposób grafika komponentu ma być mieszana z grafiką znajdującą się za nią. Poniżej przedstawiono dostępne tryby mieszania i sposób ich obliczania:
src.a * src.rgb + (1 - src.a) * dst.rgbsrc.rgb + dst.rgbsrc.rgb * dst.rgbsrc.rgb - dst.rgb * dst.rgbUstawiając właściwość Pivot, możesz zmienić sposób wyrównania tekstu.
Center, North lub South, tekst jest wyrównany do środka.West, tekst jest wyrównany do lewej.East, tekst jest wyrównany do prawej.
Możesz modyfikować Label w czasie działania, odczytując i ustawiając tekst Label oraz inne właściwości.
textstring). Dostępna przez go.get() i go.set().colorvector4)outlinevector4)shadowvector4)scalenumber dla jednolitego skalowania albo vector3 dla osobnego skalowania wzdłuż każdej osi.sizevector3)function init(self)
-- Ustaw tekst komponentu "my_label" w tym samym obiekcie gry
-- co ten skrypt.
go.set("#my_label", "text", "New text")
local text = go.get("#my_label", "text")
print(text) -- New text
end
Funkcje label.set_text() i label.get_text() są przestarzałe i zaleca się używanie właściwości text. Stare funkcje pozostają dostępne dla zgodności. Stara funkcja ustawiająca tekst umieszcza wiadomość w kolejce, natomiast go.set() aktualizuje tekst natychmiast.
function init(self)
-- Ustaw kolor komponentu "my_label" w tym samym obiekcie gry.
-- Kolor to wartość RGBA przechowywana w vector4.
local grey = vmath.vector4(0.5, 0.5, 0.5, 1.0)
go.set("#my_label", "color", grey)
-- ...i usuń obrys, ustawiając jego alfę na 0...
go.set("#my_label", "outline.w", 0)
-- ...i przeskaluj go 2x wzdłuż osi x.
local scale_x = go.get("#my_label", "scale.x")
go.set("#my_label", "scale.x", scale_x * 2)
end
Plik game.project ma kilka ustawień projektu związanych z Label.