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

Siehe auch

Referenz für DDS