Cette fonction effectue une mise à l'échelle de la brush.

La brush n'est pas redimensionnée (un appel à une des fonctions comme GdipGetPathGradientRect() ou GdipGetPathGradientRectI() retourne la taille d'origine de la brush), mais c'est la matrice de transformation appliquée à la brush qui va modifier le rendu par rapport à la brush d'origine.

La mise à l'échelle applqiue un coefficient aux dimensions en x et/ou y.
Si sx est inférieur à

Si sx vaut 0, la distance sur l'axe X est nulle
Si sx >0 et x <1 la distance sur l'axe X sera plus petite que la distance d'origine. Par exemple, si sx vaut 0.20, la distance sera de 20% de la distance d'origne.
Si sx >1 la distance sur l'axe X sera plus grande que la distance d'origine. Par exemple, si sx vaut 1.20, la distance sera de 20% plus grande que la distance d'origine.

Idem pour sy.

Voici un exemple de fonctionnement (extrait du fichier d'exemple) :

On défini une brush en forme de losange, centre rouge et contour blanc.
Largeur et hauteur 200 pixels.
La brush est définie avec la fonction GdipCreatePathGradient()
La première couleur est le rouge et la couleur d'arrivée le blanc.
WrapMode #WrapModeTile
Brush dessinée dans un carré de 200 x 200

Voici le rendu de la brush

Exemple :

On va appliquer à cette brush, la mise à l'échelle suivante :

sx.f = 0.2

sy.f = 0.2

sx valant 0.2, on aura la largeur de la brush qui sera redimensionnée comme ceci (en x)

200 x 0.2 = 40 (la largeur est multipliée par sx)

sy valant 0.2, on aura la largeur de la brush qui sera redimensionnée comme ceci(en y)

200 x 0.2= 40 (la hauteur est multipliée par sy)

La taille étant d'un rapport de 1/5 plus petite que la taille d'origine, il y aura répétition du motif, soit 5 fois en hauteur et 5 fois en largeur.

order vaut #MatrixOrderAppend pour la mise à l'échelle.

Le nouveau rendu de la brush donne ceci :