Função D3DXLoadVolumeFromMemory

  • Artigo

Carrega um volume da memória.

Sintaxe

HRESULT D3DXLoadVolumeFromMemory(
  _In_       LPDIRECT3DVOLUME9 pDestVolume,
  _In_ const PALETTEENTRY      *pDestPalette,
  _In_ const D3DBOX            *pDestBox,
  _In_       LPCVOID           pSrcMemory,
  _In_       D3DFORMAT         SrcFormat,
  _In_       UINT              SrcRowPitch,
  _In_       UINT              SrcSlicePitch,
  _In_ const PALETTEENTRY      *pSrcPalette,
  _In_ const D3DBOX            *pSrcBox,
  _In_       DWORD             Filter,
  _In_       D3DCOLOR          ColorKey
);

Parâmetros

pDestVolume [in]

Tipo: LPDIRECT3DVOLUME9

Ponteiro para uma interface IDirect3DVolume9 . Especifica o volume 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.

pDestBox [in]

Tipo: const D3DBOX*

Ponteiro para uma estrutura D3DBOX . Especifica a caixa de destino. Defina esse parâmetro como NULL para especificar todo o volume.

pSrcMemory [in]

Tipo: LPCVOID

Ponteiro para o canto superior esquerdo do volume de origem na memória.

SrcFormat [in]

Tipo: D3DFORMAT

Membro do tipo enumerado D3DFORMAT , o formato de pixel do volume de origem.

SrcRowPitch [in]

Tipo: UINT

Pitch da imagem de origem, em bytes. Para formatos DXT (formatos de textura compactadas), esse número deve representar o tamanho de uma linha de células, em bytes.

SrcSlicePitch [in]

Tipo: UINT

Pitch da imagem de origem, em bytes. Para formatos DXT (formatos de textura compactadas), esse número deve representar o tamanho de uma fatia de células, em bytes.

pSrcPalette [in]

Tipo: const PALETTEENTRY*

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

pSrcBox [in]

Tipo: const D3DBOX*

Ponteiro para uma estrutura D3DBOX . Especifica a caixa de origem. NULL não é um valor válido para esse parâmetro.

Filtrar [in]

Tipo: DWORD

Uma 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.

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

Gravar em uma superfície sem nível zero da textura do volume não fará com que o retângulo sujo seja atualizado. Se D3DXLoadVolumeFromMemory for chamado e a textura ainda não tiver sido sujo (isso é improvável em cenários de uso normais), o aplicativo precisará chamar explicitamente IDirect3DVolumeTexture9::AddDirtyBox na textura do volume.

Requisitos

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

Confira também

D3DXLoadVolumeFromFile

D3DXLoadVolumeFromResource

D3DXLoadVolumeFromVolume

Funções de textura no D3DX 9