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 |
|
| Biblioteca |
|
Consulte también