wglRealizeLayerPalette, fonction (wingdi.h)

La fonction wglRealizeLayerPalette mappe les entrées de palette d’un plan de couche d’index de couleur donné dans la palette physique ou initialise la palette d’un plan de couche RGBA.

Syntaxe

BOOL wglRealizeLayerPalette(
  HDC  unnamedParam1,
  int  unnamedParam2,
  BOOL unnamedParam3
);

Paramètres

unnamedParam1

Spécifie le contexte d’appareil d’une fenêtre dont la palette de plan de couche doit être réalisée dans la palette physique.

unnamedParam2

Spécifie le plan de superposition ou de sous-couche. Les valeurs positives d’iLayerPlane identifient les plans de superposition, où 1 est le premier plan de superposition au-dessus du plan de main, 2 est le deuxième plan de superposition sur le premier plan de superposition, et ainsi de suite. Les valeurs négatives identifient les plans de sous-couche, où 1 est le premier plan de sous-couche sous le plan de main, 2 est le deuxième plan de sous-couche sous le premier plan de sous-couche, et ainsi de suite. Le nombre de plans de superposition et de sous-couche est indiqué dans le membre bReserved de la structure PIXELFORMATDESCRIPTOR .

unnamedParam3

Indique si la palette doit être réalisée dans la palette physique. Lorsque bRealize a la valeur TRUE, les entrées de palette sont mappées dans la palette physique lorsqu’elles sont disponibles. Lorsque bRealize a la valeur FALSE, les entrées de palette pour le plan de couche de la fenêtre ne sont plus nécessaires et peuvent être utilisées par une autre fenêtre de premier plan.

Valeur retournée

Si la fonction réussit, la valeur de retour est TRUE, même si bRealize a la valeur TRUE et que la palette physique n’est pas disponible. Si la fonction échoue ou si aucun format de pixel n’est sélectionné, la valeur de retour est FALSE. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

La palette physique d’un plan de couche est une ressource partagée entre les fenêtres avec des plans de couche. Lorsque plusieurs fenêtres tentent de réaliser une palette pour un plan de couche physique donné, une seule palette à la fois est réalisée. Lorsque vous appelez la fonction wglRealizeLayerPalette , la palette de couches d’une fenêtre de premier plan est toujours réalisée en premier.

Lorsque la palette de calques d’une fenêtre est réalisée, ses entrées de palette sont toujours mappées un-à-un dans la palette physique. Contrairement aux palettes logiques GDI, avec wglRealizeLayerPalette , il n’existe aucun mappage des palettes de couches d’autres fenêtres à la palette physique actuelle.

Chaque fois qu’une fenêtre devient la fenêtre de premier plan, appelez wglRealizeLayerPalette pour réaliser à nouveau ses palettes de couches, même si le type de pixel du plan de couche est RVBA.

Étant donné que wglRealizeLayerPalette ne réalise pas la palette du plan main, utilisez les fonctions de palette GDI pour réaliser la palette de plan main.

Configuration requise

Voir aussi

LAYERPLANEDESCRIPTOR

OpenGL sur Windows

PIXELFORMATDESCRIPTOR

Fonctions WGL

wglDescribeLayerPlane

wglGetLayerPaletteEntries

wglRealizeLayerPalette

wglSetLayerPaletteEntries