Функция 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.
Комментарии
Эта функция поддерживает следующие форматы файлов: .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, NULL, ppCubeTexture).
Обратите внимание, что ресурс, созданный с помощью этой функции при вызове из объекта IDirect3Device9, будет помещен в класс памяти, обозначенный D3DPOOL_MANAGED. При вызове этого метода из объекта IDirect3DDevice9Ex ресурс будет помещен в класс памяти, обозначенный D3DPOOL_DEFAULT.
Этот метод предназначен для загрузки файлов изображений, хранящихся в виде RT_RCDATA, который является ресурсом, определяемым приложением (необработанные данные). В противном случае этот метод завершится ошибкой.
Фильтрация автоматически применяется к текстуре, созданной с помощью этого метода. Фильтрация эквивалентна D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER в D3DX_FILTER.
D3DXCreateCubeTextureFromFileInMemory использует формат файлов поверхности DirectDraw (DDS). Редактор текстур DirectX (Dxtex.exe) позволяет создать карту куба из файлов других форматов и сохранить ее в формате DDS. Вы можете получить Dxtex.exe и узнать о нем из пакета SDK для DirectX. Сведения о пакете SDK для DirectX см. в разделе Где находится пакет SDK для DirectX?.
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|
| Библиотека |
|
См. также раздел