GUI-Textknoten

Defold unterstützt eine spezielle Art von GUI-Knoten (GUI node), mit der sich Text in einer GUI-Szene rendern lässt. Jede Schriftressource, die einem Projekt hinzugefügt wurde, kann zum Rendern von Textknoten (text nodes) verwendet werden.

Die Editorvorschau unterstützt die Formung von Schriftzeichen (text shaping) und Layouts von rechts nach links mithilfe des Schriftrenderers der Engine. Die erforderlichen Einstellungen für die Schriftart und das Anwendungsmanifest (App Manifest) findest du unter Unterstützung für Textlayout.

Textknoten hinzufügen

Die Schriftarten, die du in GUI-Textknoten verwenden möchtest, müssen zur GUI-Komponente (GUI component) hinzugefügt werden. Klicke dazu entweder mit der rechten Maustaste auf den Ordner Fonts, verwende das Menü GUI in der Menüleiste oder drücke die entsprechende Tastenkombination.

Textknoten haben eine Reihe besonderer Eigenschaften:

Font

Bei jedem Textknoten, den du erstellst, muss die Eigenschaft Font festgelegt sein.

Text

Diese Eigenschaft enthält den angezeigten Text.

Line Break

Die Textausrichtung richtet sich nach der Einstellung des Bezugspunkts (pivot). Wenn du diese Eigenschaft aktivierst, kann der Text über mehrere Zeilen fließen. Die Breite des Knotens bestimmt, wo der Text umgebrochen wird.

Ausrichtung

Indem du den Bezugspunkt des Knotens festlegst, kannst du den Ausrichtungsmodus für den Text ändern.

Zentriert

Wenn der Bezugspunkt auf Center, North oder South eingestellt ist, wird der Text zentriert.

Linksbündig

Wenn der Bezugspunkt auf einen der West-Modi eingestellt ist, wird der Text linksbündig ausgerichtet.

Rechtsbündig

Wenn der Bezugspunkt auf einen der East-Modi eingestellt ist, wird der Text rechtsbündig ausgerichtet.

Textknoten zur Laufzeit ändern

Textknoten unterstützen alle allgemeinen Funktionen zur Bearbeitung von Knoten, mit denen sich Größe, Bezugspunkt, Farbe und weitere Eigenschaften festlegen lassen. Einige Funktionen sind ausschließlich für Textknoten vorgesehen:

• Um die Schriftart eines Textknotens zu ändern, verwende die Funktion gui.set_font().
• Um das Verhalten beim Zeilenumbruch eines Textknotens zu ändern, verwende die Funktion gui.set_line_break().
• Um den Inhalt eines Textknotens zu ändern, verwende die Funktion 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