Microsoft DirectX 9.0 SDK Update (October 2004)

Font.PreloadGlyphs Method

Language:

Note: This documentation is preliminary and is subject to change.

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

Definition

Visual Basic .NET Public Sub PreloadGlyphs( _
    ByVal first As Integer, _
    ByVal last As Integer _
)
C# public void PreloadGlyphs(
    int first,
    int last
);
Managed C++ public: void PreloadGlyphs(
    int first,
    int last
);
JScript .NET public function PreloadGlyphs(
    first : int,
    last : int
);

Parameters

first System.Int32. Identifier of the first glyph to load into video memory.
last System.Int32. Identifier of the last glyph to load into video memory.

Remarks

This method does not render the glyphs to the device; Font.DrawText still must be called to render the glyphs. However, pre-loading glyphs into video memory causes Font.DrawText to use substantially fewer CPU resources.

Exceptions
InvalidCallException The method call is invalid. For example, a method's parameter might contain an invalid value.
InvalidDataException The data is invalid.


© 2004 Microsoft Corporation. All rights reserved. Terms of use.

Feedback? Please provide us with your comments on this topic.
For more help, visit the DirectX Developer Center