Função D3DXLoadVolumeFromResource
Carrega um volume de um recurso.
Sintaxe
HRESULT D3DXLoadVolumeFromResource(
_In_ LPDIRECT3DVOLUME9 pDestVolume,
_In_ const PALETTEENTRY *pDestPalette,
_In_ const D3DBOX *pDestBox,
_In_ HMODULE hSrcModule,
_In_ LPCSTR pSrcResource,
_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.
-
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: LPCSTR
Ponteiro para uma cadeia de caracteres que especifica o nome do arquivo da imagem de origem. Se UNICODE ou _UNICODE forem definidos, esse tipo de parâmetro será LPCWSTR; caso contrário, o tipo será LPCSTR.
-
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 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.
-
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 valores: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.
Comentários
O recurso que está sendo carregado deve ser um recurso de bitmap (RT_BITMAP).
Essa função manipula a conversão de e para formatos de textura compactadas.
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 D3DXLoadVolumeFromFile for chamado e a textura ainda não estiver sujo (isso é improvável em cenários de uso normais), o aplicativo precisará chamar explicitamente IDirect3DVolumeTexture9::AddDirtyBox na textura do volume.
Essa função dá suporte a cadeias de caracteres Unicode e ANSI.
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|
| Biblioteca |
|
Confira também