Função D3DXLoadSurfaceFromSurface

Carrega uma superfície de outra superfície com conversão de cores.

Sintaxe

HRESULT D3DXLoadSurfaceFromSurface(
  _In_       LPDIRECT3DSURFACE9 pDestSurface,
  _In_ const PALETTEENTRY       *pDestPalette,
  _In_ const RECT               *pDestRect,
  _In_       LPDIRECT3DSURFACE9 pSrcSurface,
  _In_ const PALETTEENTRY       *pSrcPalette,
  _In_ const RECT               *pSrcRect,
  _In_       DWORD              Filter,
  _In_       D3DCOLOR           ColorKey
);

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.

pSrcSurface [in]

Tipo: LPDIRECT3DSURFACE9

Ponteiro para uma interface IDirect3DSurface9 , representando a superfície de origem.

pSrcPalette [in]

Tipo: const PALETTEENTRY*

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

pSrcRect [in]

Tipo: const RECT*

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

Filtrar [in]

Tipo: DWORD

Uma combinação de uma ou mais D3DX_FILTER, controlando 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.

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: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.

Comentários

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

Gravar em uma superfície sem nível zero não fará com que o retângulo sujo seja atualizado. Se D3DXLoadSurfaceFromSurface 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

Confira também

Funções de textura no D3DX 9