Función D3DXCreateFont

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

Sintaxis

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

Puntero a una interfaz IDirect3DDevice9 , 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 [en]

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; de lo contrario, false.

CharSet [in]

Tipo: DWORD

Juego de caracteres de la fuente.

OutputPrecision [in]

Tipo: DWORD

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

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

Índice de pitch 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 de cadena se resuelve en LPCSTR. Vea la sección Comentarios.

ppFont [out]

Tipo: LPD3DXFONT*

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

Valor devuelto

Tipo: HRESULT

Si la función se ejecuta correctamente, el valor devuelto es 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 creación de un objeto ID3DXFont requiere que el dispositivo admita color de 32 bits.

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, consulte La fuente lógica.

Requisitos

Requisito	Value
Encabezado	D3dx9core.h
Biblioteca	D3dx9.lib

Consulte también

Funciones de De uso general