GdipAddPathClosedCurve()



Syntaxe
Resultat.i = GdipAddPathClosedCurve(*path, @points.PointF, count.l)
Paramètres
*path

[in] Pointeur sur un objet GraphicsPath.

points.PointF

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

count.l

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

Description
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. La fonction ne permet pas de définir le paramètre de tension qui a une valeur par défaut de 0,5.

L'objet GraphicsPath ne stocke pas les points passés par la fonction GdipAddPathClosedCurve() 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.PointF ne sont pas confondus, la courbe est fermée en reliant ces deux points.

Le fichier d'exemple dessine 2 GraphicsPath différents, la première avec 7 points repérés et la seconde avec 3 points.
En rouge la courbe et en bleu les points de référence de la courbe.

Voici l'aperçu du fichier d'exemple :

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