DDCOLORCONTROL 構造体 (ddraw.h)

DDCOLORCONTROL 構造体は、Microsoft DirectDraw ビデオ ポート拡張機能 (VPE) オブジェクトに関連付けられているカラー コントロールを定義します。

構文

typedef struct _DDCOLORCONTROL {
  DWORD dwSize;
  DWORD dwFlags;
  LONG  lBrightness;
  LONG  lContrast;
  LONG  lHue;
  LONG  lSaturation;
  LONG  lSharpness;
  LONG  lGamma;
  LONG  lColorEnable;
  DWORD dwReserved1;
} *LPDDCOLORCONTROL, DDCOLORCONTROL;

メンバー

dwSize

この DDCOLORCONTROL 構造体のサイズをバイト単位で指定します。

dwFlags

有効なデータを含む構造体メンバーを指定するフラグのセットを示します。 DdVideoPortColorControl によって構造体が返されると、VPE オブジェクトでサポートされているオプションも示されます。 このメンバーは、次の表に示す値のビットごとの OR にすることができます。

フラグ	説明
DDCOLOR_BRIGHTNESS	lBrightness メンバーには有効なデータが含まれています。
DDCOLOR_CONTRAST	lContrast メンバーには有効なデータが含まれています。
DDCOLOR_COLORENABLE	lColorEnable メンバーには有効なデータが含まれています。
DDCOLOR_GAMMA	lGamma メンバーには有効なデータが含まれています。
DDCOLOR_HUE	lHue メンバーには有効なデータが含まれています。
DDCOLOR_SATURATION	lSaturation メンバーには有効なデータが含まれています。
DDCOLOR_SHARPNESS	lSharpness メンバーには有効なデータが含まれています。

lBrightness

輝度 (黒レベル) を IRE 単位*100 で指定します。 このメンバーの範囲は 0 から 10,000 で、既定値は 750 (7.5 IRE) です。

lContrast

輝度の高い値と低い輝度の値の相対差を IRE 単位*100 で指定します。 このメンバーの範囲は 0 から 20,000 で、既定値は 10,000 (100 IRE) です。 コントラストの値を大きくすると、輝度値が黒に向かって暗くなり、明るい輝度値が白に向かう傾向があります。 コントラストの値を小さくすると、すべての輝度値が中央の輝度値に向かって移動します。

lHue

クロム成分の位相関係を指定します。 Hue は度単位で指定され、有効な範囲は -180 から 180 です。 既定値は 0 度です。

lSaturation

色の強度を IRE 単位*100 で指定します。 このメンバーの範囲は 0 から 20,000 で、既定値は 10,000 (100 IRE) です。

lSharpness

シャープネスを任意の単位で指定します。 有効な範囲は 0 から 10 で、既定値は 5 です。

lGamma

輝度値に適用されるガンマ補正の量を制御します。 有効な範囲は 1 から 500 ガンマ単位で、既定値は 1 です。

lColorEnable

色を使用するかどうかを示すフラグを指定します。 このメンバーが 0 の場合、color は使用されません。1 の場合は、色が使用されます。 既定値は 1 です。

dwReserved1

システム用に予約されており、無視する必要があります。

要件

要件	値
Header	ddraw.h

こちらもご覧ください

• DdVideoPortColorControl