DDS_PIXELFORMAT struttura

Formato pixel di superficie.

Sintassi

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

Members

dwSize

Tipo: DWORD

Dimensioni della struttura; impostato su 32 (byte).

dwFlags

Tipo: DWORD

Valori che indicano il tipo di dati nell'area.

Flag	Descrizione	Valore
DDPF_ALPHAPIXELS	La trama contiene dati alfa; dwRGBAlphaBitMask contiene dati validi.	0x1
DDPF_ALPHA	Usato in alcuni file DDS meno recenti solo per i dati non compressi (dwRGBBitCount contiene il numero di bitcount del canale alfa; dwABitMask contiene dati validi)	0x2
DDPF_FOURCC	La trama contiene dati RGB compressi; dwFourCC contiene dati validi.	0x4
DDPF_RGB	La trama contiene dati RGB non compressi; dwRGBBitCount e le maschere RGB (dwRBitMask, dwGBitMask, dwBBitMask) contengono dati validi.	0x40
DDPF_YUV	Usato in alcuni file DDS meno recenti per i dati non compressi YUV (dwRGBBitCount contiene il conteggio dei bit YUV; dwRBitMask contiene la maschera Y, dwGBitMask contiene la maschera U mask, dwBBitMask contiene la maschera V)	0x200
DDPF_LUMINANCE	Usato in alcuni file DDS meno recenti per dati non compressi a canale singolo (dwRGBBitCount contiene il conteggio dei bit del canale di luminanza; dwRBitMask contiene la maschera del canale). Può essere combinato con DDPF_ALPHAPIXELS per un file DDS a due canali.	0x20000

dwFourCC

Tipo: DWORD

Codici a quattro caratteri per specificare formati compressi o personalizzati. I valori possibili includono: DXT1, DXT2, DXT3,DXT4 o DXT5. Un FourCC di DX10 indica il prescense dell'intestazione estesa DDS_HEADER_DXT10 e il membro dxgiFormat di tale struttura indica il formato true. Quando si usa un codice a quattro caratteri, dwFlags deve includere DDPF_FOURCC.

dwRGBBitCount

Tipo: DWORD

Numero di bit in un formato RGB (possibilmente incluso alfa). Valido quando dwFlags include DDPF_RGB, DDPF_LUMINANCE o DDPF_YUV.

dwRBitMask

Tipo: DWORD

Maschera rossa (o luminanza o Y) per la lettura dei dati dei colori. Ad esempio, dato il formato A8R8G8B8, la maschera rossa sarà 0x00ff0000.

dwGBitMask

Tipo: DWORD

Maschera verde (o U) per la lettura dei dati dei colori. Ad esempio, dato il formato A8R8G8B8, la maschera verde sarà 0x0000ff00.

dwBBitMask

Tipo: DWORD

Maschera blu (o V) per la lettura dei dati dei colori. Ad esempio, dato il formato A8R8G8B8, la maschera blu sarà 0x000000ff.

dwABitMask

Tipo: DWORD

Maschera alfa per la lettura dei dati alfa. dwFlags deve includere DDPF_ALPHAPIXELS o DDPF_ALPHA. Ad esempio, dato il formato A8R8G8B8, la maschera alfa sarà 0xff000000.

Commenti

Per archiviare formati DXGI come i dati a virgola mobile, usare un dwFlags di DDPF_FOURCC e impostare dwFourCC su 'D','X','1','0'. Usare l'intestazione di estensione DDS_HEADER_DXT10 per archiviare il formato DXGI nel membro dxgiFormat .

Si noti che esistono varianti non standard di file DDS in cui dwFlags ha DDPF_FOURCC e il valore dwFourCC è impostato direttamente su un valore di enumerazione D3DFORMAT o DXGI_FORMAT. Non è possibile disambiguare i valori D3DFORMAT rispetto ai valori DXGI_FORMAT usando questo schema non standard, pertanto è consigliabile invece l'intestazione dell'estensione DX10.

Requisiti

Requisito	Valore
Intestazione	Dds.h

Vedi anche

Riferimento per DDS