LIBGDX: FreeTypeFontGenerator and BitmapTrueFont

LIBGDX: FreeTypeFontGenerator and BitmapTrueFont

 

    在刚开始敲I;P游戏的时候, 字体使用的是BitmapFont, 只要有一套字体的PNG文件就可以显示字体数据了. 并且通过BitmapFont对象可以很好的跟Label结合在一起使用. BitmapFont中的字体从PNG文件中截取出来有很多方便的地方, 比如, 一来只需要准备使用的字符即可, 这样字体文件比较小; 二来可以定义任意的图案来代替字符, 灵活性定制方便. 但反过来, 由于基于PNG文件, 也导致了BitmapFont有个两个主要的缺陷 --

        1. 标量字体, 放大会失真;

        2. 字符集有限, 尤其是使用中文时, 改动几率大;

 

    好在LIBGDX还在其扩展库(gdx-freetype)中提供了另外一个好用的对象 --- FreeTypeFontGenerator. 通过这个对象可以加载TTF (TrueType Font), 然后产生BitmapFont对象就可以使用了.

    下面是FreeTypeFontGenerator对象的主要函数原型.

/** Generates a new {@link BitmapFont}, containing glyphs for the given characters. The size is expressed in pixels. Throws a
 * GdxRuntimeException in case the font could not be generated. Using big sizes might cause such an exception. All characters
 * need to fit onto a single texture.
 * @param size the size in pixels
 * @param characters the characters the font should contain
 * @param flip whether to flip the font horizontally, see {@link BitmapFont#BitmapFont(FileHandle, TextureRegion, boolean)} */
public BitmapFont generateFont (int size, String characters, boolean flip) {}

/** Generates a new {@link BitmapFont}. The size is expressed in pixels. Throws a GdxRuntimeException in case the font could not
 * be generated. Using big sizes might cause such an exception. All characters need to fit onto a single texture.
 * 
 * @param size the size of the font in pixels */
public BitmapFont generateFont (int size) {}

 

    在LIBGDX中, AssetManager是个很实用的对象, 通过它可以在游戏初始时就将资源加载或者初始化好, 使用时只需要传递资源名称即可获取相关资源. 比如, 下面代码加载了TextureAtlas和Sound的资源.

assetManager.load(PackConfig.SCREEN_PLAY, TextureAtlas.class);
assetManager.load(PackConfig.SCREEN_MENU, TextureAtlas.class);

assetManager.load(AudioConfig.MENU_CLICK, Sound.class);
assetManager.load(AudioConfig.TRAY_CATCH, Sound.class);

    字体也是一种资源, 因此也可以通过AssetManager来加载TTF字体. 为了能使得两者无缝链接, 可以模仿BitmapFont对象创建个BitmapTrueFont来实现.

 

package jie.android.ip.common.ttf;

import java.util.HashMap;

import com.badlogic.gdx.assets.AssetLoaderParameters;
import com.badlogic.gdx.graphics.g2d.BitmapFont;
import com.badlogic.gdx.graphics.g2d.freetype.FreeTypeFontGenerator;
import com.badlogic.gdx.utils.Disposable;

public class BitmapTrueFont implements Disposable {

	private final HashMap<Integer, BitmapFont> fontMap = new HashMap<Integer, BitmapFont>();
	
	private final FreeTypeFontGenerator generator;
	private final String chars;
	
	public BitmapTrueFont(final FreeTypeFontGenerator generator, final BitmapTrueFontParameter parameter) {
		this.generator = generator;
		this.chars = parameter.getChars();
	}
	
	@Override
	public void dispose() {
		for (final BitmapFont font : fontMap.values()) {
			if (font != null) {
				font.dispose();
			}
		}

		if (generator != null) {
			generator.dispose();
		}
	}
	
	public final BitmapFont getBitmapFont(int size) {
		if (generator == null) {
			return null;
		}
		
		BitmapFont font = fontMap.get(Integer.valueOf(size));
		if (font == null) {
			if (chars == null) {
				font = generator.generateFont(size);
			} else {
				font = generator.generateFont(size, chars, false);
			}
			fontMap.put(Integer.valueOf(size), font);
		}
		return font;
	}
	
	static public class BitmapTrueFontParameter extends AssetLoaderParameters<BitmapTrueFont> {
		private String chars = null;
		
		public BitmapTrueFontParameter() {			
		}
		
		public BitmapTrueFontParameter(final String chars) {
			this.chars = chars;
		}
		
		public final String getChars() {
			return chars;
		}
	}	
}

    OK, 现在可以使用下面代码加载TTF资源了.

assetManager.load("example.ttf", BitmapTrueFont.class, new BitmapTrueFont.BitmapTrueFontParameter(null));