![]() |
![]() |
![]() |
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_INVALIDCALL The method call is invalid. For example, a method's parameter may have an invalid value. D3DXERR_INVALIDDATA The 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
.