Функция D3DXCreateCubeTexture
Создает пустую текстуру куба, настраивая вызывающие параметры по мере необходимости.
Синтаксис
HRESULT D3DXCreateCubeTexture(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ UINT Size,
_In_ UINT MipLevels,
_In_ DWORD Usage,
_In_ D3DFORMAT Format,
_In_ D3DPOOL Pool,
_Out_ LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);
Параметры
-
pDevice [in]
-
Тип: LPDIRECT3DDEVICE9
Указатель на интерфейс IDirect3DDevice9 , представляющий устройство, связанное с текстурой.
-
Размер [in]
-
Тип: UINT
Ширина и высота текстуры куба в пикселях. Например, если текстура куба имеет размер 8 пикселей и 8 пикселей, значение этого параметра должно быть равно 8.
-
MipLevels [in]
-
Тип: UINT
Количество запрошенных уровней MIP. Если это значение равно нулю или D3DX_DEFAULT, создается полная цепочка MIP-карты.
-
Использование [в]
-
Тип: DWORD
0, D3DUSAGE_RENDERTARGET или D3DUSAGE_DYNAMIC. Установка этого флага D3DUSAGE_RENDERTARGET означает, что поверхность будет использоваться в качестве целевого объекта отрисовки. Затем ресурс можно передать в параметр pNewRenderTarget метода SetRenderTarget . Если указан D3DUSAGE_RENDERTARGET, приложение должно проверка, что устройство поддерживает эту операцию, вызвав CheckDeviceFormat. Дополнительные сведения об использовании динамических текстур см. в разделе Использование динамических текстур.
-
Формат [in]
-
Тип: D3DFORMAT
Член перечисленного типа D3DFORMAT , описывающий запрошенный формат пикселей для текстуры куба. Возвращаемая текстура куба может иметь формат, отличный от формата, заданного параметром Format. Приложения должны проверка формат возвращаемой текстуры куба.
-
Пул [в]
-
Тип: D3DPOOL
Член перечисленного типа D3DPOOL , описывающий класс памяти, в который следует поместить текстуру куба.
-
ppCubeTexture [out]
-
Тип: LPDIRECT3DCUBETEXTURE9*
Адрес указателя на интерфейс IDirect3DCubeTexture9 , представляющий созданный объект текстуры куба.
Возвращаемое значение
Тип: HRESULT
Если функция выполняется успешно, возвращаемое значение будет D3D_OK. В случае сбоя функции возвращается одно из следующих значений: D3DERR_INVALIDCALL, D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY E_OUTOFMEMORY.
Комментарии
Текстуры куба отличаются от других поверхностей тем, что они являются коллекциями поверхностей.
В D3DXCreateCubeTexture использует D3DXCheckCubeTextureRequirements для настройки параметров вызова. Поэтому вызовы D3DXCreateCubeTexture часто выполняются успешно, если вызовы CreateCubeTexture завершаются ошибкой.
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|
| Библиотека |
|
См. также раздел