Font.PreloadGlyphs(Int32,Int32) Method (Microsoft.DirectX.Direct3D)

  • Article

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

Definition

Visual Basic Public Sub PreloadGlyphs( _
    ByVal first As Integer, _
    ByVal last As Integer _
)
C# public void PreloadGlyphs(
    int first,
    int last
);
C++ public:
void PreloadGlyphs(
    int first,
    int last
);
JScript 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.