Método ID3DXFont::P reloadCharacters

Carrega uma série de caracteres na memória de vídeo para melhorar a eficiência da renderização para o dispositivo.

Sintaxe

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

Parâmetros

Primeiro [in]

Tipo: UINT

ID do primeiro caractere a ser carregado na memória de vídeo.

Último [in]

Tipo: UINT

ID do último caractere a ser carregado na memória de vídeo.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será S_OK. Se o método falhar, o valor retornado poderá ser um dos seguintes: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.

Comentários

Esse método gera texturas que contêm glifos que representam os caracteres de entrada. Os glifos são desenhados como uma série de triângulos.

Os caracteres não serão renderizados no dispositivo; DrawText ainda deve ser chamado para renderizar os caracteres. No entanto, ao pré-carregar caracteres na memória de vídeo, DrawText usará substancialmente menos recursos de CPU.

Esse método converte internamente caracteres em glifos usando a função GDI GetCharacterPlacement.

Requisitos

Requisito Valor
parâmetro
D3dx9core.h
Biblioteca
D3dx9.lib

Confira também

ID3DXFont