Функция D3DXCreateCubeTextureFromResource

Статья
06/13/2023

Создает текстуру куба из ресурса.

Синтаксис

HRESULT D3DXCreateCubeTextureFromResource(
  _In_  LPDIRECT3DDEVICE9      pDevice,
  _In_  HMODULE                hSrcModule,
  _In_  LPCTSTR                pSrcResource,
  _Out_ LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);

Параметры

pDevice [in]

Тип: LPDIRECT3DDEVICE9

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

hSrcModule [in]

Тип: HMODULE

Дескриптор к модулю, в котором находится ресурс, или значение NULL для модуля, связанного с образом, используемым операционной системой для создания текущего процесса.

pSrcResource [in]

Тип: LPCTSTR

Указатель на строку, указывающую имя ресурса. Если для параметров компилятора требуется Юникод, тип данных LPCTSTR разрешается в LPCWSTR. В противном случае строковый тип данных разрешается в LPCSTR. См. заметки.

ppCubeTexture [out]

Тип: LPDIRECT3DCUBETEXTURE9*

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

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

Тип: HRESULT

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

Параметр компилятора определяет версию функции. Если определен Юникод, вызов функции разрешается в D3DXCreateCubeTextureFromResourceW. В противном случае вызов функции разрешается в D3DXCreateCubeTextureFromResourceA , так как используются строки ANSI.

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

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

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

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

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

Требования

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

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

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