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 に解決されます。 「解説」を参照してください。

偏差 [入力]

型: FLOAT

TrueType フォントアウトラインからのコードの最大偏差。

浮き出し [入力]

型: 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 に解決されます。 それ以外の場合、ANSI 文字列が使用されているため、関数呼び出しは D3DXCreateTextA に解決されます。

この関数は、D3DXMESH_MANAGED作成オプションとD3DFVF_XYZを使用してメッシュを作成します 。 |D3DFVF_NORMAL フレキシブル頂点形式 (FVF)。

必要条件

要件	値
ヘッダー	D3dx9shape.h
ライブラリ	D3dx9.lib

関連項目

図形描画関数