DDS_PIXELFORMAT-Struktur
Surface-Pixelformat.
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, welche Art von Daten 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 unkomprimierte Alphakanaldaten verwendet (dwRGBBitCount enthält die Alphakanal-Bitanzahl; dwABitMask enthält gültige Daten). 0x2 DDPF_FOURCC Textur enthält komprimierte RGB-Daten. dwFourCC enthält gültige Daten. 0x4 DDPF_RGB 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_LUMINANCE Wird in einigen älteren DDS-Dateien für unkomprimierte Einzelkanalfarbdaten verwendet (dwRGBBitCount enthält die Luminanzkanalbitanzahl; 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äsensierung des DDS_HEADER_DXT10 erweiterten 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 dwFlagsDDPF_RGB, DDPF_LUMINANCE oder DDPF_YUV enthält.
-
dwRBitMask
-
Typ: DWORD
-
Rote Maske (oder Luminanz oder Y) zum Lesen von Farbdaten. Bei instance wäre die rote Maske angesichts des A8R8G8B8-Formats 0x00ff0000.
-
dwGBitMask
-
Typ: DWORD
-
Grüne Maske (oder U) zum Lesen von Farbdaten. Bei instance wäre die grüne Maske angesichts des A8R8G8B8-Formats 0x0000ff00.
-
dwBBitMask
-
Typ: DWORD
-
Blaue Maske (oder V) zum Lesen von Farbdaten. Bei instance wäre die blaue Maske angesichts des A8R8G8B8-Formats 0x000000ff.
-
dwABitMask
-
Typ: DWORD
-
Alphamaske zum Lesen von Alphadaten. dwFlags muss DDPF_ALPHAPIXELS oder DDPF_ALPHA enthalten. Bei instance wäre die Alphamaske angesichts des A8R8G8B8-Formats 0xff000000.
Bemerkungen
Verwenden Sie zum Speichern von DXGI-Formaten wie Gleitkommadaten einen dwFlags-Wert 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-Element zu speichern.
Beachten Sie, dass es nicht standardmäßige Varianten von DDS-Dateien gibt, bei denen dwFlags DDPF_FOURCC hat und der dwFourCC-Wert direkt auf einen D3DFORMAT- oder DXGI_FORMAT-Enumerationswert festgelegt wird. Es ist nicht möglich, das D3DFORMAT im Vergleich zu DXGI_FORMAT Werten mit diesem nicht standardmäßigen Schema zu trennen, daher wird stattdessen der DX10-Erweiterungsheader empfohlen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|