ID3DX10Font::PreloadCharacters method
Load 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; ID3DX10Font::DrawText must still be called to render the characters. However, by pre-loading characters into video memory, ID3DX10Font::DrawText will use substantially fewer CPU resources.
This method internally converts characters to glyphs using the GDI function GetCharacterPlacement.
Requirements
| Requirement | Value |
|---|---|
| Header |
|
| Library |
|
See also