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