Label

Label 组件能在游戏空间中渲染出一些文本. 默认连同 sprite 和瓷砖图一起排序和渲染. 组件的各种属性控制着文本如何被渲染. Defold 的 GUI 也能显示文本但是难以把它放在游戏世界里. Label 可以更容易做到这一点.

创建 label

要创建一个 Label 组件, 在游戏对象上 右键点击 选择 Add Component ▸ Label.

(如果你希望从一个模板创建多个 label 可以: 在 Assets 浏览器里的文件夹上 右键点击 选择 New... ▸ Label 来创建Label文件, 然后再在任意游戏对象上把它作为组件添加上去)

设置 Font 属性为需要使用的字体还要确定 Material 属性的设置与字体相匹配:

Label 属性

除了 Id, Position, Rotation 和 Scale 外还有一些特有属性:

Text

label的文本.

Size

边界方块的大小. 如果 Line Break 设置了某值, 文本就会在相应宽度换行.

Color

文本的颜色.

Outline

描边的颜色.

Shadow

阴影的颜色.

Leading

行间距倍数. 设置为 0 则没有行间距. 默认是 1.

Tracking

字间距倍数. 默认是 0.

Pivot

文本的锚点. 此值关系到文本对齐效果 (详见下文).

Blend Mode

此 label 渲染时使用的混合模式.

Line Break

文本对齐与锚点相关, 此属性可以让文本流动几行. 节点宽度决定文本在哪里换行.文本对齐与锚点相关, 此属性可以让文本溢出几行. 节点宽度决定文本在哪里换行. 注意文本换行处要留有空间.

Font

此 label 所使用的字体资源.

Material

用于渲染此 label 所使用的材质. 确保选中的材质是为你所使用的字体 (bitmap, distance field or BMFont) 创建的.

混合模式

Blend Mode 属性定义了可视组件如何与其后面的图像混合. 以下列举了支持的混合模式及其混合算法:

Alpha

普通混合: src.a * src.rgb + (1 - src.a) * dst.rgb

Add

使用相应组件的像素颜色值提亮背景: src.rgb + dst.rgb

Multiply

使用相应组件的像素颜色值调暗背景: src.rgb * dst.rgb

Screen

Multiply 的反向操作. 使用相应组件的像素颜色值提亮背景: src.rgb - dst.rgb * dst.rgb

锚点和对齐

你可以通过设置锚点来改变文本的对齐方式.

Center

如果锚点设置成 Center, North 或者 South, 则文本居中对齐.

Left

如果锚点设置成任何 West 模式, 则文本左对齐.

Right

如果锚点设置成任何 East 模式, 则文本右对齐.

运行时控制操作

你可以使用在运行时操控 labels 的文本以及其他一系列的值.

color

label颜色 (vector4)

outline

label描边颜色 (vector4)

shadow

label阴影颜色 (vector4)

scale

label缩放, 要么是 number 用于等比缩放, 要么是 vector3 分轴向缩放.

size

label大小 (vector3)

function init(self)
    -- Set the text of the "my_label" component in the same game object
    -- as this script.
    label.set_text("#my_label", "New text")
end

function init(self)
    -- Set the color of the "my_label" component in the same game object
    -- as this script. Color is a RGBA value stored in a vector4.
    local grey = vmath.vector4(0.5, 0.5, 0.5, 1.0)
    go.set("#my_label", "color", grey)

    -- ...and remove the outline, by setting its alpha to 0...
    go.set("#my_label", "outline.w", 0)

    -- ...and scale it x2 along x axis.
    local scale_x = go.get("#my_label", "scale.x")
    go.set("#my_label", "scale.x", scale_x * 2)
end

相关项目配置

在 game.project 文件里有些关于标签的 配置项目.