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