Applying Transforms in Direct2D

In Drawing with Direct2D, we saw that the ID2D1RenderTarget::FillEllipse method draws an ellipse that is aligned to the x- and y-axes. But suppose you want to draw an ellipse tilted at an angle?

 

An image that shows a tilted ellipse.

An image that shows a tilted ellipse.

 

By using transforms, you can alter a shape in the following ways.

  • Rotation around a point.
  • Scaling.
  • Translation (displacement in the X or Y direction).
  • Skew (also called shear).

A transform is a mathematical operation that maps a set of points to a new set of points. For example, the following diagram shows a triangle rotated around the point P3. After the rotation is applied, the point P1 is mapped to P1', the point P2 is mapped to P2', and the point P3 maps to itself.

 

A diagram that shows rotation around a point.

A diagram that shows rotation around a point.

 

Transforms are implemented using matrices. However, you don't need to understand the mathematics of matrices in order to use them. If you want to learn more about the math, see Appendix: Matrix Transforms.

To apply a transform in Direct2D, call the ID2D1RenderTarget::SetTransform method. This method takes a D2D1_MATRIX_3X2_F structure that defines the transformation. You can initialize this structure by calling methods on the D2D1::Matrix3x2F class. This class contains static methods that return a matrix for each type of transform:

For example, the following code applies a 20-degree rotation around the point (100, 100).


    pRenderTarget->SetTransform(
        D2D1::Matrix3x2F::Rotation(20, D2D1::Point2F(100,100)));


The transform is applied to all subsequent drawing operations until you call SetTransform again. To remove the current transform, call SetTransform with the identity matrix, which is returned by the Matrix3x2F::Identity function.


    pRenderTarget->SetTransform(D2D1::Matrix3x2F::Identity());


Drawing Clock Hands

Let's put transforms to use by converting our Circle program into an analog clock. We can do this by adding lines for the hands.

 

A screen shot of the Analog Clock program.

A screen shot of the Analog Clock program.

 

Rather than calculate the coordinates for the lines, we can simply calculate the angle and then apply a rotation transform. The following code shows a function that draws one clock hand. The fAngle parameter gives the angle of the hand, in degrees.


void Scene::DrawClockHand(float fHandLength, float fAngle, float fStrokeWidth)
{
    m_pRenderTarget->SetTransform(
        D2D1::Matrix3x2F::Rotation(fAngle, m_ellipse.point)
            );

    // endPoint defines one end of the hand.
    D2D_POINT_2F endPoint = D2D1::Point2F(
        m_ellipse.point.x,
        m_ellipse.point.y - (m_ellipse.radiusY * fHandLength)
        );

    // Draw a line from the center of the ellipse to endPoint.
    m_pRenderTarget->DrawLine(
        m_ellipse.point, endPoint, m_pStroke, fStrokeWidth);
}


This code draws a vertical line, starting from the center of the clock face and ending at the point endPoint. The line is rotated around the center of the ellipse by applying a rotation transform. The center point for the rotation is the center of ellipse that forms the clock face.

 

A diagram that shows the rotation of the clock hand.

A diagram that shows the rotation of the clock hand.

 

The following code shows how then entire clock face is drawn.


void Scene::RenderScene()
{
    m_pRenderTarget->Clear(D2D1::ColorF(D2D1::ColorF::SkyBlue));

    m_pRenderTarget->FillEllipse(m_ellipse, m_pFill);
    m_pRenderTarget->DrawEllipse(m_ellipse, m_pStroke);


    // Draw hands
    SYSTEMTIME time;
    GetLocalTime(&time);

    // 60 minutes = 30 degrees, 1 minute = 0.5 degree
    const float fHourAngle = (360.0f / 12) * (time.wHour) + (time.wMinute * 0.5f); 
    const float fMinuteAngle =(360.0f / 60) * (time.wMinute);

    DrawClockHand(0.6f,  fHourAngle,   6);
    DrawClockHand(0.85f, fMinuteAngle, 4);

    // Restore the identity transformation.
    m_pRenderTarget->SetTransform( D2D1::Matrix3x2F::Identity() );
}


You can download the complete Visual Studio project from Direct2D Clock Sample. (Just for fun, the download version adds a radial gradiant to the clock face.)

Combining Transforms

The four basic transforms can be combined by multiplying two or more matrices. For example, the following code combines a rotation with a translation.


    const D2D1::Matrix3x2F rot = D2D1::Matrix3x2F::Rotation(20);
    const D2D1::Matrix3x2F trans = D2D1::Matrix3x2F::Translation(40, 10);

    pRenderTarget->SetTransform(rot * trans);


The Matrix3x2F class provides operator*() for matrix multiplication. The order in which you multiply the matrices is important. Setting a transform (M × N) means "Apply M first, followed by N." For example, here is rotation followed by translation:

 

A diagram that shows rotation followed by translation.

A diagram that shows rotation followed by translation.

 

Here is the code for this transform:


    const D2D1::Matrix3x2F rot = D2D1::Matrix3x2F::Rotation(45, center);
    const D2D1::Matrix3x2F trans = D2D1::Matrix3x2F::Translation(x, 0);
    pRenderTarget->SetTransform(rot * trans);


Now compare that transform with a transform in the reverse order, translation followed by rotation.

 

A diagram that shows translation followed by rotation.

A diagram that shows translation followed by rotation.

 

The rotation is performed around the center of the original rectangle. Here is the code for this transform.


    D2D1::Matrix3x2F rot = D2D1::Matrix3x2F::Rotation(45, center);
    D2D1::Matrix3x2F trans = D2D1::Matrix3x2F::Translation(x, 0);
    pRenderTarget->SetTransform(trans * rot);


As you can see, the matrices are the same, but the order of operations has changed. This happens because matrix multiplication is not commutative: M × N ≠ N × M.

Next

Appendix: Matrix Transforms

 

 

Send comments about this topic to Microsoft

Build date: 10/5/2010

Community Additions

ADD
Show:
© 2014 Microsoft