ID3DXFont::P reloadText, méthode
Charge le texte mis en forme dans la mémoire vidéo pour améliorer l’efficacité du rendu sur l’appareil. Cette méthode prend en charge les chaînes ANSI et Unicode.
Syntaxe
HRESULT PreloadText(
[in] LPCTSTR *pString,
[in] INT Count
);
Paramètres
-
pString [in]
-
Type : LPCTSTR*
Pointeur vers une chaîne de caractères à charger dans la mémoire vidéo. Si les paramètres du compilateur nécessitent Unicode, le type de données LPCTSTR est résolu en LPCWSTR ; sinon, le type de données est résolu en LPCSTR. Consultez la section Notes.
-
Count [in]
-
Type : INT
Nombre de caractères dans la chaîne de texte.
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.
Notes
Le paramètre du compilateur détermine également la version de la fonction. Si Unicode est défini, l’appel de fonction est résolu en PreloadTextW. Sinon, l’appel de fonction est résolu en PreloadTextA, car les chaînes ANSI sont utilisées.
Cette méthode génère des textures qui contiennent des glyphes qui représentent le texte d’entrée. Les glyphes sont dessinés sous la forme d’une série de triangles.
Le texte ne sera pas restitué sur l’appareil ; DrawText doit toujours être appelé pour afficher le texte. Toutefois, en préchargeant du texte 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 |
|
Bibliothèque |
|
Voir aussi