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

參數

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

另請參閱

圖形繪圖函式