Platform SDK: DirectX |
DirectDrawGammaControl.SetGammaRamp メソッドは、プライマリ サーフェスに対する赤、緑、および青のガンマ ランプを設定する。
object.SetGammaRamp( _ flags As CONST_DDSGRFLAGS, _ gammaRamp As DDGAMMARAMP)
失敗すればエラーが発生し、Err.Number に次のいずれかの値が設定される。
DDERR_EXCEPTION |
DDERR_INVALIDOBJECT |
DDERR_INVALIDPARAMS |
DDERR_OUTOFMEMORY |
すべてのシステムでガンマ キャリブレーションをサポートするわけではない。ガンマ キャリブレーションをサポートするかどうかを決めるには、DirectDraw7.GetCaps を呼び出し、メソッドが返した後に関連する DDCAPS 型の lCaps2 メンバを調べる。DDCAPS_CANCALIBRATEGAMMA 能力フラグが存在すると、ガンマ キャリブレーションはサポートされる。
ガンマ ランプのキャリブレーションでは、いくつかの処理にオーバーヘッドが起こるので、頻繁に使用できない。
ガンマ キャリブレーションをサポートしないシステム上で実行する場合、flags パラメータに DDSGR_CALIBRATE フラグを設定すると、このメソッドは成功する。キャリブレーションせずに新しいガンマ ランプ値を設定すると、メソッドは成功する。