Função D3DXLoadSurfaceFromFile

Carrega uma superfície de um arquivo.

Sintaxe

HRESULT D3DXLoadSurfaceFromFile(
  _In_          LPDIRECT3DSURFACE9 pDestSurface,
  _In_    const PALETTEENTRY       *pDestPalette,
  _In_    const RECT               *pDestRect,
  _In_          LPCTSTR            pSrcFile,
  _In_    const RECT               *pSrcRect,
  _In_          DWORD              Filter,
  _In_          D3DCOLOR           ColorKey,
  _Inout_       D3DXIMAGE_INFO     *pSrcInfo
);

Parâmetros

pDestSurface [in]

Tipo: LPDIRECT3DSURFACE9

Ponteiro para uma interface IDirect3DSurface9 . Especifica a superfície de destino, que recebe a imagem.

pDestPalette [in]

Tipo: const PALETTEENTRY*

Ponteiro para uma estrutura PALETTEENTRY , a paleta de destino de 256 cores ou NULL.

pDestRect [in]

Tipo: const RECT*

Ponteiro para uma estrutura RECT . Especifica o retângulo de destino. Defina esse parâmetro como NULL para especificar toda a superfície.

pSrcFile [in]

Tipo: LPCTSTR

Ponteiro para uma cadeia de caracteres que especifica o nome do arquivo. Se as configurações do compilador exigirem Unicode, o tipo de dados LPCTSTR será resolvido para LPCWSTR. Caso contrário, o tipo de dados de cadeia de caracteres será resolvido para LPCSTR. Consulte Observações.

pSrcRect [in]

Tipo: const RECT*

Ponteiro para uma estrutura RECT . Especifica o retângulo de origem. Defina esse parâmetro como NULL para especificar a imagem inteira.

Filtrar [in]

Tipo: DWORD

Combinação de uma ou mais D3DX_FILTER controlar como a imagem é filtrada. Especificar D3DX_DEFAULT para esse parâmetro é o equivalente a especificar D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER.

ColorKey [in]

Tipo: D3DCOLOR

Valor D3DCOLOR a ser substituído por preto transparente ou 0 para desabilitar a colorkey. Essa é sempre uma cor ARGB de 32 bits, independente do formato de imagem de origem. Alfa é significativo e geralmente deve ser definido como FF para chaves de cor opacas Assim, para preto opaco, o valor seria igual a 0xFF000000.

pSrcInfo [in, out]

Tipo: D3DXIMAGE_INFO*

Ponteiro para uma estrutura D3DXIMAGE_INFO a ser preenchida com uma descrição dos dados no arquivo de imagem de origem ou NULL.

Valor retornado

Tipo: HRESULT

Se a função for bem-sucedida, o valor retornado será D3D_OK. Se a função falhar, o valor retornado poderá ser um dos seguintes valores: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.

Comentários

A configuração do compilador também determina a versão da função. Se Unicode for definido, a chamada de função será resolvida para D3DXLoadSurfaceFromFileW. Caso contrário, a chamada de função será resolvida para D3DXLoadSurfaceFromFileA porque as cadeias de caracteres ANSI estão sendo usadas.

Essa função manipula a conversão de e para formatos de textura compactadas e dá suporte aos seguintes formatos de arquivo: .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm e .tga. Confira D3DXIMAGE_FILEFORMAT.

Gravar em uma superfície sem nível zero não fará com que o retângulo sujo seja atualizado. Se D3DXLoadSurfaceFromFile for chamado e a superfície ainda não estiver sujo (isso é improvável em cenários de uso normais), o aplicativo precisará chamar explicitamente AddDirtyRect na superfície.

Requisitos

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

Confira também

Funções de textura no D3DX 9