DDS_HEADER_DXT10结构

用于处理资源数组的 DDS 标头扩展、不映射到旧版 Microsoft DirectDraw 像素格式结构的 DXGI 像素格式和其他元数据。

语法

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_DIMENSIOND3D11_RESOURCE_DIMENSION 枚举中的值的子集:

类型 说明
DDS_DIMENSION_TEXTURE1D (D3D10_RESOURCE_DIMENSION_TEXTURE1D) 资源是 一个 1D 纹理DDS_HEADER的 dwWidth 成员指定纹理的大小。 通常,将DDS_HEADER的 dwHeight 成员设置为 1;还必须在DDS_HEADER的 dwFlags 成员中设置DDSD_HEIGHT标志。 2
DDS_DIMENSION_TEXTURE2D (D3D10_RESOURCE_DIMENSION_TEXTURE2D) 资源是一个二维纹理,其区域由DDS_HEADER的 dwWidthdwHeight 成员指定。 还可以使用此类型标识多维数据集映射纹理。 有关如何标识多维数据集映射纹理的详细信息,请参阅 miscFlagarraySize 成员。 3
DDS_DIMENSION_TEXTURE3D (D3D10_RESOURCE_DIMENSION_TEXTURE3D) 资源是 一个三维纹理 ,其卷由 dwWidthdwHeightdwDepth 成员指定的 DDS_HEADER。 还必须在DDS_HEADER 的 dwFlags 成员中设置 DDSD_DEPTH标志。 4

miscFlag

类型: UINT

标识资源的其他不太常见的选项。 此成员的以下值是 D3D10_RESOURCE_MISC_FLAGD3D11_RESOURCE_MISC_FLAG 枚举中的值的子集:

类型 说明
DDS_RESOURCE_MISC_TEXTURECUBE 指示 二维纹理 是多维数据集映射纹理。 0x4

arraySize

类型: UINT

数组中的元素数。

对于也是多维数据集映射纹理的 2D 纹理 ,此数字表示多维数据集的数目。 此数字与 D3D10_TEXCUBE_ARRAY_SRV1D3D11_TEXCUBE_ARRAY_SRV) NumCubes 成员中的数字相同。 在这种情况下,DDS 文件包含 arraySize*6 2D 纹理。 有关此情况的详细信息,请参阅 miscFlag 说明。

对于 3D 纹理,必须将此数字设置为 1。

miscFlags2

类型: UINT

包含以前保留) 的其他元数据 (。 较低的 3 位表示关联资源的 alpha 模式。 高 29 位是保留的,通常为 0。

类型 说明
DDS_ALPHA_MODE_UNKNOWN Alpha 通道内容未知。 这是旧文件的值,通常假定为“直线”alpha。 0x0
DDS_ALPHA_MODE_STRAIGHT 任何 alpha 通道内容都假定使用直接 alpha。 0x1
DDS_ALPHA_MODE_PREMULTIPLIED 任何 alpha 通道内容都使用预乘 alpha。 唯一指示此信息的旧文件格式是“DX2”和“DX4”。 0x2
DDS_ALPHA_MODE_OPAQUE 所有 alpha 通道内容都设置为完全不透明。 0x3
DDS_ALPHA_MODE_CUSTOM 任何 alpha 通道内容都用作第 4 个通道,不打算表示透明度 (直接或预乘) 。 0x4

注意

旧版 D3DX 10 和 D3DX 11 实用工具库将无法加载任何库。包含 miscFlags2 的 DDS 文件不等于零。

注解

将此结构与 DDS_HEADER 结合使用,将资源数组存储在 DDS 文件中。 有关详细信息,请参阅 纹理数组

如果DDS_PIXELFORMAT结构的 dwFourCC 成员设置为“DX10”,则存在此标头。

要求

要求 Value
标头
Dds.h

另请参阅

DDS 参考