Función D3DX10CreateFont

Crea un objeto de fuente para un dispositivo y una fuente.

Nota:

En lugar de usar esta función, se recomienda usar DirectWrite y la biblioteca DirectXTK, clase SpriteFont.

 

Sintaxis

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*

Puntero a una interfaz ID3D10Device, el dispositivo que se va a asociar al objeto de fuente.

Alto [in]

Tipo: INT

Alto de los caracteres en unidades lógicas.

Ancho [in]

Tipo: UINT

Ancho de los caracteres en unidades lógicas.

Peso [in]

Tipo: UINT

Peso de la letra. Un ejemplo es negrita.

MipLevels [in]

Tipo: UINT

Número de niveles de mapa mip.

Cursiva [in]

Tipo: BOOL

True para la fuente en cursiva; en caso contrario, false.

CharSet [in]

Tipo: UINT

Juego de caracteres de la fuente.

OutputPrecision [in]

Tipo: UINT

Especifica cómo Windows debe intentar coincidir con los tamaños de fuente y las características deseados con fuentes reales. Use OUT_TT_ONLY_PRECIS por ejemplo, para asegurarse de que siempre obtiene una fuente TrueType.

Calidad [in]

Tipo: UINT

Especifica cómo Windows debe coincidir con la fuente deseada con una fuente real. Solo se aplica a las fuentes ráster y no debe afectar a las fuentes TrueType.

PitchAndFamily [in]

Tipo: UINT

Índice de tono y familia.

pFaceName [in]

Tipo: LPCTSTR

Cadena que contiene el nombre del tipo de letra. Si la configuración del compilador requiere Unicode, el tipo de datos LPCTSTR se resuelve en LPCWSTR. De lo contrario, el tipo de datos se resuelve en LPCSTR. Vea la sección Comentarios.

ppFont [out]

Tipo: LPD3DX10FONT*

Devuelve un puntero a una interfaz ID3DX10Font, que representa el objeto de fuente creado.

Valor devuelto

Tipo: HRESULT

Si la función se ejecuta correctamente, el valor devuelto se S_OK. Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Comentarios

La configuración del compilador también determina la versión de la función. Si se define Unicode, la llamada de función se resuelve en D3DXCreateFontW. De lo contrario, la llamada de función se resuelve en D3DXCreateFontA porque se usan cadenas ANSI.

Si desea más información sobre los parámetros de fuente, vea La fuente lógica.

Requisitos

Requisito	Value
Encabezado	D3DX10Core.h
Biblioteca	D3DX10.lib

Consulte también

Funciones de De uso general