Funzione D3DXCreateFont
Crea un oggetto carattere per un dispositivo e un tipo di carattere.
Sintassi
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
);
Parametri
-
pDevice [in]
-
Tipo: LPDIRECT3DDEVICE9
Puntatore a un'interfaccia IDirect3DDevice9 , il dispositivo da associare all'oggetto carattere.
-
Altezza [in]
-
Tipo: INT
Altezza dei caratteri nelle unità logiche.
-
Larghezza [in]
-
Tipo: UINT
Larghezza dei caratteri nelle unità logiche.
-
Peso [in]
-
Tipo: UINT
Peso del carattere tipizzato. Un esempio è grassetto.
-
MipLevels [in]
-
Tipo: UINT
Numero di livelli di mipmap.
-
Corsivo [in]
-
Tipo: BOOL
True per il carattere corsivo, false in caso contrario.
-
CharSet [in]
-
Tipo: DWORD
Set di caratteri del tipo di carattere.
-
OutputPrecision [in]
-
Tipo: DWORD
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 carattere TrueType.
-
Qualità [in]
-
Tipo: DWORD
Specifica il modo in cui Windows deve corrispondere al tipo di carattere desiderato con un carattere reale. Si applica solo ai tipi di carattere raster e non devono influire sui tipi di carattere TrueType.
-
PitchAndFamily [in]
-
Tipo: DWORD
Indice di passo e famiglia.
-
pFacename [in]
-
Tipo: LPCTSTR
Stringa contenente il nome del carattere di tipo. Se le impostazioni del compilatore richiedono Unicode, il tipo di dati LPCTSTR viene risolto in LPCWSTR. In caso contrario, il tipo di dati stringa viene risolto in LPCSTR. Vedere la sezione Osservazioni.
-
ppFont [out]
-
Tipo: LPD3DXFONT*
Restituisce un puntatore a un'interfaccia ID3DXFont che rappresenta l'oggetto carattere creato.
Valore restituito
Tipo: HRESULT
Se la funzione ha esito positivo, il valore restituito è S_OK. Se la funzione ha esito negativo, il valore restituito può essere uno dei seguenti: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.
Commenti
La creazione di un oggetto ID3DXFont richiede che il dispositivo supporti il colore a 32 bit.
L'impostazione del compilatore determina anche la versione della funzione. Se Unicode è definito, la chiamata alla funzione viene risolta in D3DXCreateFontW. In caso contrario, la chiamata alla funzione viene risolta in D3DXCreateFontA perché vengono usate stringhe ANSI.
Per altre informazioni sui parametri del tipo di carattere, vedere Tipo di carattere logico.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|
| Libreria |
|
Vedi anche