初学Direct X(9) ——文字的显示
初学Direct X(9)
——文字的显示
本次学习如何使用ID3DXFont创建字体,使得我们可以在任何安装了Windows系统中TrueType字体来打印文字,不过最好使用标准字体,这样文字在每一台PC上的显示才会和计划中的一样。
1. 显示前的准备
就像创建LPDIRECT3DDEVICE9一样,我们需要先声明一个接口:
LPD3DXFONT font = NULL;
接着设置创建字体所需要的参数:
typedef struct _D3DXFONT_DESCA
{
INT Height;
UINT Width;
UINT Weight;
UINT MipLevels;
BOOL Italic;
BYTE CharSet;
BYTE OutputPrecision;
BYTE Quality;
BYTE PitchAndFamily;
CHAR FaceName[LF_FACESIZE];
} D3DXFONT_DESCA, *LPD3DXFONT_DESCA;
不用害怕,这里面的大多数参数都是可以设置为默认值的,但是也有几个是我们真正需要的,诸如Height和FaceName,它们分别控制着字体的大小和类型。以下是一个创建示例:
D3DXFONT_DESC desc = {
24, // Height
0,
0,
0,
false,
DEFAULT_CHARSET,
OUT_TT_PRECIS,
CLIP_DEFAULT_PRECIS,
DEFAULT_PITCH,
"Arial" // FaceName
};
有了创建所需要的参数,下面就是开始创建字体对象了,可以发现它需要三个参数:
1)Direct3D设备:以便将设备与字体关联起来
2)D3DXFONT_DESC
3)LPD3DXFONT
HRESULT D3DXCreateFontIndirectA(
LPDIRECT3DDEVICE9 pDevice,
CONST D3DXFONT_DESCA* pDesc,
LPD3DXFONT* ppFont);
以下是一个调用示例:
D3DXCreateFontIndirect(d3ddev,&desc,&font);
到这就完成了显示字体钱所需要的一切了。
2. 显示文字
使用ID3DXFont::DrawText可以打印文字到屏幕上:
INT DrawText(
[in] LPD3DXSPRITE pSprite,
[in] LPCTSTR pString,
[in] INT Count,
[in] LPRECT pRect,
[in] DWORD Format,
[in] D3DCOLOR Color
);
pSprite:可以为NULL,不过为了提高程序运行效率最好事先声明
Count:文本的长度
pRect:显示区域
Format:文本的格式化,比如DT_RIGHT,它可以使得文本右对齐显示,详细的可以参照文档
在MSDN的文档中可以看到ID3DXFont::DrawText是支持ANSI以及Unicode的字符串的,即支持中文。
在设置相关参数之后,让我们看看调用的示例:
RECT rect;
rect = { 0, 0, 100, 100 };
color = D3DCOLOR_XRGB(255, 255, 255);
string text = "我皮一下挺开心";
// ...
font->DrawTextA(spriteobj,text.c_str(),text.length(),&rect,DT_CENTER,color);
显示效果如图1所示:
图1
3. 文字折行显示
如果我要输出的文字足够多,多到大于pRect的width,那么会出现什么情况呢?由于文字一行太长,于是就显示不出来了,就想图2这样:
图2
解决方法有如下两种:
1)手动折行
2)动态折行
3.1 手动折行
将要输出文字中需要折行位置添加'\n':
string text = "我皮一下挺开心1,\n我皮一下挺开心2,\n我皮一下挺开心3,\n我皮一下挺开心4,\n我皮一下挺开心5,\n我皮一下挺开心6,\n我皮一下挺开心7。";
其他不需要改动,效果如图3所示,由于受制于pRect中height的影响,没有全部显示:
图3
3.2 动态折行
这只需要在DrawTextA的Format传为DT_WORDBREAK,即
font->DrawTextA(spriteobj, text.c_str(), text.length(), &rect, DT_WORDBREAK, color);
显示效果如图4所示:
图4