Fonction D3DXCreateFont

  • Article

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
D3dx9core.h
Bibliothèque
D3dx9.lib

Voir aussi

fonctions usage général