Função D3DXCreateFont
Cria um objeto de fonte para um dispositivo e uma fonte.
Sintaxe
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
);
Parâmetros
-
pDevice [in]
-
Tipo: LPDIRECT3DDEVICE9
Ponteiro para uma interface IDirect3DDevice9 , o dispositivo a ser associado ao objeto de fonte.
-
Altura [in]
-
Tipo: INT
A altura dos caracteres em unidades lógicas.
-
Largura [in]
-
Tipo: UINT
A largura dos caracteres em unidades lógicas.
-
Peso [in]
-
Tipo: UINT
Peso da face de tipo. Um exemplo é negrito.
-
MipLevels [in]
-
Tipo: UINT
O número de níveis de mipmap.
-
Itálico [in]
-
Tipo: BOOL
True para fonte itálica, caso contrário, false.
-
CharSet [in]
-
Tipo: DWORD
O conjunto de caracteres da fonte.
-
OutputPrecision [in]
-
Tipo: DWORD
Especifica como o Windows deve tentar corresponder os tamanhos e características de fonte desejados com fontes reais. Use OUT_TT_ONLY_PRECIS por exemplo, para garantir que você sempre obtenha uma fonte TrueType.
-
Qualidade [in]
-
Tipo: DWORD
Especifica como o Windows deve corresponder a fonte desejada com uma fonte real. Ele se aplica apenas a fontes de raster e não deve afetar fontes TrueType.
-
PitchAndFamily [in]
-
Tipo: DWORD
Pitch e índice familiar.
-
pFacename [in]
-
Tipo: LPCTSTR
Cadeia de caracteres que contém o nome da face de tipo. Se as configurações do compilador exigirem Unicode, o tipo de dados LPCTSTR será resolvido para LPCWSTR. Caso contrário, o tipo de dados de cadeia de caracteres é resolvido para LPCSTR. Consulte Observações.
-
ppFont [out]
-
Tipo: LPD3DXFONT*
Retorna um ponteiro para uma interface ID3DXFont , representando o objeto de fonte criado.
Valor retornado
Tipo: HRESULT
Se a função for bem-sucedida, o valor retornado será S_OK. Se a função falhar, o valor retornado poderá ser um dos seguintes: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA E_OUTOFMEMORY.
Comentários
A criação de um objeto ID3DXFont requer que o dispositivo dê suporte à cor de 32 bits.
A configuração do compilador também determina a versão da função. Se Unicode for definido, a chamada de função será resolvida para D3DXCreateFontW. Caso contrário, a chamada de função será resolvida para D3DXCreateFontA porque as cadeias de caracteres ANSI estão sendo usadas.
Se você quiser mais informações sobre parâmetros de fonte, consulte A Fonte Lógica.
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|
| Biblioteca |
|
Confira também