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

First [in]

Typ: UINT

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

Letzter [in]

Typ: UINT

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

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Wenn die Methode fehlschlägt, kann der Rückgabewert einer der folgenden 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 benötigt DrawText jedoch wesentlich weniger CPU-Ressourcen.

Diese Methode konvertiert Mithilfe der GDI-Funktion GetCharacterPlacement intern Zeichen in Glyphen.

Anforderungen

Weitere Informationen

ID3DXFont