wglRealizeLayerPalette 関数 (wingdi.h)

[アーティクル]
03/04/2024

wglRealizeLayerPalette 関数は、指定されたカラーインデックスレイヤープレーンのパレットエントリを物理パレットにマップするか、RGBA レイヤープレーンのパレットを初期化します。

構文

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

パラメーター

unnamedParam1

レイヤプレーンパレットを物理パレットに表示するウィンドウのデバイスコンテキストを指定します。

unnamedParam2

オーバーレイまたはアンダーレイ平面を指定します。 iLayerPlane の正の値はオーバーレイプレーンを識別します。ここで、1 はメイン平面上の最初のオーバーレイプレーン、2 は最初のオーバーレイプレーン上の 2 番目のオーバーレイプレーンなどです。負の値を指定すると、アンダーレイ平面が識別されます。ここで、1 はメイン平面の下の最初のアンダーレイ平面、2 は最初のアンダーレイ平面の下の 2 番目のアンダーレイ平面などです。オーバーレイ面とアンダーレイ平面の数は、PIXELFORMATDESCRIPTOR 構造体の bReserved メンバーで指定されます。

unnamedParam3

パレットを物理パレットに表示するかどうかを示します。 bRealize が TRUE の場合、パレットエントリは使用可能な場合は物理パレットにマップされます。 bRealize が FALSE の場合、ウィンドウのレイヤープレーンのパレットエントリは不要になり、別のフォアグラウンドウィンドウで使用するために解放される可能性があります。

戻り値

関数が成功した場合、bRealize が TRUE で物理パレットが使用できない場合でも、戻り値は TRUE になります。関数が失敗した場合、またはピクセル形式が選択されていない場合、戻り値は FALSE です。詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

レイヤープレーンの物理パレットは、レイヤープレーンを持つウィンドウ間で共有されるリソースです。複数のウィンドウが特定の物理レイヤープレーンのパレットを実現しようとすると、一度に 1 つのパレットのみが実現されます。 wglRealizeLayerPalette 関数を呼び出すと、フォアグラウンドウィンドウのレイヤーパレットが常に最初に実現されます。

ウィンドウのレイヤーパレットが実現されると、そのパレットエントリは常に 1 対 1 で物理パレットにマップされます。 GDI 論理パレットとは異なり、 wglRealizeLayerPalette では、他のウィンドウのレイヤーパレットを現在の物理パレットにマッピングする必要はありません。

ウィンドウがフォアグラウンドウィンドウになったら、 wglRealizeLayerPalette を呼び出して、レイヤープレーンのピクセルタイプが RGBA であっても、レイヤーパレットを再び実現します。

wglRealizeLayerPalette はメインプレーンのパレットを認識しないため、GDI パレット関数を使用してメインプレーンパレットを実現します。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	wingdi.h
Library	Opengl32.lib
[DLL]	Opengl32.dll