Função D3DXCreateCubeTextureFromFileInMemory
Cria uma textura de cubo de um arquivo na memória.
Sintaxe
HRESULT D3DXCreateCubeTextureFromFileInMemory(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ LPCVOID pSrcData,
_In_ UINT SrcDataSize,
_Out_ LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);
Parâmetros
-
pDevice [in]
-
Tipo: LPDIRECT3DDEVICE9
Ponteiro para uma interface IDirect3DDevice9 , representando o dispositivo a ser associado à textura do cubo.
-
pSrcData [in]
-
Tipo: LPCVOID
Ponteiro para o arquivo na memória do qual criar o cubemap. Consulte Observações.
-
SrcDataSize [in]
-
Tipo: UINT
Tamanho do arquivo na memória, em bytes.
-
ppCubeTexture [out]
-
Tipo: LPDIRECT3DCUBETEXTURE9*
Endereço de um ponteiro para uma interface IDirect3DCubeTexture9 , representando o objeto de textura de cubo criado.
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, D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, D3DXERR_INVALIDDATA E_OUTOFMEMORY.
Comentários
Essa função dá suporte aos seguintes formatos de arquivo: .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm e .tga. Confira D3DXIMAGE_FILEFORMAT.
A função é equivalente a D3DXCreateCubeTextureFromFileInMemoryEx(pDevice, pSrcData, SrcDataSize, D3DX_DEFAULT, D3DX_DEFAULT, 0, D3DFMT_UNKNOWN, D3DPOOL_MANAGED, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, NULL, ppCubeTexture).
Observe que um recurso criado com essa função quando chamado de um objeto IDirect3DDevice9 será colocado na classe de memória indicada por D3DPOOL_MANAGED. Quando esse método é chamado de um objeto IDirect3DDevice9Ex, o recurso será colocado na classe de memória indicada por D3DPOOL_DEFAULT.
Esse método foi projetado para ser usado para carregar arquivos de imagem armazenados como RT_RCDATA, que é um recurso definido pelo aplicativo (dados brutos). Caso contrário, esse método falhará.
A filtragem é aplicada automaticamente a uma textura criada usando esse método. A filtragem é equivalente a D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER em D3DX_FILTER.
D3DXCreateCubeTextureFromFileInMemory usa o formato de arquivo DDS (superfície DirectDraw). O Editor de Textura DirectX (Dxtex.exe) permite gerar um mapa de cubo de outros formatos de arquivo e salvá-lo no formato de arquivo DDS. Você pode obter Dxtex.exe e saber mais sobre isso no SDK do DirectX. Para obter informações sobre o SDK do DirectX, consulte Onde está o SDK do DirectX?.
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|
| Biblioteca |
|
Confira também