D3DX10CreateFont, fonction

Crée un objet de police pour un appareil et une police.

Notes

Au lieu d’utiliser cette fonction, nous vous recommandons d’utiliser DirectWrite et la bibliothèque DirectXTK, classe SpriteFont.

 

Syntaxe

HRESULT D3DX10CreateFont(
  _In_  ID3D10Device *pDevice,
  _In_  INT          Height,
  _In_  UINT         Width,
  _In_  UINT         Weight,
  _In_  UINT         MipLevels,
  _In_  BOOL         Italic,
  _In_  UINT         CharSet,
  _In_  UINT         OutputPrecision,
  _In_  UINT         Quality,
  _In_  UINT         PitchAndFamily,
  _In_  LPCTSTR      pFaceName,
  _Out_ LPD3DX10FONT *ppFont
);

Paramètres

pDevice [in]

Type : ID3D10Device*

Pointeur vers une interface ID3D10Device, l’appareil à associer à l’objet de police.

Height [in]

Type : INT

Hauteur des caractères en unités logiques.

Width [in]

Type : UINT

Largeur des caractères en unités logiques.

Poids [in]

Type : UINT

Poids de la police. Un exemple est gras.

MipLevels [in]

Type : UINT

Nombre de niveaux de mipmap.

Italique [in]

Type : BOOL

True pour la police italique, false dans le cas contraire.

CharSet [in]

Type : UINT

Jeu de caractères de la police.

OutputPrecision [in]

Type : UINT

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, afin de vous assurer que vous obtenez toujours une police TrueType.

Qualité [in]

Type : UINT

Spécifie la façon dont Windows doit 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 : UINT

Index de pitch et 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 est résolu en LPCSTR. Consultez la section Notes.

ppFont [out]

Type : LPD3DX10FONT*

Retourne un pointeur vers une interface ID3DX10Font, 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

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
D3DX10Core.h
Bibliothèque
D3DX10.lib

Voir aussi

usage général Functions