Microsoft DirectX 8.0 (Visual Basic)

D3DXColorAdjustSaturation

色の彩度値を調整する。

D3DXColorAdjustSaturation( _ 
    COut As D3DCOLORVALUE, _ 
    C1 As D3DCOLORVALUE, _ 
    s As Single)

パラメータ

COut
演算結果である彩度調整の結果が格納される D3DCOLORVALUE 型。
C1
処理の基になる D3DCOLORVALUE 型。
s
彩度値。このパラメータは、グレー スケールに変換された色と元の色 C1 の間を線形補間する。s の値に制限はない。s が 0 の場合、返される色はグレー スケールの色である。s が 1 の場合、返される色は元の色である。

エラー コード

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

D3DERR_INVALIDCALL
D3DERR_OUTOFVIDEOMEMORY

エラー トラッピングの詳細については、Microsoft® Visual Basic® の「エラー処理」を参照すること。

注意

次に示す例のように、この関数は非飽和色とある色の間で D3DCOLORVALUE 型の赤 (red)、緑 (green)、青 (blue) の色成分を補間する。

    ' 輝度に対する各成分の係数の適切な値。
    ' ITU-R 勧告 BT.709 に記載された NTSC 標準に基づく。
    Dim Grey As Long
    Grey = C1.r * 0.2125 + C1.g * 0.7154 + C1.b * 0.0721
    
    COut.r = Grey + s * (C1.r - Grey)

s が 0 より大きく 1 より小さい場合、彩度は小さくなる。s が 1 より大きい場合、彩度は大きくなる。

グレー スケール色は次のようにして算出される : r = g = b = 0.2125*r + 0.7154*g + 0.0721*b

参照

D3DXColorAdjustContrast