TextureBrush::RotateTransform-Methode (gdiplusbrush.h)

Artikel
02/26/2024

Die TexturBrush::RotateTransform-Methode aktualisiert die aktuelle Transformationsmatrix dieses Texturpinsels mit dem Produkt selbst und einer Rotationsmatrix.

Syntax

Status RotateTransform(
  [in] REAL        angle,
  [in] MatrixOrder order
);

Parameter

[in] angle

Typ: REAL

Reelle Zahl, die den Winkel der Drehung in Grad angibt.

[in] order

Typ: MatrixOrder

Optional. Element der MatrixOrder-Enumeration , das die Reihenfolge der Multiplikation angibt. MatrixOrderPrepend gibt an, dass sich die Drehungsmatrix auf der linken Seite befindet, und MatrixOrderAppend gibt an, dass sich die Rotationsmatrix auf der rechten Seite befindet. Der Standardwert ist MatrixOrderPrepend.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, wird eines der anderen Elemente der Status-Enumeration zurückgegeben.

Hinweise

Eine einzelne 3×3-Matrix kann jede Sequenz von affinen Transformationen speichern. Wenn Sie über mehrere 3×3-Matrizen verfügen, von denen jede eine affine Transformation darstellt, ist das Produkt dieser Matrizen eine einzelne 3×3-Matrix, die die gesamte Sequenz von Transformationen darstellt. Die transformation, die durch dieses Produkt dargestellt wird, wird als zusammengesetzte Transformation bezeichnet. Angenommen, Matrix R stellt eine Drehung dar, und Matrix T stellt eine Übersetzung dar. Wenn Matrix M das Produkt RT ist, stellt Matrix M eine zusammengesetzte Transformation dar: zuerst drehen und dann übersetzen.

Die Reihenfolge der Matrixmultiplikation ist wichtig. Im Allgemeinen ist das Matrixprodukt RT nicht identisch mit dem Matrixprodukt TR. Im Beispiel im vorherigen Absatz ist die durch RT dargestellte zusammengesetzte Transformation (zuerst rotieren, dann übersetzen) nicht mit der zusammengesetzten Transformation identisch, die durch TR dargestellt wird (zuerst übersetzen, dann rotieren).

Beispiele

Im folgenden Beispiel wird ein Texturpinsel erstellt und die Transformation des Pinsels festgelegt. Der Code verwendet dann den transformierten Pinsel, um ein Rechteck zu füllen.

VOID Example_RotateTransform(HDC hdc)
{
   Graphics graphics(hdc);

   Image image(L"HouseAndTree.Gif");
   TextureBrush textureBrush(&image);
   textureBrush.ScaleTransform(3, 1);                    // first scale
   textureBrush.RotateTransform(30, MatrixOrderAppend);  // then rotate
   graphics.FillRectangle(&textureBrush, 0, 0, 400, 200);
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdiplusbrush.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll