ID3DXFont::P reloadCharacters メソッド

  • [アーティクル]

一連の文字をビデオ メモリに読み込み、デバイスへのレンダリングの効率を向上させます。

構文

HRESULT PreloadCharacters(
  [in] UINT First,
  [in] UINT Last
);

パラメーター

最初 の [入力]

型: UINT

ビデオ メモリに読み込まれる最初の文字の ID。

最後 の [入力]

型: UINT

ビデオ メモリに読み込まれる最後の文字の ID。

戻り値

型: HRESULT

メソッドが成功した場合、戻り値はS_OK。 メソッドが失敗した場合、戻り値は次のいずれかになります:D3DERR_INVALIDCALL、D3DXERR_INVALIDDATA。

解説

このメソッドは、入力文字を表すグリフを含むテクスチャを生成します。 グリフは、一連の三角形として描画されます。

文字はデバイスにレンダリングされません。文字をレンダリングするには、 DrawText を引き続き呼び出す必要があります。 ただし、ビデオ メモリに文字を事前に読み込むことで、 DrawText の CPU リソースは大幅に少なくなります。

このメソッドは、GDI 関数 GetCharacterPlacement を使用して文字をグリフに内部的に変換します。

必要条件

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

関連項目

ID3DXFont