DESCRIPTION.

La procédure PROC_PLpolybezier() trace un ensemble de courbes de Bézier, vide ou pleine, sur le document.

SYNTAXE.

PROC_PLpolybezier( controles , abscisses , ordonnees , remplissage )

REMARQUES.

controles doit être un nombre entier indiquant le nombre de points de controle formant la courbe de Béliez. controles doit être égal à 3n + 1, où n représente le nombre total de courbes de Bézier. Les premier, quatrième, septième,et ainsi de suite, et dernier points de controle se situent sur la courbe, les autres points de controle n'y sont généralement pas.  controles doit être égal au nombre d'éléments présents dans les tableaux de données abscisses et/ou ordonnees (voir ci-dessous).

abscisses doit être l'identifiant d'un tableau de données déclaré avec l'instruction DIM, ayant un nombre d'éléments égal à controles, et dont les éléments doivent être des valeurs numériques. Les éléments de abscisses donnent les abscisses de début des cotés, segments, qui constituent la figure à dessiner.

ordonnees doit être l'identifiant d'un tableau de données déclaré avec l'instruction DIM, ayant un nombre d'éléments égal à controles, et dont les éléments doivent être des valeurs numériques. Les éléments de ordonnees donnent les ordonnées de début des cotés, segments, qui constituent la figure à dessiner.

remplissage doit être 0, pour dessiner une rectangle vide, ou 1 pour dessiner un rectangle plein de la couleur actuellement sélectionnée.

.

La procédure PROC_PLpolybezier() est une des plus puissantes du module  pdflib.bbc, mais aussi une des moins intuitives dans sa compréhension. La procédure PROC_PLpolybezier() permet de tracer plusieurs courbes de Bézier les unes à la suite des autres, en une seule procédure, pour tracer , par exemple, des formes complexes, des courbes fluides continues, des tracés de “type dessin vectoriel, ...

Une courbe de Bézier et définie par 4 points :  le point d'origine de la ligne (P0) ; le point de controle la tangente au départ (P1) ; le point de controle la tangente à l’arrivée (P2) ; le point d’ancrage d’arrivée (P3). Avec la procédure PROC_PLpolybezier() est les points de controle sont enchainée et chaque segment partage son point de fin avec le suivant. Les points de controle tirent la courbe mais la  courbe ne passe pas par eux sauf pour les points aux extrémités.

Rappel : L'unité par défaut est le pixel, avec 1 pixel = 0,35278 mm et donc 1 mm égal environ 2,84 pixels. Les dimensions du document créé sont au format standardisé du A4 soit 210 x 297 mm. Pour basculer l'unité de mesure par défaut en millimètre, utilisez la procédure PROC_PLcolour() avec la valeur &00100000 pour style, en troisième paramètre. Dans ce cas les valeurs des ordonnées vont du haut du document (0 mm) au bas du document ( 297 mm), les valeurs des abscisses restent inchangées de gauche (0 mm) à droite (210 mm).

Rappel : la fonction FN_PLcreatepdf() doit être appelée pour placer les modifications sur le document .pdf en cours de création.

La procédure PROC_PLpolyline() est importée depuis le module pdflib.bbc. 

EXEMPLE.

INSTALL @lib$ + "pdflib.bbc"

DIM LST_Abscisses( 6 ) : LST_Abscisses() = 30 ,  53 , 83 , 105 , 128 , 158 , 180

DIM LST_Vides( 6 ) : LST_Vides() = 80 , 20 , 140 , 80 , 20 , 140 , 80

DIM LST_Pleins( 6 ) : LST_Pleins() = 160 , 100 , 220 , 160 , 100 , 220 , 160

PROC_PLcolour( &008000 , 2 , &00100000 ) : REM - modifie la couleur et l'épaisseur de la ligne

PROC_PLpolybezier( 7 , LST_Abscisses() , LST_Vides() , 0 ) : REM - trace un ensemble de courbes vide

PROC_PLpolybezier( 7 , LST_Abscisses() , LST_Pleins() , 1 ) : REM - trace un ensemble de courbes pleine

kfichier$ = @tmp$ + "test.pdf"

ketat = FN_PLcreatepdf( kfichier$ ) : REM - cree et enregistre le document

IF ketat <> 0 THEN PRINT "Vous pouvez ouvrir " ;  kfichier$ ELSE PRINT "Le document n'a pu etre cree !"

END