【LWJGL2 WIKI】【辅助库篇】Slick-Util库：第三部分－读取TrueType字体

原文：http://wiki.lwjgl.org/wiki/Slick-Util_Library_-Part_3-_TrueType_Fonts_for_LWJGL

NOTES: 注意：

TrueTypeFont类已经被标记为deprecated(过时类)，因为现在Slick2D用的是UnicodeFont来读取TTF字体了。你仍然可以用TrueTypeFont，或者也可以更新为最新的Slick2D然后用UnicodeFont。（译注：想支持中文显示的话，必须得用UnicodeFont）

When to use Bitmap Fonts vs. Unicode Fonts 使用位图字和Unicode字体的时机

大部分游戏并不需要有一套可以无限缩放的字形，因此额外在上面花费内存去读TTF字体并没有必要。大部分图形库（比如Slick2D和TWL）也支持位图字。一般来讲，用位图字比用TTF字体更简便。当然，如果你需要有一个动态的字体大小改变，或者想要适当的unicode字体支持，TrueTypeFont或UnicodeFont才是更优解决方案。

Why is a Library needed for Fonts? 为何还专门要用一个库去读字体

OpenGL默认并不对字体有任何的支持。为了显示字体，你需要手动实现。因为想在OpenGL里实现的话其实并没有唯一解，所以想完美地实现这整个字体支持过程实在是有点无从下手。用位图来显示字体在OpenGL里应该说是非常流行的一种方法。

True Type Font Format TrueType字体格式

TTF这种格式是保存和分享字体所使用的最广泛的一种格式了，有许多网站提供了海量的TFF字体，比如：

www.dafont.com

www.1001freefonts.com

www.urbanfonts.com

Basics 基础

Slick-Util使用Java内置的AWT Font支持功能读取字体，所以你需要对AWT字体类有所了解。你可以用Java内置字体，也可以用外部读取的TTF字体文件。

Slick-Util库会将AWT字体转换，用在OpenGL内。然后通过TrueTypeFont类来保存和描画。

读取TrueType字体的例子如下：

TrueTypeFont font;
TrueTypeFont font2;

public void init() {
// load a default java font
Font awtFont = new Font("Times New Roman", Font.BOLD, 24);
font = new TrueTypeFont(awtFont, false);

// load font from a .ttf file
try {
InputStream inputStream = ResourceLoader.getResourceAsStream("myfont.ttf");

Font awtFont2 = Font.createFont(Font.TRUETYPE_FONT, inputStream);
awtFont2 = awtFont2.deriveFont(24f); // set font size
font2 = new TrueTypeFont(awtFont2, false);

} catch (Exception e) {
e.printStackTrace();
}
}

之后想在屏幕上渲染出文字，也同样简单：

public void render() {
font.drawString(100, 50, "THE LIGHTWEIGHT JAVA GAMES LIBRARY", Color.yellow);
font2.drawString(100, 100, "NICE LOOKING FONTS!", Color.green);
}

以下是一个完整的例子：

import java.awt.Font;
import java.io.InputStream;

import org.lwjgl.LWJGLException;
import org.lwjgl.opengl.Display;
import org.lwjgl.opengl.DisplayMode;
import org.lwjgl.opengl.GL11;

import org.newdawn.slick.Color;
import org.newdawn.slick.TrueTypeFont;
import org.newdawn.slick.util.ResourceLoader;

public class FontExample {

/** The fonts to draw to the screen */
private TrueTypeFont font;
private TrueTypeFont font2;

/** Boolean flag on whether AntiAliasing is enabled or not */
private boolean antiAlias = true;

/**
* Start the test
*/
public void start() {
initGL(800,600);
init();

while (true) {
GL11.glClear(GL11.GL_COLOR_BUFFER_BIT);
render();

Display.update();
Display.sync(100);

if (Display.isCloseRequested()) {
Display.destroy();
System.exit(0);
}
}
}

/**
* Initialise the GL display
*
* @param width The width of the display
* @param height The height of the display
*/
private void initGL(int width, int height) {
try {
Display.setDisplayMode(new DisplayMode(width,height));
Display.create();
Display.setVSyncEnabled(true);
} catch (LWJGLException e) {
e.printStackTrace();
System.exit(0);
}

GL11.glEnable(GL11.GL_TEXTURE_2D);
GL11.glShadeModel(GL11.GL_SMOOTH);
GL11.glDisable(GL11.GL_DEPTH_TEST);
GL11.glDisable(GL11.GL_LIGHTING);

GL11.glClearColor(0.0f, 0.0f, 0.0f, 0.0f);
GL11.glClearDepth(1);

GL11.glEnable(GL11.GL_BLEND);
GL11.glBlendFunc(GL11.GL_SRC_ALPHA, GL11.GL_ONE_MINUS_SRC_ALPHA);

GL11.glViewport(0,0,width,height);
GL11.glMatrixMode(GL11.GL_MODELVIEW);

GL11.glMatrixMode(GL11.GL_PROJECTION);
GL11.glLoadIdentity();
GL11.glOrtho(0, width, height, 0, 1, -1);
GL11.glMatrixMode(GL11.GL_MODELVIEW);
}

/**
* Initialise resources
*/
public void init() {
// load a default java font
Font awtFont = new Font("Times New Roman", Font.BOLD, 24);
font = new TrueTypeFont(awtFont, antiAlias);

// load font from file
try {
InputStream inputStream = ResourceLoader.getResourceAsStream("myfont.ttf");

Font awtFont2 = Font.createFont(Font.TRUETYPE_FONT, inputStream);
awtFont2 = awtFont2.deriveFont(24f); // set font size
font2 = new TrueTypeFont(awtFont2, antiAlias);

} catch (Exception e) {
e.printStackTrace();
}
}

/**
* Game loop render
*/
public void render() {
Color.white.bind();

font.drawString(100, 50, "THE LIGHTWEIGHT JAVA GAMES LIBRARY", Color.yellow);
font2.drawString(100, 100, "NICE LOOKING FONTS!", Color.green);
}

/**
* Main method
*/
public static void main(String[] argv) {
FontExample fontExample = new FontExample();
fontExample.start();
}
}

你会得到和下图类似的效果：

UnicodeFont类用法：（译者加）

此教程对UnicodeFont的具体用法并没有细提，去官方论坛看到作者发过一段应用代码，可以用来顺利支持中文。但是需要像flash那样，预先把要用到的所有汉字做成字形。

UnicodeFont uf = new UnicodeFont("fonts/bgqc.ttf", 24, false, false);
uf.getEffects().add(new ColorEffect(java.awt.Color.white)); //Requires at least one effect
uf.addGlyphs("所有可能出现的字都要放在这里面"); //enter all the characters you want to use
uf.loadGlyphs(); //packs the glyphs onto a texture

// 在循环里这样描画
uf.drawString(100,150, "所有字 没做字形的字不会显示", Color.white);

Credit

Tutorial Credit - Ninja Cave

Kevin Glass for writing the Slick Library and initial example code.