Files
lwjglbook-CN-Translation/12-game-hud/index.html
2024-07-17 21:58:59 +08:00

740 lines
40 KiB
HTML
Executable File
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html>
<html class="writer-html5" lang="en" >
<head>
<meta charset="utf-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
<link rel="shortcut icon" href="../img/favicon.ico" />
<title>游戏HUD - Lwjglbook中文翻译</title>
<link rel="stylesheet" href="../css/theme.css" />
<link rel="stylesheet" href="../css/theme_extra.css" />
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
<script>
// Current page data
var mkdocs_page_name = "\u6e38\u620fHUD";
var mkdocs_page_input_path = "12-game-hud.md";
var mkdocs_page_url = null;
</script>
<!--[if lt IE 9]>
<script src="../js/html5shiv.min.js"></script>
<![endif]-->
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
<script>hljs.highlightAll();</script>
</head>
<body class="wy-body-for-nav" role="document">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
<div class="wy-side-scroll">
<div class="wy-side-nav-search">
<a href=".." class="icon icon-home"> Lwjglbook中文翻译
</a><div role="search">
<form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
<input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
</form>
</div>
</div>
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<ul>
<li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
</li>
</ul>
<ul class="current">
<li class="toctree-l1 current"><a class="reference internal current" href="#">游戏HUD</a>
<ul class="current">
<li class="toctree-l2"><a class="reference internal" href="#_1">文本渲染</a>
</li>
<li class="toctree-l2"><a class="reference internal" href="#hud">完善HUD</a>
</li>
<li class="toctree-l2"><a class="reference internal" href="#_2">再谈文本渲染</a>
</li>
<li class="toctree-l2"><a class="reference internal" href="#osx">OSX</a>
</li>
</ul>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../16-fog/"></a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
</li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
<nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="..">Lwjglbook中文翻译</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
<li><a href=".." class="icon icon-home" aria-label="Docs"></a></li>
<li class="breadcrumb-item active">游戏HUD</li>
<li class="wy-breadcrumbs-aside">
<a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/12-game-hud.md" class="icon icon-github"> Edit on GitHub</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div class="section" itemprop="articleBody">
<h1 id="hudgame-hud">游戏HUDGame HUD</h1>
<p>在本章中我们将为游戏创建一个HUDHeads-Up Display平视显示器。换句话说就是一组用于在三维场景上随时显示相关信息的二维图形和文本。本例中将创建一个简单的HUD这可为我们展现一些显示信息的基本技术。</p>
<p>当你查阅本章的源代码时,还将发现我们对源代码做了一些小的重构,特别是<code>Renderer</code>以便为HUD渲染做好准备。</p>
<h2 id="_1">文本渲染</h2>
<p>创建HUD所要做的第一件事是渲染文本。为了实现它我们将储存字符的纹理映射到一个方形中该方形将被分割为一组表示每个字符的片段。之后我们将使用该纹理在屏幕上绘制文本。所以首先创建含有所有字母的纹理这项工作可以使用很多软件来做例如<a href="http://www.codehead.co.uk/cbfg/">CBFG</a><a href="http://sourceforge.net/projects/f2ibuilder/">F2IBuilder</a>等等。本例使用Codehead的位图字体生成器Codeheads Bitmap Font GeneratorCBFG</p>
<p>CBFG允许你配置很多选项如纹理大小、字体类型、要使用的抗锯齿等等。下图是本例将用来生成纹理文件的配置。在本章中我们将假设文本编码为ISO-8859-1如果你需要处理其他的字符集则需要稍微修改代码。</p>
<p><img alt="CBFG配置" src="../_static/12/CBG.png" /></p>
<p>当设置好CBFG的所有选项后可以将其导出为多种图片格式。现在我们将其导出为BMP文件然后再转换为PNG文件以便将其作为纹理加载。当转换为PNG格式时我们也可以将黑色背景设置为透明也就是说我们将黑色设为Alpha值等于0可以使用GIMP这样的工具来实现。最终你会看到类似下图所示的结果。</p>
<p><img alt="字体纹理" src="../_static/12/font_texture.png" /></p>
<p>如你所见图像中的所有字符都以行和列的形式排列。在本例中图像由15列和17行字符组成。通过使用特定字符的编号我们可以计算其对应储存在图像中的行和列。所在列的计算方法为<script type="math/tex">列数 = 字符编号 \space mod \space 列总数</script>,其中<script type="math/tex">mod</script>是取余运算符,所在行的计算方法为:<script type="math/tex">所在行 = 字符编号 / 行总数</script>。在本例中我们将整数除以整数,以便忽略小数部分。</p>
<p>我们将创建一个名为<code>TextItem</code>的新类它将储存渲染文本所需的图元。这是一个不考虑多行文本的简化实现但是它能在HUD中显示文本信息。下列代码是该类的声明与构造函数</p>
<pre><code class="language-java">package org.lwjglb.engine;
import java.nio.charset.Charset;
import java.util.ArrayList;
import java.util.List;
import org.lwjglb.engine.graph.Material;
import org.lwjglb.engine.graph.Mesh;
import org.lwjglb.engine.graph.Texture;
public class TextItem extends GameItem {
private static final float ZPOS = 0.0f;
private static final int VERTICES_PER_QUAD = 4;
private String text;
private final int numCols;
private final int numRows;
public TextItem(String text, String fontFileName, int numCols, int numRows) throws Exception {
super();
this.text = text;
this.numCols = numCols;
this.numRows = numRows;
Texture texture = new Texture(fontFileName);
this.setMesh(buildMesh(texture, numCols, numRows));
}
</code></pre>
<p>这个类继承了<code>GameItem</code>类,这是因为本例希望改变在屏幕上文本的位置,也可能需要缩放和旋转它。构造函数接收要渲染的文本和用于渲染的纹理的文件和相关数据(储存图像的文件及行列数)。</p>
<p>在构造函数中,我们加载纹理图像文件,并调用一个方法来创建一个<code>Mesh</code>实例为文本建模。让我们看到<code>buildMesh</code>方法:</p>
<pre><code class="language-java">private Mesh buildMesh(Texture texture, int numCols, int numRows) {
byte[] chars = text.getBytes(Charset.forName(&quot;ISO-8859-1&quot;));
int numChars = chars.length;
List&lt;Float&gt; positions = new ArrayList&lt;&gt;();
List&lt;Float&gt; textCoords = new ArrayList&lt;&gt;();
float[] normals = new float[0];
List&lt;Integer&gt; indices = new ArrayList&lt;&gt;();
float tileWidth = (float)texture.getWidth() / (float)numCols;
float tileHeight = (float)texture.getHeight() / (float)numRows;
</code></pre>
<p>代码创建了用于储存Mesh的位置、纹理坐标、法线和索引的数据结构。现在我们不使用光照因此法线数列是空的。我们要做的是构造一组字符片段每个字符片段代表一个字符。我们还需要根据每个片段对应的字符来分配对应的纹理坐标。下图展现了文本矩形和字符片段的关系</p>
<p><img alt="文本矩形" src="../_static/12/text_quad.png" /></p>
<p>因此对于每个字符我们需要创建由两个三角形构成的字符片段这两个三角形可以用四个顶点V1、V2、V3和V4定义。第一个三角形左下角的那个的索引为(0, 1, 2),而第二个三角形(右上角的那个)的索引为(3, 0, 2)。纹理坐标是基于与纹理图像中每个字符相关的行列计算的,纹理坐标的范围为[0, 1]所以我们只需要将当前行或当前列除以总行数和总列数就可以获得V1的坐标。对于其他顶点我们只需要适当加上行宽或列宽就可以得到对应坐标。</p>
<p>下述的循环语句块创建了与渲染文本矩形相关的所有顶点、纹理坐标和索引。</p>
<pre><code class="language-java">for(int i=0; i&lt;numChars; i++) {
byte currChar = chars[i];
int col = currChar % numCols;
int row = currChar / numCols;
// 构造由两个三角形组成的字符片段
// 左上角的顶点
positions.add((float)i*tileWidth); // x
positions.add(0.0f); //y
positions.add(ZPOS); //z
textCoords.add((float)col / (float)numCols );
textCoords.add((float)row / (float)numRows );
indices.add(i*VERTICES_PER_QUAD);
// 左下角的顶点
positions.add((float)i*tileWidth); // x
positions.add(tileHeight); //y
positions.add(ZPOS); //z
textCoords.add((float)col / (float)numCols );
textCoords.add((float)(row + 1) / (float)numRows );
indices.add(i*VERTICES_PER_QUAD + 1);
// 右下角的顶点
positions.add((float)i*tileWidth + tileWidth); // x
positions.add(tileHeight); //y
positions.add(ZPOS); //z
textCoords.add((float)(col + 1)/ (float)numCols );
textCoords.add((float)(row + 1) / (float)numRows );
indices.add(i*VERTICES_PER_QUAD + 2);
// 右上角的顶点
positions.add((float)i*tileWidth + tileWidth); // x
positions.add(0.0f); //y
positions.add(ZPOS); //z
textCoords.add((float)(col + 1)/ (float)numCols );
textCoords.add((float)row / (float)numRows );
indices.add(i*VERTICES_PER_QUAD + 3);
// 添加左上角和右下角顶点的索引
indices.add(i*VERTICES_PER_QUAD);
indices.add(i*VERTICES_PER_QUAD + 2);
}
</code></pre>
<p>上述代码中需要注意的一些事项:</p>
<ul>
<li>我们将使用屏幕坐标来表示顶点记住屏幕坐标系的原点位于屏幕左上角。三角形上顶点的Y坐标小于三角形下顶点的Y坐标。</li>
<li>我们不缩放图形因此每个字符片段的X距离就等于字符宽度三角形的高度就是每个字符的高度。这是因为本例希望尽可能地使渲染文本与原始纹理相似不管怎样我们可以稍后缩放它因为<code>TextItem</code>类继承了<code>GameItem</code>类)。</li>
<li>Z坐标为固定值因为它与绘制该图像无关。</li>
</ul>
<p>下图展示了一些顶点的坐标:</p>
<p><img alt="文本矩形坐标" src="../_static/12/text_quad_coords.png" /></p>
<p>为什么我们使用屏幕坐标系首先因为本例将在HUD中渲染2D对象并且通常这样使用它们更方便。其次我们将使用正交投影Orthographic Projection绘制它们稍后再解释什么是正交投影。</p>
<p><code>TextItem</code>类最后还需添加一些方法以获取文本并在运行时更改文本。每当文本被更改时需要清理此前的VAO储存在<code>Mesh</code>实例中并创建一个新的VAO。我们不需要删除纹理所以在<code>Mesh</code>类中添加了一个新方法来删除这些数据。</p>
<pre><code class="language-java">public String getText() {
return text;
}
public void setText(String text) {
this.text = text;
Texture texture = this.getMesh().getMaterial().getTexture();
this.getMesh().deleteBuffers();
this.setMesh(buildMesh(texture, numCols, numRows));
}
</code></pre>
<p>既然我们已经建立了渲染文本所需要的基础结构接下来该怎么做呢首先如此前章节所述渲染三维场景然后在其上渲染二维的HUD。为了渲染HUD我们将使用正交投影也称为正交投影。正交投影是三维物体的一种二维表示方式你可能已经在三维模型的蓝图中看到了一些例子它们用来表示某些物体从顶部或某些侧面看到的样子。下图是圆柱体从顶部和前面的正交投影</p>
<p><img alt="正交投影" src="../_static/12/orthographic_projections.png" /></p>
<p>这种投影对于绘制二维物体是非常方便的因为它“忽略”了Z坐标的值也就是说忽略了到屏幕的距离。使用这种投影物体大小不会随着距离的增大而减小不同于透视投影。为了使用正交投影投影物体我们需要使用另一个矩阵即正交投影矩阵正交投影矩阵的公式如下所示</p>
<p><img alt="正交投影矩阵" src="../_static/12/orthographic_matrix.png" /></p>
<p>这个矩阵还矫正了失真,因为我们的窗口并不总是完美的正方形,而是一个矩形。<code>right</code><code>bottom</code>是屏幕大小,而<code>left</code><code>top</code>是原点坐标。正交投影矩阵用于将屏幕坐标转换为三维空间坐标。下图展现了该投影的映射过程:</p>
<p><img alt="正交投影示例" src="../_static/12/orthographic_projection_sample.png" /></p>
<p>该矩阵将允许我们使用屏幕坐标。</p>
<p>我们现在可以继续实现HUD了。接下来要做的是创建另一组着色器一个顶点着色器和一个片元着色器来绘制HUD。顶点着色器很简单</p>
<pre><code class="language-glsl">#version 330
layout (location=0) in vec3 position;
layout (location=1) in vec2 texCoord;
layout (location=2) in vec3 vertexNormal;
out vec2 outTexCoord;
uniform mat4 projModelMatrix;
void main()
{
gl_Position = projModelMatrix * vec4(position, 1.0);
outTexCoord = texCoord;
}
</code></pre>
<p>它仅接收顶点坐标、纹理坐标、索引和法线,并将使用矩阵将它们转换为三维空间坐标,该矩阵是正交投影矩阵与模型矩阵的乘积,即<script type="math/tex">projModelMatrix = 正交投影矩阵 \cdot 模型矩阵</script>。由于我们没有在世界坐标系中对坐标做任何处理所以在Java代码中将两个矩阵相乘比在着色器中相乘更高效。这样我们只需为每个项目做一次矩阵乘法运算而不是为每个顶点做一次。还应记住顶点应该用屏幕坐标表示。</p>
<p>片元着色器也很简单:</p>
<pre><code class="language-glsl">#version 330
in vec2 outTexCoord;
in vec3 mvPos;
out vec4 fragColor;
uniform sampler2D texture_sampler;
uniform vec4 colour;
void main()
{
fragColor = colour * texture(texture_sampler, outTexCoord);
}
</code></pre>
<p>它只是将基本颜色与纹理颜色相乘,这样可以改变渲染文本的颜色,而不需要创建多个纹理文件。现在既然已经创建了一组新的着色器,就可以在<code>Renderer</code>类中使用它们。但在此之前,我们要创建一个名为<code>IHud</code>的接口该接口储存所有要在HUD上显示的元素并提供一个默认的<code>cleanup</code>方法。</p>
<pre><code class="language-java">package org.lwjglb.engine;
public interface IHud {
GameItem[] getGameItems();
default void cleanup() {
GameItem[] gameItems = getGameItems();
for (GameItem gameItem : gameItems) {
gameItem.getMesh().cleanUp();
}
}
}
</code></pre>
<p>通过该接口不同的游戏可以定义自定义的HUD而不需要改变渲染机制。现在回到<code>Renderer</code>类,顺便一提,它已经被移动到<code>engine.graph</code>包下,因为现在它的通用性足以不依赖任何游戏的具体实现了。在<code>Renderer</code>类中,我们添加了一个新的方法来创建、连接和初始化一个新的<code>ShaderProgram</code>,以便使用上述所示的着色器。</p>
<pre><code class="language-java">private void setupHudShader() throws Exception {
hudShaderProgram = new ShaderProgram();
hudShaderProgram.createVertexShader(Utils.loadResource(&quot;/shaders/hud_vertex.vs&quot;));
hudShaderProgram.createFragmentShader(Utils.loadResource(&quot;/shaders/hud_fragment.fs&quot;));
hudShaderProgram.link();
// 为正交投影模型矩阵和颜色创建Uniform
hudShaderProgram.createUniform(&quot;projModelMatrix&quot;);
hudShaderProgram.createUniform(&quot;colour&quot;);
}
</code></pre>
<p><code>render</code>方法首先会调用<code>renderScene</code>方法,其中包含了此前章节所述的渲染三维场景的代码,然后调用一个名为<code>renderHud</code>的新方法用于渲染HUD。</p>
<pre><code class="language-java">public void render(Window window, Camera camera, GameItem[] gameItems,
SceneLight sceneLight, IHud hud) {
clear();
if ( window.isResized() ) {
glViewport(0, 0, window.getWidth(), window.getHeight());
window.setResized(false);
}
renderScene(window, camera, gameItems, sceneLight);
renderHud(window, hud);
}
</code></pre>
<p><code>renderHud</code>方法实现如下:</p>
<pre><code class="language-java">private void renderHud(Window window, IHud hud) {
hudShaderProgram.bind();
Matrix4f ortho = transformation.getOrthoProjectionMatrix(0, window.getWidth(), window.getHeight(), 0);
for (GameItem gameItem : hud.getGameItems()) {
Mesh mesh = gameItem.getMesh();
// HUD元素的正交投影矩阵与模型矩阵相乘
Matrix4f projModelMatrix = transformation.getOrtoProjModelMatrix(gameItem, ortho);
hudShaderProgram.setUniform(&quot;projModelMatrix&quot;, projModelMatrix);
hudShaderProgram.setUniform(&quot;colour&quot;, gameItem.getMesh().getMaterial().getAmbientColour());
// 渲染此HUD项目的网格
mesh.render();
}
hudShaderProgram.unbind();
}
</code></pre>
<p>上述代码中我们遍历了HUD的所有元素并将与每个元素关联的模型矩阵和正交投影矩阵相乘。正交投影矩阵在每次<code>render</code>调用时被刷新(因为屏幕大小可以被改变),并且通过如下方式计算:</p>
<pre><code class="language-java">public final Matrix4f getOrthoProjectionMatrix(float left, float right, float bottom, float top) {
orthoMatrix.identity();
orthoMatrix.setOrtho2D(left, right, bottom, top);
return orthoMatrix;
}
</code></pre>
<p>我们将在<code>game</code>包中创建一个<code>Hud</code>类,它实现了<code>IHud</code>接口,并在构造函数接收一个文本,用于在其中创建<code>TextItem</code>实例。</p>
<pre><code class="language-java">package org.lwjglb.game;
import org.joml.Vector4f;
import org.lwjglb.engine.GameItem;
import org.lwjglb.engine.IHud;
import org.lwjglb.engine.TextItem;
public class Hud implements IHud {
private static final int FONT_COLS = 15;
private static final int FONT_ROWS = 17;
private static final String FONT_TEXTURE = &quot;textures/font_texture.png&quot;;
private final GameItem[] gameItems;
private final TextItem statusTextItem;
public Hud(String statusText) throws Exception {
this.statusTextItem = new TextItem(statusText, FONT_TEXTURE, FONT_COLS, FONT_ROWS);
this.statusTextItem.getMesh().getMaterial().setColour(new Vector4f(1, 1, 1, 1));
gameItems = new GameItem[]{statusTextItem};
}
public void setStatusText(String statusText) {
this.statusTextItem.setText(statusText);
}
@Override
public GameItem[] getGameItems() {
return gameItems;
}
public void updateSize(Window window) {
this.statusTextItem.setPosition(10f, window.getHeight() - 50f, 0);
}
}
</code></pre>
<p><code>DummyGame</code>类中我们创建该类的实例,并用默认文本初始化它,最后得到如下所示的结果:</p>
<p><img alt="文本渲染结果" src="../_static/12/text_result.png" /></p>
<p><code>Texture</code>类中可以通过修改纹理的过滤方式来提升文本的可读性(如果需要文本缩放的话需要注意此事)。</p>
<pre><code class="language-java">glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST);
glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST);
</code></pre>
<p>但是本例还没有做完。如果用缩放使文本与立方体重叠时,就会看到如下效果:</p>
<p><img alt="背景不透明的文本" src="../_static/12/text_opaque.png" /></p>
<p>绘制的文本背景不透明。为了实现背景透明我们必须明确启用混合Blend这样就可以使用Alpha分量。本例将在<code>Window</code>类中用下述代码设置其初始化参数:</p>
<pre><code class="language-java">// 支持透明
glEnable(GL_BLEND);
glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA);
</code></pre>
<p>现在你可以看到文本以透明背景绘制了。</p>
<p><img alt="透明背景的文本" src="../_static/12/text_transparent.png" /></p>
<h2 id="hud">完善HUD</h2>
<p>现在我们已经渲染了一些文本但还可以向HUD添加更多的元素。本例将添加一个根据摄像机朝向旋转的指针。现在我们将向<code>Hud</code>类添加一个新的<code>GameItem</code>,它将包含一个指针的模型网格。</p>
<p><img alt="指针" src="../_static/12/compass.png" /></p>
<p>指针的模型是.obj文件但它不会关联任何纹理相反它只有一个基础色。所以需要修改HUD的片元着色器以确认是否使用纹理。本例将通过设置一个名为<code>hasTexture</code>的新Uniform来实现它。</p>
<pre><code class="language-glsl">#version 330
in vec2 outTexCoord;
in vec3 mvPos;
out vec4 fragColor;
uniform sampler2D texture_sampler;
uniform vec4 colour;
uniform int hasTexture;
void main()
{
if ( hasTexture == 1 )
{
fragColor = colour * texture(texture_sampler, outTexCoord);
}
else
{
fragColor = colour;
}
}
</code></pre>
<p>要将指针添加到HUD上只需在<code>Hud</code>类中创建一个新的<code>GameItem</code>实例。它加载指针模型,并将其添加到项目列表中。在本例中需要放大指针,因为它在屏幕坐标系中渲染,所以通常你需要放大它。</p>
<pre><code class="language-java">// 创建指针
Mesh mesh = OBJLoader.loadMesh(&quot;/models/compass.obj&quot;);
Material material = new Material();
material.setAmbientColour(new Vector4f(1, 0, 0, 1));
mesh.setMaterial(material);
compassItem = new GameItem(mesh);
compassItem.setScale(40.0f);
// 旋转以将其变换到屏幕坐标系
compassItem.setRotation(0f, 0f, 180f);
// 创建一个数组用于储存HUD项目
gameItems = new GameItem[]{statusTextItem, compassItem};
</code></pre>
<p>还要注意为了使指针指向上方我们需要将其旋转180°因为模型通常倾向于使用OpenGL空间坐标系。如果我们要使用屏幕坐标它会指向下方。<code>Hud</code>类还提供一个方法来更新指针的指向,该方法也必须考虑到这一点。</p>
<pre><code class="language-java">public void rotateCompass(float angle) {
this.compassItem.setRotation(0, 0, 180 + angle);
}
</code></pre>
<p><code>DummyGame</code>类中每当摄像机移动时我们需要用Y角旋转更新角度。</p>
<pre><code class="language-java">// 根据鼠标更新摄像机
if (mouseInput.isRightButtonPressed()) {
Vector2f rotVec = mouseInput.getDisplVec();
camera.moveRotation(rotVec.x * MOUSE_SENSITIVITY, rotVec.y * MOUSE_SENSITIVITY, 0);
// 更新HUD指针
hud.rotateCompass(camera.getRotation().y);
}
</code></pre>
<p>我们会看到这样的结果(记住这只是个示例,在实际的游戏中,你可能想使用一些纹理设置指针的外观)。</p>
<p><img alt="有指针的HUD" src="../_static/12/hud_compass.png" /></p>
<h2 id="_2">再谈文本渲染</h2>
<p>在回顾其他主题之前让我们再谈谈之前介绍的文本渲染方法。该方案非常简洁地介绍了渲染HUD所涉及的概念但它存在一些问题</p>
<ul>
<li>它不支持非拉丁字符。</li>
<li>如果你想使用多种字体,则需要为每种字体创建单独的纹理文件。此外,改变文本大小的唯一方法是缩放,这会导致渲染文本的质量较差,或者需要创建额外的纹理文件。</li>
<li>最重要的是,大多数字体中的字符之间的大小并不同,而我们将字体纹理分割成同样大小的元素。我们使用了<a href="https://en.wikipedia.org/wiki/Monospaced_font">Monospaced</a>风格即所有字符具有相同的宽度的“Consolas”字体但如果使用非Monospaced的字体就会看到字符之间恼人的空白。</li>
</ul>
<p>我们需要更改方法,并提供一种更灵活的渲染文本方式。如果你仔细想想,整体想法是可行的,也就是通过单独渲染每个字符的矩形来渲染文本。这里的问题就是该如何生成纹理,我们需要通过系统中可用的字体动态地生成这些纹理。</p>
<p>这就需要<code>java.awt.Font</code>出手了,我们将通过指定字体系列和大小动态地绘制每一个字符来生成纹理。该纹理的使用方式与之前描述的相同,但它将完美地解决上述所有问题。我们将创建一个名为<code>FontTexture</code>的新类,该类将接收<code>Font</code>实例和字符集名称,并将动态地创建包含所有可用字符的纹理。构造函数如下所示:</p>
<pre><code class="language-java">public FontTexture(Font font, String charSetName) throws Exception {
this.font = font;
this.charSetName = charSetName;
charMap = new HashMap&lt;&gt;();
buildTexture();
}
</code></pre>
<p>首先要处理非拉丁字符问题。给定字符集和字体,我们将构建一个包含所有可渲染字符的<code>String</code></p>
<pre><code class="language-java">private String getAllAvailableChars(String charsetName) {
CharsetEncoder ce = Charset.forName(charsetName).newEncoder();
StringBuilder result = new StringBuilder();
for (char c = 0; c &lt; Character.MAX_VALUE; c++) {
if (ce.canEncode(c)) {
result.append(c);
}
}
return result.toString();
}
</code></pre>
<p>让我们来看看实际创建纹理的<code>buildTexture</code>方法:</p>
<pre><code class="language-java">private void buildTexture() throws Exception {
// 使用FontMetrics获取每个字符的信息
BufferedImage img = new BufferedImage(1, 1, BufferedImage.TYPE_INT_ARGB);
Graphics2D g2D = img.createGraphics();
g2D.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON);
g2D.setFont(font);
FontMetrics fontMetrics = g2D.getFontMetrics();
String allChars = getAllAvailableChars(charSetName);
this.width = 0;
this.height = fontMetrics.getHeight();
for (char c : allChars.toCharArray()) {
// 获取每个字符的大小,并更新图像的大小
CharInfo charInfo = new CharInfo(width, fontMetrics.charWidth(c));
charMap.put(c, charInfo);
width += charInfo.getWidth() + CHAR_PADDING;
}
g2D.dispose();
</code></pre>
<p>我们首先通过创建临时图像来获得<code>FontMetrics</code>,然后遍历包含所有可用字符的<code>String</code>,并在<code>FontMetrics</code>的帮助下获取每个字符的宽度。我们将这些信息储存在一个<code>charMap</code>映射上,以字符作为映射的键。这样,我们就确定了纹理图像的大小(图像的高度等于所有字符的最大高度,而宽度等于所有字符的宽度总和)。<code>ChatSet</code>是一个内部类,它储存有关字符的信息(它的宽度和它在纹理图像中的起点)。</p>
<pre><code class="language-java"> public static class CharInfo {
private final int startX;
private final int width;
public CharInfo(int startX, int width) {
this.startX = startX;
this.width = width;
}
public int getStartX() {
return startX;
}
public int getWidth() {
return width;
}
}
</code></pre>
<p>然后,我们将创建一个储存所有可用字符的图像,只需在<code>BufferedImage</code>上绘制字符串即可。</p>
<pre><code class="language-java"> // 创建与字符集相关的图像
img = new BufferedImage(width, height, BufferedImage.TYPE_INT_ARGB);
g2D = img.createGraphics();
g2D.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON);
g2D.setFont(font);
fontMetrics = g2D.getFontMetrics();
g2D.setColor(Color.WHITE);
int startX = 0;
for (char c : allChars.toCharArray()) {
CharInfo charInfo = charMap.get(c);
g2D.drawString(&quot;&quot; + c, startX, fontMetrics.getAscent());
startX += charInfo.getWidth() + CHAR_PADDING;
}
g2D.dispose();
</code></pre>
<p>我们正在生成一个包含所有字符的单行图像(可能不满足纹理大小应该为二的幂的前提,但是它仍适用于大多数现代显卡。在任何情况下,你都可以通过增加额外的空白来解决这个问题)。你也可以查看生成的图像,在上述代码之后,添加下述的一行代码:</p>
<pre><code class="language-java">ImageIO.write(img, IMAGE_FORMAT, new java.io.File(&quot;Temp.png&quot;));
</code></pre>
<p>图像将被写入一个临时文件。该文件将包含一个在白色背景下,使用抗锯齿绘制所有可用字符的长条。</p>
<p><img alt="字体纹理" src="../_static/12/texture_font.png" /></p>
<p>最后只需要从该图像创建一个<code>Texture</code>实例我们只需使用PNG格式这就是<code>Texture</code>类所期望的)转储图像字节。</p>
<pre><code class="language-java"> ByteBuffer buf = null;
try ( ByteArrayOutputStream out = new ByteArrayOutputStream()) {
ImageIO.write(img, IMAGE_FORMAT, out);
out.flush();
byte[] data = out.toByteArray();
buf = ByteBuffer.allocateDirect(data.length);
buf.put(data, 0, data.length);
buf.flip();
}
texture = new Texture(buf);
}
</code></pre>
<p>你可能注意到,我们已经稍微修改了<code>Texture</code>类,使其具有一个接收<code>ByteBuffer</code>的构造函数。其中这个新的构造函数使用<code>stbi_load_from_memory</code>加载图片。现在我们只需更改<code>TextItem</code>类,以便在其构造函数中接收<code>FontTexture</code>实例。</p>
<pre><code class="language-java">public TextItem(String text, FontTexture fontTexture) throws Exception {
super();
this.text = text;
this.fontTexture = fontTexture;
setMesh(buildMesh());
}
</code></pre>
<p>只需要在设置片段坐标和纹理坐标时稍稍修改<code>buildMesh</code>方法,下述代码是其中一个顶点的示例:</p>
<pre><code class="language-java"> float startx = 0;
for(int i=0; i&lt;numChars; i++) {
FontTexture.CharInfo charInfo = fontTexture.getCharInfo(characters[i]);
// 构造由两个三角形组成的字符片段
// 左上角顶点
positions.add(startx); // x
positions.add(0.0f); // y
positions.add(ZPOS); // z
textCoords.add( (float)charInfo.getStartX() / (float)fontTexture.getWidth());
textCoords.add(0.0f);
indices.add(i*VERTICES_PER_QUAD);
// 更多代码...
startx += charInfo.getWidth();
}
</code></pre>
<p>你可以在源代码中查阅其他更改。下图是一个大小为20的Arial字体的渲染效果</p>
<p><img alt="改进后的文本" src="../_static/12/text_rendered_improved.png" /></p>
<p>如你所见文本渲染的质量已经有了很大的提升,你可以用不同的字体和大小来渲染。这仍然有很大的改进空间(如支持多行文本、特效等),但这将留给各位读者作为练习。</p>
<p>你可能还注意到我们仍然能够缩放文本通过着色器中的模型观察矩阵。现在的文本可能不需要缩放但对其他的HUD元素可能会有用。</p>
<p>我们已经确立了所有的基本数据结构以便为游戏创建一个HUD。现在只剩一个问题那就是创建所有的元素传递相关信息给用户并给他们一个专业的外观。</p>
<h2 id="osx">OSX</h2>
<p>如果你试图运行本章中的示例以及下一个渲染文本的示例则可能会发现应用程序阻塞屏幕上不会显示任何内容。这是由于AWT和GLFW在OSX下相处得不太好但这和AWT有什么关系呢我们使用的是<code>Font</code>它属于AWT如果要实例化它AWT也需要初始化。在OSX中AWT试图在主线程运行但GLFW也需要在主线程运行这就是造成此问题的原因。</p>
<p>为了能够使用<code>Font</code>GLFW必须在AWT之前初始化并且示例需要以Headless模式运行。你需要在任何东西被初始化之前设置此属性</p>
<pre><code class="language-java">System.setProperty(&quot;java.awt.headless&quot;, &quot;true&quot;);
</code></pre>
<p>你也许会收到一个警告,但示例成功运行了。</p>
<p>一个更简洁的方法是使用<a href="https://github.com/nothings/stb/">stb</a>库来渲染文本。</p>
</div>
</div><footer>
<div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
<a href="../11-let-there-be-even-more-light/" class="btn btn-neutral float-left" title="要有更多的光"><span class="icon icon-circle-arrow-left"></span> Previous</a>
<a href="../13-sky-box-and-some-optimizations/" class="btn btn-neutral float-right" title="天空盒与一些优化">Next <span class="icon icon-circle-arrow-right"></span></a>
</div>
<hr/>
<div role="contentinfo">
<!-- Copyright etc -->
<p>2019, Mouse0w0</p>
</div>
Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<div class="rst-versions" role="note" aria-label="Versions">
<span class="rst-current-version" data-toggle="rst-current-version">
<span>
<a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
</span>
<span><a href="../11-let-there-be-even-more-light/" style="color: #fcfcfc">&laquo; Previous</a></span>
<span><a href="../13-sky-box-and-some-optimizations/" style="color: #fcfcfc">Next &raquo;</a></span>
</span>
</div>
<script src="../js/jquery-3.6.0.min.js"></script>
<script>var base_url = "..";</script>
<script src="../js/theme_extra.js"></script>
<script src="../js/theme.js"></script>
<script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
<script src="../search/main.js"></script>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>