Microsoft DirectX 8.0 (Visual Basic)

D3DXColorScale

カラー値をスケーリングする。

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

パラメータ

COut
演算結果であるスケーリングされたカラー値が格納される D3DCOLORVALUE 型。
C1
処理の基になる D3DCOLORVALUE 型。
s
スケーリング係数。色を 4D ベクトルのように扱って、スケーリングする。s の値に制限はない。s が 1 の場合、結果の色は元の色である。

エラー コード

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

D3DERR_INVALIDCALL
D3DERR_OUTOFVIDEOMEMORY

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

注意

次の例に示すように、この関数は、D3DCOLORVALUE 型の色成分に指定されたスケーリング係数を積算することで、スケーリングしたカラー値を算出する。

    Cout.r = C1.r * s

参照

D3DXColorLerpD3DXColorModulateD3DXColorNegative