D3DX10CreateFont 函数

为设备和字体创建字体对象。

注意

建议不要使用此函数,而是使用 DirectWriteDirectXTKSpriteFont 类。

 

语法

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
);

parameters

pDevice [in]

类型: ID3D10Device*

指向 ID3D10Device 接口的指针,指向要与字体对象关联的设备。

高度 [in]

类型: INT

逻辑单元中字符的高度。

宽度 [in]

类型: UINT

字符的宽度(以逻辑单位为单位)。

权重 [in]

类型: UINT

字面粗细。 一个示例为粗体。

MipLevels [in]

类型: UINT

mipmap 级别的数目。

斜体 [in]

类型: BOOL

如果为斜体字体,则为 true;否则为 false。

CharSet [in]

类型: UINT

字体的字符集。

OutputPrecision [in]

类型: UINT

指定Windows应如何尝试与实际字体匹配所需的字号和特征。 例如,使用OUT_TT_ONLY_PRECIS确保始终获得 TrueType 字体。

质量 [in]

类型: UINT

指定Windows应如何将所需字体与实际字体匹配。 它仅适用于光栅字体,不应影响 TrueType 字体。

PitchAndFamily [in]

类型: UINT

音调和家庭索引。

pFaceName [in]

类型: LPCTSTR

包含字号名称的字符串。 如果编译器设置需要 Unicode,则数据类型 LPCTSTR 解析为 LPCWSTR。 否则,数据类型解析为 LPCSTR。 请参阅“备注”。

ppFont [out]

类型: LPD3DX10FONT*

返回指向 ID3DX10Font 接口的指针,表示创建的字体对象。

返回值

类型: HRESULT

如果函数成功,则返回值S_OK。 如果函数失败,则返回值可以是下列值之一:D3DERR_INVALIDCALL、D3DXERR_INVALIDDATA E_OUTOFMEMORY。

注解

编译器设置还确定函数版本。 如果定义了 Unicode,函数调用将解析为 D3DXCreateFontW。 否则,函数调用将解析为 D3DXCreateFontA,因为正在使用 ANSI 字符串。

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

要求

要求 Value
标头
D3DX10Core.h

D3DX10.lib

另请参阅

常规用途函数