ID3DXFont::P reloadCharacters, méthode

Charge une série de caractères en mémoire vidéo pour améliorer l’efficacité du rendu sur l’appareil.

Syntaxe

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

Paramètres

First [in]

Type : UINT

ID du premier caractère à charger dans la mémoire vidéo.

Last [in]

Type : UINT

ID du dernier caractère à charger dans la mémoire vidéo.

Valeur retournée

Type : HRESULT

Si la méthode réussit, la valeur de retour est S_OK. Si la méthode échoue, la valeur de retour peut être l’une des suivantes : D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.

Remarques

Cette méthode génère des textures contenant des glyphes qui représentent les caractères d’entrée. Les glyphes sont dessinés sous la forme d’une série de triangles.

Les caractères ne sont pas rendus sur l’appareil ; DrawText doit toujours être appelé pour afficher les caractères. Toutefois, en préchargeant des caractères dans la mémoire vidéo, DrawText utilisera beaucoup moins de ressources processeur.

Cette méthode convertit en interne des caractères en glyphes à l’aide de la fonction GDI GetCharacterPlacement.

Spécifications

Condition requise Valeur
En-tête
D3dx9core.h
Bibliothèque
D3dx9.lib

Voir aussi

ID3DXFont