Microsoft DirectX 9.0

D3DXColorLerp Function

Uses linear interpolation to create a color value.


D3DXCOLOR *D3DXColorLerp(      

    D3DXCOLOR *pOut,     CONST D3DXCOLOR *pC1,     CONST D3DXCOLOR *pC2,     FLOAT s );


[in, out] Pointer to a D3DXCOLOR structure that is the result of the operation.
[in] Pointer to a source D3DXCOLOR structure.
[in] Pointer to a source D3DXCOLOR structure.
[in] Parameter that linearly interpolates between the colors, pC1 and pC2, treating them both as 4-D vectors. There are no limits on the value of s.

Return Value

This function returns a pointer to a D3DXCOLOR structure that is the result of the linear interpolation.


The return value for this function is the same value returned in the pOut parameter. In this way, the D3DXColorLerp function can be used as a parameter for another function.

This function interpolates the red, green, blue, and alpha components of a D3DXCOLOR structure between two colors, as shown in the following example.

    pOut->r = pC1->r + s * (pC2->r - pC1->r);

If you are linearly interpolating between the colors A and B, and s is 0, the resulting color is A. If s is 1, the resulting color is color B.

Function Information

Import libraryd3dx9.lib
Minimum operating systems Windows 98

See Also

D3DXColorModulate, D3DXColorNegative, D3DXColorScale

© 2002 Microsoft Corporation. All rights reserved.