Função D3DXLoadVolumeFromFileInMemory
Carrega um volume de um arquivo na memória.
Sintaxe
HRESULT D3DXLoadVolumeFromFileInMemory(
_In_ LPDIRECT3DVOLUME9 pDestVolume,
_In_ const PALETTEENTRY *pDestPalette,
_In_ const D3DBOX *pDestBox,
_In_ LPCVOID pSrcData,
_In_ UINT SrcDataSize,
_In_ const D3DBOX *pSrcBox,
_In_ DWORD Filter,
_In_ D3DCOLOR ColorKey,
_In_ D3DXIMAGE_INFO *pSrcInfo
);
Parâmetros
-
pDestVolume [in]
-
Tipo: LPDIRECT3DVOLUME9
Ponteiro para uma interface IDirect3DVolume9 . Especifica o volume de destino.
-
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.
-
pSrcData [in]
-
Tipo: LPCVOID
Ponteiro para o arquivo na memória do qual carregar o volume.
-
SrcDataSize [in]
-
Tipo: UINT
Tamanho em bytes do arquivo na memória.
-
pSrcBox [in]
-
Tipo: const D3DBOX*
Ponteiro para uma estrutura D3DBOX . Especifica a caixa de origem. Defina esse parâmetro como NULL para especificar todo o volume.
-
Filtrar [in]
-
Tipo: DWORD
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 tecla de cor. Essa é sempre uma cor ARGB de 32 bits, independente do formato de imagem de origem. Alpha é 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]
-
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: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.
Comentários
Essa função manipula a conversão de e para formatos de textura compactados e dá suporte aos seguintes formatos de arquivo: .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm e .tga. Consulte D3DXIMAGE_FILEFORMAT.
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 D3DXLoadVolumeFromFileInMemory for chamado e a textura ainda não estiver sujo (isso é improvável em cenários de uso normal), o aplicativo precisará chamar explicitamente IDirect3DVolumeTexture9::AddDirtyBox na textura do volume.
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|
| Biblioteca |
|
Confira também