Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 |