Microsoft DirectX 8.0 (C++) |
Adjusts the saturation value of a color.
D3DXCOLOR* D3DXColorAdjustSaturation( D3DXCOLOR* pOut, D3DXCOLOR* pC, FLOAT s );
This function returns a pointer to a D3DXCOLOR structure that is the result of the saturation adjustment.
The return value for this function is the same value returned in the pOut parameter. In this way, the D3DXColorAdjustSaturation function can be used as a parameter for another function.
This function interpolates the red, green, and blue color components of a D3DXCOLOR structure between an unsaturated color and a color, as shown in the following example.
// Approximate values for each component's contribution to luminance. // Based upon the NTSC standard described in ITU-R Recommendation BT.709. FLOAT grey = pC->r * 0.2125f + pC->g * 0.7154f + pC->b * 0.0721f; pOut->r = grey + s * (pC->r - grey);
If s is greater than 0 and less than 1, the saturation is decreased. If s is greater than 1, the saturation is increased.
The gray-scale color is computed as: r = g = b = 0.2125*r + 0.7154*g + 0.0721*b.
Header: Declared in D3dx8math.h.
Import Library: Use D3dx8.lib.