Метод IDirect3DDevice9::CreateCubeTexture (d3d9.h)

Статья
08/23/2023

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

Синтаксис

HRESULT CreateCubeTexture(
  [in]          UINT                  EdgeLength,
  [in]          UINT                  Levels,
  [in]          DWORD                 Usage,
  [in]          D3DFORMAT             Format,
  [in]          D3DPOOL               Pool,
  [out, retval] IDirect3DCubeTexture9 **ppCubeTexture,
  [in]          HANDLE                *pSharedHandle
);

Параметры

[in] EdgeLength

Тип: UINT

Размер краев всех лиц верхнего уровня текстуры куба. Пиксельные размеры последующих уровней каждой грани будут усеченными значениями половины пиксельного измерения предыдущего уровня (независимо). Каждое измерение зажимает с размером 1 пиксель. Таким образом, если деление на 2 приводит к 0 (нулю), вместо него будет принято 1.

[in] Levels

Тип: UINT

Количество уровней в каждой грани текстуры куба. Если значение равно нулю, Direct3D создаст все вложенные значения текстуры куба до 1 x 1 пикселя для каждой грани для оборудования, поддерживающего текстуры кубов mipmapped. Вызовите IDirect3DBaseTexture9::GetLevelCount , чтобы просмотреть количество созданных уровней.

[in] Usage

Тип: DWORD

Использование может иметь значение 0, что указывает на отсутствие значения использования. Однако, если требуется использование, используйте сочетание одной или нескольких констант D3DUSAGE . Рекомендуется сопоставлять параметр использования в CreateCubeTexture с флагами поведения в IDirect3D9::CreateDevice. Дополнительные сведения см. в подразделе "Примечания".

[in] Format

Тип: D3DFORMAT

Член перечисленного типа D3DFORMAT , описывающий формат всех уровней во всех гранях текстуры куба.

[in] Pool

Тип: D3DPOOL

Член перечисленного типа D3DPOOL , описывающий класс памяти, в который должна быть помещена текстура куба.

[out, retval] ppCubeTexture

Тип: IDirect3DCubeTexture9**

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

[in] pSharedHandle

Тип: HANDLE*

Зарезервировано. Задайте для этого параметра значение NULL. Этот параметр можно использовать в Direct3D 9 для Windows Vista для совместного использования ресурсов.

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

Тип: HRESULT

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

MIP-карта (текстура) — это коллекция последовательно пониженных (mipmapped) поверхностей. С другой стороны, текстура куба (созданная IDirect3Device9::CreateCubeTexture) представляет собой коллекцию из шести текстур (MIP-карт), по одной для каждого лица. Все лица должны присутствовать в текстуре куба. Кроме того, поверхность карты куба должна иметь одинаковый размер пикселей во всех трех измерениях (x, y и z).

Приложение может обнаружить поддержку автоматического создания MIP-карт (Direct3D 9) в определенном формате, вызвав IDirect3D9::CheckDeviceFormat с D3DUSAGE_AUTOGENMIPMAP. Если IDirect3D9::CheckDeviceFormat возвращает D3DOK_NOAUTOGEN, IDirect3DDevice9::CreateCubeTexture будет выполнено успешно, но он вернет одноуровневую текстуру.