ID3DXFont::PreloadGlyphs

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

HRESULT PreloadGlyphs(
  UINT First,
  UINT Last
);

Parameters

First

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

Last

[in] ID of the last glyph 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 that contain the input glyphs. The glyphs are drawn as a series of triangles.

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

Requirements

Header: Declared in D3dx9core.h.