添加文本

DXUT框架对文本绘制进行了封装，提供了类CDXUTHelper来简化文本显示，使用该接口大体分为3个步骤：初始化ID3DXSprite和ID3DXFont对象，显示文本，释放ID3DXSprite和ID3DXFont对象。

首先来看看CDXUTHelper的定义部分：

接着来看看CDXUTHelper的实现部分：

以及ID3DXSprite::Begin()的声明：

Prepares a device for drawing sprites.

HRESULT Begin(
  DWORD Flags
);

Parameters

Flags

[in] Combination of zero or more flags that describe sprite rendering options. For this method, the valid flags are:

• D3DXSPRITE_ALPHABLEND
• D3DXSprite__BILLBOARD
• D3DXSPRITE_DONOTMODIFY_RENDERSTATE
• D3DXSPRITE_DONOTSAVESTATE
• D3DXSPRITE_OBJECTSPACE
• D3DXSprite__SORT_DEPTH_BACKTOFRONT
• D3DXSprite__SORT_DEPTH_FRONTTOBACK
• D3DXSprite__SORT_TEXTURE

For a description of the flags and for information on how to control device state capture and device view transforms, see D3DXSPRITE.

Return Values

If the method succeeds, the return value is S_OK. If the method fails, the return value can be one of the following: D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Remarks

This method must be called from inside a IDirect3DDevice9::BeginScene . . . IDirect3DDevice9::EndScene sequence. ID3DXSprite::Begin cannot be used as a substitute for either IDirect3DDevice9::BeginScene or ID3DXRenderToSurface::BeginScene.

This method will set the following states on the device.

Render States:

Texture Stage States:

Sampler States:

Note    This method disables N-patches.

D3DXSPRITE

The following flags are used to specify sprite rendering options to the flags parameter in the ID3DXSprite::Begin method:

初始化ID3DXSprite和ID3DXFont对象

在回调函数OnCreateDevice()中创建ID3DXFont对象：

//--------------------------------------------------------------------------------------
// Create any D3DPOOL_MANAGED resources here 
//--------------------------------------------------------------------------------------
HRESULT CALLBACK OnCreateDevice( IDirect3DDevice9* pd3dDevice, const D3DSURFACE_DESC* pBackBufferSurfaceDesc, 
								 void* pUserContext )
{
	D3DXCreateFont(pd3dDevice, 18, 0, FW_BOLD, 1, FALSE, DEFAULT_CHARSET, OUT_DEFAULT_PRECIS, DEFAULT_QUALITY,
				   DEFAULT_PITCH | FF_DONTCARE, L"Arial", &g_font);

    return S_OK;
}

绘制文本

//--------------------------------------------------------------------------------------
// Render the helper information
//--------------------------------------------------------------------------------------
void RenderText()
{
	CDXUTTextHelper text_helper(g_font, g_text_sprite, 20);
	

	text_helper.Begin();

	// show frame and device states
	text_helper.SetInsertionPos(5, 5);
	text_helper.SetForegroundColor( D3DXCOLOR(1.0f, 0.475f, 0.0f, 1.0f) );
	text_helper.DrawTextLine( DXUTGetFrameStats(true) );
	text_helper.DrawTextLine( DXUTGetDeviceStats() );

	// show other simple information
	text_helper.SetForegroundColor( D3DXCOLOR(1.0f, 1.0f, 1.0f, 1.0f) );
	text_helper.DrawTextLine(L"Put whatever misc status here");

	// show helper information
	

	const D3DSURFACE_DESC* surface_desc = DXUTGetBackBufferSurfaceDesc();

	if(g_show_help)
	{
		text_helper.SetInsertionPos(10, surface_desc->Height - 15 * 6);
		text_helper.SetForegroundColor( D3DXCOLOR(1.0f, 0.475f, 0.0f, 1.0f) );
		text_helper.DrawTextLine(L"Controls (F1 to hide):");
		

		text_helper.SetInsertionPos(40, surface_desc->Height - 15 * 5);
		text_helper.DrawTextLine(L"Quir: ESC");
	}
	else
	{
		text_helper.SetInsertionPos(10, surface_desc->Height - 15 * 4);
		text_helper.SetForegroundColor( D3DXCOLOR(1.0f, 1.0f, 1.0f, 1.0f) );
		text_helper.DrawTextLine(L"Press F1 for help");
	}

	text_helper.End();
}

处理键盘消息

程序通过键盘上的"F1"键切换来表明是否显示简单帮助文本，处理代码如下：

//--------------------------------------------------------------------------------------
// Handle keybaord event
//--------------------------------------------------------------------------------------
void CALLBACK OnKeyboardProc(UINT charater, bool is_key_down, bool is_alt_down, void* user_context)
{
	if(is_key_down)
	{
		switch(charater)
		{
		case VK_F1:
			g_show_help = !g_show_help;
			break;
		}
	}
}

运行效果图：

主程序：

下载示例工程