Funzione D3DX10CreateFont
Crea un oggetto carattere per un dispositivo e un tipo di carattere.
Nota
Invece di usare questa funzione, è consigliabile usare DirectWrite e la libreria DirectXTK, la classe SpriteFont.
Sintassi
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
);
Parametri
-
pDevice [in]
-
Tipo: ID3D10Device*
Puntatore a un'interfaccia ID3D10Device, il dispositivo da associare all'oggetto tipo di carattere.
-
Altezza [in]
-
Tipo: INT
Altezza dei caratteri in unità logiche.
-
Larghezza [in]
-
Tipo: UINT
Larghezza dei caratteri in unità logiche.
-
Peso [in]
-
Tipo: UINT
Spessore del carattere tipografico. Un esempio è in grassetto.
-
MipLevels [in]
-
Tipo: UINT
Numero di livelli mipmap.
-
Corsivo [in]
-
Tipo: BOOL
True per il tipo di carattere corsivo, false in caso contrario.
-
CharSet [in]
-
Tipo: UINT
Set di caratteri del tipo di carattere.
-
OutputPrecision [in]
-
Tipo: UINT
Specifica il modo in cui Windows deve tentare di corrispondere alle dimensioni e alle caratteristiche del carattere desiderate con i tipi di carattere effettivi. Usare OUT_TT_ONLY_PRECIS, ad esempio, per assicurarsi di ottenere sempre un tipo di carattere TrueType.
-
Qualità [in]
-
Tipo: UINT
Specifica il modo in cui Windows deve corrispondere al tipo di carattere desiderato con un tipo di carattere reale. Si applica solo ai tipi di carattere raster e non deve influire sui tipi di carattere TrueType.
-
PitchAndFamily [in]
-
Tipo: UINT
Indice pitch e family.
-
pFaceName [in]
-
Tipo: LPCTSTR
Stringa contenente il nome del carattere tipografico. Se le impostazioni del compilatore richiedono Unicode, il tipo di dati LPCTSTR viene risolto in LPCWSTR. In caso contrario, il tipo di dati viene risolto in LPCSTR. Vedere la sezione Osservazioni.
-
ppFont [out]
-
Tipo: LPD3DX10FONT*
Restituisce un puntatore a un'interfaccia ID3DX10Font che rappresenta l'oggetto carattere creato.
Valore restituito
Tipo: HRESULT
Se la funzione ha esito positivo, il valore restituito viene S_OK. Se la funzione ha esito negativo, il valore restituito può essere uno dei seguenti: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.
Commenti
L'impostazione del compilatore determina anche la versione della funzione. Se Unicode è definito, la chiamata di funzione viene risolta in D3DXCreateFontW. In caso contrario, la chiamata di funzione viene risolta in D3DXCreateFontA perché vengono usate stringhe ANSI.
Per altre informazioni sui parametri dei tipi di carattere, vedere Tipo di carattere logico.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|
| Libreria |
|
Vedi anche