D3DXCreateText 函数

使用与设备上下文关联的字体创建包含指定文本的网格。

语法

HRESULT D3DXCreateText(
  _In_  LPDIRECT3DDEVICE9   pDevice,
  _In_  HDC                 hDC,
  _In_  LPCTSTR             pText,
  _In_  FLOAT               Deviation,
  _In_  FLOAT               Extrusion,
  _Out_ LPD3DXMESH          *ppMesh,
  _Out_ LPD3DXBUFFER        *ppAdjacency,
  _Out_ LPGLYPHMETRICSFLOAT pGlyphMetrics
);

parameters

pDevice [in]

类型： LPDIRECT3DDEVICE9

指向创建网格的设备的指针。

hDC [in]

类型： HDC

设备上下文，包含输出字体。 设备上下文选择的字体必须是 TrueType 字体。

pText [in]

类型： LPCTSTR

指向指定要生成的文本的字符串的指针。 如果编译器设置需要 Unicode，则数据类型 LPCTSTR 解析为 LPCWSTR。 否则，字符串数据类型解析为 LPCSTR。 请参阅“备注”。

偏差 [in]

类型： FLOAT

与 TrueType 字体轮廓的最大弦偏差。

延伸 [ in]

类型： FLOAT

以负 z 方向延伸文本的量。

ppMesh [out]

类型： LPD3DXMESH*

指向返回的网格的指针。

ppAdjacency [out]

类型： LPD3DXBUFFER*

指向包含相邻信息的缓冲区的指针。 可能为 NULL。

pGlyphMetrics [out]

类型： LPGLYPHMETRICSFLOAT

指向包含字形指标数据的 GLYPHMETRICSFLOAT 结构的数组的指针。 每个元素都包含有关字符串中相应字形的位置和方向的信息。 数组中的元素数应等于字符串中的字符数。 请注意，每个结构中的原点并不相对于整个字符串，而是相对于该字符单元格。 若要计算整个边界框，请在遍历字符串时为每个字形添加增量。 如果不关心字形大小，请将此参数设置为 NULL。

返回值

类型： HRESULT

如果函数成功，则返回值D3D_OK。 如果函数失败，则返回值可以是以下值之一：D3DERR_INVALIDCALL、D3DXERR_INVALIDDATA E_OUTOFMEMORY。

备注

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

此函数使用D3DXMESH_MANAGED创建选项创建网格， 并D3DFVF_XYZ |D3DFVF_NORMAL FVF) (灵活顶点格式。

要求

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

请参阅

形状绘制函数