wglGetLayerPaletteEntries 関数 (wingdi.h)

[アーティクル]
08/27/2023

指定したデバイスコンテキストの特定のカラーインデックスレイヤープレーンからパレットエントリを取得します。

構文

int wglGetLayerPaletteEntries(
  HDC      unnamedParam1,
  int      unnamedParam2,
  int      unnamedParam3,
  int      unnamedParam4,
  COLORREF *unnamedParam5
);

パラメーター

unnamedParam1

種類: HDC

レイヤープレーンを記述するウィンドウのデバイスコンテキスト。

unnamedParam2

型: int

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

unnamedParam3

型: int

取得する最初のパレットエントリ。

unnamedParam4

型: int

取得するパレットエントリの数。

unnamedParam5

種類: COLORREF*

パレット RGB カラー値を含む構造体の配列。配列には、 cEntries で指定された数以上の構造体が含まれている必要があります。

戻り値

型: int

関数が成功した場合、戻り値は、ウィンドウの指定されたレイヤープレーン内のパレットで設定されたエントリの数です。

関数が失敗した場合、またはピクセル形式が選択されていない場合、戻り値は 0 になります。詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

ウィンドウ内の各カラーインデックスレイヤープレーンには、サイズが 2^n のパレットがあります。 n はレイヤープレーン内のビットプレーンの数です。パレットの透明なインデックスを変更することはできません。

レイヤーパレットを実現するには、 wglRealizeLayerPalette 関数を使用します。最初は、レイヤーパレットには白のエントリのみが含まれます。

要件

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