D3DXCreateFont 函数
为设备和字体创建字体对象。
语法
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
);
parameters
-
pDevice [in]
-
指向 IDirect3DDevice9 接口（要与字体对象关联的设备）的指针。
-
高度 [in]
-
类型： INT
字符的高度（以逻辑单元为单位）。
-
Width [in]
-
类型： UINT
字符的宽度（以逻辑单元为单位）。
-
Weight [in]
-
类型： UINT
字样粗细。 一个示例是粗体。
-
MipLevels [in]
-
类型： UINT
mipmap 级别的数目。
-
斜体 [in]
-
类型： BOOL
True 表示斜体字体，否则为 false。
-
CharSet [in]
-
类型： DWORD
字体的字符集。
-
OutputPrecision [in]
-
类型： DWORD
指定 Windows 应如何尝试将所需字号和特征与实际字体匹配。 例如，使用 OUT_TT_ONLY_PRECIS 以确保始终获得 TrueType 字体。
-
质量 [in]
-
类型： DWORD
指定 Windows 应如何将所需字体与真实字体进行匹配。 它仅适用于光栅字体，不应影响 TrueType 字体。
-
PitchAndFamily [in]
-
类型： DWORD
音调和家庭索引。
-
pFacename [in]
-
类型： LPCTSTR
包含字样名称的字符串。 如果编译器设置需要 Unicode，则数据类型 LPCTSTR 解析为 LPCWSTR。 否则，字符串数据类型解析为 LPCSTR。 请参阅“备注”。
-
ppFont [out]
-
类型： LPD3DXFONT*
返回指向 ID3DXFont 接口的指针，该接口表示创建的字体对象。
返回值
类型： HRESULT
如果函数成功，则返回值S_OK。 如果函数失败，则返回值可以是下列值之一：D3DERR_INVALIDCALL、D3DXERR_INVALIDDATA、E_OUTOFMEMORY。
备注
创建 ID3DXFont 对象需要设备支持 32 位颜色。
编译器设置还确定函数版本。 如果定义了 Unicode，则函数调用将解析为 D3DXCreateFontW。 否则，函数调用将解析为 D3DXCreateFontA，因为正在使用 ANSI 字符串。
如果需要有关字体参数的详细信息，请参阅 逻辑字体。
要求
| 要求 | 值 |
|---|---|
| 标头 |
|
| 库 |
|
请参阅