Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Beschreibt einen DDS-Dateiheader.
Syntax
typedef struct {
DWORD dwSize;
DWORD dwFlags;
DWORD dwHeight;
DWORD dwWidth;
DWORD dwPitchOrLinearSize;
DWORD dwDepth;
DWORD dwMipMapCount;
DWORD dwReserved1[11];
DDS_PIXELFORMAT ddspf;
DWORD dwCaps;
DWORD dwCaps2;
DWORD dwCaps3;
DWORD dwCaps4;
DWORD dwReserved2;
} DDS_HEADER;
Member
-
dwSize
-
Typ: DWORD
-
Größe der Struktur. Dieses Element muss auf 124 festgelegt werden.
-
dwFlags
-
Typ: DWORD
-
Flags, um anzugeben, welche Member gültige Daten enthalten.
Flag Beschreibung Wert DDSD_CAPS Erforderlich in jeder DDS-Datei. 0x1 DDSD_HEIGHT Erforderlich in jeder DDS-Datei. 0x2 DDSD_WIDTH Erforderlich in jeder DDS-Datei. 0x4 DDSD_PITCH Erforderlich, wenn die Tonhöhe für eine nicht komprimierte Textur bereitgestellt wird. 0x8 DDSD_PIXELFORMAT Erforderlich in jeder DDS-Datei. 0x1000 DDSD_MIPMAPCOUNT Erforderlich in einer mipmapped-Textur. 0x20000 DDSD_LINEARSIZE Erforderlich, wenn die Tonhöhe für eine komprimierte Textur bereitgestellt wird. 0x80000 DDSD_DEPTH Erforderlich in einer Tiefentextur. 0x800000 Hinweis
Wenn Sie DDS-Dateien schreiben, sollten Sie die DDSD_CAPS- und DDSD_PIXELFORMAT-Flags festlegen, und für mipmapped-Texturen sollten Sie auch das DDSD_MIPMAPCOUNT-Flag festlegen. Wenn Sie jedoch eine DDS-Datei lesen, sollten Sie sich nicht darauf verlassen, dass die DDSD_CAPS, DDSD_PIXELFORMAT und DDSD_MIPMAPCOUNT-Flags festgelegt werden, da einige Autoren einer solchen Datei diese Flags möglicherweise nicht festlegen.
Das in Dds.h definierte DDS_HEADER_FLAGS_TEXTURE-Flag ist eine bitweise OR-Kombination aus den DDSD_CAPS-, DDSD_HEIGHT-, DDSD_WIDTH- und DDSD_PIXELFORMAT-Flags.
Das in Dds.h definierte DDS_HEADER_FLAGS_MIPMAP-Flag entspricht dem DDSD_MIPMAPCOUNT-Flag.
Das in Dds.h definierte DDS_HEADER_FLAGS_VOLUME-Flag entspricht dem DDSD_DEPTH Flag.
Das in Dds.h definierte DDS_HEADER_FLAGS_PITCH-Flag entspricht dem DDSD_PITCH-Flag.
Das in Dds.h definierte DDS_HEADER_FLAGS_LINEARSIZE-Flag entspricht dem DDSD_LINEARSIZE-Flag.
-
dwHeight
-
Typ: DWORD
-
Oberflächenhöhe (in Pixel).
-
dwWidth
-
Typ: DWORD
-
Breite der Oberfläche (in Pixel).
-
dwPitchOrLinearSize
-
Typ: DWORD
-
Die Tonhöhe oder Anzahl von Bytes pro Scanzeile in einer nicht komprimierten Textur; die Gesamtanzahl von Bytes in der Textur der obersten Ebene für eine komprimierte Textur. Informationen zum Berechnen der Tonhöhe finden Sie im Abschnitt DDS-Dateilayout des Programmierhandbuchs für DDS.
-
dwDepth
-
Typ: DWORD
-
Tiefe einer Volumetextur (in Pixel), andernfalls nicht verwendet.
-
dwMipMapCount
-
Typ: DWORD
-
Anzahl der mipmap-Ebenen, andernfalls nicht verwendet.
-
dwReserved1[11]
-
Typ: DWORD
-
Nicht verwendet.
-
ddspf
-
Typ: DDS_PIXELFORMAT
-
Das Pixelformat (siehe DDS_PIXELFORMAT).
-
dwCaps
-
Typ: DWORD
-
Gibt die Komplexität der gespeicherten Oberflächen an.
Flag Beschreibung Wert DDSCAPS_COMPLEX Optional; muss für jede Datei verwendet werden, die mehr als eine Oberfläche enthält (eine mipmap, eine kubische Umgebungszuordnung oder eine Mipmapped-Volumetextur). 0x8 DDSCAPS_MIPMAP Optional; sollte für eine mipmap verwendet werden. 0x400000 DDSCAPS_TEXTURE Erforderlich 0x1000 Hinweis
Wenn Sie DDS-Dateien schreiben, sollten Sie das DDSCAPS_TEXTURE-Flag festlegen, und für mehrere Oberflächen sollten Sie auch das DDSCAPS_COMPLEX-Flag festlegen. Wenn Sie jedoch eine DDS-Datei lesen, sollten Sie sich nicht darauf verlassen, dass die DDSCAPS_TEXTURE und DDSCAPS_COMPLEX Flags festgelegt werden, da einige Autoren einer solchen Datei diese Flags möglicherweise nicht festlegen.
Das in Dds.h definierte DDS_SURFACE_FLAGS_MIPMAP-Flag ist eine bitweise OR-Kombination aus den DDSCAPS_COMPLEX- und DDSCAPS_MIPMAP-Flags.
Das in Dds.h definierte DDS_SURFACE_FLAGS_TEXTURE-Flag entspricht dem DDSCAPS_TEXTURE-Flag.
Das in Dds.h definierte DDS_SURFACE_FLAGS_CUBEMAP-Flag entspricht dem DDSCAPS_COMPLEX-Flag.
-
dwCaps2
-
Typ: DWORD
-
Zusätzliche Details zu den gespeicherten Oberflächen.
Flag Beschreibung Wert DDSCAPS2_CUBEMAP Erforderlich für eine Cubezuordnung. 0x200 DDSCAPS2_CUBEMAP_POSITIVEX Erforderlich, wenn diese Oberflächen in einer Cubezuordnung gespeichert werden. 0x400 DDSCAPS2_CUBEMAP_NEGATIVEX Erforderlich, wenn diese Oberflächen in einer Cubezuordnung gespeichert werden. 0x800 DDSCAPS2_CUBEMAP_POSITIVEY Erforderlich, wenn diese Oberflächen in einer Cubezuordnung gespeichert werden. 0x1000 DDSCAPS2_CUBEMAP_NEGATIVEY Erforderlich, wenn diese Oberflächen in einer Cubezuordnung gespeichert werden. 0x2000 DDSCAPS2_CUBEMAP_POSITIVEZ Erforderlich, wenn diese Oberflächen in einer Cubezuordnung gespeichert werden. 0x4000 DDSCAPS2_CUBEMAP_NEGATIVEZ Erforderlich, wenn diese Oberflächen in einer Cubezuordnung gespeichert werden. 0x8000 DDSCAPS2_VOLUME Erforderlich für eine Volumetextur. 0x200000 Das in Dds.h definierte DDS_CUBEMAP_POSITIVEX-Flag ist eine bitweise OR-Kombination aus den DDSCAPS2_CUBEMAP- und DDSCAPS2_CUBEMAP_POSITIVEX-Flags.
Das in Dds.h definierte DDS_CUBEMAP_NEGATIVEX-Flag ist eine bitweise OR-Kombination aus den DDSCAPS2_CUBEMAP- und DDSCAPS2_CUBEMAP_NEGATIVEX-Flags.
Das in Dds.h definierte DDS_CUBEMAP_POSITIVEY-Flag ist eine bitweise OR-Kombination aus den DDSCAPS2_CUBEMAP- und DDSCAPS2_CUBEMAP_POSITIVEY-Flags.
Das in Dds.h definierte DDS_CUBEMAP_NEGATIVEY-Flag ist eine bitweise OR-Kombination aus den DDSCAPS2_CUBEMAP- und DDSCAPS2_CUBEMAP_NEGATIVEY-Flags.
Das in Dds.h definierte DDS_CUBEMAP_POSITIVEZ-Flag ist eine bitweise OR-Kombination aus den DDSCAPS2_CUBEMAP- und DDSCAPS2_CUBEMAP_POSITIVEZ-Flags.
Das in Dds.h definierte DDS_CUBEMAP_NEGATIVEZ-Flag ist eine bitweise OR-Kombination aus den DDSCAPS2_CUBEMAP- und DDSCAPS2_CUBEMAP_NEGATIVEZ-Flags.
Das in Dds.h definierte DDS_CUBEMAP_ALLFACES-Flag ist eine bitweise OR-Kombination aus den Flags DDS_CUBEMAP_POSITIVEX, DDS_CUBEMAP_NEGATIVEX, DDS_CUBEMAP_POSITIVEY, DDS_CUBEMAP_NEGATIVEY, DDS_CUBEMAP_POSITIVEZ und DDSCAPS2_CUBEMAP_NEGATIVEZ.
Das in Dds.h definierte DDS_FLAGS_VOLUME-Flag entspricht dem DDSCAPS2_VOLUME-Flag.
Hinweis
Obwohl Direct3D 9 partielle Cubezuordnungen unterstützt, erfordern Direct3D 10, 10.1 und 11, dass Sie alle sechs Cubezuordnungsflächen definieren (d. h. Sie müssen DDS_CUBEMAP_ALLFACES festlegen).
-
dwCaps3
-
Typ: DWORD
-
Nicht verwendet.
-
dwCaps4
-
Typ: DWORD
-
Nicht verwendet.
-
dwReserved2
-
Typ: DWORD
-
Nicht verwendet.
Bemerkungen
Schließen Sie Flags in dwFlags für die Member der Struktur ein, die gültige Daten enthalten.
Verwenden Sie diese Struktur in Kombination mit einem DDS_HEADER_DXT10 , um ein Ressourcenarray in einer DDS-Datei zu speichern. Weitere Informationen finden Sie unter Texturarrays.
DDS_HEADER ist mit der DirectDraw DDSURFACEDESC2-Struktur ohne DirectDraw-Abhängigkeiten identisch.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|