Direct3D 10学习笔记（三）——文本输出

本篇将简单整理Direct3D 10的文本输出的实现，具体内容参照《 Introduction to 3D Game Programming with DirectX 10》（中文版有汤毅翻译的电子书《DirectX 10 3D游戏编程入门》）。

1.填充D3DX10_FONT_DESC结构体

D3DX库提供了用于显示文本的ID3DX10Font接口。而要获取一个指向ID3DX10Font对象的指针，需要先填充一个D3DX10_FONT_DESC结构体，该结构体用于描述所创建的字体特征。该结构体定义如下：

typedef struct D3DXFONT_DESC
{
    INT   Height;
    UINT  Width;
    UINT  Weight;
    UINT  MipLevels;
    BOOL  Italic;
    BYTE  CharSet;
    BYTE  OutputPrecision;
    BYTE  Quality;
    BYTE  PitchAndFamily;
    TCHAR FaceName;
}D3DXFONT_DESC, *LPD3DXFONT_DESC;

Height：字体高度。

Width：字体宽度。

Weight：字体权重，即字体的粗细，其枚举以下列宏表示：

 #define FW_DONTCARE 0
 #define FW_THIN 100
 #define FW_EXTRALIGHT 200
 #define FW_LIGHT 300
 #define FW_NORMAL 400
 #define FW_MEDIUM 500
 #define FW_SEMIBOLD 600
 #define FW_BOLD 700
 #define FW_EXTRABOLD 800
 #define FW_HEAVY 900

 #define FW_ULTRALIGHT    FW_EXTRALIGHT
 #define FW_REGULAR    FW_NORMAL
 #define FW_DEMIBOLD    FW_SEMIBOLD
 #define FW_ULTRABOLD    FW_EXTRABOLD
 #define FW_BLACK    FW_HEAVY

MipLevels：过滤属性。当取值为0或者D3DX_DEFAULT时，创建完全Mipmap链。当取值为1时，将纹理空间映射到屏幕空间。

Italic：斜体字。当取值为TRUE时，将字体设置为斜体。

CharSet：指定字符集。通常设置为DEFAULT_CHARSET，表示使用默认字符集，其枚举以下列宏表示：

 #define ANSI_CHARSET 0
 #define DEFAULT_CHARSET 1
 #define SYMBOL_CHARSET 2
 #define SHIFTJIS_CHARSET 128
 #define HANGEUL_CHARSET 129
 #define HANGUL_CHARSET 129
 #define GB2312_CHARSET 134
 #define CHINESEBIG5_CHARSET 136
 #define OEM_CHARSET 255

OutputPrecision：文本输出精度。指定Windows如何把指定的字体大小和实际的字体相配。通常设置为OUT_DEFAULT_PRECIS，其枚举以下列宏表示：

 #define OUT_DEFAULT_PRECIS 0
 #define OUT_STRING_PRECIS 1
 #define OUT_CHARACTER_PRECIS 2
 #define OUT_STROKE_PRECIS 3
 #define OUT_TT_PRECIS 4
 #define OUT_DEVICE_PRECIS 5
 #define OUT_RASTER_PRECIS 6
 #define OUT_TT_ONLY_PRECIS 7
 #define OUT_OUTLINE_PRECIS 8
 #define OUT_SCREEN_OUTLINE_PRECIS 9
 #define OUT_PS_ONLY_PRECIS 10

Quality：字符输出质量。通常设置为DEFAULT_QUALITY，其枚举以下列宏表示：

 #define DEFAULT_QUALITY 0
 #define DRAFT_QUALITY 1
 #define PROOF_QUALITY 2
 #if(WINVER >= 0x0400)
 #define NONANTIALIASED_QUALITY 3
 #define ANTIALIASED_QUALITY 4
 #endif /* WINVER >= 0x0400 */

 #if (_WIN32_WINNT >= _WIN32_WINNT_WINXP)
 #define CLEARTYPE_QUALITY 5
 #define CLEARTYPE_NATURAL_QUALITY 6
 #endif

PitchAndFamily：指定字体间距及字体族。低二位指定字体的字符间距，四位指定字体族，它们分别可取下列值，并用位或符连接：

 #define DEFAULT_PITCH 0
 #define FIXED_PITCH 1
 #define VARIABLE_PITCH 2

 #define FF_DONTCARE (0<<4)
 #define FF_ROMAN (1<<4)
 #define FF_SWISS (2<<4)
 #define FF_MODERN (3<<4)
 #define FF_SCRIPT (4<<4)
 #define FF_DECORATIVE (5<<4)

FaceName：指定字体名称的字符串。类型为TCHAR，即当没有定义_UNICODE宏时，TCHAR = char；当定义了_UNICODE宏时，TCHAR = wchar_t。中文游戏开发使用宽字符类型。若在Visual Studio下使用，可以在项目属性中将字符集改为多字节字符集，这样便能直接使用strcpy等函数，而不必使用对应于宽字符的wcscpy等函数以及使用L""进行包裹的字符串。

D3DX10_FONT_DESC结构体填充示例：

 D3DX10_FONT_DESC fontDesc;
 fontDesc.Height = ;
 fontDesc.Width = ;
 fontDesc.Weight = ;
 fontDesc.MipLevels = ;
 fontDesc.Italic = FALSE;
 fontDesc.CharSet = DEFAULT_CHARSET;
 fontDesc.OutputPrecision = OUT_DEFAULT_PRECIS;
 fontDesc.Quality = DEFAULT_QUALITY;
 fontDesc.PitchAndFamily = DEFAULT_PITCH | FF_DONTCARE;
 strcpy(fontDesc.FaceName, "Times New Roman");

2.获取ID3DX10Font对象的指针

使用D3DX10CreateFontIndirect函数获取ID3DX10Font对象的指针。该函数如下：

 HRESULT D3DX10CreateFontIndirectA(
     ID3D10Device* pDevice,
     CONST D3DX10_FONT_DESCA* pDesc,
     LPD3DX10FONT* ppFont);

pDevice：指向一个有效的ID3D10Device对象的指针。

pDesc：指向D3DX10_FONT_DESC实例的指针。

ppFont：用于返回创建后的字体对象的指针。

获取ID3DX10Font指针示例：

 ID3DX10Font* pFont;
 D3DX10CreateFontIndirect(pd3dDevice, &fontDesc, &pFont);

3.显示文本

使用ID3DX10Font::DrawText方法，其原型如下：

 INT ID3DX10Font::DrawText(
     LPD3DX10SPRITE pSprite,
     LPCTSTR lpString
     INT Count,
     LPRECT pRect,
     UINT Format,
     D3DXCOLOR Color);

pSprite：一个指向ID3DX10Sprite接口的指针。该参数可设为空值，但当每帧绘制的文本数量较多时，更高效的做法是提供自己的sprite接口。

pString：所要绘制的字符串的指针。

Count：字符串中的字符数量。当字符串以空字符（\0）结尾时，该参数可设为−1。

pRect：一个指向RECT结构体的指针，该结构体定义了文本相对于窗口客户区的绘制区域。

Format：绘制文字的格式。其可用格式用下列宏表示：

 #define DT_TOP 0x00000000
 #define DT_LEFT 0x00000000
 #define DT_CENTER 0x00000001
 #define DT_RIGHT 0x00000002
 #define DT_VCENTER 0x00000004
 #define DT_BOTTOM 0x00000008
 #define DT_WORDBREAK 0x00000010
 #define DT_SINGLELINE 0x00000020
 #define DT_EXPANDTABS 0x00000040
 #define DT_TABSTOP 0x00000080
 #define DT_NOCLIP 0x00000100
 #define DT_EXTERNALLEADING 0x00000200
 #define DT_CALCRECT 0x00000400
 #define DT_NOPREFIX 0x00000800
 #define DT_INTERNAL 0x00001000

 #if(WINVER >= 0x0400)
 #define DT_EDITCONTROL 0x00002000
 #define DT_PATH_ELLIPSIS 0x00004000
 #define DT_END_ELLIPSIS 0x00008000
 #define DT_MODIFYSTRING 0x00010000
 #define DT_RTLREADING 0x00020000
 #define DT_WORD_ELLIPSIS 0x00040000
 #if(WINVER >= 0x0500)
 #define DT_NOFULLWIDTHCHARBREAK 0x00080000
 #if(_WIN32_WINNT >= 0x0500)
 #define DT_HIDEPREFIX 0x00100000
 #define DT_PREFIXONLY 0x00200000
 #endif /* _WIN32_WINNT >= 0x0500 */
 #endif /* WINVER >= 0x0500 */

Color：文本颜色。使用D3DXCOLOR结构体表示颜色，包含4个浮点数成员，分别描述颜色的红、绿、蓝和透明度分量。

文本输出示例：

 const D3DXCOLOR BLACK(0.0f, 0.0f, 0.0f, 1.0f);
 RECT R = { , , ,  };
 pFont->DrawText(, "Hello, Direct3D!", -, &R, DT_NOCLIP, BLACK);