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 |
|
Biblioteca |
|
Confira também