DDS_PIXELFORMAT structuur

Surface pixel format.

Syntaxis

struct DDS_PIXELFORMAT {
  DWORD dwSize;
  DWORD dwFlags;
  DWORD dwFourCC;
  DWORD dwRGBBitCount;
  DWORD dwRBitMask;
  DWORD dwGBitMask;
  DWORD dwBBitMask;
  DWORD dwABitMask;
};

Members

dwSize

Type: DWORD

Structuurgrootte; ingesteld op 32 (bytes).

dwFlags

Type: DWORD

Waarden die aangeven welk type gegevens zich in het oppervlak bevindt.

Flag	Description	Waarde
DDPF_ALPHAPIXELS	Patroon bevat alfagegevens; dwRGBAlphaBitMask bevat geldige gegevens.	0x1
DDPF_ALPHA	Wordt gebruikt in sommige oudere DDS-bestanden voor alfakanaal alleen niet-gecomprimeerde gegevens (dwRGBBitCount bevat het alfakanaal bitcount; dwABitMask bevat geldige gegevens)	0x2
DDPF_FOURCC	dwFourCC bevat geldige gegevens.	0x4
DDPF_RGB	Bitmappatroon bevat niet-gecomprimeerde RGB-gegevens; dwRGBBitCount en de RGB-maskers (dwRBitMask, dwGBitMask, dwBBitMask) bevatten geldige gegevens.	0x40
DDPF_YUV	Wordt gebruikt in sommige oudere DDS-bestanden voor niet-gecomprimeerde YUV-gegevens (dwRGBBitCount bevat het AANTAL YUV-bits; dwRBitMask bevat het Y-masker, dwGBitMask bevat het U-masker, dwBBitMask bevat het V-masker)	0x200
DDPF_LUMINANCE	Wordt gebruikt in sommige oudere DDS-bestanden voor niet-gecomprimeerde gegevens met één kanaalkleur (dwRGBBitCount bevat het aantal luminance-kanaalbits; dwRBitMask bevat het kanaalmasker). Kan worden gecombineerd met DDPF_ALPHAPIXELS voor een DDS-bestand met twee kanalen.	0x20000

dwFourCC

Type: DWORD

Codes met vier tekens voor het opgeven van gecomprimeerde of aangepaste indelingen. Mogelijke waarden zijn: DXT1, DXT2, DXT3, DXT4 of DXT5. Een FourCC van DX10 geeft de prescense van de DDS_HEADER_DXT10 uitgebreide header aan en het dxgiFormat-lid van die structuur geeft de werkelijke indeling aan. Wanneer u een code van vier tekens gebruikt, moet dwFlags DDPF_FOURCC bevatten.

dwRGBBitCount

Type: DWORD

Aantal bits in een RGB-indeling (mogelijk inclusief alfa). Geldig wanneer dwFlagsDDPF_RGB, DDPF_LUMINANCE of DDPF_YUV bevat.

dwRBitMask

Type: DWORD

Rood (of luminantie of Y)-masker voor het lezen van kleurgegevens. Op basis van de A8R8G8B8-indeling wordt het rode masker bijvoorbeeld 0x00ff0000.

dwGBitMask

Type: DWORD

Groen masker (of U) voor het lezen van kleurgegevens. Op basis van de A8R8G8B8-indeling wordt het groene masker bijvoorbeeld 0x0000ff00.

dwBBitMask

Type: DWORD

Blauw masker (of V) voor het lezen van kleurgegevens. Op basis van de A8R8G8B8-indeling wordt het blauwe masker bijvoorbeeld 0x000000ff.

dwABitMask

Type: DWORD

Alfamasker voor het lezen van alfagegevens. dwFlags moet DDPF_ALPHAPIXELS of DDPF_ALPHA bevatten. Op basis van de A8R8G8B8-indeling wordt het alfamasker bijvoorbeeld 0xff000000.

Opmerkingen

Als u DXGI-indelingen zoals drijvendekommagegegevens wilt opslaan, gebruikt u een dwFlags van DDPF_FOURCC en stelt u dwFourCC in op 'D','X','1','0'. Gebruik de DDS_HEADER_DXT10 extensieheader om de DXGI-indeling op te slaan in het dxgiFormat-lid .

Houd er rekening mee dat er niet-standaardvarianten van DDS-bestanden zijn waarbij dwFlags DDPF_FOURCC heeft en de dwFourCC-waarde rechtstreeks is ingesteld op een D3DFORMAT of DXGI_FORMAT opsommingswaarde. Het is niet mogelijk om de D3DFORMAT versus DXGI_FORMAT waarden te ontkoppelen met behulp van dit niet-standaardschema, dus wordt de DX10-extensieheader aanbevolen.

Requirements

Zie ook

Naslaginformatie voor DDS