Microsoft DirectX 8.0 (Visual Basic)

D3DXColorModulate

Blends two colors.

D3DXColorModulate( _ 
    COut As D3DCOLORVALUE, _ 
    C1 As D3DCOLORVALUE, _ 
    C2 As D3DCOLORVALUE)

Parameters

COut
A D3DCOLORVALUE type that is the result of the operation, the result of the blending operation.
C1
A source D3DCOLORVALUE type.
C2
A source D3DCOLORVALUE type.

Error Codes

If the function fails, an error is raised and Err.Number can be set to one of the following values:

D3DERR_INVALIDCALL
D3DERR_OUTOFVIDEOMEMORY

For information on trapping errors, see the Microsoft® Visual Basic® Error Handling topic.

Remarks

This function blends together two colors by multiplying matching color components, as shown in the following example.

    Cout.r = C1.r * C2.r

See Also

D3DXColorLerp, D3DXColorNegative, D3DXColorScale