LAYERPLANEDESCRIPTOR 構造体 (wingdi.h)

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

LAYERPLANEDESCRIPTOR 構造体は、描画サーフェスのピクセル形式を表します。

構文

typedef struct tagLAYERPLANEDESCRIPTOR {
  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     iLayerPlane;
  BYTE     bReserved;
  COLORREF crTransparent;
} LAYERPLANEDESCRIPTOR, *PLAYERPLANEDESCRIPTOR, *LPLAYERPLANEDESCRIPTOR;

メンバー

nSize

このデータ構造のサイズを指定します。この値を sizeof(LAYERPLANEDESCRIPTOR) に設定します。

nVersion

このデータ構造のバージョンを指定します。この値を 1 に設定します。

dwFlags

レイヤープレーンのプロパティを指定するビットフラグのセット。プロパティは一般に相互に排他的ではありません。ビットフラグの任意の組み合わせを設定できます。例外が示されています。次のビットフラグ定数が定義されています。

値	意味
LPD_SUPPORT_OPENGL	レイヤープレーンは OpenGL 描画をサポートしています。
LPD_SUPPORT_GDI	レイヤープレーンは GDI 描画をサポートしています。 OpenGL の現在の実装では、このフラグはサポートされていません。
LPD_DOUBLEBUFFER	レイヤープレーンは二重バッファーに格納されます。レイヤープレーンは、メインプレーンが単一バッファーである場合でも、その逆の場合でも、ダブルバッファリングできます。
LPD_STEREO	レイヤープレーンは立体的です。レイヤープレーンは、メイン平面が単視である場合でも立体的であり、その逆も可能です。
LPD_SWAP_EXCHANGE	ダブルバッファーレイヤープレーンでは、カラーバッファーをスワップすると、フロントバッファーとバックバッファーの内容が交換されます。その後、バックバッファーには、スワップ前のフロントバッファーの内容が格納されます。このフラグはヒントのみであり、ドライバーによって提供されない場合があります。
LPD_SWAP_COPY	ダブルバッファーレイヤープレーンでは、カラーバッファーをスワップすると、バックバッファーの内容がフロントバッファーにコピーされます。スワップは、バックバッファーの内容には影響しません。このフラグはヒントのみであり、ドライバーによって提供されない場合があります。
LPD_TRANSPARENT	この構造体の crTransparent メンバーには、基になるレイヤーがこのレイヤーを表示できるようにする透明な色またはインデックス値が含まれています。最小番号のアンダーレイレイヤーを除くすべてのレイヤープレーンには、透明な色またはインデックスがあります。
LPD_SHARE_DEPTH	レイヤープレーンは、深度バッファーをメインプレーンと共有します。
LPD_SHARE_STENCIL	レイヤープレーンは、ステンシルバッファーをメインプレーンと共有します。
LPD_SHARE_ACCUM	レイヤープレーンは、蓄積バッファーをメインプレーンと共有します。

iPixelType

ピクセルデータの種類を指定します。次の型が定義されています。

値	意味
LPD_TYPE_RGBA	RGBA ピクセル。各ピクセルには、赤、緑、青、アルファの 4 つのコンポーネントがあります。
LPD_TYPE_COLORINDEX	色インデックスのピクセル。各ピクセルは、色インデックス値を使用します。

cColorBits

各カラーバッファー内のカラービットプレーンの数を指定します。 RGBA ピクセルタイプの場合、アルファビットプレーンを除くカラーバッファーのサイズです。色インデックスピクセルの場合は、色インデックスバッファーのサイズです。

cRedBits

各 RGBA カラーバッファー内の赤いビットプレーンの数を指定します。

cRedShift

各 RGBA カラーバッファー内の赤いビットプレーンのシフト数を指定します。

cGreenBits

各 RGBA カラーバッファー内の緑色のビットプレーンの数を指定します。

cGreenShift

各 RGBA カラーバッファーの緑色のビットプレーンのシフト数を指定します。

cBlueBits

各 RGBA カラーバッファー内の青いビットプレーンの数を指定します。

cBlueShift

各 RGBA カラーバッファーの青いビットプレーンのシフト数を指定します。

cAlphaBits

各 RGBA カラーバッファー内のアルファビットプレーンの数を指定します。アルファビットプレーンはサポートされていません。

cAlphaShift

各 RGBA カラーバッファー内のアルファビットプレーンのシフト数を指定します。アルファビットプレーンはサポートされていません。

cAccumBits

累積バッファー内のビットプレーンの合計数を指定します。

cAccumRedBits

累積バッファー内の赤いビットプレーンの数を指定します。

cAccumGreenBits

累積バッファー内の緑色のビットプレーンの数を指定します。

cAccumBlueBits

累積バッファー内の青いビットプレーンの数を指定します。

cAccumAlphaBits

累積バッファー内のアルファビットプレーンの数を指定します。

cDepthBits

深度 (z 軸) バッファーの深さを指定します。

cStencilBits

ステンシルバッファーの深さを指定します。

cAuxBuffers

補助バッファーの数を指定します。補助バッファーはサポートされていません。

iLayerPlane

bReserved

使用されていません。ゼロを指定してください。

crTransparent

LPD_TRANSPARENT フラグが設定されている場合は、透明色またはインデックス値を指定します。通常、値は 0 です。

注釈

前述のように、特定のレイヤープレーンプロパティは現在の実装ではサポートされていないことに注意してください。実装は、OpenGL の Microsoft GDI ソフトウェア実装です。 OpenGL の一部を強化するハードウェア製造元は、一般的な実装でサポートされていない一部のレイヤープレーンプロパティをサポートしている場合があります。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
Header	wingdi.h