Funzione D3DXCreateFont

  • Articolo

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
D3dx9core.h
Libreria
D3dx9.lib

Vedi anche

Funzioni per utilizzo generico