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;
};

Elemente

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	Description	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 Daten des Alphakanals verwendet (dwRGBBitCount enthält die Alphakanal-Bitanzahl; dwABitMask enthält gültige Daten)	0 x 2
DDPF_FOURCC	dwFourCC enthält gültige Daten.	0 x 4
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 nicht komprimierte Daten (dwRGBBitCount enthält die Bitanzahl des Leuchtdichtekanals; 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. A FourCC of DX10 indicates the prescense of the DDS_HEADER_DXT10 extended header, and the dxgiFormat member of that structure indicates the true format. Bei Verwendung eines vierstelligen Codes muss dwFlags DDPF_FOURCC enthalten.

dwRGBBitCount

Typ: DWORD

Die 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 Leuchtdichte oder Y) zum Lesen von Farbdaten. Bei A8R8G8B8 Format wäre beispielsweise die rote Maske 0x00ff0000.

dwGBitMask

Typ: DWORD

Grüne Maske (oder U) zum Lesen von Farbdaten. Bei A8R8G8B8 Format wäre beispielsweise die grüne Maske 0x0000ff00.

dwBBitMask

Typ: DWORD

Blaue Maske (oder V) zum Lesen von Farbdaten. Beispielsweise wäre die blaue Maske aufgrund des A8R8G8B8-Formats 0x000000ff.

dwABitMask

Typ: DWORD

Alphaformat zum Lesen von Alphadaten. dwFlags müssen DDPF_ALPHAPIXELS oder DDPF_ALPHA enthalten. Beispielsweise wäre die Alphamaske aufgrund des A8R8G8B8-Formats 0xff000000.

Bemerkungen

Verwenden Sie zum Speichern von DXGI-Formaten wie Gleitkommadaten eine 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-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, die D3DFORMAT im Vergleich zu DXGI_FORMAT Werten mit diesem nicht standardmäßigen Schema zu disambiguieren, sodass stattdessen der DX10-Erweiterungsheader empfohlen wird.

Anforderungen

Siehe auch

Referenz für DDS