Função D3DXLoadSurfaceFromResource

Carrega uma superfície de um recurso.

Sintaxe

HRESULT D3DXLoadSurfaceFromResource(
  _In_          LPDIRECT3DSURFACE9 pDestSurface,
  _In_    const PALETTEENTRY       *pDestPalette,
  _In_    const RECT               *pDestRect,
  _In_          HMODULE            hSrcModule,
  _In_          LPCTSTR            pSrcResource,
  _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.

hSrcModule [in]

Tipo: HMODULE

Manipule para o módulo em que o recurso está localizado ou NULL para o módulo associado à imagem que o sistema operacional usou para criar o processo atual.

pSrcResource [in]

Tipo: LPCTSTR

Ponteiro para uma cadeia de caracteres que especifica o nome do recurso. 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 é 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 tecla de cor. 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 D3DXLoadSurfaceFromResourceW. Caso contrário, a chamada de função será resolvida para D3DXLoadSurfaceFromResourceA porque as cadeias de caracteres ANSI estão sendo usadas.

O recurso que está sendo carregado deve ser do tipo RT_BITMAP ou RT_RCDATA. O tipo de recurso RT_RCDATA é usado para carregar formatos diferentes de bitmaps (como .tga, .jpg e .dds).

Essa função manipula a conversão de e para formatos de textura compactados.

Gravar em uma superfície não 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 normal), o aplicativo precisará chamar explicitamente AddDirtyRect na superfície.

Requisitos

Confira também

Funções de textura no D3DX 9