Función D3DXCreateCubeTextureFromFileInMemory
Crea una textura de cubo a partir de un archivo en memoria.
Sintaxis
HRESULT D3DXCreateCubeTextureFromFileInMemory(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ LPCVOID pSrcData,
_In_ UINT SrcDataSize,
_Out_ LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);
Parámetros
-
pDevice [in]
-
Tipo: LPDIRECT3DDEVICE9
Puntero a una interfaz IDirect3DDevice9 , que representa el dispositivo que se va a asociar a la textura del cubo.
-
pSrcData [in]
-
Tipo: LPCVOID
Puntero al archivo en memoria desde el que se va a crear el mapa de cubos. Vea la sección Comentarios.
-
SrcDataSize [in]
-
Tipo: UINT
Tamaño del archivo en memoria, en bytes.
-
ppCubeTexture [out]
-
Tipo: LPDIRECT3DCUBETEXTURE9*
Dirección de un puntero a una interfaz IDirect3DCubeTexture9 , que representa el objeto de textura de cubo creado.
Valor devuelto
Tipo: HRESULT
Si la función se realiza correctamente, el valor devuelto se D3D_OK. Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes: D3DERR_INVALIDCALL, D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.
Observaciones
Esta función admite los siguientes formatos de archivo: .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm y .tga. Consulte D3DXIMAGE_FILEFORMAT.
La función es equivalente a D3DXCreateCubeTextureFromFileInMemoryEx(pDevice, pSrcData, SrcDataSize, D3DX_DEFAULT, D3DX_DEFAULT, 0, D3DFMT_UNKNOWN, D3DPOOL_MANAGED, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, NULL, ppCubeTexture).
Tenga en cuenta que un recurso creado con esta función cuando se llama desde un objeto IDirect3DDevice9 se colocará en la clase de memoria indicada por D3DPOOL_MANAGED. Cuando se llama a este método desde un objeto IDirect3DDevice9Ex, el recurso se colocará en la clase de memoria indicada por D3DPOOL_DEFAULT.
Este método está diseñado para usarse para cargar archivos de imagen almacenados como RT_RCDATA, que es un recurso definido por la aplicación (datos sin procesar). De lo contrario, se producirá un error en este método.
El filtrado se aplica automáticamente a una textura creada mediante este método. El filtrado es equivalente a D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER en D3DX_FILTER.
D3DXCreateCubeTextureFromFileInMemory usa el formato de archivo de superficie DirectDraw (DDS). El Editor de texturas de DirectX (Dxtex.exe) permite generar un mapa de cubo a partir de otros formatos de archivo y guardarlo en el formato de archivo DDS. Puede obtener Dxtex.exe y obtener información sobre ella desde el SDK de DirectX. Para obtener información sobre el SDK de DirectX, consulta ¿Dónde está el SDK de DirectX?.
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|
| Biblioteca |
|
Vea también