Fonction D3DXCreateFont
Crée un objet de police pour un appareil et une police.
Syntaxe
HRESULT D3DXCreateFont(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ INT Height,
_In_ UINT Width,
_In_ UINT Weight,
_In_ UINT MipLevels,
_In_ BOOL Italic,
_In_ DWORD CharSet,
_In_ DWORD OutputPrecision,
_In_ DWORD Quality,
_In_ DWORD PitchAndFamily,
_In_ LPCTSTR pFacename,
_Out_ LPD3DXFONT *ppFont
);
Paramètres
-
pDevice [in]
-
Type : LPDIRECT3DDEVICE9
Pointeur vers une interface IDirect3DDevice9 , l’appareil à associer à l’objet police.
-
Hauteur [in]
-
Type : INT
Hauteur des caractères en unités logiques.
-
Largeur [in]
-
Type : UINT
Largeur des caractères en unités logiques.
-
Poids [en]
-
Type : UINT
Poids de la police. Un exemple est en gras.
-
MipLevels [in]
-
Type : UINT
Nombre de niveaux de mipmap.
-
Italique [in]
-
Type : BOOL
True pour la police italique, false sinon.
-
CharSet [in]
-
Type : DWORD
Jeu de caractères de la police.
-
OutputPrecision [in]
-
Type : DWORD
Spécifie comment Windows doit tenter de faire correspondre les tailles et caractéristiques de police souhaitées avec les polices réelles. Utilisez OUT_TT_ONLY_PRECIS pour instance, pour vous assurer que vous obtenez toujours une police TrueType.
-
Qualité [in]
-
Type : DWORD
Spécifie la façon dont Windows doit faire correspondre la police souhaitée avec une police réelle. Elle s’applique uniquement aux polices raster et ne doit pas affecter les polices TrueType.
-
PitchAndFamily [in]
-
Type : DWORD
Pitch et index de famille.
-
pFacename [in]
-
Type : LPCTSTR
Chaîne contenant le nom de la police. 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 de chaîne est résolu en LPCSTR. Consultez la section Notes.
-
ppFont [out]
-
Type : LPD3DXFONT*
Retourne un pointeur vers une interface ID3DXFont , représentant l’objet de police créé.
Valeur retournée
Type : HRESULT
Si la fonction réussit, la valeur de retour est S_OK. Si la fonction échoue, la valeur de retour peut être l’une des suivantes : D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.
Notes
La création d’un objet ID3DXFont nécessite que l’appareil prenne en charge la couleur 32 bits.
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 D3DXCreateFontW. Sinon, l’appel de fonction est résolu en D3DXCreateFontA, car les chaînes ANSI sont utilisées.
Si vous souhaitez plus d’informations sur les paramètres de police, consultez Police logique.
Spécifications
Condition requise | Valeur |
---|---|
En-tête |
|
Bibliothèque |
|
Voir aussi