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
Dds.h

Siehe auch

Referenz für DDS