ID3DXFont::P reloadCharacters 메서드

일련의 문자를 비디오 메모리에 로드하여 디바이스에 렌더링하는 효율성을 개선합니다.

구문

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

첫 번째 [in]

형식: UINT

비디오 메모리에 로드할 첫 번째 문자의 ID입니다.

마지막 [in]

형식: UINT

비디오 메모리에 로드할 마지막 문자의 ID입니다.

메서드가 성공하면 반환 값이 S_OK. 메서드가 실패하면 반환 값은 D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA 중 하나일 수 있습니다.

이 메서드는 입력 문자를 나타내는 문자 모양을 포함하는 텍스처를 생성합니다. 문자 모양은 일련의 삼각형으로 그려집니다.

문자는 디바이스에 렌더링되지 않습니다. 문자를 렌더링하려면 DrawText 를 호출해야 합니다. 그러나 비디오 메모리에 문자를 미리 로드하면 DrawText 는 훨씬 적은 CPU 리소스를 사용합니다.

이 메서드는 GDI 함수 GetCharacterPlacement를 사용하여 문자를 문자 모양으로 내부적으로 변환합니다.

요구 사항	값
헤더	D3dx9core.h
라이브러리	D3dx9.lib