Matrix3x2F::Rotation-Methode (d2d1helper.h)

Artikel
08/22/2023

Erstellt eine Drehungstransformation mit dem angegebenen Winkel und Mittelpunkt.

Syntax

Matrix3x2F Rotation(
  FLOAT         angle,
  D2D1_POINT_2F center
);

Parameter

angle

Typ: FLOAT

Der Drehwinkel in Grad. Ein positiver Winkel erzeugt eine Drehung im Uhrzeigersinn, und ein negativer Winkel erzeugt eine Drehung gegen den Uhrzeigersinn.

center

Typ: D2D1_POINT_2F

Der Punkt, an dem die Drehung ausgeführt wird.

Rückgabewert

Typ: Matrix3x2F

Die neue Rotationstransformation.

Hinweise

Geben Sie beim Aufrufen dieser Methode einen CenterPoint an, um den das Objekt gedreht werden soll, und den Drehwinkel in Grad. Die folgende Abbildung zeigt ein Um 45 Grad gedrehtes Quadrat um seinen Mittelpunkt.

Abbildung eines um 45 Grad im Uhrzeigersinn gedrehten Quadrats über die Mitte des ursprünglichen Quadrats

Beispiele

Im folgenden Beispiel wird die D2D1::Matrix3x2F::Rotation-Methode verwendet, um eine Drehungsmatrix zu erstellen, die ein Quadrat im Uhrzeigersinn um 45 Grad um die Mitte des Quadrats dreht und die Matrix an die SetTransform-Methode des Renderziels (m_pRenderTarget) übergibt.

Die folgende Abbildung zeigt den Effekt der Anwendung der vorherigen Drehungstransformation auf das Quadrat. Das ursprüngliche Quadrat ist ein gepunkteter Umriss, und das gedrehte Quadrat ist ein durchgehender Umriss.

Abbildung eines um 45 Grad gedrehten Quadrats um die Mitte des ursprünglichen Quadrats

    // 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);

Code wurde aus diesem Beispiel weggelassen. Weitere Informationen zu Transformationen finden Sie in der Übersicht über Transformationen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	d2d1helper.h
Bibliothek	D2d1.lib
DLL	D2d1.dll

Weitere Informationen

Matrix3x2F

Freigeben über