【汉化资料】开源的图形渲染引擎OGRE(2) --让OGRE支持中文

shane007

如何修改字幕输出函数，也许这篇文章可以参考。
4 i4 j9 w3 c& \5 k/ i( Q5 C8 B
6 u8 ?6 ~$ }, V" H
让OGRE支持中文 (转贴)

2 c2 O$ v0 o! c- z6 g
0．前言：
本人非计算机专业，凭着爱好和一腔热血混入游戏开发大军候补小队，平面尚未钻透。为赶时髦，企图叛变到3D阵营，慌乱之中捡起“OGRE”。学到如今，亦可让正方体飞机等不明物体在三次元空间胡乱打转。但觉得本引擎不支持中文显示而感到不爽，便四处寻求高人指教，但大部分高人指点说：“自己写引擎算了。”衡量了一下自己份量，觉得“自己写”这件事十年内恐尚难做到。再后来找到3DCastle论坛，经过“bug王”以及“浪客☆龙猫” 两位前辈的指点，也通过高手“renwind”遗留下来的教程，误打误撞竟然自己改出了中文支持，兴奋之余便想写点东西留点纪念。
# y1 ]) H: o3 u1 _" C) {1 b$ P2 K1．准备工作
/ t) m- Y; j, \“bug王”已经通过WINAPI实现了OGRE在Direct7.0下的中文支持，也有高手说这样效率不高，更因为本人基本上是不怎么熟悉WINAPI的，所以就放弃了这种方法。企图直接通过贴图来实现中文显示，毕竟OGRE本身文字输出也是用的这种办法，更好的是OGRE引擎除了普通的“ttf”字体外还支持位图字体（其实“ttf”在引擎中也被Ogre::Font::createTextureFromFont()转换成位图了），基本上就是做一个很大很大的图片，然后上面画满汉字，直接读进去就可以了，问题也就变成了——如何找这个大图片。
幸好GBA游戏的开发者们已经找到了很好的文字来源和取得方法，通过金山的16*16点阵字库得到接近9000个字模，然后通过程序读出并写到2048*2048的单色位图上，转换成“png”格式图片才221k。
2．基本知识
修改引擎之前，我们先要知道OGRE是如何显示字体的。OGRE本身面向对象的设计和自带文档都做得非常规范漂亮，很容易就能找到关于显示文字的类以及相关函数。在这里主要看一下关于位图字体是如何显示在画面上。(1)字体的读取。
  ]& E  ~; p% s和这项功能相关的有两个类，一个是Ogre::FontManager类，负责分析字体信息（*.fontdef）文件。然后用builder模式构建一个Ogre::Font类。在Font类中最重要的数据莫过于mTexCoords_u1、mTexCoords_u2、mTexCoords_v1、mTexCoords_v2这四个数组，他们分别用来储存不同文字对应在图片上的纹理坐标。 不过数组大小明显不够储存9000个汉字的，一会儿要改的。
3 h! x8 ~, K) n7 z* w(2)字体的显示。
: b/ T. v/ ]3 b+ }好像字体显示中用得较多的是Ogre::TextAreaGuiElement类，不过好像还有其他的，我们在这里只看这个吧，估计其他的也大同小异。看了看好像唯一和显示字体有关的函数就是void TextAreaGuiElement::updateGeometry()了，基本上就是根据要写到屏幕上的字串，在Ogre::Font类中得到相应的贴图坐标和贴图，然后画上去，道理也不是很难。
8 `+ M, ]. T% Z6 K3．动手术
目标锁定到Ogre::Font，Ogre::FontManager，Ogre::TextAreaGuiElement三个类中，把所有文件备份一遍手术开始！
# |, y9 W! D8 }! L(1) Ogre::Font类。
6 M5 W8 r$ ]4 P) d9 c) e+ B. @3 u  t首先是储存文字贴图坐标的数组的大小不够，原来定义的是——宽字符集 (1024 - 32)、ASCII(256 - 32)。这点点大小怎么够我近9000字大军进入，索性都改成(9030 - 32)。还有就是set和get文字贴图的id都是char类型数据，256个id也不够分配给汉字，看来要都改成unsigned long形（其实大部分机器上int也是32位，不过long是固定32位的类型，感觉统用点）。
(2) Ogre::FontManager类。
9 W6 }, S. E6 r# _! w7 w里面从脚本文件中解析贴图坐标的方法是根据单字符的方式，为支持汉字，改成同时可以分析int的。一个汉字对应数字是他的区位码+161（前160个留给了半角字）。
(3) Ogre::TextAreaGuiElement类。
这个是相对比较麻烦的，他要从字串中分辨出到半角字和中文。在这里增加一个std::vector<unsigned long> caption，用来储存分辨的结果。增加以下几行。
, |$ ~8 Z% o1 X: k8 Q5 Jstd::vector<unsigned long> caption;
8 E3 |8 Q- K4 _; d9 y& _unsigned char nTemp;
String::iterator it=mCaption.begin();
2 K" \. [2 ]' A1 Q/ x2 Kfor(;it!=mCaption.end();++it)
0 l1 E( q+ D6 R* ]{
if(unsigned char(*it)<=160)//如果是半角
{
+ x) W- z3 W! y) jcaption.push_back((unsigned char)*it);
}
else//处理全角字符
6 R/ w2 {. M8 Q: K0 ?{
2 ~. D( e* k' Y! m& F  |, d! }nTemp=(unsigned char)(*it);
++it;
if(it==mCaption.end())
: A0 |/ H+ f2 c4 G: K0 p( bbreak;
//下面是得到区位码+161的公式。
( y/ G, U+ P6 ~! T, q  Bcaption.push_back((94*(nTemp-0xa0-1)+((unsigned char)(*it)-0xa0-1))+161);
4 E5 k; g6 }) H, f/ ?( X3 v0 X}
/ e# g1 L/ H' w# S- l5 _; e}
然后后面所有关于mCaption的地方都用caption代替就ok了。
! U) P. _) n1 x! d# n4．结果。
在OpenGL和DX9.0中成功的支持了中文，但是DX7.0中竟然出现了运行错误，具体问题还不清楚，还望各位高手指教。
因为字体本身原因，文字很扁平的不好看，索性又改了改Ogre::Font，Ogre::FontManager两个类，实现脚本中支持修改文字纵横比例的系数的proportion，当这个值设置为0.8的时候比较好看了。


9 y8 }1 j9 _. `2 e; N- J  k相关文件
chinese.fontdef//字体信息文件 放在资源文件加中
. Q* d* U. c, r+ g9 Yfont.png//字体图片 放在资源文件加中

4 F" H1 K, O7 O* |OgreFont.cpp
5 M9 k1 Y% f/ oOgreFont.h
/ n- K7 X7 J9 u' a/ P9 z$ IOgreFontManager.cpp
9 s6 c7 f8 X( J1 cOgreTextAreaGuiElement.cpp
//上面文件覆盖同名文件 就可以 先备份
( d4 c3 ~( C  }! @9 _
这个是在ogre-win32-v0-13-1基础上改的，请到
ogre-win32-v0-13-1.zip下载

中文字体名字就叫 Chinese,以后能做中文游戏了！