GdipSetPathGradientSurroundColorsWithCount()

Resultat.i = GdipSetPathGradientSurroundColorsWithCount(*brush, @color.i, @count.l)

*brush

[in] Pointeur sur un objet PathGradientBrush.

color.i

[in] Pointeur sur un tableau de couleurs de type ARGB.

count.l

[in] Nombre de couleurs du contour contenu dans le tableau ci-dessus (paramètre color).

Cette fonction permet de définir une ou plusieurs couleurs pour chaque point du contour défini lors de la création de la brush. Par défaut, la couleur du contour (sans utiliser cette fonction) est le blanc. On peut définir pour chaque point du contour (Path), une couleur différente ou la même.

Le fonctionnement est le suivant.

Exemple avec une brush en forme de losange, couleur centrale bleu et contour blanc (couleur par défaut).
Dans l'exemple, la couche alpha vaut 255 pour chaque couleur utilisée.
Le point central se trouve au centre géométrique pour chaque exemple.

Le dégradé d'origine donne ceci :

Si on applique une seule couleur, le rouge, on a ceci :

L'unique couleur appliquée l'est pour chaque point définissant le contour de la brush.
Le dégradé part du contour pour converger vers la couleur du centre géométrique (qui n'a pas été modifié)

 

Si on applique deux couleurs :
le rouge, 1ère couleur du tableau
Le vert, seconde couleur du tableau

on a ceci :

Le premier point du contour de la brush est rouge (1ère couleur du tableau)
La deuxième couleur (verte) est appliquée à tous les autres points du contour de la brush (les 3 autres points).
Le dégradé part du contour pour converger vers la couleur du centre géométrique (qui n'a pas été modifié).
Il y a également un dégradé entre les points 1 et 2 et le point 1 et 4 (rouge/vert).

 

Si on applique trois couleurs :
le rouge, 1ère couleur du tableau
Le vert, seconde couleur du tableau
Le jaune, troisième couleur du tableau

on a ceci :

Le premier point du contour de la brush est rouge (1ère couleur du tableau)
La deuxième couleur (verte) est appliquée au deuxième points du contour de la brush.
La troisième couleur (jaune) est appliquée à tous les autres points du contour de la brush (les 2 derniers points).
Le dégradé part du contour pour converger vers la couleur du centre géométrique (qui n'a pas été modifié).
Il y a un dégradé entre les points 1 et 2, entre les points 2 et 3 et entre les points 1 et 4.

 

Si on applique quatre couleurs :
le rouge, 1ère couleur du tableau
Le vert, seconde couleur du tableau
Le jaune, troisième couleur du tableau
Le blanc, quatrième couleur du tableau

on a ceci :

A chaque point de coordonnées du tableau (dans l'ordre de création de la brush), correspond une couleur du tableau des couleurs.

Si la fonction réussit, elle retourne #Ok qui est une constante de l'énumération status.
Si la fonction échoue, elle retourne une des autres valeurs de l'énumération status.

PureBasic v4.30 bêta 4 (Windows - x86)
Testé avec Windows Vista édition familiale Premium