Hue rotation effect
Use the hue rotate effect to alter the hue of an image by applying a color matrix based on the rotation angle.
The CLSID for this effect is CLSID_D2D1HueRotation.
Example image
The example here shows the input and output images of the hue rotate effect with a rotation angle of 270 degrees.
| Before |
|---|
 |
| After |
 |
ComPtr<ID2D1Effect> hueRotationEffect;
m_d2dContext->CreateEffect(CLSID_D2D1HueRotation, &hueRotationEffect);
hueRotationEffect->SetInput(0, bitmap);
hueRotationEffect->SetValue(D2D1_HUEROTATION_PROP_ANGLE, 270.0f);
m_d2dContext->BeginDraw();
m_d2dContext->DrawImage(hueRotationEffect.Get());
m_d2dContext->EndDraw();
The effect calculates a color matrix based on the rotation angle (?) you specify with the D2D1_HUEROTATION_PROP_ANGLE property. Here are the matrix equations.
The matrix created depends only on the rotation angle. You can use the color matrix effect if you need a specific matrix.
Effect properties
| Display name and index enumeration | Type and default value | Description |
|---|---|---|
| Angle D2D1_HUEROTATION_PROP_ANGLE |
FLOAT 0.0f |
The angle to rotate the hue, in degrees. |
Output bitmap
The output bitmap size is the same as the input bitmap size.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 8 and Platform Update for Windows 7 [desktop apps | Windows Store apps] |
| Minimum supported server | Windows 8 and Platform Update for Windows 7 [desktop apps | Windows Store apps] |
| Header | d2d1effects.h |
| Library | d2d1.lib, dxguid.lib |