LibGDX_6.2: 常用系统控件: 标签（Label）

本文链接: http://blog.csdn.net/xietansheng/article/details/50187811

LibGDX 基础教程（总目录）

1. 标签（Label）

标签控件主要用于输出文本信息，在舞台中展示一下文本内容，例如玩家分数，主角血值，关卡说明等。

由于标签是用来展示文字的，所以使用标签首先要有位图字体（BitmapFont）来 提供字符显示 ，这里使用前面章节创建好的位图文件（bitmapfont.png 和 bitmapfont.fnt），把这两个文件复制到 assets 资源文件夹中，这里我在 assets 中单独创建一个文件夹 font 来存放这两个字体文件，如下图所示：

2. 代码示例: Label 的使用

package com.libgdx.test;
		
import com.badlogic.gdx.ApplicationAdapter;
import com.badlogic.gdx.Gdx;
import com.badlogic.gdx.graphics.Color;
import com.badlogic.gdx.graphics.GL20;
import com.badlogic.gdx.graphics.g2d.BitmapFont;
import com.badlogic.gdx.scenes.scene2d.Stage;
import com.badlogic.gdx.scenes.scene2d.ui.Label;
import com.badlogic.gdx.utils.viewport.StretchViewport;
	
/**
 * 游戏主程序的启动入口类
 */
public class MainGame extends ApplicationAdapter {
	
	// 视口世界的宽高统使用 480 * 800, 并统一使用伸展视口（StretchViewport）
	public static final float WORLD_WIDTH = 480;
	public static final float WORLD_HEIGHT = 800;
	
	// 舞台
	private Stage stage;
	
	// 标签控件
	private Label label;
	
	// 位图字体
	private BitmapFont bitmapFont;
	
	@Override
	public void create() {
		// 使用伸展视口（StretchViewport）创建舞台
        stage = new Stage(new StretchViewport(WORLD_WIDTH, WORLD_HEIGHT));
        
		/*
		 * 第 1 步: 创建 BitmapFont
		 */
        // 读取 bitmapfont.fnt 文件创建位图字体
        bitmapFont = new BitmapFont(Gdx.files.internal("font/bitmapfont.fnt"));
        
        /*
		 * 第 2 步: 创建 LabelStyle
		 */
		// 要创建 Label 首先要创建一个 Label 的样式, 用于指明 Label 所使用的位图字体, 背景图片, 颜色等
        Label.LabelStyle style = new Label.LabelStyle();
        
        // 指定 Label 的背景, 可用纹理区域 textureRegion（在这里背景我就不再设置）
        // style.background = new TextureRegionDrawable(textureRegion);
        
        // 指定 Label 所使用的位图字体
        style.font = bitmapFont;
        
        // 指定 Label 字体的 RGBA 颜色, 在这里我设置为红色
        style.fontColor = new Color(1, 0, 0, 1);
        
		/*
		 * 第 3 步: 创建 Label
		 */
        // 根据 Label 的样式创建 Label, 第一个参数表示显示的文本（要显示的文本字符必须在 BitmapFont 中存在）
        label = new Label("Hello Label", style);
        
        // 也可以通过方法设置或获取文本
        // label.setText("Hello");
        // String text = label.getText().toString();
        
        // 设置 Label 的显示位置
        label.setPosition(50, 400);
        
        // 可以通过设置字体的缩放比来控制字体显示的大小
        label.setFontScale(1.5f);
        
		/*
		 * 第 4 步: 添加到舞台
		 */
        // 添加 label 到舞台
        stage.addActor(label);
	}

	@Override
	public void render() {
		// 黑色清屏
		Gdx.gl.glClearColor(0, 0, 0, 1);
		Gdx.gl.glClear(GL20.GL_COLOR_BUFFER_BIT);
		
		// 更新舞台逻辑
		stage.act();
		// 绘制舞台
		stage.draw();
	}

	@Override
	public void dispose() {
		// 应用退出时释放资源
		if (bitmapFont != null) {
			bitmapFont.dispose();
		}
		if (stage != null) {
			stage.dispose();
		}
	}

}

运行结果：

---