ID3DXFont::P reloadCharacters-Methode

Lädt eine Reihe von Zeichen in den Videospeicher, um die Effizienz des Renderns auf dem Gerät zu verbessern.

Syntax

HRESULT PreloadCharacters(
  [in] UINT First,
  [in] UINT Last
);

Parameter

Erste [ In]

Typ: UINT

ID des ersten Zeichens, das in den Videospeicher geladen werden soll.

Zuletzt [ In]

Typ: UINT

ID des letzten Zeichens, das in den Videospeicher geladen werden soll.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, lautet der Rückgabewert S _ OK. Wenn die Methode fehlschlägt, kann der Rückgabewert einer der folgenden Werte sein: D3DERR _ INVALIDCALL, D3DXERR _ INVALIDDATA.

Bemerkungen

Diese Methode generiert Texturen, die Glyphen enthalten, die die Eingabezeichen darstellen. Die Glyphen werden als eine Reihe von Dreiecken gezeichnet.

Zeichen werden nicht auf dem Gerät gerendert. DrawText muss weiterhin aufgerufen werden, um die Zeichen zu rendern. Durch das Vorabladen von Zeichen in den Videospeicher verwendet DrawText jedoch deutlich weniger CPU-Ressourcen.

Diese Methode konvertiert Zeichen intern mithilfe der GDI-Funktion GetCharacterPlacementin Glyphen.

Requirements (Anforderungen)

Anforderung Wert
Header
D3dx9core.h
Bibliothek
D3dx9.lib

Weitere Informationen

ID3DXFont