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]

类型： LPDIRECT3DDEVICE9

指向 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 字符串。

如果需要有关字体参数的详细信息，请参阅 逻辑字体。

要求

要求 值
标头
D3dx9core.h
库
D3dx9.lib

请参阅

常规用途函数