структура DDS_HEADER_DXT10

  • Статья

Расширение заголовка DDS для обработки массивов ресурсов, форматов пикселей DXGI, которые не соответствуют устаревшим структурам формата пикселей Microsoft DirectDraw, и дополнительных метаданных.

Синтаксис

typedef struct {
  DXGI_FORMAT              dxgiFormat;
  D3D10_RESOURCE_DIMENSION resourceDimension;
  UINT                     miscFlag;
  UINT                     arraySize;
  UINT                     miscFlags2;
} DDS_HEADER_DXT10;

Члены

dxgiFormat

Тип: DXGI_FORMAT

Формат пикселей поверхности (см . DXGI_FORMAT).

resourceDimension

Тип: D3D10_RESOURCE_DIMENSION

Определяет тип ресурса. Следующие значения для этого элемента являются подмножеством значений в перечислении D3D10_RESOURCE_DIMENSION или D3D11_RESOURCE_DIMENSION :

Тип Описание Значение
DDS_DIMENSION_TEXTURE1D (D3D10_RESOURCE_DIMENSION_TEXTURE1D) Ресурс — это 1D-текстура. Элемент dwWidthDDS_HEADER указывает размер текстуры. Как правило, для элемента dwHeightDDS_HEADER устанавливается значение 1; Также необходимо задать флаг DDSD_HEIGHT в элементе dwFlagsDDS_HEADER. 2
DDS_DIMENSION_TEXTURE2D (D3D10_RESOURCE_DIMENSION_TEXTURE2D) Ресурс — это двухd-текстура с областью, заданной элементами dwWidth и dwHeightDDS_HEADER. Этот тип также можно использовать для идентификации текстуры кубической карты. Дополнительные сведения о том, как идентифицировать текстуру карты куба, см. в разделе miscFlag и arraySize members. 3
DDS_DIMENSION_TEXTURE3D (D3D10_RESOURCE_DIMENSION_TEXTURE3D) Ресурс — это трехмерная текстура с объемом, заданным элементами dwWidth, dwHeight и dwDepthDDS_HEADER. Также необходимо задать флаг DDSD_DEPTH в элементе dwFlagsDDS_HEADER. 4

miscFlag

Тип: UINT

Определяет другие, менее распространенные параметры для ресурсов. Следующее значение для этого элемента является подмножеством значений в перечислении D3D10_RESOURCE_MISC_FLAG или D3D11_RESOURCE_MISC_FLAG :

Тип Описание Значение
DDS_RESOURCE_MISC_TEXTURECUBE Указывает, что двухd-текстура является текстурой кубической карты. 0x4

arraySize

Тип: UINT

Количество элементов в массиве.

Для двухмерной текстуры , которая также является текстурой карты куба, это число представляет количество кубов. Это число совпадает с числом в элементе NumCubesD3D10_TEXCUBE_ARRAY_SRV1 или D3D11_TEXCUBE_ARRAY_SRV). В этом случае файл DDS содержит двухd-текстуры arraySize*6. Дополнительные сведения об этом случае см. в описании miscFlag .

Для трехмерной текстуры необходимо задать для этого числа значение 1.

miscFlags2

Тип: UINT

Содержит дополнительные метаданные (ранее были зарезервированы). Более низкие 3 бита указывают на альфа-режим связанного ресурса. Верхние 29 бит зарезервированы и обычно имеют значение 0.

Тип Описание Значение
DDS_ALPHA_MODE_UNKNOWN Содержимое альфа-канала неизвестно. Это значение для устаревших файлов, которые обычно считаются "прямым" альфа-каналом. 0x0
DDS_ALPHA_MODE_STRAIGHT Предполагается, что любое содержимое альфа-канала использует прямой альфа-канал. 0x1
DDS_ALPHA_MODE_PREMULTIPLIED Любое содержимое альфа-канала использует предварительно подготовленный альфа-канал. Единственными устаревшими форматами файлов, указывающими на эти сведения, являются DX2 и DX4. 0x2
DDS_ALPHA_MODE_OPAQUE Содержимое альфа-канала полностью непрозрачно. 0x3
DDS_ALPHA_MODE_CUSTOM Любое содержимое альфа-канала используется в качестве 4-го канала и не предназначено для представления прозрачности (прямой или предварительной). 0x4

Примечание

Устаревшие библиотеки служебных программ D3DX 10 и D3DX 11 не смогут загрузить . Файл DDS с miscFlags2 не равен нулю.

Комментарии

Используйте эту структуру вместе с DDS_HEADER для хранения массива ресурсов в DDS-файле. Дополнительные сведения см. в разделе Массивы текстур.

Этот заголовок присутствует, если член dwFourCCструктуры DDS_PIXELFORMAT имеет значение DX10.

Требования

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

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

Справочник по DDS