Platform SDK: DirectX

DirectDrawGammaControl.SetGammaRamp

DirectDrawGammaControl.SetGammaRamp メソッドは、プライマリ サーフェスに対する赤、緑、および青のガンマ ランプを設定する。

object.SetGammaRamp( _ 
    flags As CONST_DDSGRFLAGS, _ 
    gammaRamp As DDGAMMARAMP)

パラメータ

object
DirectDrawGammaControl オブジェクトを表す オブジェクト 式。
flags
ガンマ キャリブレーションを要求するかどうかを示す CONST_DDSGRFLAGS 列挙の定数の 1 つ。このパラメータを DDSGR_CALIBRATE に設定すると、口径測定器がすべてのシステム上で同一になるように、ディスプレイの物理的性質に従って、ガンマ ランプの調整を要求できる。キャリブレーションを必要としない場合は、このパラメータを 0 に設定する。
gammaRamp
新しい赤、緑、および青のガンマ ランプ エントリを含む DDGAMMARAMP 型。個々の配列は、フレーム バッファの色の値をデジタル-アナログ コンバータ (DAC) に渡す色の値にマップする。

エラー コード

失敗すればエラーが発生し、Err.Number に次のいずれかの値が設定される。

DDERR_EXCEPTION
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_OUTOFMEMORY

注意

すべてのシステムでガンマ キャリブレーションをサポートするわけではない。ガンマ キャリブレーションをサポートするかどうかを決めるには、DirectDraw7.GetCaps を呼び出し、メソッドが返した後に関連する DDCAPS 型の lCaps2 メンバを調べる。DDCAPS_CANCALIBRATEGAMMA 能力フラグが存在すると、ガンマ キャリブレーションはサポートされる。

ガンマ ランプのキャリブレーションでは、いくつかの処理にオーバーヘッドが起こるので、頻繁に使用できない。

ガンマ キャリブレーションをサポートしないシステム上で実行する場合、flags パラメータに DDSGR_CALIBRATE フラグを設定すると、このメソッドは成功する。キャリブレーションせずに新しいガンマ ランプ値を設定すると、メソッドは成功する。

参照

DirectDrawGammaControl.GetGammaRampガンマ コントロールとカラー コントロール