Méthode LinearGradientBrush ::ScaleTransform (gdiplusbrush.h)

La méthode LinearGradientBrush ::ScaleTransform met à jour la matrice de transformation actuelle de ce pinceau avec le produit de lui-même et une matrice de mise à l’échelle.

Syntaxe

Status ScaleTransform(
  [in] REAL        sx,
  [in] REAL        sy,
  [in] MatrixOrder order
);

Paramètres

[in] sx

Type : REAL

Nombre réel qui spécifie la quantité à mettre à l’échelle dans la direction x.

[in] sy

Type : REAL

Nombre réel qui spécifie la quantité à mettre à l’échelle dans la direction y.

[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 mise à l’échelle se trouve à gauche, et MatrixOrderAppend spécifie que la matrice de mise à l’échelle 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 de 3 ×3, chacune représentant une transformation affine, le produit de ces matrices est une matrice unique 3 ×3 qui représente la séquence entière de transformations. La transformation représentée par ce produit est appelée transformation composite. Par exemple, supposons que la matrice T représente une traduction, et que la matrice S représente une mise à l’échelle. Si la matrice M est le produit TS, la matrice M représente une transformation composite : d’abord traduire, puis mettre à l’échelle.

L’ordre de multiplication des matrices est important. En général, le produit de matrice RT n’est pas le même que le 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 la même que la transformation composite représentée par TR (d’abord traduire, puis pivoter).

Exemples

L’exemple suivant crée un pinceau de dégradé linéaire et l’utilise pour remplir un rectangle. Ensuite, le code modifie la matrice de transformation du pinceau, en appliquant une transformation composite, puis remplit un rectangle avec le pinceau transformé.

VOID Example_ScaleTrans(HDC hdc)
{
   Graphics myGraphics(hdc);

   LinearGradientBrush linGrBrush(
      Rect(0, 0, 80, 40),
      Color(255, 255, 0, 0),  // red
      Color(255, 0, 0, 255),  // blue
      LinearGradientModeHorizontal);

   // Fill a large area with the linear gradient brush (no transformation).
   myGraphics.FillRectangle(&linGrBrush, 0, 0, 800, 150);

   // Apply a composite transformation: first translate, then scale.
   linGrBrush.TranslateTransform(60, 0);            // horizontal translation
   linGrBrush.ScaleTransform(2, MatrixOrderAppend); // horizontal doubling

   // Fill a large area with the transformed linear gradient brush.
   myGraphics.FillRectangle(&linGrBrush, 0, 200, 800, 150);  
}

Configuration requise

Voir aussi

Pinceaux et formes remplies

Remplissage de formes avec un pinceau dégradé

LinearGradientBrush

LinearGradientBrush ::MultiplyTransform

LinearGradientBrush ::RotateTransform

LinearGradientBrush ::TranslateTransform

LinearGradientMode

Matrice

Représentation matricielle des transformations

MatrixOrder

Rect

Transformations