GdipCreatePathGradientI()



Syntaxe
Resultat.i = GdipCreatePathGradientI(@points.Point, count.l, wrapMode.i, @*polyGradient)

Paramètres

points.Point

[in] Tableau de Point qui représente les coordonnées (nombres entiers) du contour du dégradé.

count.l

[in] Nombre entier positif qui indique le nombre d'éléments du tableau points.Point.

wrapMode.i

[in] Ce paramètre spécifie la manière dont le dégradé est disposé. Si le dégradé est plus petit que la zone à remplir, il est disposé en mosaïque selon un des formats de l'énumération Wrapmode.

*polyGradient

[out] *polyGradient recevra le pointeur sur l'objet PathGradientBrush créé.

Description

La fonction crée un objet brush permettant de peindre un dégradé à partir de une ou plusieurs couleurs pour remplir une forme fermée dont les segments reliés entre eux sont définis par les coordonnées exprimées en points sont passés en paramètre par le tableau points.Point (sous la forme de valeurs de type long). Le dégradé part du point central du tracé à son bord extérieur.
La couleur du point central sera définie par la fonction GdipSetPathGradientCenterColor().
Par défaut, le point central d'un objet PathGradientBrush est le centre de la surface défini par ses contours, mais vous pouvez placer le point central à n'importe ou, à l'intérieur ou à l'extérieur du contour en appelant la fonction GdipSetPathGradientCenterPointI().

Les couleurs passées en paramètre aux brush doivent avoir été préalablement modifiées par la procédure ARGB (voir le fichier gdiplus.pbi)
La fonction GdipCreatePathGradientI() utilise des coordonnées de type long alors que La fonction GdipCreatePathGradient() utilise des coordonnées de type flottant.
Pour plus d'explications, reportez-vous à le fonction GdipCreatePathGradient() dont le fonctionnement est similaire sauf pour les coordonnées des points qui sont en nombre flottants.

Résultat de la fonction

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.

PB - OS

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