ID3DX10Font::P reloadCharacters メソッド

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

構文

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

最初の [入力]

型: UINT

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

最後の [入力]

型: UINT

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

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

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

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

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

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