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教程(十)绘制文本

然后呢?

这篇只是对于文本绘做一个简单的介绍,在Direct2D与文本相关的东西远不止这些,在后续的DirectWrite系列中会详细阐述每个方面,敬请关注!

你可能感兴趣的:(教程)