dwSize
类型: DWORD
结构的大小。 此成员必须设置为 124。
dwFlags
类型: DWORD
用于指示哪些成员包含有效数据的标志。
标志描述值DDSD_CAPS每个 .dds 文件中都是必需的。0x1DDSD_HEIGHT每个 .dds 文件中都是必需的。0x2DDSD_WIDTH每个 .dds 文件中都是必需的。0x4DDSD_PITCH为未压缩的纹理提供俯仰时是必需的。0x8DDSD_PIXELFORMAT每个 .dds 文件中都是必需的。0x1000DDSD_MIPMAPCOUNT在被误贴的纹理中是必需的。0x20000DDSD_LINEARSIZE为压缩纹理提供间距时必需。0x80000DDSD_DEPTH深度纹理中必需。0x800000注意
编写 .dds 文件时,应设置DDSD_CAPS和DDSD_PIXELFORMAT标志,对于被误用的纹理,还应设置DDSD_MIPMAPCOUNT标志。 但是,在读取 .dds 文件时,不应依赖于设置DDSD_CAPS、DDSD_PIXELFORMAT和DDSD_MIPMAPCOUNT标志,因为此类文件的某些编写者可能不会设置这些标志。
在 Dds.h 中定义的DDS_HEADER_FLAGS_TEXTURE标志是DDSD_CAPS、DDSD_HEIGHT、DDSD_WIDTH和DDSD_PIXELFORMAT标志的按位 OR 组合。
在 Dds.h 中定义的 DDS_HEADER_FLAGS_MIPMAP 标志等于 DDSD_MIPMAPCOUNT 标志。
在 Dds.h 中定义的 DDS_HEADER_FLAGS_VOLUME 标志等于 DDSD_DEPTH 标志。
在 Dds.h 中定义的 DDS_HEADER_FLAGS_PITCH 标志等于 DDSD_PITCH 标志。
在 Dds.h 中定义的 DDS_HEADER_FLAGS_LINEARSIZE 标志等于 DDSD_LINEARSIZE 标志。
dwHeight
类型: DWORD
图面高度 (以像素) 为单位。
dwWidth
类型: DWORD
图面宽度 (以像素) 为单位。
dwPitchOrLinearSize
类型: DWORD
未压缩纹理中每个扫描行的间距或字节数;压缩纹理的顶级纹理中的字节总数。 有关如何计算间距的信息,请参阅 DDS 编程指南的 DDS 文件布局部分。
dwDepth
类型: DWORD
卷纹理的深度 () 像素,否则未使用。
dwMipMapCount
类型: DWORD
mipmap 级别的数目,否则未使用。
dwReserved1[11]
类型: DWORD
未使用。
ddspf
类型: DDS_PIXELFORMAT
像素格式 (DDS_PIXELFORMAT) 。
dwCaps
类型: DWORD
指定存储的图面的复杂性。
标志描述值DDSCAPS_COMPLEX选;必须在包含多个图面的任何文件上使用, (mipmap、三次方环境贴图或 mipmapped 体积纹理) 。0x8DDSCAPS_MIPMAP选;应用于 mipmap。0x400000DDSCAPS_TEXTURE必须0x1000注意
编写 .dds 文件时,应设置DDSCAPS_TEXTURE标志,对于多个图面,还应设置DDSCAPS_COMPLEX标志。 但是,在读取 .dds 文件时,不应依赖于设置DDSCAPS_TEXTURE和DDSCAPS_COMPLEX标志,因为此类文件的某些编写者可能不会设置这些标志。
DDS_SURFACE_FLAGS_MIPMAP标志(在 Dds.h 中定义)是DDSCAPS_COMPLEX和DDSCAPS_MIPMAP标志的按位 OR 组合。
在 Dds.h 中定义的 DDS_SURFACE_FLAGS_TEXTURE 标志等于 DDSCAPS_TEXTURE 标志。
在 Dds.h 中定义的 DDS_SURFACE_FLAGS_CUBEMAP 标志等于 DDSCAPS_COMPLEX 标志。
dwCaps2
类型: DWORD
有关存储的图面的其他详细信息。
标志描述值DDSCAPS2_CUBEMAP对于多维数据集映射是必需的。0x200DDSCAPS2_CUBEMAP_POSITIVEX当这些图面存储在立方体映射中时是必需的。0x400DDSCAPS2_CUBEMAP_NEGATIVEX当这些图面存储在立方体映射中时是必需的。0x800DDSCAPS2_CUBEMAP_POSITIVEY当这些图面存储在立方体映射中时是必需的。0x1000DDSCAPS2_CUBEMAP_NEGATIVEY当这些图面存储在立方体映射中时是必需的。0x2000DDSCAPS2_CUBEMAP_POSITIVEZ当这些图面存储在立方体映射中时是必需的。0x4000DDSCAPS2_CUBEMAP_NEGATIVEZ当这些图面存储在立方体映射中时是必需的。0x8000DDSCAPS2_VOLUME对于体积纹理是必需的。0x200000在 Dds.h 中定义的DDS_CUBEMAP_POSITIVEX标志是DDSCAPS2_CUBEMAP和DDSCAPS2_CUBEMAP_POSITIVEX标志的按位 OR 组合。
在 Dds.h 中定义的DDS_CUBEMAP_NEGATIVEX标志是DDSCAPS2_CUBEMAP和DDSCAPS2_CUBEMAP_NEGATIVEX标志的按位 OR 组合。
在 Dds.h 中定义的DDS_CUBEMAP_POSITIVEY标志是DDSCAPS2_CUBEMAP标志和DDSCAPS2_CUBEMAP_POSITIVEY标志的按位 OR 组合。
在 Dds.h 中定义的DDS_CUBEMAP_NEGATIVEY标志是DDSCAPS2_CUBEMAP和DDSCAPS2_CUBEMAP_NEGATIVEY标志的按位 OR 组合。
在 Dds.h 中定义的DDS_CUBEMAP_POSITIVEZ标志是DDSCAPS2_CUBEMAP和DDSCAPS2_CUBEMAP_POSITIVEZ标志的按位 OR 组合。
DDS_CUBEMAP_NEGATIVEZ标志(在 Dds.h 中定义)是DDSCAPS2_CUBEMAP和DDSCAPS2_CUBEMAP_NEGATIVEZ标志的按位 OR 组合。
在 Dds.h 中定义的DDS_CUBEMAP_ALLFACES标志是DDS_CUBEMAP_POSITIVEX、DDS_CUBEMAP_NEGATIVEX、DDS_CUBEMAP_POSITIVEY、DDS_CUBEMAP_NEGATIVEY、DDS_CUBEMAP_POSITIVEZ和DDSCAPS2_CUBEMAP_NEGATIVEZ标志的按位 OR 组合。
在 Dds.h 中定义的DDS_FLAGS_VOLUME标志等于 DDSCAPS2_VOLUME 标志。
注意
尽管 Direct3D 9 支持部分多维数据集映射,但 Direct3D 10、10.1 和 11 要求定义所有六个多维数据集映射面, (即,必须设置DDS_CUBEMAP_ALLFACES) 。
dwCaps3
类型: DWORD
未使用。
dwCaps4
类型: DWORD
未使用。
dwReserved2
类型: DWORD
未使用。