ID3DXFont::PreloadCharacters

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

HRESULT PreloadCharacters(
  UINT First,
  UINT Last
);

Parameters

First

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

Last

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

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, 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; ID3DXFont::DrawText must still be called to render the characters. However, by pre-loading characters into video memory, ID3DXFont::DrawText will use substantially fewer CPU resources.

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

Requirements

Header: Declared in D3dx9core.h.