d3d9.dllPreloadCharacters
Microsoft DirectX 9.0 SDK Update (October 2004)

ID3DXFont::PreloadCharacters Method


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

Syntax

HRESULT PreloadCharacters(      

    UINT First,     UINT Last );

Parameters

First
[in] Identifier (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 Value

If the method succeeds, the return value is S_OK.

If the method fails, the return value can be one of the following:

D3DERR_INVALIDCALLThe method call is invalid. For example, a method's parameter may have an invalid value.
D3DXERR_INVALIDDATAThe data is invalid.


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 Microsoft Windows Graphics Device Interface (GDI) function GetCharacterPlacement World Wide Web link.



© 2004 Microsoft Corporation. All rights reserved.
Feedback? Please provide us with your comments on this topic.
For more help, visit the DirectX Developer Center.