structure de DDS_PIXELFORMAT

Format de pixel surface.

Syntaxe

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

Members

dwSize

Type : DWORD

Taille de la structure ; défini sur 32 (octets).

dwFlags

Type : DWORD

Valeurs qui indiquent le type de données dans la surface.

Flag	Descriptif	Valeur
DDPF_ALPHAPIXELS	La texture contient des données alpha ; dwRGBAlphaBitMask contient des données valides.	0x1
DDPF_ALPHA	Utilisé dans certains fichiers DDS plus anciens pour les données alpha canal uniquement non compressées (dwRGBBitCount contient le nombre de bits de canal alpha ; dwABitMask contient des données valides)	0x2
DDPF_FOURCC	dwFourCC contient des données valides.	0x4
DDPF_RGB	La texture contient des données RVB non compressées ; dwRGBBitCount et les masques RVB (dwRBitMask, dwGBitMask, dwBBitMask) contiennent des données valides.	0x40
DDPF_YUV	Utilisé dans certains fichiers DDS plus anciens pour les données non compressées YUV (dwRGBBitCount contient le nombre de bits YUV ; dwRBitMask contient le masque Y, dwGBitMask contient le masque U, dwBBitMask contient le masque V)	0x200
DDPF_LUMINANCE	Utilisé dans certains fichiers DDS plus anciens pour les données non compressées de couleur de canal unique (dwRGBBitCount contient le nombre de bits de canal luminance ; dwRBitMask contient le masque de canal). Peut être combiné avec DDPF_ALPHAPIXELS pour un fichier DDS à deux canaux.	0x20000

dwFourCC

Type : DWORD

Codes à quatre caractères pour spécifier des formats compressés ou personnalisés. Les valeurs possibles sont les suivantes : DXT1, DXT2, DXT3, DXT4 ou DXT5. Un FourCC de DX10 indique le préscense de l’en-tête étendu DDS_HEADER_DXT10 , et le membre dxgiFormat de cette structure indique le format vrai. Lorsque vous utilisez un code à quatre caractères, dwFlags doit inclure DDPF_FOURCC.

dwRGBBitCount

Type : DWORD

Nombre de bits dans un format RVB (éventuellement alpha). Valide lorsque dwFlags inclut DDPF_RGB, DDPF_LUMINANCE ou DDPF_YUV.

dwRBitMask

Type : DWORD

Masque rouge (ou luminance ou Y) pour la lecture des données de couleur. Par exemple, étant donné le format A8R8G8B8, le masque rouge serait 0x00ff0000.

dwGBitMask

Type : DWORD

Masque vert (ou U) pour la lecture des données de couleur. Par exemple, étant donné le format A8R8G8B8, le masque vert serait 0x0000ff00.

dwBBitMask

Type : DWORD

Masque bleu (ou V) pour la lecture des données de couleur. Par exemple, étant donné le format A8R8G8B8, le masque bleu serait 0x000000ff.

dwABitMask

Type : DWORD

Masque alpha pour la lecture des données alpha. dwFlags doit inclure DDPF_ALPHAPIXELS ou DDPF_ALPHA. Par exemple, étant donné le format A8R8G8B8, le masque alpha serait 0xff000000.

Remarques

Pour stocker des formats DXGI tels que des données à virgule flottante, utilisez un dwFlags de DDPF_FOURCC et définissez dwFourCC sur « D », « X », « 1 », « 0 ». Utilisez l’en-tête d’extension DDS_HEADER_DXT10 pour stocker le format DXGI dans le membre dxgiFormat .

Notez qu’il existe des variantes non standard de fichiers DDS où dwFlags a DDPF_FOURCC et que la valeur dwFourCC est définie directement sur une valeur d’énumération D3DFORMAT ou DXGI_FORMAT. Il n’est pas possible de lever l’ambiguïté des valeurs D3DFORMAT par rapport aux valeurs DXGI_FORMAT à l’aide de ce schéma non standard. L’en-tête d’extension DX10 est donc recommandé à la place.

Spécifications

Voir aussi

Référence pour DDS