ID3DXFont::PreloadCharacters method

Loads a series of characters into video memory to improve the efficiency of rendering to the device.

Syntax

HRESULT PreloadCharacters(
  [in] UINT First,
  [in] UINT Last
);

Parameters

First [in]

Type: UINT

ID of the first character to be loaded into video memory.

Last [in]

Type: UINT

ID of the last character to be loaded into video memory.

Return value

Type: HRESULT

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, D3DXERR_INVALIDDATA.

Remarks

This method generates textures containing glyphs that represent the input characters. The glyphs are drawn as a series of triangles.

Characters will not be rendered to the device; DrawText must still be called to render the characters. However, by pre-loading characters into video memory, DrawText will use substantially fewer CPU resources.

This method internally converts characters to glyphs using the GDI function GetCharacterPlacement.

Requirements

Header
D3dx9core.h
Library
D3dx9.lib

See also

ID3DXFont