Função D3DX10CreateFont

Cria um objeto de fonte para um dispositivo e uma fonte.

Observação

Em vez de usar essa função, recomendamos que você use DirectWrite e a biblioteca DirectXTK, classe SpriteFont.

 

Sintaxe

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
);

Parâmetros

pDevice [in]

Tipo: ID3D10Device*

Ponteiro para uma interface ID3D10Device, 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: UINT

O conjunto de caracteres da fonte.

OutputPrecision [in]

Tipo: UINT

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: UINT

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: UINT

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 será resolvido para LPCSTR. Consulte Observações.

ppFont [out]

Tipo: LPD3DX10FONT*

Retorna um ponteiro para uma interface ID3DX10Font, 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 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	D3DX10Core.h
Biblioteca	D3DX10.lib

Confira também

Funções Uso Geral