структура D3D11_TEXTURE2D_DESC (d3d11.h)

  • Статья

Описывает двухd-текстуру.

Синтаксис

typedef struct D3D11_TEXTURE2D_DESC {
  UINT             Width;
  UINT             Height;
  UINT             MipLevels;
  UINT             ArraySize;
  DXGI_FORMAT      Format;
  DXGI_SAMPLE_DESC SampleDesc;
  D3D11_USAGE      Usage;
  UINT             BindFlags;
  UINT             CPUAccessFlags;
  UINT             MiscFlags;
} D3D11_TEXTURE2D_DESC;

Члены

Width

Тип: UINT

Ширина текстуры (в текселях). Диапазон от 1 до D3D11_REQ_TEXTURE2D_U_OR_V_DIMENSION (16384). Для кубической карты текстуры диапазон составляет от 1 до D3D11_REQ_TEXTURECUBE_DIMENSION (16384). Однако диапазон фактически ограничен уровнем функций , на котором создается устройство отрисовки. Дополнительные сведения об ограничениях см. в разделе Примечания.

Height

Тип: UINT

Высота текстуры (в текселях). Диапазон от 1 до D3D11_REQ_TEXTURE2D_U_OR_V_DIMENSION (16384). Для кубической карты текстуры диапазон составляет от 1 до D3D11_REQ_TEXTURECUBE_DIMENSION (16384). Однако диапазон фактически ограничен уровнем функций , на котором создается устройство отрисовки. Дополнительные сведения об ограничениях см. в разделе Примечания.

MipLevels

Тип: UINT

Максимальное количество уровней MIP-карты в текстуре. См. примечания в D3D11_TEX1D_SRV. Используйте 1 для текстуры с несколькими выборками; или 0 для создания полного набора подтекстов.

ArraySize

Тип: UINT

Количество текстур в массиве текстур. Диапазон — от 1 до D3D11_REQ_TEXTURE2D_ARRAY_AXIS_DIMENSION (2048). Для кубической карты текстур это значение кратно 6 (то есть в 6 раз больше значения в элементе NumCubesD3D11_TEXCUBE_ARRAY_SRV), а диапазон составляет от 6 до 2046. Диапазон фактически ограничивается уровнем функций , на котором создается устройство отрисовки. Дополнительные сведения об ограничениях см. в разделе Примечания.

Format

Тип: DXGI_FORMAT

Формат текстуры (см . DXGI_FORMAT).

SampleDesc

Тип: DXGI_SAMPLE_DESC

Структура, задающая параметры множественной выборки для текстуры. См . DXGI_SAMPLE_DESC.

Usage

Тип: D3D11_USAGE

Значение, определяющее, как текстура будет считываться и записываться в нее. Наиболее распространенным значением является D3D11_USAGE_DEFAULT; Все возможные значения см. в разделе D3D11_USAGE.

BindFlags

Тип: UINT

Флаги (см . D3D11_BIND_FLAG) для привязки к этапам конвейера. Флаги можно объединить с помощью побитового ИЛИ.

CPUAccessFlags

Тип: UINT

Флаги (см . D3D11_CPU_ACCESS_FLAG) для указания разрешенных типов доступа к ЦП. Используйте 0, если доступ к ЦП не требуется. Эти флаги можно комбинировать с побитовой или.

MiscFlags

Тип: UINT

Флаги (см . D3D11_RESOURCE_MISC_FLAG), которые определяют другие, менее распространенные варианты ресурсов. Используйте значение 0, если ни один из этих флагов не применяется. Эти флаги можно объединить с помощью побитового ИЛИ. Для кубической карты текстуры установите флаг D3D11_RESOURCE_MISC_TEXTURECUBE . Для массивов кубической карты (то есть ArraySize> 6) требуется уровень функций D3D_FEATURE_LEVEL_10_1 или выше.

Комментарии

Эта структура используется в вызове ID3D11Device::CreateTexture2D.

В дополнение к этой структуре можно также использовать производную CD3D11_TEXTURE2D_DESC структуру, которая определена в D3D11.h и ведет себя как наследуемый класс, для создания описания текстуры.

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

Диапазон размеров текстур определяется уровнем функций , на котором создается устройство, а не версией интерфейса Microsoft Direct3D. Например, если вы используете оборудование Microsoft Direct3D 10 на уровне компонентов 10 (D3D_FEATURE_LEVEL_10_0) и вызываете D3D11CreateDevice для создания ID3D11Device, при создании двухd-текстур необходимо ограничить максимальный размер текстуры D3D10_REQ_TEXTURE2D_U_OR_V_DIMENSION (8192).

Требования

Требование Значение
Заголовок d3d11.h

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

Структуры ресурсов