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) 资源是 一维纹理 DDS_HEADERdwWidth 成员指定纹理的大小。 通常,将 DDS_HEADERdwHeight 成员设置为 1;还必须在 DDS_HEADER 的 dwFlags 成员中设置DDSD_HEIGHT标志 2
DDS_DIMENSION_TEXTURE2D (D3D10_RESOURCE_DIMENSION_TEXTURE2D) 资源是一个 2D 纹理,其区域由DDS_HEADERdwWidthdwHeight 成员指定。 还可以使用此类型来标识立方体贴图纹理。 有关如何识别多维数据集贴图纹理的详细信息,请参阅 miscFlagarraySize 成员。 3
DDS_DIMENSION_TEXTURE3D (D3D10_RESOURCE_DIMENSION_TEXTURE3D) 资源是一种 3D 纹理,其卷由DDS_HEADERdwWidthdwHeightdwDepth 成员指定。 还必须在 DDS_HEADER 的 dwFlags 成员中设置 DDSD_DEPTH标志 4

miscFlag

类型: UINT

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

类型 说明
DDS_RESOURCE_MISC_TEXTURECUBE 指示 2D 纹理 是立方体贴图纹理。 0x4

arraySize

类型: UINT

数组中的元素数。

对于也是多维数据集贴 图纹理的 2D 纹理,此数字表示多维数据集的数量。 此数字与 D3D10_TEXCUBE_ARRAY_SRV1 D3D11_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”,则存在此标头。

要求

要求
标头
Dds.h

另请参阅

DDS 参考