LibGDX_5.1: 位图文字工具（Hiero 工具 与 BitmapFont 类）

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

LibGDX 基础教程（总目录）

1. 概述

跨平台游戏开发和 Native APP 开发不同，为了实现良好的跨平台，可能不会直接使用系统字库显示文本。在 LibGDX 中使用位图字体（BitmapFont）的方式渲染文本。BitmapFont 字体使用一张静态图片来提供文本字符的显示（以一张小图表示一个字符，本质上其实是绘制图片）。

2. Hiero 工具

要使用位图字体（BitmapFont），首先要制作一张表示字符形状纹理的图片。LibGDX 提供了一个创建位图字体文件的工具，即 Hiero。Hiero 使用标准 JavaSE 编写，在各个平台安装 JDK 后均可运行。

Hiero 下载地址：https://libgdx.badlogicgames.com/releases/

下载 hiero.jar 这个文件，参考下图：

将 hiero.jar 文件下载到本地后，打开命令行，进入到 hiero.jar 文件所在目录，运行命令： java -jar hiero.jar

运行后的 hiero 界面：

为了演示，在这里我点击文本输入区域的 NEHE 按钮快速输入大小写字母，数字 和 常用英文标点符号，然后再换行输入一段中文 “跨平台游戏开发框架”。

编辑好要显示的所有字符后（只有在文本编辑区域所输入过的字符在最终才能被使用），点击 菜单栏的 “File” -> “Save BMFont files” -> 选择保存位置，输入文件名称（在这里我输入“bitmapfont”） -> 保存。

在保存的目录位置将生成两个文件：

• bitmapfont.png： 一张 png 图片，图片中包含了所输入的所有字符图形（重复输入的字符会自动过滤只显示一个）。
• bitmapfont.fnt： 一个文本文件，记录了 bitmapfont.png 图片文件的位置（默认为当前位置）以及所输入的所有字符图形分别在 bitmapfont.png 图片中的具体位置（记录字符的纹理区域）。

将 bitmapfont.png 和 bitmapfont.fnt 这两个文件复制到 assets 资源文件夹中，这里我在 assets 中单独创建一个文件夹 font 来存放这两个字体文件，如下图所示：

3. 代码示例：BitmapFont 类的使用

package com.libgdx.test;
	
import com.badlogic.gdx.ApplicationAdapter;
import com.badlogic.gdx.Gdx;
import com.badlogic.gdx.graphics.GL20;
import com.badlogic.gdx.graphics.g2d.BitmapFont;
import com.badlogic.gdx.graphics.g2d.SpriteBatch;

/**
 * 游戏主程序的启动入口类
 */
public class MainGame extends ApplicationAdapter {
	
	private SpriteBatch batch;
	
	// 位图字体
	private BitmapFont bitmapFont;
	
	@Override
	public void create() {
		// 创建 SpriteBatch
		batch = new SpriteBatch();
		
		// 读取 bitmapfont.fnt 文件创建位图字体对象
		bitmapFont = new BitmapFont(Gdx.files.internal("font/bitmapfont.fnt"));
		
		/*
		 * 给位图字体设置颜色（RGBA）,
		 * 
		 * 使用 hiero 创建位图字体文件时也可以设置字体颜色（默认为白色）, 这里设置的颜色和 hiero 中设置的字体颜色
		 * 对最终显示的颜色会相互影响。如果在 hiero 中设置了白色（默认）, 则在这里通过 bitmapFont.setColor(...)
		 * 设置的颜色就是最终显示的颜色（姑且可以简单地看做是 hiero 中设置了白色就不会影响到这里设置的颜色）。
		 */
		// bitmapFont.setColor(1, 0, 0, 1);
		
		/*
		 * 如果想改变显示文本的大小, 可以通过设置显示数据的缩放比实现
		 */
		// bitmapFont.getData().setScale(2.0F);
		
		/*
		 * 多行绘制时（字符串中有换行符）可以选择给显示数据设置行高
		 */
		// bitmapFont.getData().setLineHeight(64.0F);
	}

	@Override
	public void render() {
		// 黑色清屏
		Gdx.gl.glClearColor(0, 0, 0, 1);
		Gdx.gl.glClear(GL20.GL_COLOR_BUFFER_BIT);
		
		// 开始绘制
		batch.begin();
		
		/*
		 * 绘制文本（创建位图字体文件时有输入过的字符才能被显示）,
		 * 
		 * 注意: 这里的绘制坐标和绘制纹理时不同，绘制 BitmapFont 时的起点坐标在文本字符串的左上角
		 */
		bitmapFont.draw(batch, "Hello BitmapFont!~", 10, 100);
		
		// 中英混合绘制文本, 支持换行符
		bitmapFont.draw(batch, "LibGDX跨平台\n游戏开发框架", 10, 300);
		
		// 绘制结束
		batch.end();
	}

	@Override
	public void dispose() {
		// 当应用退出时释放资源
		if (batch != null) {
			batch.dispose();
		}
		// BitmapFont 关联了一张图片纹理, 不再使用时需要释放资源
		if (bitmapFont != null) {
			bitmapFont.dispose();
		}
	}

}

运行结果：

---