Функция D3DXCreateCubeTextureFromFileInMemory

Создает текстуру куба из файла в памяти.

Синтаксис

HRESULT D3DXCreateCubeTextureFromFileInMemory(
  _In_  LPDIRECT3DDEVICE9      pDevice,
  _In_  LPCVOID                pSrcData,
  _In_  UINT                   SrcDataSize,
  _Out_ LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);

Параметры

pDevice [in]

Тип: LPDIRECT3DDEVICE9

Указатель на интерфейс IDirect3DDevice9 , представляющий устройство, связанное с текстурой куба.

pSrcData [in]

Тип: LPCVOID

Указатель на файл в памяти, из которого создается карта куба. См. заметки.

SrcDataSize [in]

Тип: UINT

Размер файла в памяти в байтах.

ppCubeTexture [out]

Тип: LPDIRECT3DCUBETEXTURE9*

Адрес указателя на интерфейс IDirect3DCubeTexture9 , представляющий созданный объект текстуры куба.

Возвращаемое значение

Тип: HRESULT

Если функция завершается успешно, возвращаемое значение D3D_OK. Если функция завершается ошибкой, возвращаемое значение может быть одним из следующих значений: D3DERR_INVALIDCALL, D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Remarks

Эта функция поддерживает следующие форматы файлов: .bmp, DDS, DIB, HDR, .jpg, PFM, .png, PPM и TGA. См. D3DXIMAGE_FILEFORMAT.

Функция эквивалентна D3DXCreateCubeTextureFromFileInMemoryEx(pDevice, pSrcData, SrcDataSize, D3DX_DEFAULT, D3DX_DEFAULT, 0, D3DFMT_UNKNOWN, D3DPOOL_MANAGED, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, ppCubeTexture).

Обратите внимание, что ресурс, созданный с помощью этой функции при вызове из объекта IDirect3DDevice9, будет помещен в класс памяти, обозначаемый D3DPOOL_MANAGED. При вызове этого метода из объекта IDirect3DDevice9Ex ресурс будет помещен в класс памяти, обозначаемый D3DPOOL_DEFAULT.

Этот метод предназначен для загрузки файлов изображений, хранящихся как RT_RCDATA, который является ресурсом, определяемым приложением (необработанными данными). В противном случае этот метод завершится ошибкой.

Фильтрация автоматически применяется к текстуре, созданной с помощью этого метода. Фильтрация эквивалентна D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER в D3DX_FILTER.

D3DXCreateCubeTextureFromFileInMemory использует формат файла DirectDraw surface (DDS). Редактор текстур DirectX (Dxtex.exe) позволяет создать карту куба из других форматов файлов и сохранить ее в формате DDS-файла. Вы можете получить Dxtex.exe и узнать об этом из пакета SDK для DirectX. Сведения о пакете SDK Для DirectX см. в разделе " Где находится пакет SDK Для DirectX?".

Требования

Требование Значение
Заголовок
D3dx9tex.h
Библиотека
D3dx9.lib

См. также раздел

Функции текстуры в D3DX 9