Поделиться через

структура D3D11_TEXTURE3D_DESC1 (d3d11_3.h)

  • Статья

Описывает трехмерную текстуру.

Синтаксис

typedef struct D3D11_TEXTURE3D_DESC1 {
  UINT                 Width;
  UINT                 Height;
  UINT                 Depth;
  UINT                 MipLevels;
  DXGI_FORMAT          Format;
  D3D11_USAGE          Usage;
  UINT                 BindFlags;
  UINT                 CPUAccessFlags;
  UINT                 MiscFlags;
  D3D11_TEXTURE_LAYOUT TextureLayout;
} D3D11_TEXTURE3D_DESC1;

Члены

Width

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

Height

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

Depth

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

MipLevels

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

Format

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

Usage

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

BindFlags

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

CPUAccessFlags

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

MiscFlags

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

TextureLayout

D3D11_TEXTURE_LAYOUT типизированное значение, определяющее макет текстуры.

Параметр TextureLayout выбирает как фактический макет текстуры в памяти, так и макет, видимый приложению при сопоставлении текстуры. Эти флаги не могут быть запрошены без запроса доступа к ЦП.

Недопустимо устанавливать флаги доступа к ЦП для текстур по умолчанию, не устанавливая для макета значение, отличное от D3D11_TEXTURE_LAYOUT_UNDEFINED.

D3D11_TEXTURE_LAYOUT_ROW_MAJOR нельзя использовать с трехмерными текстурами. D3D11_TEXTURE_LAYOUT_64K_STANDARD_SWIZZLE не могут использоваться с трехмерными текстурами с MIP-картами.

Комментарии

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

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

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

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

Требования

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

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

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