GUI metin düğümleri

Defold, GUI sahnesinde metin işleme (rendering) için özel bir GUI düğümü (GUI node) türünü destekler. Projeye eklenen herhangi bir yazı tipi kaynağı, metin düğümlerini (text node) işlemek için kullanılabilir.

Düzenleyici önizlemesi, motorun yazı tipi işleyicisini kullanarak metin şekillendirmeyi ve sağdan sola yerleşimi destekler. Gerekli yazı tipi ve App Manifest ayarları için metin yerleşimi desteğine bakın.

Metin düğümleri ekleme

GUI metin düğümlerinde kullanmak istediğiniz yazı tiplerinin GUI bileşenine (GUI component) eklenmesi gerekir. Bunun için Fonts klasörüne sağ tıklayın, üstteki GUI menüsünü kullanın veya ilgili klavye kısayoluna basın.

Metin düğümlerinin bir dizi özel özelliği vardır:

Font

Oluşturduğunuz her metin düğümünün Font özelliği ayarlanmalıdır.

Text

Bu özellik, görüntülenen metni içerir.

Line Break

Metin hizalaması, dayanak noktası (pivot) ayarını izler ve bu özelliğin ayarlanması, metnin birden çok satıra yayılmasını sağlar. Düğümün genişliği, metnin nerede alt satıra kaydırılacağını belirler.

Vektör yazı tipleri ve renkli emoji

Vektör yazı tipi kurulumunu izleyin, .font kaynağını GUI sahnesinin Fonts listesine ekleyin ve metin düğümünde seçin. Yazı tipi kaynağının Material özelliğini /builtins/fonts/font-vector.material olarak ayarlayın. Görüntülenen boyutu kontrol etmek için düğümün Font Size özelliğini kullanın.

Renkli emoji için COLRv1 yedek yazı tipi ve paketleme kurulumunu da tamamlayın. text kimliğine sahip bir metin düğümü oluşturun, Text alanını boş bırakın ve GUI sahnesinin .gui_script dosyasına şunu ekleyin:

function init(self)
    local node = gui.get_node("text")
    local text = "Hello 😀 🍎 🚀"
    local font_resource = gui.get_font_resource(gui.get_font(node))
    -- Add the fallback once for this shared font resource.
    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(), GUI sahnesindeki yazı tipi adını döndürür; gui.get_font_resource() ise bu adı font.add_font() işlevinin kullandığı yazı tipi kaynağına çözümler. Bu kaynağı paylaşan diğer düğümler ve etiketler de yedek yazı tipini alır; bu nedenle onu yalnızca bir kez başlatın. Metin, ön hazırlık başarıyla tamamlandıktan sonra ayarlanır.

Hizalama

Düğümün dayanak noktasını ayarlayarak metnin hizalama modunu değiştirebilirsiniz.

Ortalanmış

Dayanak noktası Center, North veya South olarak ayarlanırsa metin ortalanır.

Sola hizalı

Dayanak noktası West modlarından herhangi birine ayarlanırsa metin sola hizalanır.

Sağa hizalı

Dayanak noktası East modlarından herhangi birine ayarlanırsa metin sağa hizalanır.

Çalışma sırasında metin düğümlerini değiştirme

Metin düğümleri, boyut, dayanak noktası, renk ve benzerlerini ayarlayan tüm genel düğüm düzenleme işlevleriyle değiştirilebilir. Yalnızca metin düğümlerine özgü birkaç işlev de vardır:

• Bir metin düğümünün yazı tipini değiştirmek için gui.set_font() işlevini kullanın.
• Bir metin düğümünün satır kaydırma davranışını değiştirmek için gui.set_line_break() işlevini kullanın.
• Bir metin düğümünün içeriğini değiştirmek için gui.set_text() işlevini kullanın.

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