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 |
|
Bibliothèque |
|
Voir aussi