Função D3DXLoadVolumeFromVolume
Carrega um volume de outro volume.
Sintaxe
HRESULT D3DXLoadVolumeFromVolume(
_In_ LPDIRECT3DVOLUME9 pDestVolume,
_In_ const PALETTEENTRY *pDestPalette,
_In_ const D3DBOX *pDestBox,
_In_ LPDIRECT3DVOLUME9 pSrcVolume,
_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.
-
pSrcVolume [in]
-
Tipo: LPDIRECT3DVOLUME9
Um Ponteiro para uma interface IDirect3DVolume9 . Especifica o volume de origem.
-
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. Defina esse parâmetro como NULL para especificar todo o volume.
-
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
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 D3DXLoadVolumeFromVolume 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 IDirect3DVolumeTexture9::AddDirtyBox na superfície.
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|
| Biblioteca |
|
Confira também