TextureBrush ::RotateTransform, méthode (gdiplusbrush.h)

La méthode TextureBrush ::RotateTransform met à jour la matrice de transformation actuelle de ce pinceau de texture avec le produit de lui-même et une matrice de rotation.

Syntaxe

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

Paramètres

[in] angle

Type : REAL

Nombre réel qui spécifie l’angle, en degrés, de rotation.

[in] order

Type : MatrixOrder

facultatif. Élément de l’énumération MatrixOrder qui spécifie l’ordre de la multiplication. MatrixOrderPrepend spécifie que la matrice de rotation se trouve à gauche et MatrixOrderAppend spécifie que la matrice de rotation se trouve à droite. La valeur par défaut est MatrixOrderPrepend.

Valeur retournée

Type : État

Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .

Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .

Remarques

Une seule matrice 3×3 peut stocker n’importe quelle séquence de transformations affines. Si vous avez plusieurs matrices 3×3, chacune représentant une transformation affine, le produit de ces matrices est une matrice 3×3 unique qui représente l’ensemble de la séquence de transformations. La transformation représentée par ce produit est appelée transformation composite. Par exemple, supposons que la matrice R représente une rotation et que la matrice T représente une traduction. Si la matrice M est le produit RT, la matrice M représente une transformation composite : d’abord pivoter, puis traduire.

L’ordre de multiplication matricielle est important. En général, le produit de matrice RT n’est pas identique au produit de matrice TR. Dans l’exemple donné dans le paragraphe précédent, la transformation composite représentée par RT (d’abord pivoter, puis traduire) n’est pas identique à la transformation composite représentée par TR (d’abord traduire, puis pivoter).

Exemples

L’exemple suivant crée un pinceau de texture et définit la transformation du pinceau. Le code utilise ensuite le pinceau transformé pour remplir un rectangle.

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

Configuration requise

Voir aussi

Pinceaux et formes remplies

Remplissage de formes avec un pinceau dégradé

Image

Matrice

Représentation matricielle des transformations

MatrixOrder

TextureBrush

TextureBrush ::ScaleTransform

TextureBrush ::SetTransform

TextureBrush ::TranslateTransform

Transformations