Método Matrix3x2F::Rotation (d2d1helper.h)

Cria uma transformação de rotação que tem o ângulo e o ponto central especificados.

Sintaxe

Matrix3x2F Rotation(
  FLOAT         angle,
  D2D1_POINT_2F center
);

Parâmetros

angle

Tipo: FLOAT

O ângulo de rotação em graus. Um ângulo positivo cria uma rotação no sentido horário e um ângulo negativo cria uma rotação no sentido anti-horário.

center

Tipo: D2D1_POINT_2F

O ponto sobre o qual a rotação é executada.

Retornar valor

Tipo: Matrix3x2F

A nova transformação de rotação.

Comentários

Ao chamar esse método, especifique um centerPoint para girar o objeto e o ângulo de rotação em graus. A ilustração a seguir mostra um quadrado girado 45 graus sobre seu ponto central.

Exemplos

O exemplo a seguir usa o método D2D1::Matrix3x2F::Rotation para criar uma matriz de rotação que gira um quadrado no sentido horário de 45 graus sobre o centro do quadrado e passa a matriz para o método SetTransform do destino de renderização (m_pRenderTarget).

A ilustração a seguir mostra o efeito de aplicar a transformação de rotação anterior ao quadrado. O quadrado original é um contorno pontilhado, e o quadrado girado é um contorno sólido.

    // Create a rectangle.
    D2D1_RECT_F rectangle = D2D1::Rect(438.0f, 301.5f, 498.0f, 361.5f);

    // Draw the rectangle.
    m_pRenderTarget->DrawRectangle(
        rectangle,
        m_pOriginalShapeBrush,
        1.0f,
        m_pStrokeStyleDash
        );

    // Apply the rotation transform to the render target.
    m_pRenderTarget->SetTransform(
        D2D1::Matrix3x2F::Rotation(
            45.0f,
            D2D1::Point2F(468.0f, 331.5f))
        );

    // Fill the rectangle.
    m_pRenderTarget->FillRectangle(rectangle, m_pFillBrush);

    // Draw the transformed rectangle.
    m_pRenderTarget->DrawRectangle(rectangle, m_pTransformedShapeBrush);

O código foi omitido neste exemplo. Para obter mais informações sobre transformações, consulte a Visão geral das transformações.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	d2d1helper.h
Biblioteca	D2d1.lib
DLL	D2d1.dll

Confira também

Matrix3x2F