Structure PIXELFORMATDESCRIPTOR (wingdi.h)

La structure PIXELFORMATDESCRIPTOR décrit le format de pixel d’une surface de dessin.

Syntaxe

typedef struct tagPIXELFORMATDESCRIPTOR {
  WORD  nSize;
  WORD  nVersion;
  DWORD dwFlags;
  BYTE  iPixelType;
  BYTE  cColorBits;
  BYTE  cRedBits;
  BYTE  cRedShift;
  BYTE  cGreenBits;
  BYTE  cGreenShift;
  BYTE  cBlueBits;
  BYTE  cBlueShift;
  BYTE  cAlphaBits;
  BYTE  cAlphaShift;
  BYTE  cAccumBits;
  BYTE  cAccumRedBits;
  BYTE  cAccumGreenBits;
  BYTE  cAccumBlueBits;
  BYTE  cAccumAlphaBits;
  BYTE  cDepthBits;
  BYTE  cStencilBits;
  BYTE  cAuxBuffers;
  BYTE  iLayerType;
  BYTE  bReserved;
  DWORD dwLayerMask;
  DWORD dwVisibleMask;
  DWORD dwDamageMask;
} PIXELFORMATDESCRIPTOR, *PPIXELFORMATDESCRIPTOR, *LPPIXELFORMATDESCRIPTOR;

Membres

nSize

Spécifie la taille de cette structure de données. Cette valeur doit être définie sur sizeof(PIXELFORMATDESCRIPTOR).

nVersion

Spécifie la version de cette structure de données. Cette valeur doit être définie sur 1.

dwFlags

Ensemble d’indicateurs de bits qui spécifient les propriétés de la mémoire tampon de pixels. Les propriétés ne s’excluent généralement pas mutuellement ; vous pouvez définir n’importe quelle combinaison d’indicateurs de bits, avec les exceptions notées. Les constantes d’indicateur de bits suivantes sont définies.

Vous pouvez spécifier les indicateurs de bits suivants lors de l’appel de ChoosePixelFormat.

Avec la fonction d’extension glAddSwapHintRectWIN , deux nouveaux indicateurs sont inclus pour la structure de format de pixel PIXELFORMATDESCRIPTOR .

iPixelType

Spécifie le type de données de pixels. Les types suivants sont définis.

cColorBits

Spécifie le nombre de plans de bits de couleur dans chaque mémoire tampon de couleur. Pour les types de pixels RVBA, il s’agit de la taille de la mémoire tampon de couleurs, à l’exclusion des plans de bits alpha. Pour les pixels d’index de couleur, il s’agit de la taille de la mémoire tampon color-index.

cRedBits

Spécifie le nombre de plans de bits rouges dans chaque mémoire tampon de couleurs RVBA.

cRedShift

Spécifie le nombre de décalages pour les plans de bits rouges dans chaque mémoire tampon de couleurs RVBA.

cGreenBits

Spécifie le nombre de plans de bits verts dans chaque mémoire tampon de couleurs RVBA.

cGreenShift

Spécifie le nombre de décalages pour les plans de bits verts dans chaque mémoire tampon de couleurs RVBA.

cBlueBits

Spécifie le nombre de plans de bits bleus dans chaque mémoire tampon de couleurs RVBA.

cBlueShift

Spécifie le nombre de décalages pour les plans de bits bleus dans chaque mémoire tampon de couleurs RVBA.

cAlphaBits

Spécifie le nombre de plans de bits alpha dans chaque mémoire tampon de couleurs RVBA. Les plans de bits alpha ne sont pas pris en charge.

cAlphaShift

Spécifie le nombre de décalages pour les plans de bits alpha dans chaque mémoire tampon de couleurs RVBA. Les plans de bits alpha ne sont pas pris en charge.

cAccumBits

Spécifie le nombre total de plans de bits dans la mémoire tampon d’accumulation.

cAccumRedBits

Spécifie le nombre de plans de bits rouges dans la mémoire tampon d’accumulation.

cAccumGreenBits

Spécifie le nombre de plans de bits verts dans la mémoire tampon d’accumulation.

cAccumBlueBits

Spécifie le nombre de plans de bits bleus dans la mémoire tampon d’accumulation.

cAccumAlphaBits

Spécifie le nombre de plans de bits alpha dans la mémoire tampon d’accumulation.

cDepthBits

Spécifie la profondeur de la mémoire tampon de profondeur (axe z).

cStencilBits

Spécifie la profondeur de la mémoire tampon de gabarit.

cAuxBuffers

Spécifie le nombre de mémoires tampons auxiliaires. Les mémoires tampons auxiliaires ne sont pas prises en charge.

iLayerType

Ignoré. Les implémentations antérieures d’OpenGL utilisaient ce membre, mais il n’est plus utilisé.

bReserved

Spécifie le nombre de plans de superposition et de sous-couche. Les bits 0 à 3 spécifient jusqu’à 15 plans de superposition et les bits 4 à 7 spécifient jusqu’à 15 plans de sous-couche.

dwLayerMask

Ignoré. Les implémentations antérieures d’OpenGL utilisaient ce membre, mais il n’est plus utilisé.

dwVisibleMask

Spécifie la couleur transparente ou l’index d’un plan sous-jacent. Lorsque le type de pixel est RVBA, dwVisibleMask est une valeur de couleur RVB transparente. Lorsque le type de pixel est un index de couleur, il s’agit d’une valeur d’index transparente.

dwDamageMask

Ignoré. Les implémentations antérieures d’OpenGL utilisaient ce membre, mais il n’est plus utilisé.

Remarques

Notez soigneusement, comme indiqué ci-dessus, que certaines propriétés de format de pixels ne sont pas prises en charge dans l’implémentation générique actuelle. L’implémentation générique est l’implémentation logicielle Microsoft GDI d’OpenGL. Les fabricants de matériel peuvent améliorer certaines parties d’OpenGL et peuvent prendre en charge certaines propriétés de format de pixels non prises en charge par l’implémentation générique.

Configuration requise

Voir aussi

ChoosePixelFormat

DescribePixelFormat

GetPixelFormat

OpenGL sur Windows

SetPixelFormat

Structures