Manuals
Manuals




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

GUI文本节点

Defold支持一种特定类型的GUI节点,允许在GUI场景中渲染文本。项目中添加的任何字体资源都可以用于文本节点渲染。

编辑器预览使用引擎的字体渲染器,支持文本塑形和从右到左的布局。有关所需的字体和 App Manifest 设置,请参阅文本布局支持。

添加文本节点

您希望在GUI文本节点中使用的字体必须添加到GUI组件中。可以右键单击Fonts文件夹,使用GUI顶部菜单或按相应的键盘快捷键。

Fonts

文本节点具有一组特殊属性:

Font
您创建的任何文本节点都必须设置Font属性。
Text
此属性包含显示的文本。
Line Break
文本对齐遵循 pivot 设置,设置此属性允许文本流到多行。节点的宽度决定文本将在何处换行。

矢量字体与彩色表情符号

按照矢量字体设置,将 .font 资源添加到 GUI 场景的 Fonts,并在文本节点上选择它。将字体资源的 Material 设为 /builtins/fonts/font-vector.material。使用节点的 Font Size 控制显示大小。

对于彩色表情符号,还需完成 COLRv1 后备字体和打包设置。创建 id 为 text 的文本节点,将其 Text 留空,并将以下代码添加到 GUI 场景的 .gui_script:

function init(self)
    local node = gui.get_node("text")
    local text = "Hello 😀 🍎 🚀"
    local font_resource = gui.get_font_resource(gui.get_font(node))
    -- 为这个共享字体资源添加后备字体,只需添加一次。
    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 场景中的名称;gui.get_font_resource() 将此名称解析为 font.add_font() 使用的字体资源。共用该资源的其他节点和标签也会获得后备字体,因此只初始化一次。预热成功后才设置文本。

对齐

通过设置节点 pivot,您可以更改文本的对齐模式。

Center
如果 pivot 设置为Center、North或South,则文本居中对齐。
Left
如果 pivot 设置为任何West模式,则文本左对齐。
Right
如果 pivot 设置为任何East模式,则文本右对齐。

文本对齐

运行时修改文本节点

文本节点响应任何通用的节点操作函数,用于设置大小、pivot、颜色等。存在一些仅用于文本节点的函数:

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
⌂ 换网址