Руководство по программированию для DDS

Direct3D реализует формат файла DDS для хранения несжатых или сжатых текстур (DXTn). Формат файла реализует несколько немного различных типов, предназначенных для хранения разных типов данных, и поддерживает однослойные текстуры, текстуры с MIP-картами, карты кубов, объемные карты и массивы текстур (в Direct3D 10/11). В этом разделе описывается макет файла DDS.

Сведения о создании текстуры в Direct3D 11 см. в разделе Практическое руководство. Создание текстуры. Справку по Direct3D 9 см. в статье Поддержка текстур в D3DX (Direct3D 9).

• Макет файла DDS
• Варианты DDS
• Использование массивов текстур в Direct3D 10/11
• Распространенные форматы ресурсов файлов DDS и связанное содержимое заголовка
• Связанные темы

Макет файла DDS

DDS-файл — это двоичный файл, который содержит следующую информацию:

• Параметр DWORD (контрольное число), содержащий четырехсимвольное кодовое значение «DDS « (0x20534444).

• Описание данных, содержащихся в файле.

  Данные описываются с описанием заголовка с помощью DDS_HEADER; формат пикселей определяется с помощью DDS_PIXELFORMAT. Обратите внимание, что структуры DDS_HEADER и DDS_PIXELFORMAT заменяют устаревшие структуры DirectDraw 7 DDSURFACEDESC2, DDSCAPS2 и DDPIXELFORMAT DirectDraw 7. DDS_HEADER является двоичным эквивалентом DDSURFACEDESC2 и DDSCAPS2. DDS_PIXELFORMAT является двоичным эквивалентом DDPIXELFORMAT.

  DWORD               dwMagic;
  DDS_HEADER          header;
  
  

  Если параметру DDS_PIXELFORMAT dwFlags присвоено значение DDPF_FOURCC а параметру dwFourCC присвоено значение DX10, будет представлена дополнительная структура DDS_HEADER_DXT10 для размещения массивов текстур или форматов DXGI, которые не могут быть выражены как формат пикселей RGB, например форматы с плавающей запятой, форматы sRGB и т. д. При наличии структуры DDS_HEADER_DXT10 все описание данных будет выглядеть следующим образом.

  DWORD               dwMagic;
  DDS_HEADER          header;
  DDS_HEADER_DXT10    header10;
  

• Указатель на массив байтов, содержащий сведения о главной плоскости.

  BYTE bdata[]
  

• Указатель на массив байтов, содержащий сведения об остальных плоскостях, например об уровнях MIP, гранях в кубической текстуре, глубин в объемной текстуре. В статьях, ссылки на которые приведены ниже, представлены дополнительные сведения о структуре DDS-файлов для текстуры, кубической текстуры или объемной текстуры.

  BYTE bdata2[]
  

Для широкой поддержки оборудования рекомендуется использовать DXGI_FORMAT_R8G8B8A8_UNORM, DXGI_FORMAT_R8G8B8A8_UNORM_SRGB, DXGI_FORMAT_R8G8B8A8_SNORM, DXGI_FORMAT_B8G8R8A8_UNORM, DXGI_FORMAT_R16G16_SNORM, DXGI_FORMAT_R8G8_SNORM, DXGI_FORMAT_R8_UNORM, DXGI_FORMAT_BC1_UNORM, DXGI_FORMAT_BC1_UNORM_SRGB, DXGI_FORMAT_BC2_UNORM, DXGI_FORMAT_BC2_UNORM_SRGB. DXGI_FORMAT_BC3_UNORM или DXGI_FORMAT_BC3_UNORM_SRGB формате.

Дополнительные сведения о сжатых форматах текстур см. в разделах Сжатие блочных текстур в Direct3D 11 и Сжатие блоков (Direct3D 10).

Библиотека D3DX (например, D3DX11.lib) и другие аналогичные библиотеки ненадежно или несогласованно предоставляют значение тона в элементе dwPitchOrLinearSizeструктуры DDS_HEADER . Поэтому при чтении и записи в DDS-файлы рекомендуется вычислять тон одним из следующих способов для указанных форматов:

• Для форматов со сжатием блоков вычисляйте тон как:

  max( 1, ((ширина+3)/4) ) * размер блока

  Размер блока составляет 8 байт для форматов DXT1, BC1 и BC4 и 16 байт для других форматов со сжатием блоков.

• Для R8G8_B8G8, G8R8_G8B8, устаревших форматов, упакованных в UYVY, и устаревших форматов, упакованных в формате YUY2, вычисляете тон следующим образом:

  ((ширина+1) >> 1) * 4

• Для других форматов вычисляете тон как:

  ( ширина * бит на пиксель + 7 ) / 8

  Вы делите на 8 для выравнивания байтов.

Варианты DDS

Существует множество средств, которые создают и используют DDS-файлы, но они могут отличаться в деталях того, что им нужно в заголовке. Записи должны заполнять заголовки как можно более полно, а читатели должны проверка минимальные значения для максимальной совместимости. Чтобы проверить DDS-файл, средство чтения должно убедиться, что длина файла не менее 128 байт для размещения магического значения и базового заголовка, магическое значение — 0x20534444 ("DDS"), размер DDS_HEADER — 124, а DDS_PIXELFORMAT в заголовке — 32. Если параметру DDS_PIXELFORMAT dwFlags присвоено значение DDPF_FOURCC, а параметру dwFourCC присвоено значение DX10, общий размер файла должен быть не менее 148 байт.

Существуют некоторые распространенные варианты, в которых формат пикселей устанавливается в DDPF_FOURCC коде, где dwFourCC имеет значение D3DFORMAT или значение перечисления DXGI_FORMAT. Невозможно определить, является ли значение перечисления D3DFORMAT или DXGI_FORMAT, поэтому настоятельно рекомендуется использовать расширение DX10 и заголовок DDS_HEADER_DXT10 вместо этого для хранения dxgiFormat, если базовый DDS_PIXELFORMAT не может выразить формат.

Стандартный DDS_PIXELFORMAT следует использовать для обеспечения максимальной совместимости для хранения несжатых данных RGB и данных DXT1-5, так как не все средства DDS поддерживают расширение DX10.

Использование массивов текстур в Direct3D 10/11

Новые структуры DDS (DDS_HEADER и DDS_HEADER_DXT10) в Direct3D 10/11 расширяют формат файлов DDS для поддержки массива текстур, который является новым типом ресурсов в Direct3D 10/11. Ниже приведен пример кода, который показывает, как получить доступ к различным уровням MIP-карты в массиве текстур с помощью новых заголовков.

DWORD               dwMagic;
DDS_HEADER          header;
DDS_HEADER_DXT10    header10;
   
for (int iArrayElement = 0; iArrayElement < header10.arraySize; iArrayElement++)
{
   for (int iMipLevel = 0; iMipLevel < header.dwMipMapCount; iMipLevel++)
   {
     ...
   }
}       

Распространенные форматы ресурсов файлов DDS и связанное содержимое заголовка

* = надежное средство чтения DDS должно иметь возможность обрабатывать эти устаревшие коды формата. Однако такое средство чтения DDS должно предпочесть использовать расширение заголовка DX10 при записи этих кодов формата, чтобы избежать неоднозначности.

** = Из-за некоторых давних проблем в распространенных реализациях средств чтения и записи DDS наиболее надежным способом записи данных типа 10:10:10:2 является использование расширения заголовка DX10 с кодом DXGI_FORMAT "24" (т. е. значение DXGI_FORMAT_R10G10B10A2_UNORM). D3DFMT_A2R10G10B10 данные должны быть преобразованы в данные типа 10:10:10:2 перед записью в виде DDS-файла DXGI_FORMAT_R10G10B10A2_UNORM формата.

Связанные темы

DDS