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	D3DX10Core.h
Libreria	D3DX10.lib

Vedi anche

Funzioni per utilizzo generico