GdipAddPathClosedCurve2I()

Resultat.i = GdipAddPathClosedCurve2I(*path, @points.Point, count.l, tension.f)

*path

[in] Pointeur sur un objet GraphicsPath.

points.Point

[in] Tableau de variables Point (nombres entiers) qui représentent les points définissant la spline cardinale.

count.l

[in] Nombre d'éléments du tableau de points points.Point.

tension.f

[in] Courbure de la courbe entre les points, la valeur 0 correspondant à la courbe la plus petite (angle le plus prononcé) et 1 représente la courbe la plus régulière.

Cette fonction permet de dessiner une spline cardinale et ferme ensuite le tracé.

Une spline cardinale est définie par des points et un paramètre de tension qui influence la forme de la courbe. C'est une suite de courbes individuelles jointes entre elles pour former une plus grande courbe. La courbe passe par chaque point de manière adoucie (sans angle pointu). Il en résulte une allure lissée (douce) de la courbe (sauf avec des valeurs faibles du paramètre tension).

L'objet GraphicsPath ne stocke pas les points passés par la fonction GdipAddPathClosedCurve2I() mais il convertit la spline cardinale en en une suite de courbes de Bézier et sauvegarde les points qui définissent ces courbes de Bézier. Si vous avez besoin des coordonnées d'origine des points, vous devez en garder une copie car il n'est pas possible de les retrouver à partir de l'objet GraphicsPath.

Si le premier et le dernier point du tableau de points points.Point ne sont pas confondus, la courbe est fermée en reliant ces deux points.

Le premier fichier d'exemple dessine un tracé en 7 points. A l'aide d'un curseur, on peut modifier la valeur de la tension entre 0 et 2 et voir les modifications de la courbe.

Le second fichier d'exemple retrouve les valeurs des points stockés qui ne sont pas les points d'origine; 7 points d'origine pour l'exemple et 22 points retrouvés par la fonction GdipGetPointCount().