GdipDrawBezierI()
Syntaxe
|
Resultat.i = GdipDrawBezierI(*graphics, *pen, x1.l, y1.l, x2.l, y2.l, x3.l, y3.l, x4.l, y4.l)
Paramètres |
*graphics
[in] Pointeur sur un objet Graphics.
*pen
[in] Pointeur sur un objet Pen.
x1.l
[in] Coordonnée x du point de départ de la courbe.
y1.l
[in] Coordonnée y du point de début de la courbe.
x2.l
[in] Coordonnée x du premier point de contrôle de la courbe.
y2.l
[in] Coordonnée y du premier point de contrôle de la courbe.
x3.l
[in] Coordonnée x du second point de contrôle de la courbe.
y3.l
[in] Coordonnée y du second point de contrôle de la courbe.
x4.l
[in] Coordonnée x du point final de la courbe.
y4.l
[in] Coordonnée y du point final de la courbe.
Description |
Cette fonction permet de dessiner une courbe de Bézier cubique sur le graphique *graphics avec le pen *pen. Les coordonnées qui définissent la courbe sont des nombres entiers (long).
Une courbe de Bézier cubique est définie par quatre points, la courbe passe par le premier et le dernier point (appelés noeuds) qui sont le point de départ et le point de terminaison (point d'arrivée). Les deux autres points sont des points de contrôle, ils permettent de définir la forme de la courbe, celle-ci ne passe pas par ces points de contrôle (sauf cas spéciaux avec noeuds alignés). Ces courbes sont très utilisées en dessin vectoriel, les points de contrôle correspondent aux "poignées" des objets utilisés en dessin vectoriel.
On pourrait comparer les deux points de commande à des aimants, ils attirent la courbe dans certaines directions en influençant sa courbure.
Les quatre points définissent l'enveloppe convexe de la courbe.
- Une courbe de Bézier est à l'intérieur de l'enveloppe convexe des points de contrôle.
- Une courbe de Bézier est un segment si et seulement si les points de contrôle sont alignés.
- Le contrôle de la courbe est global : modifier un point de contrôle modifie toute la courbe et non pas le voisinage du point de contrôle.
Exemples de courbes :
La courbe est en rouge et l'enveloppe en bleu.
P1 est le point de départ.
P2 et P3 sont les points de contrôle.
P4 est le point final.
Entre les 2 courbes suivante (les deux exemples), seul le point P2 (point de contrôle) n'a pas les mêmes coordonnées.
La courbe de Bézier est fortement modifiée.
Aperçu du premier exemple :
Aperçu du second 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