DDS _ PIXELFORMAT-Struktur
Oberflächenpixelformat.
Syntax
struct DDS_PIXELFORMAT {
DWORD dwSize;
DWORD dwFlags;
DWORD dwFourCC;
DWORD dwRGBBitCount;
DWORD dwRBitMask;
DWORD dwGBitMask;
DWORD dwBBitMask;
DWORD dwABitMask;
};
Member
-
dwSize
-
Typ: DWORD
-
Strukturgröße; auf 32 (Bytes) festgelegt.
-
dwFlags
-
Typ: DWORD
-
Werte, die angeben, welcher Datentyp sich auf der Oberfläche befindet.
Flag Beschreibung Wert DDPF _ ALPHAPIXELS Textur enthält Alphadaten. dwRGBAlphaBitMask enthält gültige Daten. 0x1 DDPF _ ALPHA Wird in einigen älteren DDS-Dateien nur für nicht komprimierte Alphakanaldaten verwendet (dwRGBBitCount enthält die Alphakanalbitcount, dwABitMask enthält gültige Daten) 0x2 DDPF _ FOURCC Textur enthält komprimierte RGB-Daten. dwFourCC enthält gültige Daten. 0x4 DDPF _ RGB Die Textur enthält unkomprimierte RGB-Daten. dwRGBBitCount und die RGB-Masken (dwRBitMask, dwGBitMask, dwBBitMask) enthalten gültige Daten. 0x40 DDPF _ YUV Wird in einigen älteren DDS-Dateien für unkomprimierte YUV-Daten verwendet (dwRGBBitCount enthält die YUV-Bitanzahl; dwRBitMask enthält die Y-Maske, dwGBitMask enthält die U-Maske, dwBBitMask enthält die V-Maske). 0x200 _DDPF-LEUCHTDICHTE Wird in einigen älteren DDS-Dateien für unkomprimierte Daten mit einzelner Kanalfarbe verwendet (dwRGBBitCount enthält die Bitanzahl des Leuchtkanals; dwRBitMask enthält die Kanalmaske). Kann mit DDPF _ ALPHAPIXELS für eine DDS-Datei mit zwei Kanälen kombiniert werden. 0x20000 -
dwFourCC
-
Typ: DWORD
-
Vierstellige Codes zum Angeben komprimierter oder benutzerdefinierter Formate. Mögliche Werte sind: DXT1, DXT2, DXT3, DXT4 oder DXT5. Ein FourCC von DX10 gibt die Präsense des erweiterten DDS _ HEADER _ DXT10-Headers an, und der dxgiFormat-Member dieser Struktur gibt das true-Format an. Bei Verwendung eines vierstelligen Codes muss dwFlags DDPF _ FOURCC enthalten.
-
dwRGBBitCount
-
Typ: DWORD
-
Anzahl der Bits in einem RGB-Format (möglicherweise einschließlich Alpha). Gültig, wenn dwFlags DDPF _ RGB, DDPF _ LUMINANCE oder DDPF _ YUV enthält.
-
dwRBitMask
-
Typ: DWORD
-
Rote Maske (oder Leuchtdichte oder Y) zum Lesen von Farbdaten. Beispielsweise wäre die rote Maske im Format A8R8G8B8 0x00ff0000.
-
dwGBitMask
-
Typ: DWORD
-
Grüne (oder U)-Maske zum Lesen von Farbdaten. Beispielsweise wäre die grüne Maske im Format A8R8G8B8 0x0000ff00.
-
dwBBitMask
-
Typ: DWORD
-
Blaue (oder V)-Maske zum Lesen von Farbdaten. Beispielsweise wäre die blaue Maske im Format A8R8G8B8 0x000000ff.
-
dwABitMask
-
Typ: DWORD
-
Alphamaske zum Lesen von Alphadaten. dwFlags muss DDPF _ ALPHAPIXELS oder DDPF _ ALPHA enthalten. Beispielsweise wäre die Alphamaske im Format A8R8G8B8 0xff000000.
Hinweise
Um DXGI-Formate wie Gleitkommadaten zu speichern, verwenden Sie dwFlags von DDPF _ FOURCC, und legen Sie dwFourCC auf "D", "X", "1", "0" fest. Verwenden Sie den DDS _ HEADER _ DXT10-Erweiterungsheader, um das DXGI-Format im dxgiFormat-Member zu speichern.
Beachten Sie, dass es nicht standardmäßige Varianten von DDS-Dateien gibt, bei denen dwFlags über DDPF _ FOURCC verfügt und der dwFourCC-Wert direkt auf einen D3DFORMAT- oder DXGI _ FORMAT-Enumerationswert festgelegt ist. Es ist nicht möglich, die D3DFORMAT- und DXGI _ FORMAT-Werte mit diesem nicht standardmäßigen Schema zu unterscheiden. Daher wird stattdessen der DX10-Erweiterungsheader empfohlen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|