Direct2D教程（十）绘制文本
概述
在Direct2D中，文本的绘制是通过DirectWrite来实现的，DirectWrite实际上已经是一个独立的DirectX组件了。关于DirectWrite，我摘录了MSDN的一段文字。
DirectWrite介绍
当今的应用程序应提供高质量的文本渲染，分辨率无关的字体及完整的Unicode文本和布局支持，DirectWrite提供了这些功能，甚至比这更多。下面是DirectWrite的特性
- 设备无关的文本布局系统，提高了文本的可读性（包括文档及UI上的文本）
- 高质量的，子像素，ClearType文本的渲染（可以使用GDI及Direct2D或应用程序指定的渲染技术）
- 硬件加速的文本渲染（和Direct2D一起使用时）
- 支持多格式文本
- 支持OpenType fonts的高级typography特性
- 对所支持语言文本的渲染及布局。
- GDI兼容的布局及渲染
DirectWrite API支持多格式文本的度量，绘制及命中测试。DirectWrite处理所有支持语言的文本，包括global及localized应用程序（构建于Windows7核心语言基础之上）。DirectWrite也提供了底层的glyph渲染。
Direct2D提供了如下两个绘制文本的函数，稍后的代码使用第一个函数。
- ID2D1RenderTarget::DrawText
- ID2D1RenderTarget::DrawTextLayout
主要步骤
这里介绍的步骤都是与绘制文本相关的核心步骤，其它步骤比如创建render target或者画刷，处理Windows消息等是每个Direct2D程序都会涉及的，这里就不再介绍了。
创建ID2D1Factory接口对象
凡事都有个根源，程序也是一样，在Direct2D中也有一个根源对象，那就是ID2D1Factory接口，它是所有其它资源的根源，包括设备相关的资源及设备无关的资源，有了这个接口，就可以创建其它的D2D对象了，比如render target，画刷等。所以首要任务是创建一个ID2D1Factory对象。
D2D1Factory* g_pD2DFactory = NULL; HRESULT hr = D2D1CreateFactory( D2D1_FACTORY_TYPE_SINGLE_THREADED, &g_pD2DFactory ); if(FAILED(hr)) { MessageBox(NULL, L"Create Direct2D factory failed!", L"Error", 0); return; }
创建IDWriteFactory接口对象
前面说了，在Direct2D中绘制文本实际上是通过DirectWrite来实现的，一切和文本相关的接口也都是由这个接口来创建的，所以接下来要创建一个IDWriteFactory接口对象，代码如下。
IDWriteFactory* g_pDWriteFactory = NULL; // Create DirectWrite Factory hr = DWriteCreateFactory( DWRITE_FACTORY_TYPE_SHARED, __uuidof(IDWriteFactory), reinterpret_cast<IUnknown**>(&g_pDWriteFactory) ); if(FAILED(hr)) { MessageBox(NULL, L"Create DirectWrite factory failed!", L"Error", 0); return; }
创建IDWriteTextFormat接口对象
文本有一系列属性，比如字体类型，Arial还是Consolas？字体大小，14px还是16px? 字体风格，倾斜或加粗？在D2D中，用IDWriteTextFormat来描述文本的这些属性，所以，下一步需要创建IDWriteTextFormat对象了。需要注意的是文本的颜色并不是由该接口来控制的，而是由画刷来控制。
IDWriteTextFormat* g_pTextFormat = NULL; hr = g_pDWriteFactory->CreateTextFormat( L"Gabriola", // Font family name NULL, // Font collection(NULL sets it to the system font collection) DWRITE_FONT_WEIGHT_REGULAR, // Weight DWRITE_FONT_STYLE_NORMAL, // Style DWRITE_FONT_STRETCH_NORMAL, // Stretch 50.0f, // Size L"en-us", // Local &g_pTextFormat // Pointer to recieve the created object ); if(FAILED(hr)) { MessageBox(NULL, L"Create IDWriteTextFormat failed!", L"Error", 0); return; }
定义文本绘制区域
下一步，需要确定文本的绘制区域，也就是在哪里绘制文本，这个区域通常是一个矩形结构。所以，只需简单定义一个rect即可。
// Create text layout rect RECT rc; GetClientRect(hwnd, &rc); D2D1_RECT_F textLayoutRect = D2D1::RectF( static_cast<FLOAT>(rc.left), static_cast<FLOAT>(rc.top), static_cast<FLOAT>(rc.right - rc.left), static_cast<FLOAT>(rc.bottom - rc.top) );
绘制
万事俱备，只欠东风！下面就是最后一步也是最重要的一步，渲染文本，这里使用接口ID2D1HwndRenderTarget中的函数DrawText来完成具体的绘制工作，这个函数的具体定义如下：
virtual void DrawText( [in] WCHAR *string, UINT stringLength, [in] IDWriteTextFormat *textFormat, [in] const D2D1_RECT_F *layoutRect, [in] ID2D1Brush *defaultForegroundBrush, D2D1_DRAW_TEXT_OPTIONS options = D2D1_DRAW_TEXT_OPTIONS_NONE, DWRITE_MEASURING_MODE measuringMode = DWRITE_MEASURING_MODE_NATURAL ) = 0;
参数说明：
- string, 待绘制的文本，unicode编码。
- stringLength, 文本长度。
- textFormat, 文本的格式化信息（属性），上面提到过。
- layoutRect, 绘制区域对应的矩形。
- defaultForegroundBrush, 绘制文本所用的画刷
最后两个参数暂时用不到，而且有默认参数，这里就不考虑了。调用代码如下。
// Draw text g_pRenderTarget->DrawText( wszText, // Text to render cTextLength, // Text length g_pTextFormat, // Text format textLayoutRect, // The region of the window where the text will be rendered g_pBlackBrush // The brush used to draw the text );
效果图
然后呢？
这篇只是对于文本绘做一个简单的介绍，在Direct2D与文本相关的东西远不止这些，在后续的DirectWrite系列中会详细阐述每个方面，敬请关注！
